Backup Instances - Create Or Update
在备份保管库中创建或更新备份实例
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2025-09-01
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
backup
|
path | True |
string |
BackupInstanceResource 的名称 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
资源组的名称。 此名称不区分大小写。 |
|
subscription
|
path | True |
string (uuid) |
目标订阅的 ID。 该值必须是 UUID。 |
|
vault
|
path | True |
string minLength: 2maxLength: 50 pattern: ^[A-Za-z][-A-Za-z0-9]*[A-Za-z0-9]$ |
备份保管库的名称。 |
|
api-version
|
query | True |
string minLength: 1 |
要用于此操作的 API 版本。 |
请求头
| 名称 | 必需 | 类型 | 说明 |
|---|---|---|---|
| x-ms-authorization-auxiliary |
string |
请求正文
| 名称 | 类型 | 说明 |
|---|---|---|
| properties |
BackupInstanceResource 属性 |
|
| tags |
object |
代理资源标记。 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 OK |
资源“BackupInstanceResource”更新作成功 |
|
| 201 Created |
资源“BackupInstanceResource”创建作成功 标头
|
|
| 202 Accepted |
已接受资源作。 标头
|
|
| Other Status Codes |
意外的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
| 名称 | 说明 |
|---|---|
| user_impersonation | 模拟用户帐户 |
示例
Create BackupInstance
示例请求
PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-09-01
{
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "Microsoft.DBforPostgreSQL/servers",
"resourceUri": ""
},
"datasourceAuthCredentials": {
"objectType": "SecretStoreBasedAuthCredentials",
"secretStoreResource": {
"secretStoreType": "AzureKeyVault",
"uri": "https://samplevault.vault.azure.net/secrets/credentials"
}
},
"friendlyName": "harshitbi2",
"identityDetails": {
"useSystemAssignedIdentity": false,
"userAssignedIdentityArmUrl": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"
},
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
}
]
}
},
"validationType": "ShallowValidation"
}
}
示例响应
{
"name": "harshitbi2",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
"properties": {
"dataSourceInfo": {
"datasourceType": "OssDB",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "OssDB",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "OssDB",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "OssDB",
"resourceUri": ""
},
"friendlyName": "harshitbi2",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
}
]
},
"policyVersion": "3.2"
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioned"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Retry-After: 60
{
"name": "harshitbi2",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
"properties": {
"dataSourceInfo": {
"datasourceType": "OssDB",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "OssDB",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "OssDB",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "OssDB",
"resourceUri": ""
},
"friendlyName": "harshitbi2",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
}
]
},
"policyVersion": "3.2"
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioning"
}
}
Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-09-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-09-01
Retry-After: 60
Create BackupInstance to perform critical operation With MUA
示例请求
PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-09-01
{
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.DBforPostgreSQL/servers/databases",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "Microsoft.DBforPostgreSQL/servers",
"resourceUri": ""
},
"datasourceAuthCredentials": {
"objectType": "SecretStoreBasedAuthCredentials",
"secretStoreResource": {
"secretStoreType": "AzureKeyVault",
"uri": "https://samplevault.vault.azure.net/secrets/credentials"
}
},
"friendlyName": "harshitbi2",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"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"
}
}
示例响应
{
"name": "harshitbi2",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
"properties": {
"dataSourceInfo": {
"datasourceType": "OssDB",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "OssDB",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "OssDB",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "OssDB",
"resourceUri": ""
},
"friendlyName": "harshitbi2",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
}
]
},
"policyVersion": "3.2"
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioned"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Retry-After: 60
{
"name": "harshitbi2",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
"properties": {
"dataSourceInfo": {
"datasourceType": "OssDB",
"objectType": "Datasource",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
"resourceLocation": "",
"resourceName": "testdb",
"resourceType": "OssDB",
"resourceUri": ""
},
"dataSourceSetInfo": {
"datasourceType": "OssDB",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
"resourceLocation": "",
"resourceName": "viveksipgtest",
"resourceType": "OssDB",
"resourceUri": ""
},
"friendlyName": "harshitbi2",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
"policyParameters": {
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
}
]
},
"policyVersion": "3.2"
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioning"
}
}
Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-09-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-09-01
Retry-After: 60
Create BackupInstance With ADLSBlobBackupDatasourceParameters
示例请求
PUT https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071?api-version=2025-09-01
{
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"friendlyName": "adlsstorageaccount\\adlsbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"containersList": [
"container1"
],
"objectType": "AdlsBlobBackupDatasourceParameters"
}
]
}
}
}
}
示例响应
{
"name": "19a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/19a76f8a-c176-4f7d-819e-95157e2b0077",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"friendlyName": "adlsstorageaccount\\adlsbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"containersList": [
"container1"
],
"objectType": "AdlsBlobBackupDatasourceParameters"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioned"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourcegroups/adlsrg/providers/Microsoft.Resources/deployments/ConfigureProtection-2097/operationStatuses/08584622124860116406?api-version=2022-12-01&t=638749912006014742&c=MIIHhzCCBm-gAwIBAgITfAaTiaklTwdb3CiPmAAABpOJqTANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDUw
Retry-After: 60
{
"name": "19a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/19a76f8a-c176-4f7d-819e-95157e2b0077",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/adlsBlobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "adlsstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"
},
"friendlyName": "adlsstorageaccount\\adlsbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"containersList": [],
"objectType": "AdlsBlobBackupDatasourceParameters"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioning"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourcegroups/adlsrg/providers/Microsoft.Resources/deployments/ConfigureProtection-2097/operationStatuses/08584622124860116406?api-version=2022-12-01&t=638749912006014742&c=MIIHhzCCBm-gAwIBAgITfAaTiaklTwdb3CiPmAAABpOJqTANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDUw
Location: https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourcegroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071/operationStatuses/08584622124860116406?api-version=2022-12-01&t=638749912006014742&c=MIIHhzCCBm-gAwIBAgITfAaTiaklTwdb3CiPmAAABpOJqTANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDUw
Retry-After: 60
Create BackupInstance With KubernetesClusterBackupDatasourceParameters
示例请求
PUT https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi?api-version=2025-09-01
{
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "Datasource",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceName": "akscluster",
"resourceType": "Microsoft.ContainerService/managedclusters",
"resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceName": "akscluster",
"resourceType": "Microsoft.ContainerService/managedclusters",
"resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"
},
"friendlyName": "aksbi",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourcegroups/aksrg/providers/Microsoft.DataProtection/BackupVaults/aksvault/backupPolicies/akspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"excludedNamespaces": [
"kube-system"
],
"excludedResourceTypes": [
"v1/Secret"
],
"includeClusterScopeResources": true,
"includedNamespaces": [
"test"
],
"includedResourceTypes": [],
"includedVolumeTypes": [
"AzureDisk",
"AzureFileShareSMB"
],
"labelSelectors": [],
"objectType": "KubernetesClusterBackupDatasourceParameters",
"snapshotVolumes": true
}
],
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg"
}
]
}
}
}
}
示例响应
{
"name": "aksbi",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "Datasource",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceName": "akscluster",
"resourceType": "Microsoft.ContainerService/managedclusters",
"resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceType": "Microsoft.ContainerService/managedclusters"
},
"friendlyName": "aksbi",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"excludedNamespaces": [
"kube-system"
],
"excludedResourceTypes": [
"v1/Secret"
],
"includeClusterScopeResources": true,
"includedNamespaces": [
"test"
],
"includedResourceTypes": [],
"includedVolumeTypes": [
"AzureDisk",
"AzureFileShareSMB"
],
"labelSelectors": [],
"objectType": "KubernetesClusterBackupDatasourceParameters",
"snapshotVolumes": true
}
],
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioned"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-09-01
Retry-After: 60
{
"name": "aksbi",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "Datasource",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceName": "akscluster",
"resourceType": "Microsoft.ContainerService/managedclusters",
"resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.ContainerService/managedclusters",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
"resourceLocation": "eastus2euap",
"resourceType": "Microsoft.ContainerService/managedclusters"
},
"friendlyName": "aksbi",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"excludedNamespaces": [
"kube-system"
],
"excludedResourceTypes": [
"v1/Secret"
],
"includeClusterScopeResources": true,
"includedNamespaces": [
"test"
],
"includedResourceTypes": [],
"includedVolumeTypes": [
"AzureDisk",
"AzureFileShareSMB"
],
"labelSelectors": [],
"objectType": "KubernetesClusterBackupDatasourceParameters",
"snapshotVolumes": true
}
],
"dataStoreParametersList": [
{
"dataStoreType": "OperationalStore",
"objectType": "AzureOperationalStoreParameters",
"resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioning"
}
}
Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-09-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-09-01
Retry-After: 60
定义
AdlsBlobBackupDatasourceParameters
配置 Azure Data Lake Storage 帐户 blob 备份期间要使用的参数
| 名称 | 类型 | 说明 |
|---|---|---|
| containersList |
string[] |
配置 blob 时要备份的容器列表 |
| objectType | string: |
特定对象的类型 - 用于反序列化 |
AKSVolumeTypes
| 值 | 说明 |
|---|---|
| AzureDisk | |
| AzureFileShareSMB |
AzureOperationalStoreParameters
Operational-Tier DataStore 的参数
| 名称 | 类型 | 说明 |
|---|---|---|
| dataStoreType |
数据存储的类型;作/保管库/存档 |
|
| objectType | string: |
特定对象的类型 - 用于反序列化 |
| resourceGroupId |
string |
获取或设置快照资源组 URI。 |
BackupInstance
备份实例
| 名称 | 类型 | 说明 |
|---|---|---|
| currentProtectionState |
指定资源的当前保护状态 |
|
| dataSourceInfo |
获取或设置数据源信息。 |
|
| dataSourceSetInfo |
获取或设置数据源集信息。 |
|
| datasourceAuthCredentials | AuthCredentials: |
用于向数据源提供程序进行身份验证的凭据。 |
| friendlyName |
string |
获取或设置备份实例友好名称。 |
| identityDetails |
包含 BI 的标识详细信息的信息。 如果为 null,则默认值将被视为系统分配。 |
|
| objectType |
string |
|
| policyInfo |
获取或设置策略信息。 |
|
| protectionErrorDetails |
指定资源的保护错误 |
|
| protectionStatus |
指定资源的保护状态 |
|
| provisioningState |
string |
指定资源的预配状态,即预配/更新/成功/失败 |
| resourceGuardOperationRequests |
string[] |
将对其执行 LAC 检查的 ResourceGuardOperationRequests |
| validationType |
指定验证的类型。 对于 DeepValidation,/validateForBackup API 中的所有验证都将再次运行。 |
BackupInstanceResource
BackupInstance 资源
| 名称 | 类型 | 说明 |
|---|---|---|
| id |
string (arm-id) |
资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}” |
| name |
string |
资源的名称 |
| properties |
BackupInstanceResource 属性 |
|
| systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
| tags |
object |
代理资源标记。 |
| type |
string |
资源类型。 例如,“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
BlobBackupDatasourceParameters
配置 blob 期间要使用的参数
| 名称 | 类型 | 说明 |
|---|---|---|
| containersList |
string[] |
配置 blob 时要备份的容器列表 |
| objectType | string: |
特定对象的类型 - 用于反序列化 |
CloudError
Azure 备份的错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| error |
资源管理错误响应。 |
createdByType
创建资源的标识的类型。
| 值 | 说明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
CurrentProtectionState
指定资源的当前保护状态
| 值 | 说明 |
|---|---|
| Invalid | |
| NotProtected | |
| ConfiguringProtection | |
| ProtectionConfigured | |
| BackupSchedulesSuspended | |
| RetentionSchedulesSuspended | |
| ProtectionStopped | |
| ProtectionError | |
| ConfiguringProtectionFailed | |
| SoftDeleting | |
| SoftDeleted | |
| UpdatingProtection |
Datasource
要备份的数据源
| 名称 | 类型 | 说明 |
|---|---|---|
| datasourceType |
string |
资源的 DatasourceType。 |
| objectType |
string |
Datasource 对象的类型,用于初始化正确的继承类型 |
| resourceID |
string |
资源的完整 ARM ID。 对于 Azure 资源,这是 ARM ID。 对于非 Azure 资源,这是通过 Fabric/Vault 备份服务创建的 ID。 |
| resourceLocation |
string |
数据源的位置。 |
| resourceName |
string |
父上下文中资源的唯一标识符。 |
| resourceProperties | BaseResourceProperties: |
特定于数据源的属性 |
| resourceType |
string |
数据源的资源类型。 |
| resourceUri |
string |
资源的 URI。 |
DatasourceSet
要备份的数据源的 DatasourceSet 详细信息
| 名称 | 类型 | 说明 |
|---|---|---|
| datasourceType |
string |
资源的 DatasourceType。 |
| objectType |
string |
Datasource 对象的类型,用于初始化正确的继承类型 |
| resourceID |
string |
资源的完整 ARM ID。 对于 Azure 资源,这是 ARM ID。 对于非 Azure 资源,这是通过 Fabric/Vault 备份服务创建的 ID。 |
| resourceLocation |
string |
数据源的位置。 |
| resourceName |
string |
父上下文中资源的唯一标识符。 |
| resourceProperties | BaseResourceProperties: |
特定于数据源集的属性 |
| resourceType |
string |
数据源的资源类型。 |
| resourceUri |
string |
资源的 URI。 |
DataStoreTypes
数据存储的类型;作/保管库/存档
| 值 | 说明 |
|---|---|
| OperationalStore | |
| VaultStore | |
| ArchiveStore |
DefaultResourceProperties
默认源属性
| 名称 | 类型 | 说明 |
|---|---|---|
| objectType | string: |
特定对象的类型 - 用于反序列化 |
Error
资源管理错误响应。
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
错误附加信息。 |
|
| code |
string |
错误代码。 |
| details |
Error[] |
错误详细信息。 |
| message |
string |
错误消息。 |
| target |
string |
错误目标。 |
ErrorAdditionalInfo
资源管理错误附加信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| info |
object |
其他信息。 |
| type |
string |
其他信息类型。 |
IdentityDetails
| 名称 | 类型 | 说明 |
|---|---|---|
| useSystemAssignedIdentity |
boolean |
指定 BI 是否受系统标识保护。 |
| userAssignedIdentityArmUrl |
string |
用户分配标识的 ARM URL。 |
InnerError
内部错误
| 名称 | 类型 | 说明 |
|---|---|---|
| additionalInfo |
object |
任何可提供给客户端的键值对,以获取其他详细信息。 |
| code |
string |
此错误的唯一代码 |
| embeddedInnerError |
子内部错误,允许嵌套。 |
KubernetesClusterBackupDatasourceParameters
Kubernetes 群集备份数据源的参数
| 名称 | 类型 | 说明 |
|---|---|---|
| backupHookReferences |
获取或设置备份挂钩引用。 此属性设置在备份期间要执行的挂钩引用。 |
|
| excludedNamespaces |
string[] |
获取或设置 exclude 命名空间属性。 此属性设置在备份期间要排除的命名空间。 |
| excludedResourceTypes |
string[] |
获取或设置排除资源类型属性。 此属性设置在备份期间要排除的资源类型。 |
| includeClusterScopeResources |
boolean |
获取或设置 include 群集资源属性。 如果启用此属性,则会在备份期间包括群集范围资源。 |
| includedNamespaces |
string[] |
获取或设置 include 命名空间属性。 此属性设置在备份期间要包括的命名空间。 |
| includedResourceTypes |
string[] |
获取或设置 include 资源类型属性。 此属性设置在备份期间要包含的资源类型。 |
| includedVolumeTypes |
获取或设置 include 卷类型属性。 此属性设置备份期间要包含的卷类型。 |
|
| labelSelectors |
string[] |
获取或设置 LabelSelectors 属性。 此属性设置在备份期间要包含的此类标签选择器的资源。 |
| objectType | string: |
特定对象的类型 - 用于反序列化 |
| snapshotVolumes |
boolean |
获取或设置卷快照属性。 如果启用此属性,则会在备份期间创建卷快照。 |
NamespacedNameResource
引用包含命名空间和名称的资源的类
| 名称 | 类型 | 说明 |
|---|---|---|
| name |
string |
资源的名称 |
| namespace |
string |
资源所在的命名空间 |
PolicyInfo
backupInstance 中的策略信息
| 名称 | 类型 | 说明 |
|---|---|---|
| policyId |
string |
|
| policyParameters |
备份实例的策略参数 |
|
| policyVersion |
string |
PolicyParameters
策略中的参数
| 名称 | 类型 | 说明 |
|---|---|---|
| backupDatasourceParametersList | BackupDatasourceParameters[]: |
获取或设置备份数据源参数 |
| dataStoreParametersList | DataStoreParameters[]: |
获取或设置 DataStore 参数 |
ProtectionStatusDetails
保护状态详细信息
| 名称 | 类型 | 说明 |
|---|---|---|
| errorDetails |
指定资源的保护状态错误 |
|
| status |
指定资源的保护状态 |
ResourcePropertiesObjectType
特定对象的类型 - 用于反序列化
| 值 | 说明 |
|---|---|
| DefaultResourceProperties |
SecretStoreBasedAuthCredentials
基于机密存储的身份验证凭据。
| 名称 | 类型 | 说明 |
|---|---|---|
| objectType | string: |
特定对象的类型 - 用于反序列化 |
| secretStoreResource |
机密存储资源 |
SecretStoreResource
表示机密存储资源的类。
| 名称 | 类型 | 说明 |
|---|---|---|
| secretStoreType |
获取或设置机密存储的类型 |
|
| uri |
string |
用于访问资源的 URI |
| value |
string |
获取或设置存储在机密存储资源中的值 |
SecretStoreType
获取或设置机密存储的类型
| 值 | 说明 |
|---|---|
| Invalid | |
| AzureKeyVault |
Status
指定资源的保护状态
| 值 | 说明 |
|---|---|
| ConfiguringProtection | |
| ConfiguringProtectionFailed | |
| ProtectionConfigured | |
| ProtectionStopped | |
| SoftDeleted | |
| SoftDeleting |
systemData
与创建和上次修改资源相关的元数据。
| 名称 | 类型 | 说明 |
|---|---|---|
| createdAt |
string (date-time) |
资源创建时间戳(UTC)。 |
| createdBy |
string |
创建资源的标识。 |
| createdByType |
创建资源的标识的类型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的资源时间戳(UTC) |
| lastModifiedBy |
string |
上次修改资源的标识。 |
| lastModifiedByType |
上次修改资源的标识的类型。 |
UserFacingError
有权访问本地化内容的层使用的 Error 对象,并将其传播到用户
| 名称 | 类型 | 说明 |
|---|---|---|
| code |
string |
此错误的唯一代码 |
| details |
其他相关错误 |
|
| innerError |
内部错误 |
|
| isRetryable |
boolean |
作是否可重试 |
| isUserError |
boolean |
作是由用户错误还是服务错误导致的 |
| message |
string |
|
| properties |
object |
可在错误对象内注入的任何键值对 |
| recommendedAction |
string[] |
RecommendedAction 本地化。 |
| target |
string |
错误的目标。 |
ValidationType
指定验证的类型。 对于 DeepValidation,/validateForBackup API 中的所有验证都将再次运行。
| 值 | 说明 |
|---|---|
| ShallowValidation | |
| DeepValidation |