Backup Instances - Create Or Update

Referência

Serviço:: Data Protection

Versão da API:: 2025-01-01

Criar ou atualizar uma instância de backup em um cofre de backup

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2025-01-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
backupInstanceName	path	True	string	O nome da instância de backup.
resourceGroupName	path	True	string	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string uuid	A ID da assinatura de destino. O valor deve ser um UUID.
vaultName	path	True	string	O nome do cofre de backup.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
x-ms-authorization-auxiliary		string

Corpo do Pedido

Name	Tipo	Description
properties	BackupInstance	Propriedades BackupInstanceResource
tags	object	Tags de recurso de proxy.

Respostas

Name	Tipo	Description
200 OK	BackupInstanceResource	OK
201 Created	BackupInstanceResource	Criado
202 Accepted		Aceito Cabeçalhos Location: string Azure-AsyncOperation: string
Other Status Codes	CloudError	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	Personifique a sua conta de utilizador.

Exemplos

Create BackupInstance

Create BackupInstance to perform critical operation With MUA

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Create BackupInstance

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "objectType": "BackupInstance",
    "friendlyName": "harshitbi2",
    "dataSourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "dataSourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "datasourceAuthCredentials": {
      "secretStoreResource": {
        "uri": "https://samplevault.vault.azure.net/secrets/credentials",
        "secretStoreType": "AzureKeyVault"
      },
      "objectType": "SecretStoreBasedAuthCredentials"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "validationType": "ShallowValidation"
  }
}

Resposta da amostra

Código de estado:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Código de estado:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Código de estado:: 200

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Create BackupInstance to perform critical operation With MUA

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "objectType": "BackupInstance",
    "friendlyName": "harshitbi2",
    "dataSourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "dataSourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "datasourceAuthCredentials": {
      "secretStoreResource": {
        "uri": "https://samplevault.vault.azure.net/secrets/credentials",
        "secretStoreType": "AzureKeyVault"
      },
      "objectType": "SecretStoreBasedAuthCredentials"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "resourceGuardOperationRequests": [
      "/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/dppModifyPolicy/default"
    ],
    "validationType": "ShallowValidation"
  }
}

Resposta da amostra

Código de estado:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Código de estado:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Código de estado:: 200

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourcegroups/aksrg/providers/Microsoft.DataProtection/BackupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "objectType": "BackupInstance"
  }
}

Resposta da amostra

Código de estado:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
  "name": "aksbi",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Código de estado:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Código de estado:: 200

{
  "id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
  "name": "aksbi",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Definições

Name	Description
AKSVolumeTypes	Obtém ou define a propriedade include volume types. Esta propriedade define os tipos de volume a serem incluídos durante o backup.
AzureOperationalStoreParameters	Parâmetros para Operational-Tier DataStore
BackupInstance	Instância de backup
BackupInstanceResource	BackupInstanceResource
BlobBackupDatasourceParameters	Parâmetros a serem usados durante a configuração de backup de blobs
CloudError	CloudError
createdByType	O tipo de identidade que criou o recurso.
CurrentProtectionState	Especifica o estado de proteção atual do recurso
Datasource	Fonte de dados
DatasourceSet	DatasourceSet
DataStoreTypes	tipo de armazenamento de dados; Operacional/Cofre/Arquivo
DefaultResourceProperties	Propriedades de origem padrão
Error	A resposta de erro de gerenciamento de recursos.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
IdentityDetails
InnerError	InnerError
KubernetesClusterBackupDatasourceParameters	Parâmetros para a fonte de dados do Kubernetes Cluster Backup
NamespacedNameResource	NamespacedNameResource
PolicyInfo	Informação Política
PolicyParameters	Parâmetros na Política
ProtectionStatusDetails	ProteçãoStatusDetalhes
SecretStoreBasedAuthCredentials	Credenciais de autenticação baseadas em armazenamento secreto.
SecretStoreResource	Classe que representa um recurso de armazenamento secreto.
SecretStoreType	Obtém ou define o tipo de armazenamento secreto
Status	Especifica o status de proteção do recurso
systemData	Metadados referentes à criação e última modificação do recurso.
UserFacingError	Objeto de erro usado por camadas que têm acesso a conteúdo localizado e propagam isso para o usuário
ValidationType	Especifica o tipo de validação. No caso de DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

AKSVolumeTypes

Enumeration

Obtém ou define a propriedade include volume types. Esta propriedade define os tipos de volume a serem incluídos durante o backup.

Valor	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Parâmetros para Operational-Tier DataStore

Name	Tipo	Description
dataStoreType	DataStoreTypes	tipo de armazenamento de dados; Operacional/Cofre/Arquivo
objectType	string: AzureOperationalStoreParameters	Tipo do objeto específico - usado para desserialização
resourceGroupId	string	Obtém ou define o Uri do Grupo de Recursos de Instantâneo.

BackupInstance

Object

Instância de backup

Name	Tipo	Description
currentProtectionState	CurrentProtectionState	Especifica o estado de proteção atual do recurso
dataSourceInfo	Datasource	Fonte de dados Obtém ou define as informações da fonte de dados.
dataSourceSetInfo	DatasourceSet	DatasourceSet Obtém ou define as informações do conjunto de fontes de dados.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Credenciais a serem usadas para autenticar com o provedor da fonte de dados.
friendlyName	string	Obtém ou define o nome amigável da instância de backup.
identityDetails	IdentityDetails	Contém informações dos Detalhes de Identidade para o BI. Se for null, o padrão será considerado como System Assigned.
objectType	string
policyInfo	PolicyInfo	Informação Política Obtém ou define as informações da política.
protectionErrorDetails	UserFacingError	Especifica o erro de proteção do recurso
protectionStatus	ProtectionStatusDetails	ProteçãoStatusDetalhes Especifica o status de proteção do recurso
provisioningState	string	Especifica o estado de provisionamento do recurso, ou seja, provisionamento/atualização/êxito/falha
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests em que a verificação LAC será executada
validationType	ValidationType	Especifica o tipo de validação. No caso de DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

BackupInstanceResource

Object

BackupInstanceResource

Name	Tipo	Description
id	string	Proxy Resource Id representa o caminho completo para o recurso.
name	string	Proxy Nome do recurso associado ao recurso.
properties	BackupInstance	Propriedades BackupInstanceResource
systemData	systemData	Metadados referentes à criação e última modificação do recurso.
tags	object	Tags de recurso de proxy.
type	string	O tipo de recurso de proxy representa o caminho completo do formulário Namespace/ResourceType/ResourceType/...

BlobBackupDatasourceParameters

Object

Parâmetros a serem usados durante a configuração de backup de blobs

Name	Tipo	Description
containersList	string[]	Lista de contêineres para backup durante a configuração de backup de blobs
objectType	string: BlobBackupDatasourceParameters	Tipo do objeto específico - usado para desserialização

CloudError

Object

CloudError

Name	Tipo	Description
error	Error	A resposta de erro de gerenciamento de recursos.

createdByType

Enumeration

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CurrentProtectionState

Enumeration

Especifica o estado de proteção atual do recurso

Valor	Description
BackupSchedulesSuspended
ConfiguringProtection
ConfiguringProtectionFailed
Invalid
NotProtected
ProtectionConfigured
ProtectionError
ProtectionStopped
RetentionSchedulesSuspended
SoftDeleted
SoftDeleting
UpdatingProtection

Datasource

Object

Fonte de dados

Name	Tipo	Description
datasourceType	string	DatasourceType do recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
resourceID	string	ID ARM completo do recurso. Para recursos do Azure, isso é ARM ID. Para recursos não azure, essa será a ID criada pelo serviço de backup via Fabric/Vault.
resourceLocation	string	Localização da fonte de dados.
resourceName	string	Identificador exclusivo do recurso no contexto do pai.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriedades específicas da fonte de dados
resourceType	string	Tipo de recurso da fonte de dados.
resourceUri	string	Uri do recurso.

DatasourceSet

Object

DatasourceSet

Name	Tipo	Description
datasourceType	string	DatasourceType do recurso.
objectType	string	Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
resourceID	string	ID ARM completo do recurso. Para recursos do Azure, isso é ARM ID. Para recursos não azure, essa será a ID criada pelo serviço de backup via Fabric/Vault.
resourceLocation	string	Localização da fonte de dados.
resourceName	string	Identificador exclusivo do recurso no contexto do pai.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Propriedades específicas do conjunto de fontes de dados
resourceType	string	Tipo de recurso da fonte de dados.
resourceUri	string	Uri do recurso.

DataStoreTypes

Enumeration

tipo de armazenamento de dados; Operacional/Cofre/Arquivo

Valor	Description
ArchiveStore
OperationalStore
VaultStore

DefaultResourceProperties

Object

Propriedades de origem padrão

Name	Tipo	Description
objectType	string: DefaultResourceProperties	Tipo do objeto específico - usado para desserialização

Error

Object

A resposta de erro de gerenciamento de recursos.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	Error[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

IdentityDetails

Object

Name	Tipo	Description
useSystemAssignedIdentity	boolean	Especifica se o BI está protegido pela Identidade do Sistema.
userAssignedIdentityArmUrl	string	URL ARM para identidade atribuída ao usuário.

InnerError

Object

InnerError

Name	Tipo	Description
additionalInfo	object	Quaisquer pares de valores de chave que possam ser fornecidos ao cliente para obter informações detalhadas adicionais.
code	string	Código exclusivo para este erro
embeddedInnerError	InnerError	InnerError Erro interno da criança, para permitir o aninhamento.

KubernetesClusterBackupDatasourceParameters

Object

Parâmetros para a fonte de dados do Kubernetes Cluster Backup

Name	Tipo	Description
backupHookReferences	NamespacedNameResource[]	Obtém ou define as referências de gancho de backup. Esta propriedade define a referência de gancho a ser executada durante o backup.
excludedNamespaces	string[]	Obtém ou define a propriedade exclude namespaces. Esta propriedade define os namespaces a serem excluídos durante o backup.
excludedResourceTypes	string[]	Obtém ou define a propriedade excluir tipos de recursos. Esta propriedade define os tipos de recursos a serem excluídos durante o backup.
includeClusterScopeResources	boolean	Obtém ou define a propriedade include cluster resources. Essa propriedade, se habilitada, incluirá recursos de escopo de cluster durante o backup.
includedNamespaces	string[]	Obtém ou define a propriedade include namespaces. Esta propriedade define os namespaces a serem incluídos durante o backup.
includedResourceTypes	string[]	Obtém ou define a propriedade include resource types. Esta propriedade define os tipos de recursos a serem incluídos durante o backup.
includedVolumeTypes	AKSVolumeTypes[]	Obtém ou define a propriedade include volume types. Esta propriedade define os tipos de volume a serem incluídos durante o backup.
labelSelectors	string[]	Obtém ou define a propriedade LabelSelectors. Esta propriedade define o recurso com esses seletores de rótulo a serem incluídos durante o backup.
objectType	string: KubernetesClusterBackupDatasourceParameters	Tipo do objeto específico - usado para desserialização
snapshotVolumes	boolean	Obtém ou define a propriedade de instantâneo de volume. Essa propriedade, se ativada, tirará instantâneos de volume durante o backup.

NamespacedNameResource

Object

NamespacedNameResource

Name	Tipo	Description
name	string	Nome do recurso
namespace	string	Namespace no qual o recurso existe

PolicyInfo

Object

Informação Política

Name	Tipo	Description
policyId	string
policyParameters	PolicyParameters	Parâmetros de política para a instância de backup
policyVersion	string

PolicyParameters

Object

Parâmetros na Política

Name	Tipo	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Obtém ou define os parâmetros da fonte de dados de backup
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Obtém ou define os parâmetros DataStore

ProtectionStatusDetails

Object

ProteçãoStatusDetalhes

Name	Tipo	Description
errorDetails	UserFacingError	Especifica o erro de status de proteção do recurso
status	Status	Especifica o status de proteção do recurso

SecretStoreBasedAuthCredentials

Object

Credenciais de autenticação baseadas em armazenamento secreto.

Name	Tipo	Description
objectType	string: SecretStoreBasedAuthCredentials	Tipo do objeto específico - usado para desserialização
secretStoreResource	SecretStoreResource	Recurso de armazenamento secreto

SecretStoreResource

Object

Classe que representa um recurso de armazenamento secreto.

Name	Tipo	Description
secretStoreType	SecretStoreType	Obtém ou define o tipo de armazenamento secreto
uri	string	Uri para chegar ao recurso
value	string	Obtém ou define o valor armazenado no recurso de armazenamento secreto

SecretStoreType

Enumeration

Obtém ou define o tipo de armazenamento secreto

Valor	Description
AzureKeyVault
Invalid

Status

Enumeration

Especifica o status de proteção do recurso

Valor	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

UserFacingError

Object

Objeto de erro usado por camadas que têm acesso a conteúdo localizado e propagam isso para o usuário

Name	Tipo	Description
code	string	Código exclusivo para este erro
details	UserFacingError[]	Erros adicionais relacionados
innerError	InnerError	InnerError Erro interno
isRetryable	boolean	Se a operação será repetida ou não
isUserError	boolean	Se a operação é devido a um erro do usuário ou erro de serviço
message	string
properties	object	Qualquer par de valores de chave que possa ser injetado dentro do objeto de erro
recommendedAction	string[]	RecommendedAction localizado.
target	string	Alvo do erro.

ValidationType

Enumeration

Especifica o tipo de validação. No caso de DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.

Valor	Description
DeepValidation
ShallowValidation

Partilhar via

Backup Instances - Create Or Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create BackupInstance

Pedido de amostra

Resposta da amostra

Create BackupInstance to perform critical operation With MUA

Pedido de amostra

Resposta da amostra

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Pedido de amostra

Resposta da amostra

Definições

AKSVolumeTypes

AzureOperationalStoreParameters

BackupInstance

BackupInstanceResource

BlobBackupDatasourceParameters

CloudError

createdByType

CurrentProtectionState

Datasource

DatasourceSet

DataStoreTypes

DefaultResourceProperties

Error

ErrorAdditionalInfo

IdentityDetails

InnerError

KubernetesClusterBackupDatasourceParameters

NamespacedNameResource

PolicyInfo

PolicyParameters

ProtectionStatusDetails

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

systemData

UserFacingError

ValidationType

Recursos adicionais