Azure Backup Providers API

The Providers API from Azure Backup — 1 operation(s) for providers.

GitHub OpenAPI

Operations 1

GET /{resourceId}/providers/Microsoft.DataProtection/backupInstances Backup instances extension routing list #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/microsoft-azure-backup:microsoft-azure-backup-providers-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

microsoft-azure-backup-providers-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Data Protection Client Providers API
  version: '2026-07-01'
  description: Open API 2.0 Specs for Azure Data Protection service
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Providers
paths:
  /{resourceId}/providers/Microsoft.DataProtection/backupInstances:
    get:
      operationId: BackupInstancesExtensionRouting_List
      description: Gets a list of backup instances associated with a tracked resource
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: resourceId
        in: path
        description: ARM path of the resource to be protected using Microsoft.DataProtection
        required: true
        x-ms-skip-url-encoding: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackupInstanceResourceList'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CloudError'
      x-ms-pageable:
        nextLinkName: nextLink
      tags:
      - Providers
      summary: Backup instances extension routing list
      x-summary-source: derived
components:
  schemas:
    Status:
      type: string
      description: Specifies the protection status of the resource
      enum:
      - ConfiguringProtection
      - ConfiguringProtectionFailed
      - ProtectionConfigured
      - ProtectionStopped
      - SoftDeleted
      - SoftDeleting
      x-ms-enum:
        name: Status
        modelAsString: true
        values:
        - name: ConfiguringProtection
          value: ConfiguringProtection
        - name: ConfiguringProtectionFailed
          value: ConfiguringProtectionFailed
        - name: ProtectionConfigured
          value: ProtectionConfigured
        - name: ProtectionStopped
          value: ProtectionStopped
        - name: SoftDeleted
          value: SoftDeleted
        - name: SoftDeleting
          value: SoftDeleting
    BackupDatasourceParameters:
      type: object
      description: Parameters for Backup Datasource
      properties:
        objectType:
          type: string
          description: Type of the specific object - used for deserializing
      discriminator:
        propertyName: objectType
      required:
      - objectType
    ResourcePropertiesObjectType:
      type: string
      description: Type of the specific object - used for deserializing
      enum:
      - DefaultResourceProperties
      x-ms-enum:
        name: ResourcePropertiesObjectType
        modelAsString: true
        values:
        - name: DefaultResourceProperties
          value: DefaultResourceProperties
    BackupInstanceResource:
      type: object
      description: BackupInstance Resource
      properties:
        properties:
          $ref: '#/components/schemas/BackupInstance'
          description: BackupInstanceResource properties
        tags:
          type: object
          description: Proxy Resource tags.
          additionalProperties:
            type: string
      allOf:
      - $ref: '#/components/schemas/ProxyResource'
    CloudError:
      type: object
      description: An error response from Azure Backup.
      properties:
        error:
          $ref: '#/components/schemas/Error'
          description: The resource management error response.
    DataStoreParameters:
      type: object
      description: Parameters for DataStore
      properties:
        objectType:
          type: string
          description: Type of the specific object - used for deserializing
        dataStoreType:
          $ref: '#/components/schemas/DataStoreTypes'
          description: type of datastore; Operational/Vault/Archive
      discriminator:
        propertyName: objectType
      required:
      - objectType
      - dataStoreType
    DppResourceList:
      type: object
      description: ListResource
      properties:
        nextLink:
          type: string
          description: The uri to fetch the next page of resources. Call ListNext() fetches next page of resources.
    DatasourceSet:
      type: object
      description: DatasourceSet details of datasource to be backed up
      properties:
        datasourceType:
          type: string
          description: DatasourceType of the resource.
        objectType:
          type: string
          description: Type of Datasource object, used to initialize the right inherited type
        resourceID:
          type: string
          description: Full ARM ID of the resource. For azure resources, this is ARM ID. For non azure resources, this will be the ID created by backup service via Fabric/Vault.
        resourceLocation:
          type: string
          description: Location of datasource.
        resourceName:
          type: string
          description: Unique identifier of the resource in the context of parent.
        resourceType:
          type: string
          description: Resource Type of Datasource.
        resourceUri:
          type: string
          description: Uri of the resource.
        resourceProperties:
          $ref: '#/components/schemas/BaseResourceProperties'
          description: Properties specific to data source set
      required:
      - resourceID
    AuthCredentials:
      type: object
      description: Base class for different types of authentication credentials.
      properties:
        objectType:
          type: string
          description: Type of the specific object - used for deserializing
      discriminator:
        propertyName: objectType
      required:
      - objectType
    Datasource:
      type: object
      description: Datasource to be backed up
      properties:
        datasourceType:
          type: string
          description: DatasourceType of the resource.
        objectType:
          type: string
          description: Type of Datasource object, used to initialize the right inherited type
        resourceID:
          type: string
          description: Full ARM ID of the resource. For azure resources, this is ARM ID. For non azure resources, this will be the ID created by backup service via Fabric/Vault.
        resourceLocation:
          type: string
          description: Location of datasource.
        resourceName:
          type: string
          description: Unique identifier of the resource in the context of parent.
        resourceType:
          type: string
          description: Resource Type of Datasource.
        resourceUri:
          type: string
          description: Uri of the resource.
        resourceProperties:
          $ref: '#/components/schemas/BaseResourceProperties'
          description: Properties specific to data source
      required:
      - resourceID
    BackupInstanceResourceList:
      type: object
      description: BackupInstance Resource list response
      properties:
        value:
          type: array
          description: List of resources.
          items:
            $ref: '#/components/schemas/BackupInstanceResource'
      allOf:
      - $ref: '#/components/schemas/DppResourceList'
    PolicyParameters:
      type: object
      description: Parameters in Policy
      properties:
        dataStoreParametersList:
          type: array
          description: Gets or sets the DataStore Parameters
          items:
            $ref: '#/components/schemas/DataStoreParameters'
          x-ms-identifiers: []
        backupDatasourceParametersList:
          type: array
          description: Gets or sets the Backup Data Source Parameters
          items:
            $ref: '#/components/schemas/BackupDatasourceParameters'
          x-ms-identifiers: []
    ValidationType:
      type: string
      description: Specifies the type of validation. In case of DeepValidation, all validations from /validateForBackup API will run again.
      enum:
      - ShallowValidation
      - DeepValidation
      x-ms-enum:
        name: ValidationType
        modelAsString: true
        values:
        - name: ShallowValidation
          value: ShallowValidation
        - name: DeepValidation
          value: DeepValidation
    IdentityDetails:
      type: object
      properties:
        useSystemAssignedIdentity:
          type: boolean
          description: Specifies if the BI is protected by System Identity.
        userAssignedIdentityArmUrl:
          type: string
          description: ARM URL for User Assigned Identity.
    ProtectionStatusDetails:
      type: object
      description: Protection status details
      properties:
        errorDetails:
          $ref: '#/components/schemas/UserFacingError'
          description: Specifies the protection status error of the resource
        status:
          $ref: '#/components/schemas/Status'
          description: Specifies the protection status of the resource
    DataStoreTypes:
      type: string
      description: type of datastore; Operational/Vault/Archive
      enum:
      - OperationalStore
      - VaultStore
      - ArchiveStore
      x-ms-enum:
        name: DataStoreTypes
        modelAsString: true
        values:
        - name: OperationalStore
          value: OperationalStore
        - name: VaultStore
          value: VaultStore
        - name: ArchiveStore
          value: ArchiveStore
    BaseResourceProperties:
      type: object
      description: Properties which are specific to datasource/datasourceSets
      properties:
        objectType:
          $ref: '#/components/schemas/ResourcePropertiesObjectType'
          description: Type of the specific object - used for deserializing
      discriminator:
        propertyName: objectType
      required:
      - objectType
    Error:
      type: object
      description: The resource management error response.
      properties:
        additionalInfo:
          type: array
          description: The error additional info.
          items:
            $ref: '#/components/schemas/ErrorAdditionalInfo'
          readOnly: true
          x-ms-identifiers: []
        code:
          type: string
          description: The error code.
          readOnly: true
        details:
          type: array
          description: The error details.
          items:
            $ref: '#/components/schemas/Error'
          readOnly: true
          x-ms-identifiers: []
        message:
          type: string
          description: The error message.
          readOnly: true
        target:
          type: string
          description: The error target.
          readOnly: true
    ErrorAdditionalInfo:
      type: object
      description: The resource management error additional info.
      properties:
        type:
          type: string
          description: The additional info type.
          readOnly: true
        info:
          type: object
          description: The additional info.
          readOnly: true
    BackupInstance:
      type: object
      description: Backup Instance
      properties:
        friendlyName:
          type: string
          description: Gets or sets the Backup Instance friendly name.
        dataSourceInfo:
          $ref: '#/components/schemas/Datasource'
          description: Gets or sets the data source information.
        dataSourceSetInfo:
          $ref: '#/components/schemas/DatasourceSet'
          description: Gets or sets the data source set information.
        policyInfo:
          $ref: '#/components/schemas/PolicyInfo'
          description: Gets or sets the policy information.
        resourceGuardOperationRequests:
          type: array
          description: ResourceGuardOperationRequests on which LAC check will be performed
          items:
            type: string
        protectionStatus:
          $ref: '#/components/schemas/ProtectionStatusDetails'
          description: Specifies the protection status of the resource
          readOnly: true
        currentProtectionState:
          $ref: '#/components/schemas/CurrentProtectionState'
          description: Specifies the current protection state of the resource
          readOnly: true
        protectionErrorDetails:
          $ref: '#/components/schemas/UserFacingError'
          description: Specifies the protection error of the resource
          readOnly: true
        provisioningState:
          type: string
          description: Specifies the provisioning state of the resource i.e. provisioning/updating/Succeeded/Failed
          readOnly: true
        datasourceAuthCredentials:
          $ref: '#/components/schemas/AuthCredentials'
          description: Credentials to use to authenticate with data source provider.
        validationType:
          $ref: '#/components/schemas/ValidationType'
          description: Specifies the type of validation. In case of DeepValidation, all validations from /validateForBackup API will run again.
        identityDetails:
          $ref: '#/components/schemas/IdentityDetails'
          description: 'Contains information of the Identity Details for the BI.

            If it is null, default will be considered as System Assigned.'
        objectType:
          type: string
      required:
      - dataSourceInfo
      - policyInfo
      - objectType
    CurrentProtectionState:
      type: string
      description: Specifies the current protection state of the resource
      enum:
      - Invalid
      - NotProtected
      - ConfiguringProtection
      - ProtectionConfigured
      - BackupSchedulesSuspended
      - RetentionSchedulesSuspended
      - ProtectionStopped
      - ProtectionError
      - ConfiguringProtectionFailed
      - SoftDeleting
      - SoftDeleted
      - UpdatingProtection
      x-ms-enum:
        name: CurrentProtectionState
        modelAsString: true
        values:
        - name: Invalid
          value: Invalid
        - name: NotProtected
          value: NotProtected
        - name: ConfiguringProtection
          value: ConfiguringProtection
        - name: ProtectionConfigured
          value: ProtectionConfigured
        - name: BackupSchedulesSuspended
          value: BackupSchedulesSuspended
        - name: RetentionSchedulesSuspended
          value: RetentionSchedulesSuspended
        - name: ProtectionStopped
          value: ProtectionStopped
        - name: ProtectionError
          value: ProtectionError
        - name: ConfiguringProtectionFailed
          value: ConfiguringProtectionFailed
        - name: SoftDeleting
          value: SoftDeleting
        - name: SoftDeleted
          value: SoftDeleted
        - name: UpdatingProtection
          value: UpdatingProtection
    UserFacingError:
      type: object
      description: Error object used by layers that have access to localized content, and propagate that to user
      properties:
        code:
          type: string
          description: Unique code for this error
        details:
          type: array
          description: Additional related Errors
          items:
            $ref: '#/components/schemas/UserFacingError'
          x-ms-identifiers: []
        innerError:
          $ref: '#/components/schemas/InnerError'
          description: Inner Error
        isRetryable:
          type: boolean
          description: Whether the operation will be retryable or not
        isUserError:
          type: boolean
          description: Whether the operation is due to a user error or service error
        properties:
          type: object
          description: Any key value pairs that can be injected inside error object
          additionalProperties:
            type: string
        message:
          type: string
        recommendedAction:
          type: array
          description: RecommendedAction � localized.
          items:
            type: string
        target:
          type: string
          description: Target of the error.
    PolicyInfo:
      type: object
      description: Policy Info in backupInstance
      properties:
        policyId:
          type: string
        policyVersion:
          type: string
          readOnly: true
        policyParameters:
          $ref: '#/components/schemas/PolicyParameters'
          description: Policy parameters for the backup instance
      required:
      - policyId
    ProxyResource:
      type: object
      title: Proxy Resource
      description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
      allOf:
      - $ref: '#/components/schemas/Resource'
    InnerError:
      type: object
      description: Inner Error
      properties:
        additionalInfo:
          type: object
          description: Any Key value pairs that can be provided to the client for additional  verbose information.
          additionalProperties:
            type: string
        code:
          type: string
          description: Unique code for this error
        embeddedInnerError:
          $ref: '#/components/schemas/InnerError'
          description: Child Inner Error, to allow Nesting.
  parameters:
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.