Criar ou atualizar uma instância de backup em um cofre de backup
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2026-03-01
Parâmetros de URI
| Nome |
Em |
Obrigatório |
Tipo |
Description |
|
backupInstanceName
|
path |
True
|
string
|
O nome do BackupInstanceResource
|
|
resourceGroupName
|
path |
True
|
string
minLength: 1
maxLength: 90
|
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
|
|
subscriptionId
|
path |
True
|
string
(uuid)
|
A ID da assinatura de destino. O valor deve ser uma UUID.
|
|
vaultName
|
path |
True
|
string
minLength: 2
maxLength: 50
pattern: ^[A-Za-z][-A-Za-z0-9]*[A-Za-z0-9]$
|
O nome do cofre de backup.
|
|
api-version
|
query |
True
|
string
minLength: 1
|
A versão da API a ser usada para esta operação.
|
| Nome |
Obrigatório |
Tipo |
Description |
|
x-ms-authorization-auxiliary
|
|
string
|
|
Corpo da solicitação
| Nome |
Tipo |
Description |
|
properties
|
BackupInstance
|
Propriedades de BackupInstanceResource
|
|
tags
|
object
|
Marcas de recurso de proxy.
|
Respostas
| Nome |
Tipo |
Description |
|
200 OK
|
BackupInstanceResource
|
Operação de atualização do recurso 'BackupInstanceResource' bem-sucedida
|
|
201 Created
|
BackupInstanceResource
|
Operação de criação do recurso 'BackupInstanceResource' bem-sucedida
Cabeçalhos
- Location: string
- Retry-After: integer
|
|
202 Accepted
|
|
Operação de recurso aceita.
Cabeçalhos
- Azure-AsyncOperation: string
- Location: string
|
|
Other Status Codes
|
CloudError
|
Uma resposta de erro inesperada.
|
Segurança
azure_auth
Fluxo do OAuth2 do Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
| Nome |
Description |
|
user_impersonation
|
representar sua conta de usuário
|
Exemplos
Create BackupInstance
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Solicitação de exemplo
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
Resposta de exemplo
{
"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
Definições
AdlsBlobBackupDatasourceParameters
Objeto
Parâmetros a serem usados durante a configuração do backup de blobs de conta do Azure Data Lake Storage
| Nome |
Tipo |
Description |
|
containersList
|
string[]
|
Lista de contêineres a serem armazenados em backup durante a configuração do backup de blobs
|
|
objectType
|
string:
AdlsBlobBackupDatasourceParameters
|
Tipo do objeto específico – usado para desserializar
|
AdlsBlobBackupDatasourceParametersForAutoProtection
Objeto
Parâmetros a serem usados durante a configuração de backup de blobs de contas de armazenamento Azure Data Lake usando as configurações de AutoProtection
AKSVolumeTypes
Enumeração
| Valor |
Description |
|
AzureDisk
|
|
|
AzureFileShareSMB
|
|
AzureOperationalStoreParameters
Objeto
Parâmetros para Operational-Tier DataStore
| Nome |
Tipo |
Description |
|
dataStoreType
|
DataStoreTypes
|
tipo de armazenamento de dados; Operacional/Cofre/Arquivo Morto
|
|
objectType
|
string:
AzureOperationalStoreParameters
|
Tipo do objeto específico – usado para desserializar
|
|
resourceGroupId
|
string
|
Obtém ou define o Uri do Grupo de Recursos de Instantâneo.
|
BackupInstance
Objeto
Instância de Backup
| Nome |
Tipo |
Description |
|
currentProtectionState
|
CurrentProtectionState
|
Especifica o estado de proteção atual do recurso
|
|
dataSourceInfo
|
Datasource
|
Obtém ou define as informações da fonte de dados.
|
|
dataSourceSetInfo
|
DatasourceSet
|
Obtém ou define as informações do conjunto de fontes de dados.
|
|
datasourceAuthCredentials
|
AuthCredentials:
SecretStoreBasedAuthCredentials
|
Credenciais a serem usadas para autenticar com o provedor de fonte de dados.
|
|
friendlyName
|
string
|
Obtém ou define o nome amigável da Instância de Backup.
|
|
identityDetails
|
IdentityDetails
|
Contém informações dos Detalhes de Identidade para o BI.
Se for nulo, o padrão será considerado como Atribuído pelo Sistema.
|
|
objectType
|
string
|
|
|
policyInfo
|
PolicyInfo
|
Obtém ou define as informações da política.
|
|
protectionErrorDetails
|
UserFacingError
|
Especifica o erro de proteção do recurso
|
|
protectionStatus
|
ProtectionStatusDetails
|
Especifica o status de proteção do recurso
|
|
provisioningState
|
string
|
Especifica o estado de provisionamento do recurso, ou seja, provisionamento/atualização/êxito/com falha
|
|
resourceGuardOperationRequests
|
string[]
|
ResourceGuardOperationRequests no qual a verificação LAC será executada
|
|
validationType
|
ValidationType
|
Especifica o tipo de validação. No caso do DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.
|
BackupInstanceResource
Objeto
Recurso BackupInstance
| Nome |
Tipo |
Description |
|
id
|
string
(arm-id)
|
ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
|
|
name
|
string
|
O nome do recurso
|
|
properties
|
BackupInstance
|
Propriedades de BackupInstanceResource
|
|
systemData
|
systemData
|
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
|
|
tags
|
object
|
Marcas de recurso de proxy.
|
|
type
|
string
|
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"
|
BlobBackupAutoProtectionRule
Objeto
Indica uma regra de proteção automática contra backup de blobs.
| Nome |
Tipo |
Description |
|
mode
|
BlobBackupRuleMode
|
Excluir remove candidatos (após inclusão)
|
|
objectType
|
string
|
Tipo do objeto específico – usado para desserializar
|
|
pattern
|
string
|
O padrão de string para avaliar contra nomes de contêineres. Por enquanto, isso aceita apenas strings literais (sem curingas ou regex).
|
|
type
|
BlobBackupPatternType
|
Tipo de padrão: Prefixo, apenas o tipo de padrão é suportado por enquanto.
|
BlobBackupDatasourceParameters
Objeto
Parâmetros a serem usados durante a configuração do backup de blobs
| Nome |
Tipo |
Description |
|
containersList
|
string[]
|
Lista de contêineres a serem armazenados em backup durante a configuração do backup de blobs
|
|
objectType
|
string:
BlobBackupDatasourceParameters
|
Tipo do objeto específico – usado para desserializar
|
BlobBackupDatasourceParametersForAutoProtection
Objeto
Parâmetros a serem usados durante a configuração de backup de blobs usando configurações de Autoproteção
BlobBackupPatternType
Enumeração
Tipo de padrão. Apenas prefixo suportado por enquanto.
BlobBackupRuleBasedAutoProtectionSettings
Objeto
Parâmetros a serem usados para as configurações de Proteção Automática Baseada em Regras de Backup de Blobs.
| Nome |
Tipo |
Description |
|
enabled
|
boolean
|
Sinalize para ativar se a proteção auto.
|
|
objectType
|
string:
BlobBackupRuleBasedAutoProtectionSettings
|
Tipo do objeto específico – usado para desserializar
|
|
rules
|
BlobBackupAutoProtectionRule[]
|
As regras são avaliadas na ordem fornecida. Inclusão adiciona candidatos; Exclusão remove candidatos.
Se não houver regras presentes, todos os contêineres são considerados elegíveis quando ativados = verdadeiro.
|
BlobBackupRuleMode
Enumeração
Modo de regras (Apenas Exclusão suportado por enquanto).
| Valor |
Description |
|
Exclude
|
|
CloudError
Objeto
Uma resposta de erro do Backup do Azure.
| Nome |
Tipo |
Description |
|
error
|
Error
|
A resposta de erro de gerenciamento de recursos.
|
createdByType
Enumeração
O tipo de identidade que criou o recurso.
| Valor |
Description |
|
User
|
|
|
Application
|
|
|
ManagedIdentity
|
|
|
Key
|
|
CurrentProtectionState
Enumeração
Especifica o estado de proteção atual do recurso
| Valor |
Description |
|
Invalid
|
|
|
NotProtected
|
|
|
ConfiguringProtection
|
|
|
ProtectionConfigured
|
|
|
BackupSchedulesSuspended
|
|
|
RetentionSchedulesSuspended
|
|
|
ProtectionStopped
|
|
|
ProtectionError
|
|
|
ConfiguringProtectionFailed
|
|
|
SoftDeleting
|
|
|
SoftDeleted
|
|
|
UpdatingProtection
|
|
Datasource
Objeto
Fonte de dados a ser backup
| Nome |
Tipo |
Description |
|
datasourceType
|
string
|
DatasourceType do recurso.
|
|
objectType
|
string
|
Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
|
|
resourceID
|
string
|
ID completa do ARM do recurso. Para recursos do Azure, essa é a ID do ARM. Para recursos que não são do Azure, essa será a ID criada pelo serviço de backup por meio do Fabric/Vault.
|
|
resourceLocation
|
string
|
Local da fonte de dados.
|
|
resourceName
|
string
|
Identificador exclusivo do recurso no contexto do pai.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Propriedades específicas da fonte de dados
|
|
resourceType
|
string
|
Tipo de recurso de fonte de dados.
|
|
resourceUri
|
string
|
Uri do recurso.
|
DatasourceSet
Objeto
Detalhes do Conjunto de Fontes de Dados da fonte de dados a ser feito em backup
| Nome |
Tipo |
Description |
|
datasourceType
|
string
|
DatasourceType do recurso.
|
|
objectType
|
string
|
Tipo de objeto Datasource, usado para inicializar o tipo herdado correto
|
|
resourceID
|
string
|
ID completa do ARM do recurso. Para recursos do Azure, essa é a ID do ARM. Para recursos que não são do Azure, essa será a ID criada pelo serviço de backup por meio do Fabric/Vault.
|
|
resourceLocation
|
string
|
Local da fonte de dados.
|
|
resourceName
|
string
|
Identificador exclusivo do recurso no contexto do pai.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Propriedades específicas do conjunto de fontes de dados
|
|
resourceType
|
string
|
Tipo de recurso de fonte de dados.
|
|
resourceUri
|
string
|
Uri do recurso.
|
DataStoreTypes
Enumeração
tipo de armazenamento de dados; Operacional/Cofre/Arquivo Morto
| Valor |
Description |
|
OperationalStore
|
|
|
VaultStore
|
|
|
ArchiveStore
|
|
DefaultResourceProperties
Objeto
Propriedades de origem padrão
Error
Objeto
A resposta de erro de gerenciamento de recursos.
| Nome |
Tipo |
Description |
|
additionalInfo
|
ErrorAdditionalInfo[]
|
As informações adicionais do erro.
|
|
code
|
string
|
O código de erro.
|
|
details
|
Error[]
|
Os detalhes do erro.
|
|
message
|
string
|
A mensagem de erro.
|
|
target
|
string
|
O destino do erro.
|
ErrorAdditionalInfo
Objeto
As informações adicionais do erro de gerenciamento de recursos.
| Nome |
Tipo |
Description |
|
info
|
object
|
As informações adicionais.
|
|
type
|
string
|
O tipo de informação adicional.
|
IdentityDetails
Objeto
| Nome |
Tipo |
Description |
|
useSystemAssignedIdentity
|
boolean
|
Especifica se o BI está protegido pela Identidade do Sistema.
|
|
userAssignedIdentityArmUrl
|
string
|
URL do ARM para identidade atribuída pelo usuário.
|
InnerError
Objeto
Erro interno
| Nome |
Tipo |
Description |
|
additionalInfo
|
object
|
Todos os pares de valor chave que podem ser fornecidos ao cliente para obter informações detalhadas adicionais.
|
|
code
|
string
|
Código exclusivo para este erro
|
|
embeddedInnerError
|
InnerError
|
Erro interno filho, para permitir o aninhamento.
|
KubernetesClusterBackupDatasourceParameters
Objeto
Parâmetros para a fonte de dados de backup do cluster do Kubernetes
| Nome |
Tipo |
Description |
|
backupHookReferences
|
NamespacedNameResource[]
|
Obtém ou define as referências de gancho de backup. Essa propriedade define a referência de gancho a ser executada durante o backup.
|
|
excludedNamespaces
|
string[]
|
Obtém ou define a propriedade excluir namespaces. Essa propriedade define os namespaces a serem excluídos durante o backup.
|
|
excludedResourceTypes
|
string[]
|
Obtém ou define a propriedade excluir tipos de recurso. Essa propriedade define os tipos de recurso a serem excluídos durante o backup.
|
|
includeClusterScopeResources
|
boolean
|
Obtém ou define a propriedade incluir recursos de cluster. Essa propriedade, se habilitada, incluirá recursos de escopo de cluster durante o backup.
|
|
includedNamespaces
|
string[]
|
Obtém ou define a propriedade de namespaces de inclusão. Essa propriedade define os namespaces a serem incluídos durante o backup.
|
|
includedResourceTypes
|
string[]
|
Obtém ou define a propriedade incluir tipos de recurso. Essa propriedade define os tipos de recurso a serem incluídos durante o backup.
|
|
includedVolumeTypes
|
AKSVolumeTypes[]
|
Obtém ou define a propriedade incluir tipos de volume. Essa propriedade define os tipos de volume a serem incluídos durante o backup.
|
|
labelSelectors
|
string[]
|
Obtém ou define a propriedade LabelSelectors. Essa propriedade define o recurso com esses seletores de rótulo a serem incluídos durante o backup.
|
|
objectType
|
string:
KubernetesClusterBackupDatasourceParameters
|
Tipo do objeto específico – usado para desserializar
|
|
snapshotVolumes
|
boolean
|
Obtém ou define a propriedade de instantâneo de volume. Essa propriedade, se habilitada, tirará instantâneos de volume durante o backup.
|
NamespacedNameResource
Objeto
Classe para consultar recursos que contêm namespace e nome
| Nome |
Tipo |
Description |
|
name
|
string
|
Nome do recurso
|
|
namespace
|
string
|
Namespace no qual o recurso existe
|
PolicyInfo
Objeto
Informações de política no backupInstance
| Nome |
Tipo |
Description |
|
policyId
|
string
|
|
|
policyParameters
|
PolicyParameters
|
Parâmetros de política para a instância de backup
|
|
policyVersion
|
string
|
|
PolicyParameters
Objeto
Parâmetros na política
| Nome |
Tipo |
Description |
|
backupDatasourceParametersList
|
BackupDatasourceParameters[]:
|
Obtém ou define os parâmetros da fonte de dados de backup
|
|
dataStoreParametersList
|
DataStoreParameters[]:
AzureOperationalStoreParameters[]
|
Obtém ou define os parâmetros do DataStore
|
ProtectionStatusDetails
Objeto
Detalhes do status da proteção
| Nome |
Tipo |
Description |
|
errorDetails
|
UserFacingError
|
Especifica o erro de status de proteção do recurso
|
|
status
|
Status
|
Especifica o status de proteção do recurso
|
ResourcePropertiesObjectType
Enumeração
Tipo do objeto específico – usado para desserializar
| Valor |
Description |
|
DefaultResourceProperties
|
|
SecretStoreBasedAuthCredentials
Objeto
Credenciais de autenticação baseadas em repositório secreto.
SecretStoreResource
Objeto
Classe que representa um recurso do repositório de segredos.
| Nome |
Tipo |
Description |
|
secretStoreType
|
SecretStoreType
|
Obtém ou define o tipo de repositório secreto
|
|
uri
|
string
|
Uri para acessar o recurso
|
|
value
|
string
|
Obtém ou define o valor armazenado no recurso do repositório de segredos
|
SecretStoreType
Enumeração
Obtém ou define o tipo de repositório secreto
| Valor |
Description |
|
Invalid
|
|
|
AzureKeyVault
|
|
Status
Enumeração
Especifica o status de proteção do recurso
| Valor |
Description |
|
ConfiguringProtection
|
|
|
ConfiguringProtectionFailed
|
|
|
ProtectionConfigured
|
|
|
ProtectionStopped
|
|
|
SoftDeleted
|
|
|
SoftDeleting
|
|
systemData
Objeto
Metadados relativos à criação e última modificação do recurso.
| Nome |
Tipo |
Description |
|
createdAt
|
string
(date-time)
|
O carimbo de data/hora da criação de recursos (UTC).
|
|
createdBy
|
string
|
A identidade que criou o recurso.
|
|
createdByType
|
createdByType
|
O tipo de identidade que criou o recurso.
|
|
lastModifiedAt
|
string
(date-time)
|
O carimbo de data/hora da última modificação do recurso (UTC)
|
|
lastModifiedBy
|
string
|
A identidade que modificou o recurso pela última vez.
|
|
lastModifiedByType
|
createdByType
|
O tipo de identidade que modificou o recurso pela última vez.
|
UserFacingError
Objeto
Objeto de erro usado por camadas que têm acesso ao conteúdo localizado e propagam isso para o usuário
| Nome |
Tipo |
Description |
|
code
|
string
|
Código exclusivo para este erro
|
|
details
|
UserFacingError[]
|
Erros adicionais relacionados
|
|
innerError
|
InnerError
|
Erro interno
|
|
isRetryable
|
boolean
|
Se a operação será repetível ou não
|
|
isUserError
|
boolean
|
Se a operação é devido a um erro de usuário ou erro de serviço
|
|
message
|
string
|
|
|
properties
|
object
|
Todos os pares de valores de chave que podem ser injetados dentro do objeto de erro
|
|
recommendedAction
|
string[]
|
RecommendedAction localizado.
|
|
target
|
string
|
Destino do erro.
|
ValidationType
Enumeração
Especifica o tipo de validação. No caso do DeepValidation, todas as validações da API /validateForBackup serão executadas novamente.
| Valor |
Description |
|
ShallowValidation
|
|
|
DeepValidation
|
|