在备份保管库中创建或更新备份实例
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2026-03-01
URI 参数
| 名称 |
在 |
必需 |
类型 |
说明 |
|
backupInstanceName
|
path |
True
|
string
|
BackupInstanceResource 的名称
|
|
resourceGroupName
|
path |
True
|
string
minLength: 1 maxLength: 90
|
资源组的名称。 此名称不区分大小写。
|
|
subscriptionId
|
path |
True
|
string
(uuid)
|
目标订阅的 ID。 该值必须是 UUID。
|
|
vaultName
|
path |
True
|
string
minLength: 2 maxLength: 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
|
BackupInstance
|
BackupInstanceResource 属性
|
|
tags
|
object
|
代理资源标记。
|
响应
| 名称 |
类型 |
说明 |
|
200 OK
|
BackupInstanceResource
|
资源“BackupInstanceResource”更新作成功
|
|
201 Created
|
BackupInstanceResource
|
资源“BackupInstanceResource”创建作成功
标头
- Location: string
- Retry-After: integer
|
|
202 Accepted
|
|
已接受资源作。
标头
- Azure-AsyncOperation: string
- Location: string
|
|
Other Status Codes
|
CloudError
|
意外的错误响应。
|
安全性
azure_auth
Azure Active Directory OAuth2 流程。
类型:
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=2026-03-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"
}
}
import com.azure.resourcemanager.dataprotection.models.AzureOperationalStoreParameters;
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.DataStoreTypes;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.IdentityDetails;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import com.azure.resourcemanager.dataprotection.models.SecretStoreBasedAuthCredentials;
import com.azure.resourcemanager.dataprotection.models.SecretStoreResource;
import com.azure.resourcemanager.dataprotection.models.SecretStoreType;
import com.azure.resourcemanager.dataprotection.models.ValidationType;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance.json
*/
/**
* Sample code: Create BackupInstance.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstance(com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("testInstance1")
.withExistingBackupVault("000pikumar", "PratikPrivatePreviewVault1")
.withProperties(new BackupInstance().withFriendlyName("harshitbi2").withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.DBforPostgreSQL/servers/databases").withObjectType("Datasource")
.withResourceId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb")
.withResourceLocation("").withResourceName("testdb")
.withResourceType("Microsoft.DBforPostgreSQL/servers/databases").withResourceUri(""))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.DBforPostgreSQL/servers/databases").withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest")
.withResourceLocation("").withResourceName("viveksipgtest")
.withResourceType("Microsoft.DBforPostgreSQL/servers").withResourceUri(""))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1")
.withPolicyParameters(new PolicyParameters()
.withDataStoreParametersList(Arrays.asList(new AzureOperationalStoreParameters()
.withDataStoreType(DataStoreTypes.OPERATIONAL_STORE).withResourceGroupId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest")))))
.withDatasourceAuthCredentials(new SecretStoreBasedAuthCredentials().withSecretStoreResource(
new SecretStoreResource().withUri("https://samplevault.vault.azure.net/secrets/credentials")
.withSecretStoreType(SecretStoreType.AZURE_KEY_VAULT)))
.withValidationType(ValidationType.SHALLOW_VALIDATION)
.withIdentityDetails(
new IdentityDetails().withUseSystemAssignedIdentity(false).withUserAssignedIdentityArmUrl(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"))
.withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="000pikumar",
vault_name="PratikPrivatePreviewVault1",
backup_instance_name="testInstance1",
parameters={
"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",
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstance() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("04cf684a-d41f-4550-9f70-7708a3a2283b", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "000pikumar", "PratikPrivatePreviewVault1", "testInstance1", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb"),
ResourceLocation: to.Ptr(""),
ResourceName: to.Ptr("testdb"),
ResourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ResourceURI: to.Ptr(""),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest"),
ResourceLocation: to.Ptr(""),
ResourceName: to.Ptr("viveksipgtest"),
ResourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers"),
ResourceURI: to.Ptr(""),
},
DatasourceAuthCredentials: &armdataprotection.SecretStoreBasedAuthCredentials{
ObjectType: to.Ptr("SecretStoreBasedAuthCredentials"),
SecretStoreResource: &armdataprotection.SecretStoreResource{
SecretStoreType: to.Ptr(armdataprotection.SecretStoreTypeAzureKeyVault),
URI: to.Ptr("https://samplevault.vault.azure.net/secrets/credentials"),
},
},
FriendlyName: to.Ptr("harshitbi2"),
IdentityDetails: &armdataprotection.IdentityDetails{
UseSystemAssignedIdentity: to.Ptr(false),
UserAssignedIdentityArmURL: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourcegroups/rg-name/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testUami"),
},
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"),
PolicyParameters: &armdataprotection.PolicyParameters{
DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
&armdataprotection.AzureOperationalStoreParameters{
DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
ObjectType: to.Ptr("AzureOperationalStoreParameters"),
ResourceGroupID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"),
},
},
},
},
ValidationType: to.Ptr(armdataprotection.ValidationTypeShallowValidation),
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("harshitbi2"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("OssDB"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb"),
// ResourceLocation: to.Ptr(""),
// ResourceName: to.Ptr("testdb"),
// ResourceType: to.Ptr("OssDB"),
// ResourceURI: to.Ptr(""),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("OssDB"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest"),
// ResourceLocation: to.Ptr(""),
// ResourceName: to.Ptr("viveksipgtest"),
// ResourceType: to.Ptr("OssDB"),
// ResourceURI: to.Ptr(""),
// },
// FriendlyName: to.Ptr("harshitbi2"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
// &armdataprotection.AzureOperationalStoreParameters{
// DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
// ObjectType: to.Ptr("AzureOperationalStoreParameters"),
// ResourceGroupID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"),
// },
// },
// },
// PolicyVersion: to.Ptr("3.2"),
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance.json
*/
async function createBackupInstance() {
const credential = new DefaultAzureCredential();
const subscriptionId = "04cf684a-d41f-4550-9f70-7708a3a2283b";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate(
"000pikumar",
"PratikPrivatePreviewVault1",
"testInstance1",
{
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",
},
},
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"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=2026-03-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.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Retry-After: 60
示例请求
PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2026-03-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"
}
}
import com.azure.resourcemanager.dataprotection.models.AzureOperationalStoreParameters;
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.DataStoreTypes;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import com.azure.resourcemanager.dataprotection.models.SecretStoreBasedAuthCredentials;
import com.azure.resourcemanager.dataprotection.models.SecretStoreResource;
import com.azure.resourcemanager.dataprotection.models.SecretStoreType;
import com.azure.resourcemanager.dataprotection.models.ValidationType;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ResourceGuardEnabled.json
*/
/**
* Sample code: Create BackupInstance to perform critical operation With MUA.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstanceToPerformCriticalOperationWithMUA(
com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("testInstance1")
.withExistingBackupVault("000pikumar", "PratikPrivatePreviewVault1")
.withProperties(new BackupInstance().withFriendlyName("harshitbi2").withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.DBforPostgreSQL/servers/databases").withObjectType("Datasource")
.withResourceId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb")
.withResourceLocation("").withResourceName("testdb")
.withResourceType("Microsoft.DBforPostgreSQL/servers/databases").withResourceUri(""))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.DBforPostgreSQL/servers/databases").withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest")
.withResourceLocation("").withResourceName("viveksipgtest")
.withResourceType("Microsoft.DBforPostgreSQL/servers").withResourceUri(""))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1")
.withPolicyParameters(new PolicyParameters()
.withDataStoreParametersList(Arrays.asList(new AzureOperationalStoreParameters()
.withDataStoreType(DataStoreTypes.OPERATIONAL_STORE).withResourceGroupId(
"/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest")))))
.withResourceGuardOperationRequests(Arrays.asList(
"/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/dppModifyPolicy/default"))
.withDatasourceAuthCredentials(new SecretStoreBasedAuthCredentials().withSecretStoreResource(
new SecretStoreResource().withUri("https://samplevault.vault.azure.net/secrets/credentials")
.withSecretStoreType(SecretStoreType.AZURE_KEY_VAULT)))
.withValidationType(ValidationType.SHALLOW_VALIDATION).withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance_resource_guard_enabled.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="000pikumar",
vault_name="PratikPrivatePreviewVault1",
backup_instance_name="testInstance1",
parameters={
"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",
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ResourceGuardEnabled.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ResourceGuardEnabled.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstanceToPerformCriticalOperationWithMua() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("04cf684a-d41f-4550-9f70-7708a3a2283b", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "000pikumar", "PratikPrivatePreviewVault1", "testInstance1", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb"),
ResourceLocation: to.Ptr(""),
ResourceName: to.Ptr("testdb"),
ResourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ResourceURI: to.Ptr(""),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers/databases"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest"),
ResourceLocation: to.Ptr(""),
ResourceName: to.Ptr("viveksipgtest"),
ResourceType: to.Ptr("Microsoft.DBforPostgreSQL/servers"),
ResourceURI: to.Ptr(""),
},
DatasourceAuthCredentials: &armdataprotection.SecretStoreBasedAuthCredentials{
ObjectType: to.Ptr("SecretStoreBasedAuthCredentials"),
SecretStoreResource: &armdataprotection.SecretStoreResource{
SecretStoreType: to.Ptr(armdataprotection.SecretStoreTypeAzureKeyVault),
URI: to.Ptr("https://samplevault.vault.azure.net/secrets/credentials"),
},
},
FriendlyName: to.Ptr("harshitbi2"),
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"),
PolicyParameters: &armdataprotection.PolicyParameters{
DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
&armdataprotection.AzureOperationalStoreParameters{
DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
ObjectType: to.Ptr("AzureOperationalStoreParameters"),
ResourceGroupID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"),
},
},
},
},
ResourceGuardOperationRequests: []*string{
to.Ptr("/subscriptions/38304e13-357e-405e-9e9a-220351dcce8c/resourcegroups/ankurResourceGuard1/providers/Microsoft.DataProtection/resourceGuards/ResourceGuard38-1/dppModifyPolicy/default"),
},
ValidationType: to.Ptr(armdataprotection.ValidationTypeShallowValidation),
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("harshitbi2"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("OssDB"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb"),
// ResourceLocation: to.Ptr(""),
// ResourceName: to.Ptr("testdb"),
// ResourceType: to.Ptr("OssDB"),
// ResourceURI: to.Ptr(""),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("OssDB"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest"),
// ResourceLocation: to.Ptr(""),
// ResourceName: to.Ptr("viveksipgtest"),
// ResourceType: to.Ptr("OssDB"),
// ResourceURI: to.Ptr(""),
// },
// FriendlyName: to.Ptr("harshitbi2"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
// &armdataprotection.AzureOperationalStoreParameters{
// DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
// ObjectType: to.Ptr("AzureOperationalStoreParameters"),
// ResourceGroupID: to.Ptr("/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"),
// },
// },
// },
// PolicyVersion: to.Ptr("3.2"),
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ResourceGuardEnabled.json
*/
async function createBackupInstanceToPerformCriticalOperationWithMUA() {
const credential = new DefaultAzureCredential();
const subscriptionId = "04cf684a-d41f-4550-9f70-7708a3a2283b";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate(
"000pikumar",
"PratikPrivatePreviewVault1",
"testInstance1",
{
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",
},
},
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"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=2026-03-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.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Location: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Retry-After: 60
Create BackupInstance With ADLSBlobBackupAutoProtection
示例请求
PUT https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/adlsstorageaccount-adlsstorageaccount-3a76f8a-c176-4f7d-819e-95157e2b0071?api-version=2026-03-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": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "temp-"
},
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "test-"
}
]
},
"objectType": "AdlsBlobBackupDatasourceParametersForAutoProtection"
}
]
}
}
}
}
import com.azure.resourcemanager.dataprotection.models.AdlsBlobBackupDatasourceParametersForAutoProtection;
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.BlobBackupAutoProtectionRule;
import com.azure.resourcemanager.dataprotection.models.BlobBackupPatternType;
import com.azure.resourcemanager.dataprotection.models.BlobBackupRuleBasedAutoProtectionSettings;
import com.azure.resourcemanager.dataprotection.models.BlobBackupRuleMode;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupAutoProtection.json
*/
/**
* Sample code: Create BackupInstance With ADLSBlobBackupAutoProtection.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstanceWithADLSBlobBackupAutoProtection(
com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("adlsstorageaccount-adlsstorageaccount-3a76f8a-c176-4f7d-819e-95157e2b0071")
.withExistingBackupVault("adlsrg", "adlsvault")
.withProperties(new BackupInstance().withFriendlyName("adlsstorageaccount\\adlsbackupinstance")
.withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.Storage/storageAccounts/adlsBlobServices")
.withObjectType("Datasource")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("adlsstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.Storage/storageAccounts/adlsBlobServices")
.withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("adlsstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy")
.withPolicyParameters(new PolicyParameters().withBackupDatasourceParametersList(Arrays
.asList(new AdlsBlobBackupDatasourceParametersForAutoProtection().withAutoProtectionSettings(
new BlobBackupRuleBasedAutoProtectionSettings().withEnabled(true)
.withRules(Arrays.asList(
new BlobBackupAutoProtectionRule().withObjectType("BlobBackupAutoProtectionRule")
.withMode(BlobBackupRuleMode.EXCLUDE).withType(BlobBackupPatternType.PREFIX)
.withPattern("temp-"),
new BlobBackupAutoProtectionRule().withObjectType("BlobBackupAutoProtectionRule")
.withMode(BlobBackupRuleMode.EXCLUDE).withType(BlobBackupPatternType.PREFIX)
.withPattern("test-"))))))))
.withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance_adlsblob_backup_auto_protection.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="adlsrg",
vault_name="adlsvault",
backup_instance_name="adlsstorageaccount-adlsstorageaccount-3a76f8a-c176-4f7d-819e-95157e2b0071",
parameters={
"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": [
{
"autoProtectionSettings": {
"enabled": True,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"mode": "Exclude",
"objectType": "BlobBackupAutoProtectionRule",
"pattern": "temp-",
"type": "Prefix",
},
{
"mode": "Exclude",
"objectType": "BlobBackupAutoProtectionRule",
"pattern": "test-",
"type": "Prefix",
},
],
},
"objectType": "AdlsBlobBackupDatasourceParametersForAutoProtection",
}
]
},
},
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupAutoProtection.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupAutoProtection.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstanceWithAdlsBlobBackupAutoProtection() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("54707983-993e-43de-8d94-074451394eda", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "adlsrg", "adlsvault", "adlsstorageaccount-adlsstorageaccount-3a76f8a-c176-4f7d-819e-95157e2b0071", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("adlsstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("adlsstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
},
FriendlyName: to.Ptr("adlsstorageaccount\\adlsbackupinstance"),
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy"),
PolicyParameters: &armdataprotection.PolicyParameters{
BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
&armdataprotection.AdlsBlobBackupDatasourceParametersForAutoProtection{
AutoProtectionSettings: &armdataprotection.BlobBackupRuleBasedAutoProtectionSettings{
Enabled: to.Ptr(true),
ObjectType: to.Ptr("BlobBackupRuleBasedAutoProtectionSettings"),
Rules: []*armdataprotection.BlobBackupAutoProtectionRule{
{
ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
Pattern: to.Ptr("temp-"),
},
{
ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
Pattern: to.Ptr("test-"),
},
},
},
ObjectType: to.Ptr("AdlsBlobBackupDatasourceParametersForAutoProtection"),
},
},
},
},
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("3a76f8a-c176-4f7d-819e-95157e2b0077"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/3a76f8a-c176-4f7d-819e-95157e2b0077"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("adlsstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("adlsstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// },
// FriendlyName: to.Ptr("adlsstorageaccount\\adlsbackupinstance"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
// &armdataprotection.AdlsBlobBackupDatasourceParametersForAutoProtection{
// AutoProtectionSettings: &armdataprotection.BlobBackupRuleBasedAutoProtectionSettings{
// Enabled: to.Ptr(true),
// ObjectType: to.Ptr("BlobBackupRuleBasedAutoProtectionSettings"),
// Rules: []*armdataprotection.BlobBackupAutoProtectionRule{
// {
// ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
// Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
// Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
// Pattern: to.Ptr("temp-"),
// },
// {
// ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
// Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
// Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
// Pattern: to.Ptr("test-"),
// },
// },
// },
// ObjectType: to.Ptr("AdlsBlobBackupDatasourceParametersForAutoProtection"),
// },
// },
// },
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupAutoProtection.json
*/
async function createBackupInstanceWithAdlsBlobBackupAutoProtection() {
const credential = new DefaultAzureCredential();
const subscriptionId = "54707983-993e-43de-8d94-074451394eda";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate(
"adlsrg",
"adlsvault",
"adlsstorageaccount-adlsstorageaccount-3a76f8a-c176-4f7d-819e-95157e2b0071",
{
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: [
{
autoProtectionSettings: {
enabled: true,
objectType: "BlobBackupRuleBasedAutoProtectionSettings",
rules: [
{
objectType: "BlobBackupAutoProtectionRule",
mode: "Exclude",
type: "Prefix",
pattern: "temp-",
},
{
objectType: "BlobBackupAutoProtectionRule",
mode: "Exclude",
type: "Prefix",
pattern: "test-",
},
],
},
objectType: "AdlsBlobBackupDatasourceParametersForAutoProtection",
},
],
},
},
},
},
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"name": "3a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/3a76f8a-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": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "temp-"
},
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "test-"
}
]
},
"objectType": "AdlsBlobBackupDatasourceParametersForAutoProtection"
}
]
}
},
"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": "3a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/3a76f8a-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": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": []
},
"objectType": "AdlsBlobBackupDatasourceParametersForAutoProtection"
}
]
}
},
"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-3a76f8a-c176-4f7d-819e-95157e2b0071/operationStatuses/08584622124860116406?api-version=2022-12-01&t=638749912006014742&c=MIIHhzCCBm-gAwIBAgITfAaTiaklTwdb3CiPmAAABpOJqTANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDUw
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=2026-03-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"
}
]
}
}
}
}
import com.azure.resourcemanager.dataprotection.models.AdlsBlobBackupDatasourceParameters;
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupDatasourceParameters.json
*/
/**
* Sample code: Create BackupInstance With ADLSBlobBackupDatasourceParameters.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstanceWithADLSBlobBackupDatasourceParameters(
com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071")
.withExistingBackupVault("adlsrg", "adlsvault")
.withProperties(new BackupInstance().withFriendlyName("adlsstorageaccount\\adlsbackupinstance")
.withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.Storage/storageAccounts/adlsBlobServices")
.withObjectType("Datasource")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("adlsstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.Storage/storageAccounts/adlsBlobServices")
.withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("adlsstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy")
.withPolicyParameters(new PolicyParameters().withBackupDatasourceParametersList(Arrays.asList(
new AdlsBlobBackupDatasourceParameters().withContainersList(Arrays.asList("container1"))))))
.withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance_adlsblob_backup_datasource_parameters.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="adlsrg",
vault_name="adlsvault",
backup_instance_name="adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071",
parameters={
"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"}
]
},
},
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupDatasourceParameters.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupDatasourceParameters.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstanceWithAdlsBlobBackupDatasourceParameters() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("54707983-993e-43de-8d94-074451394eda", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "adlsrg", "adlsvault", "adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("adlsstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("adlsstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
},
FriendlyName: to.Ptr("adlsstorageaccount\\adlsbackupinstance"),
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy"),
PolicyParameters: &armdataprotection.PolicyParameters{
BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
&armdataprotection.AdlsBlobBackupDatasourceParameters{
ContainersList: []*string{
to.Ptr("container1"),
},
ObjectType: to.Ptr("AdlsBlobBackupDatasourceParameters"),
},
},
},
},
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("19a76f8a-c176-4f7d-819e-95157e2b0077"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupInstances/19a76f8a-c176-4f7d-819e-95157e2b0077"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("adlsstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/adlsBlobServices"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("adlsstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.Storage/storageAccounts/adlsstorageaccount"),
// },
// FriendlyName: to.Ptr("adlsstorageaccount\\adlsbackupinstance"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/adlsrg/providers/Microsoft.DataProtection/backupVaults/adlsvault/backupPolicies/adlspolicy"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
// &armdataprotection.AdlsBlobBackupDatasourceParameters{
// ContainersList: []*string{
// to.Ptr("container1"),
// },
// ObjectType: to.Ptr("AdlsBlobBackupDatasourceParameters"),
// },
// },
// },
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_ADLSBlobBackupDatasourceParameters.json
*/
async function createBackupInstanceWithAdlsBlobBackupDatasourceParameters() {
const credential = new DefaultAzureCredential();
const subscriptionId = "54707983-993e-43de-8d94-074451394eda";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate(
"adlsrg",
"adlsvault",
"adlsstorageaccount-adlsstorageaccount-19a76f8a-c176-4f7d-819e-95157e2b0071",
{
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" },
],
},
},
},
},
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"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 BlobBackupAutoProtection
示例请求
PUT https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupInstances/blobstorageaccount-blobstorageaccount-2a76f8a-c176-4f7d-819e-95157e2b0071?api-version=2026-03-01
{
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"friendlyName": "blobstorageaccount\\blobbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "temp-"
},
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "test-"
}
]
},
"objectType": "BlobBackupDatasourceParametersForAutoProtection"
}
]
}
}
}
}
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.BlobBackupAutoProtectionRule;
import com.azure.resourcemanager.dataprotection.models.BlobBackupDatasourceParametersForAutoProtection;
import com.azure.resourcemanager.dataprotection.models.BlobBackupPatternType;
import com.azure.resourcemanager.dataprotection.models.BlobBackupRuleBasedAutoProtectionSettings;
import com.azure.resourcemanager.dataprotection.models.BlobBackupRuleMode;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_BlobBackupAutoProtection.json
*/
/**
* Sample code: Create BackupInstance With BlobBackupAutoProtection.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstanceWithBlobBackupAutoProtection(
com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("blobstorageaccount-blobstorageaccount-2a76f8a-c176-4f7d-819e-95157e2b0071")
.withExistingBackupVault("blobrg", "blobvault")
.withProperties(new BackupInstance().withFriendlyName("blobstorageaccount\\blobbackupinstance")
.withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.Storage/storageAccounts/blobServices").withObjectType("Datasource")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("blobstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.Storage/storageAccounts/blobServices")
.withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount")
.withResourceLocation("centraluseuap").withResourceName("blobstorageaccount")
.withResourceType("microsoft.storage/storageAccounts").withResourceUri(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy")
.withPolicyParameters(new PolicyParameters().withBackupDatasourceParametersList(
Arrays.asList(new BlobBackupDatasourceParametersForAutoProtection().withAutoProtectionSettings(
new BlobBackupRuleBasedAutoProtectionSettings().withEnabled(true)
.withRules(Arrays.asList(
new BlobBackupAutoProtectionRule().withObjectType("BlobBackupAutoProtectionRule")
.withMode(BlobBackupRuleMode.EXCLUDE).withType(BlobBackupPatternType.PREFIX)
.withPattern("temp-"),
new BlobBackupAutoProtectionRule().withObjectType("BlobBackupAutoProtectionRule")
.withMode(BlobBackupRuleMode.EXCLUDE).withType(BlobBackupPatternType.PREFIX)
.withPattern("test-"))))))))
.withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance_blob_backup_auto_protection.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="blobrg",
vault_name="blobvault",
backup_instance_name="blobstorageaccount-blobstorageaccount-2a76f8a-c176-4f7d-819e-95157e2b0071",
parameters={
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
},
"friendlyName": "blobstorageaccount\\blobbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"autoProtectionSettings": {
"enabled": True,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"mode": "Exclude",
"objectType": "BlobBackupAutoProtectionRule",
"pattern": "temp-",
"type": "Prefix",
},
{
"mode": "Exclude",
"objectType": "BlobBackupAutoProtectionRule",
"pattern": "test-",
"type": "Prefix",
},
],
},
"objectType": "BlobBackupDatasourceParametersForAutoProtection",
}
]
},
},
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_BlobBackupAutoProtection.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance_BlobBackupAutoProtection.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstanceWithBlobBackupAutoProtection() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("54707983-993e-43de-8d94-074451394eda", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "blobrg", "blobvault", "blobstorageaccount-blobstorageaccount-2a76f8a-c176-4f7d-819e-95157e2b0071", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/blobServices"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("blobstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/blobServices"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
ResourceLocation: to.Ptr("centraluseuap"),
ResourceName: to.Ptr("blobstorageaccount"),
ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
},
FriendlyName: to.Ptr("blobstorageaccount\\blobbackupinstance"),
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy"),
PolicyParameters: &armdataprotection.PolicyParameters{
BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
&armdataprotection.BlobBackupDatasourceParametersForAutoProtection{
AutoProtectionSettings: &armdataprotection.BlobBackupRuleBasedAutoProtectionSettings{
Enabled: to.Ptr(true),
ObjectType: to.Ptr("BlobBackupRuleBasedAutoProtectionSettings"),
Rules: []*armdataprotection.BlobBackupAutoProtectionRule{
{
ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
Pattern: to.Ptr("temp-"),
},
{
ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
Pattern: to.Ptr("test-"),
},
},
},
ObjectType: to.Ptr("BlobBackupDatasourceParametersForAutoProtection"),
},
},
},
},
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("2a76f8a-c176-4f7d-819e-95157e2b0077"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupInstances/2a76f8a-c176-4f7d-819e-95157e2b0077"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/blobServices"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("blobstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("Microsoft.Storage/storageAccounts/blobServices"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
// ResourceLocation: to.Ptr("centraluseuap"),
// ResourceName: to.Ptr("blobstorageaccount"),
// ResourceType: to.Ptr("microsoft.storage/storageAccounts"),
// ResourceURI: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"),
// },
// FriendlyName: to.Ptr("blobstorageaccount\\blobbackupinstance"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
// &armdataprotection.BlobBackupDatasourceParametersForAutoProtection{
// AutoProtectionSettings: &armdataprotection.BlobBackupRuleBasedAutoProtectionSettings{
// Enabled: to.Ptr(true),
// ObjectType: to.Ptr("BlobBackupRuleBasedAutoProtectionSettings"),
// Rules: []*armdataprotection.BlobBackupAutoProtectionRule{
// {
// ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
// Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
// Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
// Pattern: to.Ptr("temp-"),
// },
// {
// ObjectType: to.Ptr("BlobBackupAutoProtectionRule"),
// Mode: to.Ptr(armdataprotection.BlobBackupRuleModeExclude),
// Type: to.Ptr(armdataprotection.BlobBackupPatternTypePrefix),
// Pattern: to.Ptr("test-"),
// },
// },
// },
// ObjectType: to.Ptr("BlobBackupDatasourceParametersForAutoProtection"),
// },
// },
// },
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_BlobBackupAutoProtection.json
*/
async function createBackupInstanceWithBlobBackupAutoProtection() {
const credential = new DefaultAzureCredential();
const subscriptionId = "54707983-993e-43de-8d94-074451394eda";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate(
"blobrg",
"blobvault",
"blobstorageaccount-blobstorageaccount-2a76f8a-c176-4f7d-819e-95157e2b0071",
{
properties: {
dataSourceInfo: {
datasourceType: "Microsoft.Storage/storageAccounts/blobServices",
objectType: "Datasource",
resourceID:
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
resourceLocation: "centraluseuap",
resourceName: "blobstorageaccount",
resourceType: "microsoft.storage/storageAccounts",
resourceUri:
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
},
dataSourceSetInfo: {
datasourceType: "Microsoft.Storage/storageAccounts/blobServices",
objectType: "DatasourceSet",
resourceID:
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
resourceLocation: "centraluseuap",
resourceName: "blobstorageaccount",
resourceType: "microsoft.storage/storageAccounts",
resourceUri:
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
},
friendlyName: "blobstorageaccount\\blobbackupinstance",
objectType: "BackupInstance",
policyInfo: {
policyId:
"/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy",
policyParameters: {
backupDatasourceParametersList: [
{
autoProtectionSettings: {
enabled: true,
objectType: "BlobBackupRuleBasedAutoProtectionSettings",
rules: [
{
objectType: "BlobBackupAutoProtectionRule",
mode: "Exclude",
type: "Prefix",
pattern: "temp-",
},
{
objectType: "BlobBackupAutoProtectionRule",
mode: "Exclude",
type: "Prefix",
pattern: "test-",
},
],
},
objectType: "BlobBackupDatasourceParametersForAutoProtection",
},
],
},
},
},
},
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"name": "2a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupInstances/2a76f8a-c176-4f7d-819e-95157e2b0077",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"friendlyName": "blobstorageaccount\\blobbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": [
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "temp-"
},
{
"objectType": "BlobBackupAutoProtectionRule",
"mode": "Exclude",
"type": "Prefix",
"pattern": "test-"
}
]
},
"objectType": "BlobBackupDatasourceParametersForAutoProtection"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioned"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Resources/deployments/ConfigureProtection-2097/operationStatuses/08584622124860116406?api-version=2022-12-01&t=638749912006014742&c=MIIHhzCCBm-gAwIBAgITfAaTiaklTwdb3CiPmAAABpOJqTANBgkqhkiG9w0BAQsFADBEMRMwEQYKCZImiZPyLGQBGRYDR0JMMRMwEQYKCZImiZPyLGQBGRYDQU1FMRgwFgYDVQQDEw9BTUUgSW5mcmEgQ0EgMDUw
Retry-After: 60
{
"name": "2a76f8a-c176-4f7d-819e-95157e2b0077",
"type": "Microsoft.DataProtection/backupVaults/backupInstances",
"id": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupInstances/2a76f8a-c176-4f7d-819e-95157e2b0077",
"properties": {
"dataSourceInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "Datasource",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"dataSourceSetInfo": {
"datasourceType": "Microsoft.Storage/storageAccounts/blobServices",
"objectType": "DatasourceSet",
"resourceID": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount",
"resourceLocation": "centraluseuap",
"resourceName": "blobstorageaccount",
"resourceType": "microsoft.storage/storageAccounts",
"resourceUri": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.Storage/storageAccounts/blobstorageaccount"
},
"friendlyName": "blobstorageaccount\\blobbackupinstance",
"objectType": "BackupInstance",
"policyInfo": {
"policyId": "/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupPolicies/blobpolicy",
"policyParameters": {
"backupDatasourceParametersList": [
{
"autoProtectionSettings": {
"enabled": true,
"objectType": "BlobBackupRuleBasedAutoProtectionSettings",
"rules": []
},
"objectType": "BlobBackupDatasourceParametersForAutoProtection"
}
]
}
},
"protectionStatus": {
"status": "NotProtected"
},
"provisioningState": "Provisioning"
}
}
Azure-AsyncOperation: https://management.azure.com/subscriptions/54707983-993e-43de-8d94-074451394eda/resourceGroups/blobrg/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/blobrg/providers/Microsoft.DataProtection/backupVaults/blobvault/backupInstances/blobstorageaccount-blobstorageaccount-2a76f8a-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=2026-03-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"
}
]
}
}
}
}
import com.azure.resourcemanager.dataprotection.models.AKSVolumeTypes;
import com.azure.resourcemanager.dataprotection.models.AzureOperationalStoreParameters;
import com.azure.resourcemanager.dataprotection.models.BackupInstance;
import com.azure.resourcemanager.dataprotection.models.DataStoreTypes;
import com.azure.resourcemanager.dataprotection.models.Datasource;
import com.azure.resourcemanager.dataprotection.models.DatasourceSet;
import com.azure.resourcemanager.dataprotection.models.KubernetesClusterBackupDatasourceParameters;
import com.azure.resourcemanager.dataprotection.models.PolicyInfo;
import com.azure.resourcemanager.dataprotection.models.PolicyParameters;
import java.util.Arrays;
/**
* Samples for BackupInstances CreateOrUpdate.
*/
public final class Main {
/*
* x-ms-original-file:
* 2026-03-01/BackupInstanceOperations/PutBackupInstance_KubernetesClusterBackupDatasourceParameters.json
*/
/**
* Sample code: Create BackupInstance With KubernetesClusterBackupDatasourceParameters.
*
* @param manager Entry point to DataProtectionManager.
*/
public static void createBackupInstanceWithKubernetesClusterBackupDatasourceParameters(
com.azure.resourcemanager.dataprotection.DataProtectionManager manager) {
manager.backupInstances().define("aksbi").withExistingBackupVault("aksrg", "aksvault")
.withProperties(new BackupInstance().withFriendlyName("aksbi").withDataSourceInfo(new Datasource()
.withDatasourceType("Microsoft.ContainerService/managedclusters").withObjectType("Datasource")
.withResourceId(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster")
.withResourceLocation("eastus2euap").withResourceName("akscluster")
.withResourceType("Microsoft.ContainerService/managedclusters").withResourceUri(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"))
.withDataSourceSetInfo(new DatasourceSet()
.withDatasourceType("Microsoft.ContainerService/managedclusters").withObjectType("DatasourceSet")
.withResourceId(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster")
.withResourceLocation("eastus2euap").withResourceName("akscluster")
.withResourceType("Microsoft.ContainerService/managedclusters").withResourceUri(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"))
.withPolicyInfo(new PolicyInfo().withPolicyId(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourcegroups/aksrg/providers/Microsoft.DataProtection/BackupVaults/aksvault/backupPolicies/akspolicy")
.withPolicyParameters(new PolicyParameters()
.withDataStoreParametersList(Arrays.asList(new AzureOperationalStoreParameters()
.withDataStoreType(DataStoreTypes.OPERATIONAL_STORE).withResourceGroupId(
"/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg")))
.withBackupDatasourceParametersList(
Arrays.asList(new KubernetesClusterBackupDatasourceParameters().withSnapshotVolumes(true)
.withIncludedVolumeTypes(
Arrays.asList(AKSVolumeTypes.AZURE_DISK, AKSVolumeTypes.AZURE_FILE_SHARE_SMB))
.withIncludeClusterScopeResources(true).withIncludedNamespaces(Arrays.asList("test"))
.withExcludedNamespaces(Arrays.asList("kube-system"))
.withIncludedResourceTypes(Arrays.asList())
.withExcludedResourceTypes(Arrays.asList("v1/Secret"))
.withLabelSelectors(Arrays.asList())))))
.withObjectType("BackupInstance"))
.create();
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-dataprotection
# USAGE
python put_backup_instance_kubernetes_cluster_backup_datasource_parameters.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = DataProtectionMgmtClient(
credential=DefaultAzureCredential(),
subscription_id="SUBSCRIPTION_ID",
)
response = client.backup_instances.begin_create_or_update(
resource_group_name="aksrg",
vault_name="aksvault",
backup_instance_name="aksbi",
parameters={
"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",
}
],
},
},
}
},
).result()
print(response)
# x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_KubernetesClusterBackupDatasourceParameters.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armdataprotection_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/dataprotection/armdataprotection/v4"
)
// Generated from example definition: 2026-03-01/BackupInstanceOperations/PutBackupInstance_KubernetesClusterBackupDatasourceParameters.json
func ExampleBackupInstancesClient_BeginCreateOrUpdate_createBackupInstanceWithKubernetesClusterBackupDatasourceParameters() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armdataprotection.NewClientFactory("62b829ee-7936-40c9-a1c9-47a93f9f3965", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewBackupInstancesClient().BeginCreateOrUpdate(ctx, "aksrg", "aksvault", "aksbi", armdataprotection.BackupInstanceResource{
Properties: &armdataprotection.BackupInstance{
DataSourceInfo: &armdataprotection.Datasource{
DatasourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
ObjectType: to.Ptr("Datasource"),
ResourceID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
ResourceLocation: to.Ptr("eastus2euap"),
ResourceName: to.Ptr("akscluster"),
ResourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
ResourceURI: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
},
DataSourceSetInfo: &armdataprotection.DatasourceSet{
DatasourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
ObjectType: to.Ptr("DatasourceSet"),
ResourceID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
ResourceLocation: to.Ptr("eastus2euap"),
ResourceName: to.Ptr("akscluster"),
ResourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
ResourceURI: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
},
FriendlyName: to.Ptr("aksbi"),
ObjectType: to.Ptr("BackupInstance"),
PolicyInfo: &armdataprotection.PolicyInfo{
PolicyID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourcegroups/aksrg/providers/Microsoft.DataProtection/BackupVaults/aksvault/backupPolicies/akspolicy"),
PolicyParameters: &armdataprotection.PolicyParameters{
BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
&armdataprotection.KubernetesClusterBackupDatasourceParameters{
ExcludedNamespaces: []*string{
to.Ptr("kube-system"),
},
ExcludedResourceTypes: []*string{
to.Ptr("v1/Secret"),
},
IncludeClusterScopeResources: to.Ptr(true),
IncludedNamespaces: []*string{
to.Ptr("test"),
},
IncludedResourceTypes: []*string{},
IncludedVolumeTypes: []*armdataprotection.AKSVolumeTypes{
to.Ptr(armdataprotection.AKSVolumeTypesAzureDisk),
to.Ptr(armdataprotection.AKSVolumeTypesAzureFileShareSMB),
},
LabelSelectors: []*string{},
ObjectType: to.Ptr("KubernetesClusterBackupDatasourceParameters"),
SnapshotVolumes: to.Ptr(true),
},
},
DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
&armdataprotection.AzureOperationalStoreParameters{
DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
ObjectType: to.Ptr("AzureOperationalStoreParameters"),
ResourceGroupID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg"),
},
},
},
},
},
}, nil)
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
res, err := poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
// You could use response here. We use blank identifier for just demo purposes.
_ = res
// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
// res = armdataprotection.BackupInstancesClientCreateOrUpdateResponse{
// BackupInstanceResource: &armdataprotection.BackupInstanceResource{
// Name: to.Ptr("aksbi"),
// Type: to.Ptr("Microsoft.DataProtection/backupVaults/backupInstances"),
// ID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi"),
// Properties: &armdataprotection.BackupInstance{
// DataSourceInfo: &armdataprotection.Datasource{
// DatasourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
// ObjectType: to.Ptr("Datasource"),
// ResourceID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
// ResourceLocation: to.Ptr("eastus2euap"),
// ResourceName: to.Ptr("akscluster"),
// ResourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
// ResourceURI: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
// },
// DataSourceSetInfo: &armdataprotection.DatasourceSet{
// DatasourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
// ObjectType: to.Ptr("DatasourceSet"),
// ResourceID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster"),
// ResourceLocation: to.Ptr("eastus2euap"),
// ResourceType: to.Ptr("Microsoft.ContainerService/managedclusters"),
// },
// FriendlyName: to.Ptr("aksbi"),
// ObjectType: to.Ptr("BackupInstance"),
// PolicyInfo: &armdataprotection.PolicyInfo{
// PolicyID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy"),
// PolicyParameters: &armdataprotection.PolicyParameters{
// BackupDatasourceParametersList: []armdataprotection.BackupDatasourceParametersClassification{
// &armdataprotection.KubernetesClusterBackupDatasourceParameters{
// ExcludedNamespaces: []*string{
// to.Ptr("kube-system"),
// },
// ExcludedResourceTypes: []*string{
// to.Ptr("v1/Secret"),
// },
// IncludeClusterScopeResources: to.Ptr(true),
// IncludedNamespaces: []*string{
// to.Ptr("test"),
// },
// IncludedResourceTypes: []*string{
// },
// IncludedVolumeTypes: []*armdataprotection.AKSVolumeTypes{
// to.Ptr(armdataprotection.AKSVolumeTypesAzureDisk),
// to.Ptr(armdataprotection.AKSVolumeTypesAzureFileShareSMB),
// },
// LabelSelectors: []*string{
// },
// ObjectType: to.Ptr("KubernetesClusterBackupDatasourceParameters"),
// SnapshotVolumes: to.Ptr(true),
// },
// },
// DataStoreParametersList: []armdataprotection.DataStoreParametersClassification{
// &armdataprotection.AzureOperationalStoreParameters{
// DataStoreType: to.Ptr(armdataprotection.DataStoreTypesOperationalStore),
// ObjectType: to.Ptr("AzureOperationalStoreParameters"),
// ResourceGroupID: to.Ptr("/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg"),
// },
// },
// },
// },
// ProtectionStatus: &armdataprotection.ProtectionStatusDetails{
// Status: to.Ptr(armdataprotection.Status("NotProtected")),
// },
// ProvisioningState: to.Ptr("Provisioned"),
// },
// },
// }
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { DataProtectionClient } = require("@azure/arm-dataprotection");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to create or update a backup instance in a backup vault
*
* @summary create or update a backup instance in a backup vault
* x-ms-original-file: 2026-03-01/BackupInstanceOperations/PutBackupInstance_KubernetesClusterBackupDatasourceParameters.json
*/
async function createBackupInstanceWithKubernetesClusterBackupDatasourceParameters() {
const credential = new DefaultAzureCredential();
const subscriptionId = "62b829ee-7936-40c9-a1c9-47a93f9f3965";
const client = new DataProtectionClient(credential, subscriptionId);
const result = await client.backupInstances.createOrUpdate("aksrg", "aksvault", "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",
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",
},
],
},
},
},
});
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
示例响应
{
"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=2026-03-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.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Location: https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2026-03-01
Retry-After: 60
定义
AdlsBlobBackupDatasourceParameters
对象
在配置 Azure Data Lake Storage 帐户 blob 的备份期间要使用的参数
AdlsBlobBackupDatasourceParametersForAutoProtection
对象
在使用自动保护设置配置Azure数据湖账户Blob备份时使用的参数
AKSVolumeTypes
枚举
| 值 |
说明 |
|
AzureDisk
|
|
|
AzureFileShareSMB
|
|
AzureOperationalStoreParameters
对象
Operational-Tier DataStore 的参数
BackupInstance
对象
备份实例
BackupInstanceResource
对象
BackupInstance 资源
| 名称 |
类型 |
说明 |
|
id
|
string
(arm-id)
|
资源的完全限定资源 ID。 例如,“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
|
|
name
|
string
|
资源的名称
|
|
properties
|
BackupInstance
|
BackupInstanceResource 属性
|
|
systemData
|
systemData
|
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
|
|
tags
|
object
|
代理资源标记。
|
|
type
|
string
|
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”
|
BlobBackupAutoProtectionRule
对象
表示有 Blob 备份自动保护规则。
BlobBackupDatasourceParameters
对象
配置 blob 期间要使用的参数
BlobBackupDatasourceParametersForAutoProtection
对象
参数用于配置 AutoProtection 设置的 blob 备份
BlobBackupPatternType
枚举
图案类型。 目前只支持Prefix。
BlobBackupRuleBasedAutoProtectionSettings
对象
用于基于规则的Blob备份自动保护设置的参数。
BlobBackupRuleMode
枚举
规则模式(目前仅支持排除)。
CloudError
对象
Azure 备份的错误响应。
| 名称 |
类型 |
说明 |
|
error
|
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:
DefaultResourceProperties
|
特定于数据源的属性
|
|
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:
DefaultResourceProperties
|
特定于数据源集的属性
|
|
resourceType
|
string
|
数据源的资源类型。
|
|
resourceUri
|
string
|
资源的 URI。
|
DataStoreTypes
枚举
数据存储的类型;作/保管库/存档
| 值 |
说明 |
|
OperationalStore
|
|
|
VaultStore
|
|
|
ArchiveStore
|
|
DefaultResourceProperties
对象
默认源属性
Error
对象
资源管理错误响应。
| 名称 |
类型 |
说明 |
|
additionalInfo
|
ErrorAdditionalInfo[]
|
错误附加信息。
|
|
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
|
InnerError
|
子内部错误,允许嵌套。
|
KubernetesClusterBackupDatasourceParameters
对象
Kubernetes 群集备份数据源的参数
| 名称 |
类型 |
说明 |
|
backupHookReferences
|
NamespacedNameResource[]
|
获取或设置备份挂钩引用。 此属性设置在备份期间要执行的挂钩引用。
|
|
excludedNamespaces
|
string[]
|
获取或设置 exclude 命名空间属性。 此属性设置在备份期间要排除的命名空间。
|
|
excludedResourceTypes
|
string[]
|
获取或设置排除资源类型属性。 此属性设置在备份期间要排除的资源类型。
|
|
includeClusterScopeResources
|
boolean
|
获取或设置 include 群集资源属性。 如果启用此属性,则会在备份期间包括群集范围资源。
|
|
includedNamespaces
|
string[]
|
获取或设置 include 命名空间属性。 此属性设置在备份期间要包括的命名空间。
|
|
includedResourceTypes
|
string[]
|
获取或设置 include 资源类型属性。 此属性设置在备份期间要包含的资源类型。
|
|
includedVolumeTypes
|
AKSVolumeTypes[]
|
获取或设置 include 卷类型属性。 此属性设置备份期间要包含的卷类型。
|
|
labelSelectors
|
string[]
|
获取或设置 LabelSelectors 属性。 此属性设置在备份期间要包含的此类标签选择器的资源。
|
|
objectType
|
string:
KubernetesClusterBackupDatasourceParameters
|
特定对象的类型 - 用于反序列化
|
|
snapshotVolumes
|
boolean
|
获取或设置卷快照属性。 如果启用此属性,则会在备份期间创建卷快照。
|
NamespacedNameResource
对象
引用包含命名空间和名称的资源的类
| 名称 |
类型 |
说明 |
|
name
|
string
|
资源的名称
|
|
namespace
|
string
|
资源所在的命名空间
|
PolicyInfo
对象
backupInstance 中的策略信息
| 名称 |
类型 |
说明 |
|
policyId
|
string
|
|
|
policyParameters
|
PolicyParameters
|
备份实例的策略参数
|
|
policyVersion
|
string
|
|
PolicyParameters
对象
策略中的参数
| 名称 |
类型 |
说明 |
|
backupDatasourceParametersList
|
BackupDatasourceParameters[]:
|
获取或设置备份数据源参数
|
|
dataStoreParametersList
|
DataStoreParameters[]:
AzureOperationalStoreParameters[]
|
获取或设置 DataStore 参数
|
ProtectionStatusDetails
对象
保护状态详细信息
ResourcePropertiesObjectType
枚举
特定对象的类型 - 用于反序列化
| 值 |
说明 |
|
DefaultResourceProperties
|
|
SecretStoreBasedAuthCredentials
对象
基于机密存储的身份验证凭据。
SecretStoreResource
对象
表示机密存储资源的类。
| 名称 |
类型 |
说明 |
|
secretStoreType
|
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
|
createdByType
|
创建资源的标识的类型。
|
|
lastModifiedAt
|
string
(date-time)
|
上次修改的资源时间戳(UTC)
|
|
lastModifiedBy
|
string
|
上次修改资源的标识。
|
|
lastModifiedByType
|
createdByType
|
上次修改资源的标识的类型。
|
UserFacingError
对象
有权访问本地化内容的层使用的 Error 对象,并将其传播到用户
| 名称 |
类型 |
说明 |
|
code
|
string
|
此错误的唯一代码
|
|
details
|
UserFacingError[]
|
其他相关错误
|
|
innerError
|
InnerError
|
内部错误
|
|
isRetryable
|
boolean
|
作是否可重试
|
|
isUserError
|
boolean
|
作是由用户错误还是服务错误导致的
|
|
message
|
string
|
|
|
properties
|
object
|
可在错误对象内注入的任何键值对
|
|
recommendedAction
|
string[]
|
RecommendedAction 本地化。
|
|
target
|
string
|
错误的目标。
|
ValidationType
枚举
指定验证的类型。 对于 DeepValidation,/validateForBackup API 中的所有验证都将再次运行。
| 值 |
说明 |
|
ShallowValidation
|
|
|
DeepValidation
|
|