Créer ou mettre à jour une instance de sauvegarde dans un coffre de sauvegarde
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2026-03-01
Paramètres URI
| Nom |
Dans |
Obligatoire |
Type |
Description |
|
backupInstanceName
|
path |
True
|
string
|
Nom de la ressource BackupInstanceResource
|
|
resourceGroupName
|
path |
True
|
string
minLength: 1 maxLength: 90
|
Nom du groupe de ressources. Le nom ne respecte pas la casse.
|
|
subscriptionId
|
path |
True
|
string
(uuid)
|
ID de l’abonnement cible. La valeur doit être un UUID.
|
|
vaultName
|
path |
True
|
string
minLength: 2 maxLength: 50 pattern: ^[A-Za-z][-A-Za-z0-9]*[A-Za-z0-9]$
|
Nom du coffre de sauvegarde.
|
|
api-version
|
query |
True
|
string
minLength: 1
|
Version de l’API à utiliser pour cette opération.
|
| Nom |
Obligatoire |
Type |
Description |
|
x-ms-authorization-auxiliary
|
|
string
|
|
Corps de la demande
| Nom |
Type |
Description |
|
properties
|
BackupInstance
|
Propriétés BackupInstanceResource
|
|
tags
|
object
|
Balises de ressource proxy.
|
Réponses
| Nom |
Type |
Description |
|
200 OK
|
BackupInstanceResource
|
Réussite de l’opération de mise à jour de la ressource 'BackupInstanceResource'
|
|
201 Created
|
BackupInstanceResource
|
Réussite de l’opération de création de la ressource 'BackupInstanceResource'
En-têtes
- Location: string
- Retry-After: integer
|
|
202 Accepted
|
|
Exploitation des ressources acceptée.
En-têtes
- Azure-AsyncOperation: string
- Location: string
|
|
Other Status Codes
|
CloudError
|
Réponse d’erreur inattendue.
|
Sécurité
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
| Nom |
Description |
|
user_impersonation
|
emprunter l’identité de votre compte d’utilisateur
|
Exemples
Create BackupInstance
Exemple de requête
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
Exemple de réponse
{
"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
Exemple de requête
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
Exemple de réponse
{
"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
Exemple de requête
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
Exemple de réponse
{
"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
Exemple de requête
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
Exemple de réponse
{
"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
Exemple de requête
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
Exemple de réponse
{
"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
Exemple de requête
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
Exemple de réponse
{
"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
Définitions
AdlsBlobBackupDatasourceParameters
Objet
Paramètres à utiliser lors de la configuration de la sauvegarde des objets blob de comptes de stockage Azure Data Lake
| Nom |
Type |
Description |
|
containersList
|
string[]
|
Liste des conteneurs à sauvegarder lors de la configuration de la sauvegarde des objets blob
|
|
objectType
|
string:
AdlsBlobBackupDatasourceParameters
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
AdlsBlobBackupDatasourceParametersForAutoProtection
Objet
Paramètres à utiliser lors de la configuration de la sauvegarde des blobs de comptes de stockage Azure Data Lake en utilisant les paramètres AutoProtection
AKSVolumeTypes
Énumération
| Valeur |
Description |
|
AzureDisk
|
|
|
AzureFileShareSMB
|
|
AzureOperationalStoreParameters
Objet
Paramètres du magasin de données Operational-Tier
| Nom |
Type |
Description |
|
dataStoreType
|
DataStoreTypes
|
type de magasin de données ; Operational/Vault/Archive
|
|
objectType
|
string:
AzureOperationalStoreParameters
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
|
resourceGroupId
|
string
|
Obtient ou définit l’URI du groupe de ressources d’instantané.
|
BackupInstance
Objet
Instance de sauvegarde
| Nom |
Type |
Description |
|
currentProtectionState
|
CurrentProtectionState
|
Spécifie l’état de protection actuel de la ressource
|
|
dataSourceInfo
|
Datasource
|
Obtient ou définit les informations de source de données.
|
|
dataSourceSetInfo
|
DatasourceSet
|
Obtient ou définit les informations du jeu de sources de données.
|
|
datasourceAuthCredentials
|
AuthCredentials:
SecretStoreBasedAuthCredentials
|
Informations d’identification à utiliser pour s’authentifier auprès du fournisseur de source de données.
|
|
friendlyName
|
string
|
Obtient ou définit le nom convivial de l’instance de sauvegarde.
|
|
identityDetails
|
IdentityDetails
|
Contient des informations sur les détails de l’identité pour le décisionnel.
S’il s’agit de null, la valeur par défaut est considérée comme affectée par le système.
|
|
objectType
|
string
|
|
|
policyInfo
|
PolicyInfo
|
Obtient ou définit les informations de stratégie.
|
|
protectionErrorDetails
|
UserFacingError
|
Spécifie l’erreur de protection de la ressource
|
|
protectionStatus
|
ProtectionStatusDetails
|
Spécifie l’état de protection de la ressource
|
|
provisioningState
|
string
|
Spécifie l’état d’approvisionnement de la ressource, c’est-à-dire l’approvisionnement/la mise à jour/Succeeded/Failed
|
|
resourceGuardOperationRequests
|
string[]
|
ResourceGuardOperationRequests sur laquelle la vérification LAC sera effectuée
|
|
validationType
|
ValidationType
|
Spécifie le type de validation. En cas de DeepValidation, toutes les validations de l’API /validateForBackup s’exécutent à nouveau.
|
BackupInstanceResource
Objet
Ressource BackupInstance
| Nom |
Type |
Description |
|
id
|
string
(arm-id)
|
ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
|
|
name
|
string
|
Nom de la ressource
|
|
properties
|
BackupInstance
|
Propriétés BackupInstanceResource
|
|
systemData
|
systemData
|
Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
|
|
tags
|
object
|
Balises de ressource proxy.
|
|
type
|
string
|
Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »
|
BlobBackupAutoProtectionRule
Objet
Indique une règle de protection automatique contre la sauvegarde de blobs.
| Nom |
Type |
Description |
|
mode
|
BlobBackupRuleMode
|
Exclure supprime les candidats (après inclusion)
|
|
objectType
|
string
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
|
pattern
|
string
|
Le motif de chaîne à évaluer par rapport aux noms de conteneurs. Pour l’instant, cela n’accepte que les chaînes littérales (pas de jokers ni de régulation).
|
|
type
|
BlobBackupPatternType
|
Type de patron : Préfixe, seul le type de patron est pris en charge pour l’instant.
|
BlobBackupDatasourceParameters
Objet
Paramètres à utiliser lors de la configuration de la sauvegarde d’objets blob
| Nom |
Type |
Description |
|
containersList
|
string[]
|
Liste des conteneurs à sauvegarder lors de la configuration de la sauvegarde des objets blob
|
|
objectType
|
string:
BlobBackupDatasourceParameters
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
BlobBackupDatasourceParametersForAutoProtection
Objet
Paramters à utiliser lors de la configuration de sauvegarde des blobs via les paramètres AutoProtection
BlobBackupPatternType
Énumération
Type de patron. Seul le préfixe est pris en charge pour l’instant.
| Valeur |
Description |
|
Prefix
|
|
BlobBackupRuleBasedAutoProtectionSettings
Objet
Paramètres à utiliser pour les paramètres de protection automatique basée sur les règles de sauvegarde de blob.
| Nom |
Type |
Description |
|
enabled
|
boolean
|
Marquez pour activer la protection auto.
|
|
objectType
|
string:
BlobBackupRuleBasedAutoProtectionSettings
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
|
rules
|
BlobBackupAutoProtectionRule[]
|
Les règles sont évaluées dans l’ordre fourni. L’inclusion ajoute des candidats ; L’exclusion élimine les candidats.
Si aucune règle n’est présente, tous les conteneurs sont considérés comme éligibles lorsqu’activé = vrai.
|
BlobBackupRuleMode
Énumération
Mode règle (Exclusif uniquement pris en charge pour l’instant).
| Valeur |
Description |
|
Exclude
|
|
CloudError
Objet
Réponse d’erreur de Sauvegarde Azure.
| Nom |
Type |
Description |
|
error
|
Error
|
Réponse d’erreur de gestion des ressources.
|
createdByType
Énumération
Type d’identité qui a créé la ressource.
| Valeur |
Description |
|
User
|
|
|
Application
|
|
|
ManagedIdentity
|
|
|
Key
|
|
CurrentProtectionState
Énumération
Spécifie l’état de protection actuel de la ressource
| Valeur |
Description |
|
Invalid
|
|
|
NotProtected
|
|
|
ConfiguringProtection
|
|
|
ProtectionConfigured
|
|
|
BackupSchedulesSuspended
|
|
|
RetentionSchedulesSuspended
|
|
|
ProtectionStopped
|
|
|
ProtectionError
|
|
|
ConfiguringProtectionFailed
|
|
|
SoftDeleting
|
|
|
SoftDeleted
|
|
|
UpdatingProtection
|
|
Datasource
Objet
Source de données à sauvegarder
| Nom |
Type |
Description |
|
datasourceType
|
string
|
DatasourceType de la ressource.
|
|
objectType
|
string
|
Type d’objet Datasource, utilisé pour initialiser le type hérité droit
|
|
resourceID
|
string
|
ID ARM complet de la ressource. Pour les ressources Azure, il s’agit de l’ID ARM. Pour les ressources non Azure, il s’agit de l’ID créé par le service de sauvegarde via Fabric/Vault.
|
|
resourceLocation
|
string
|
Emplacement de la source de données.
|
|
resourceName
|
string
|
Identificateur unique de la ressource dans le contexte du parent.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Propriétés spécifiques à la source de données
|
|
resourceType
|
string
|
Type de ressource de la source de données.
|
|
resourceUri
|
string
|
Uri de la ressource.
|
DatasourceSet
Objet
Détails de DatasourceSet de la source de données à sauvegarder
| Nom |
Type |
Description |
|
datasourceType
|
string
|
DatasourceType de la ressource.
|
|
objectType
|
string
|
Type d’objet Datasource, utilisé pour initialiser le type hérité droit
|
|
resourceID
|
string
|
ID ARM complet de la ressource. Pour les ressources Azure, il s’agit de l’ID ARM. Pour les ressources non Azure, il s’agit de l’ID créé par le service de sauvegarde via Fabric/Vault.
|
|
resourceLocation
|
string
|
Emplacement de la source de données.
|
|
resourceName
|
string
|
Identificateur unique de la ressource dans le contexte du parent.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Propriétés propres au jeu de sources de données
|
|
resourceType
|
string
|
Type de ressource de la source de données.
|
|
resourceUri
|
string
|
Uri de la ressource.
|
DataStoreTypes
Énumération
type de magasin de données ; Operational/Vault/Archive
| Valeur |
Description |
|
OperationalStore
|
|
|
VaultStore
|
|
|
ArchiveStore
|
|
DefaultResourceProperties
Objet
Propriétés sources par défaut
| Nom |
Type |
Description |
|
objectType
|
string:
DefaultResourceProperties
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
Error
Objet
Réponse d’erreur de gestion des ressources.
| Nom |
Type |
Description |
|
additionalInfo
|
ErrorAdditionalInfo[]
|
Informations supplémentaires sur l’erreur.
|
|
code
|
string
|
Code d’erreur.
|
|
details
|
Error[]
|
Détails de l’erreur.
|
|
message
|
string
|
Message d’erreur.
|
|
target
|
string
|
Cible d’erreur.
|
ErrorAdditionalInfo
Objet
Informations supplémentaires sur l’erreur de gestion des ressources.
| Nom |
Type |
Description |
|
info
|
object
|
Informations supplémentaires.
|
|
type
|
string
|
Type d’informations supplémentaire.
|
IdentityDetails
Objet
| Nom |
Type |
Description |
|
useSystemAssignedIdentity
|
boolean
|
Spécifie si la bi est protégée par l’identité système.
|
|
userAssignedIdentityArmUrl
|
string
|
URL ARM pour l’identité affectée par l’utilisateur.
|
InnerError
Objet
Erreur interne
| Nom |
Type |
Description |
|
additionalInfo
|
object
|
Toutes les paires clé-valeur qui peuvent être fournies au client pour obtenir des informations détaillées supplémentaires.
|
|
code
|
string
|
Code unique pour cette erreur
|
|
embeddedInnerError
|
InnerError
|
Erreur interne enfant pour autoriser l’imbrication.
|
KubernetesClusterBackupDatasourceParameters
Objet
Paramètres de la source de données de sauvegarde de cluster Kubernetes
| Nom |
Type |
Description |
|
backupHookReferences
|
NamespacedNameResource[]
|
Obtient ou définit les références de hook de sauvegarde. Cette propriété définit la référence de hook à exécuter pendant la sauvegarde.
|
|
excludedNamespaces
|
string[]
|
Obtient ou définit la propriété exclure des espaces de noms. Cette propriété définit les espaces de noms à exclure pendant la sauvegarde.
|
|
excludedResourceTypes
|
string[]
|
Obtient ou définit la propriété exclure les types de ressources. Cette propriété définit les types de ressources à exclure pendant la sauvegarde.
|
|
includeClusterScopeResources
|
boolean
|
Obtient ou définit la propriété des ressources de cluster include. Cette propriété s’il est activé inclut des ressources d’étendue de cluster pendant la sauvegarde.
|
|
includedNamespaces
|
string[]
|
Obtient ou définit la propriété include namespaces. Cette propriété définit les espaces de noms à inclure pendant la sauvegarde.
|
|
includedResourceTypes
|
string[]
|
Obtient ou définit la propriété include resource types. Cette propriété définit les types de ressources à inclure pendant la sauvegarde.
|
|
includedVolumeTypes
|
AKSVolumeTypes[]
|
Obtient ou définit la propriété des types de volumes include. Cette propriété définit les types de volumes à inclure pendant la sauvegarde.
|
|
labelSelectors
|
string[]
|
Obtient ou définit la propriété LabelSelectors. Cette propriété définit la ressource avec ces sélecteurs d’étiquettes à inclure pendant la sauvegarde.
|
|
objectType
|
string:
KubernetesClusterBackupDatasourceParameters
|
Type de l’objet spécifique - utilisé pour la désérialisation
|
|
snapshotVolumes
|
boolean
|
Obtient ou définit la propriété d’instantané de volume. Cette propriété si activée prend des instantanés de volume lors de la sauvegarde.
|
NamespacedNameResource
Objet
Classe pour faire référence aux ressources qui contiennent l’espace de noms et le nom
| Nom |
Type |
Description |
|
name
|
string
|
Nom de la ressource
|
|
namespace
|
string
|
Espace de noms dans lequel la ressource existe
|
PolicyInfo
Objet
Informations de stratégie dans backupInstance
| Nom |
Type |
Description |
|
policyId
|
string
|
|
|
policyParameters
|
PolicyParameters
|
Paramètres de stratégie pour l’instance de sauvegarde
|
|
policyVersion
|
string
|
|
PolicyParameters
Objet
Paramètres dans la stratégie
| Nom |
Type |
Description |
|
backupDatasourceParametersList
|
BackupDatasourceParameters[]:
|
Obtient ou définit les paramètres de la source de données de sauvegarde
|
|
dataStoreParametersList
|
DataStoreParameters[]:
AzureOperationalStoreParameters[]
|
Obtient ou définit les paramètres du Magasin de données
|
ProtectionStatusDetails
Objet
Détails de l’état de la protection
| Nom |
Type |
Description |
|
errorDetails
|
UserFacingError
|
Spécifie l’erreur d’état de protection de la ressource
|
|
status
|
Status
|
Spécifie l’état de protection de la ressource
|
ResourcePropertiesObjectType
Énumération
Type de l’objet spécifique - utilisé pour la désérialisation
| Valeur |
Description |
|
DefaultResourceProperties
|
|
SecretStoreBasedAuthCredentials
Objet
Informations d’identification d’authentification basées sur le magasin de secrets.
SecretStoreResource
Objet
Classe représentant une ressource de magasin de secrets.
| Nom |
Type |
Description |
|
secretStoreType
|
SecretStoreType
|
Obtient ou définit le type de magasin de secrets
|
|
uri
|
string
|
URI pour accéder à la ressource
|
|
value
|
string
|
Obtient ou définit la valeur stockée dans la ressource de magasin de secrets
|
SecretStoreType
Énumération
Obtient ou définit le type de magasin de secrets
| Valeur |
Description |
|
Invalid
|
|
|
AzureKeyVault
|
|
Status
Énumération
Spécifie l’état de protection de la ressource
| Valeur |
Description |
|
ConfiguringProtection
|
|
|
ConfiguringProtectionFailed
|
|
|
ProtectionConfigured
|
|
|
ProtectionStopped
|
|
|
SoftDeleted
|
|
|
SoftDeleting
|
|
systemData
Objet
Métadonnées relatives à la création et à la dernière modification de la ressource.
| Nom |
Type |
Description |
|
createdAt
|
string
(date-time)
|
Horodatage de la création de ressources (UTC).
|
|
createdBy
|
string
|
Identité qui a créé la ressource.
|
|
createdByType
|
createdByType
|
Type d’identité qui a créé la ressource.
|
|
lastModifiedAt
|
string
(date-time)
|
Horodatage de la dernière modification de ressource (UTC)
|
|
lastModifiedBy
|
string
|
Identité qui a modifié la ressource pour la dernière fois.
|
|
lastModifiedByType
|
createdByType
|
Type d’identité qui a modifié la ressource pour la dernière fois.
|
UserFacingError
Objet
Objet d’erreur utilisé par les couches qui ont accès au contenu localisé et propagent celui-ci à l’utilisateur
| Nom |
Type |
Description |
|
code
|
string
|
Code unique pour cette erreur
|
|
details
|
UserFacingError[]
|
Erreurs connexes supplémentaires
|
|
innerError
|
InnerError
|
Erreur interne
|
|
isRetryable
|
boolean
|
Indique si l’opération sera retenable ou non
|
|
isUserError
|
boolean
|
Indique si l’opération est due à une erreur utilisateur ou à une erreur de service
|
|
message
|
string
|
|
|
properties
|
object
|
Toutes les paires clé-valeur qui peuvent être injectées à l’intérieur de l’objet d’erreur
|
|
recommendedAction
|
string[]
|
RecommendedAction localisé.
|
|
target
|
string
|
Cible de l’erreur.
|
ValidationType
Énumération
Spécifie le type de validation. En cas de DeepValidation, toutes les validations de l’API /validateForBackup s’exécutent à nouveau.
| Valeur |
Description |
|
ShallowValidation
|
|
|
DeepValidation
|
|