Creare o aggiornare un'istanza di backup in un insieme di credenziali di backup
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2026-03-01
Parametri dell'URI
| Nome |
In |
Necessario |
Tipo |
Descrizione |
|
backupInstanceName
|
path |
True
|
string
|
Nome di BackupInstanceResource
|
|
resourceGroupName
|
path |
True
|
string
minLength: 1 maxLength: 90
|
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
|
|
subscriptionId
|
path |
True
|
string
(uuid)
|
ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
|
|
vaultName
|
path |
True
|
string
minLength: 2 maxLength: 50 pattern: ^[A-Za-z][-A-Za-z0-9]*[A-Za-z0-9]$
|
Nome dell'insieme di credenziali di backup.
|
|
api-version
|
query |
True
|
string
minLength: 1
|
Versione dell'API da usare per questa operazione.
|
| Nome |
Necessario |
Tipo |
Descrizione |
|
x-ms-authorization-auxiliary
|
|
string
|
|
Corpo della richiesta
| Nome |
Tipo |
Descrizione |
|
properties
|
BackupInstance
|
Proprietà di BackupInstanceResource
|
|
tags
|
object
|
Tag risorsa proxy.
|
Risposte
| Nome |
Tipo |
Descrizione |
|
200 OK
|
BackupInstanceResource
|
L'operazione di aggiornamento della risorsa 'BackupInstanceResource' è riuscita
|
|
201 Created
|
BackupInstanceResource
|
L'operazione di creazione della risorsa 'BackupInstanceResource' è riuscita
Intestazioni
- Location: string
- Retry-After: integer
|
|
202 Accepted
|
|
Operazione sulle risorse accettata.
Intestazioni
- Azure-AsyncOperation: string
- Location: string
|
|
Other Status Codes
|
CloudError
|
Risposta di errore imprevista.
|
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome |
Descrizione |
|
user_impersonation
|
rappresentare l'account utente
|
Esempio
Create BackupInstance
Esempio di richiesta
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
Risposta di esempio
{
"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
Esempio di richiesta
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
Risposta di esempio
{
"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
Esempio di richiesta
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
Risposta di esempio
{
"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
Esempio di richiesta
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
Risposta di esempio
{
"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
Esempio di richiesta
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
Risposta di esempio
{
"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
Esempio di richiesta
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
Risposta di esempio
{
"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
Definizioni
AdlsBlobBackupDatasourceParameters
Oggetto
Parametri da utilizzare durante la configurazione del backup dei BLOB dell'account Azure Data Lake Storage
| Nome |
Tipo |
Descrizione |
|
containersList
|
string[]
|
Elenco di contenitori di cui eseguire il backup durante la configurazione del backup dei BLOB
|
|
objectType
|
string:
AdlsBlobBackupDatasourceParameters
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
AdlsBlobBackupDatasourceParametersForAutoProtection
Oggetto
Parametri da utilizzare durante la configurazione del backup dei blob degli account di archiviazione di Azure Data Lake utilizzando le impostazioni di AutoProtection
AKSVolumeTypes
Enumerazione
| Valore |
Descrizione |
|
AzureDisk
|
|
|
AzureFileShareSMB
|
|
AzureOperationalStoreParameters
Oggetto
Parametri per Operational-Tier Archivio dati
| Nome |
Tipo |
Descrizione |
|
dataStoreType
|
DataStoreTypes
|
tipo di archivio dati; Operational/Vault/Archive
|
|
objectType
|
string:
AzureOperationalStoreParameters
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
|
resourceGroupId
|
string
|
Ottiene o imposta l'URI del gruppo di risorse snapshot.
|
BackupInstance
Oggetto
Istanza di backup
| Nome |
Tipo |
Descrizione |
|
currentProtectionState
|
CurrentProtectionState
|
Specifica lo stato di protezione corrente della risorsa
|
|
dataSourceInfo
|
Datasource
|
Ottiene o imposta le informazioni sull'origine dati.
|
|
dataSourceSetInfo
|
DatasourceSet
|
Ottiene o imposta le informazioni sul set di origini dati.
|
|
datasourceAuthCredentials
|
AuthCredentials:
SecretStoreBasedAuthCredentials
|
Credenziali da usare per l'autenticazione con il provider dell'origine dati.
|
|
friendlyName
|
string
|
Ottiene o imposta il nome descrittivo dell'istanza di backup.
|
|
identityDetails
|
IdentityDetails
|
Contiene informazioni sui dettagli dell'identità per l'bi.
Se è null, il valore predefinito verrà considerato assegnato dal sistema.
|
|
objectType
|
string
|
|
|
policyInfo
|
PolicyInfo
|
Ottiene o imposta le informazioni sui criteri.
|
|
protectionErrorDetails
|
UserFacingError
|
Specifica l'errore di protezione della risorsa
|
|
protectionStatus
|
ProtectionStatusDetails
|
Specifica lo stato di protezione della risorsa
|
|
provisioningState
|
string
|
Specifica lo stato di provisioning della risorsa, ad esempio provisioning/aggiornamento/succeeded/failed
|
|
resourceGuardOperationRequests
|
string[]
|
ResourceGuardOperationRequests su cui verrà eseguito il controllo LAC
|
|
validationType
|
ValidationType
|
Specifica il tipo di convalida. In caso di DeepValidation, tutte le convalide dell'API /validateForBackup verranno eseguite di nuovo.
|
BackupInstanceResource
Oggetto
Risorsa BackupInstance
| Nome |
Tipo |
Descrizione |
|
id
|
string
(arm-id)
|
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
|
|
name
|
string
|
Nome della risorsa
|
|
properties
|
BackupInstance
|
Proprietà di BackupInstanceResource
|
|
systemData
|
systemData
|
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
|
|
tags
|
object
|
Tag risorsa proxy.
|
|
type
|
string
|
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"
|
BlobBackupAutoProtectionRule
Oggetto
Indica una regola di protezione automatica contro il backup del blob.
| Nome |
Tipo |
Descrizione |
|
mode
|
BlobBackupRuleMode
|
Escludere rimuove i candidati (dopo inclusione)
|
|
objectType
|
string
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
|
pattern
|
string
|
Il pattern di stringhe da valutare rispetto ai nomi dei contenitori. Per ora accetta solo stringhe letterali (niente jolly o regex).
|
|
type
|
BlobBackupPatternType
|
Tipo di modello: Prefisso, per ora è supportato solo il tipo di modello.
|
BlobBackupDatasourceParameters
Oggetto
Parametri da usare durante la configurazione del backup dei BLOB
| Nome |
Tipo |
Descrizione |
|
containersList
|
string[]
|
Elenco di contenitori di cui eseguire il backup durante la configurazione del backup dei BLOB
|
|
objectType
|
string:
BlobBackupDatasourceParameters
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
BlobBackupDatasourceParametersForAutoProtection
Oggetto
Parametri da usare durante la configurazione del backup dei blob tramite le impostazioni di AutoProtection
BlobBackupPatternType
Enumerazione
Tipo di modello. Per ora è supportato solo il prefisso.
| Valore |
Descrizione |
|
Prefix
|
|
BlobBackupRuleBasedAutoProtectionSettings
Oggetto
Parametri da utilizzare per le impostazioni di Auto Protection Basata sulle Regole di Backup Blob.
| Nome |
Tipo |
Descrizione |
|
enabled
|
boolean
|
Segnala per abilitare se la protezione auto.
|
|
objectType
|
string:
BlobBackupRuleBasedAutoProtectionSettings
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
|
rules
|
BlobBackupAutoProtectionRule[]
|
Le regole vengono valutate nell'ordine fornito. L'inclusione aggiunge candidati; L'esclusione elimina i candidati.
Se non sono presenti regole, tutti i contenitori sono considerati idonei quando abilitati = true.
|
BlobBackupRuleMode
Enumerazione
Modalità Regola (per ora supportata solo Escludere).
| Valore |
Descrizione |
|
Exclude
|
|
CloudError
Oggetto
Risposta di errore da Backup di Azure.
| Nome |
Tipo |
Descrizione |
|
error
|
Error
|
Risposta di errore di gestione delle risorse.
|
createdByType
Enumerazione
Tipo di identità che ha creato la risorsa.
| Valore |
Descrizione |
|
User
|
|
|
Application
|
|
|
ManagedIdentity
|
|
|
Key
|
|
CurrentProtectionState
Enumerazione
Specifica lo stato di protezione corrente della risorsa
| Valore |
Descrizione |
|
Invalid
|
|
|
NotProtected
|
|
|
ConfiguringProtection
|
|
|
ProtectionConfigured
|
|
|
BackupSchedulesSuspended
|
|
|
RetentionSchedulesSuspended
|
|
|
ProtectionStopped
|
|
|
ProtectionError
|
|
|
ConfiguringProtectionFailed
|
|
|
SoftDeleting
|
|
|
SoftDeleted
|
|
|
UpdatingProtection
|
|
Datasource
Oggetto
Origine dati di cui eseguire il backup
| Nome |
Tipo |
Descrizione |
|
datasourceType
|
string
|
DatasourceType della risorsa.
|
|
objectType
|
string
|
Tipo di oggetto Datasource, utilizzato per inizializzare il tipo ereditato corretto
|
|
resourceID
|
string
|
ID arm completo della risorsa. Per le risorse di Azure, si tratta dell'ID ARM. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.
|
|
resourceLocation
|
string
|
Posizione dell'origine dati.
|
|
resourceName
|
string
|
Identificatore univoco della risorsa nel contesto dell'elemento padre.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Proprietà specifiche dell'origine dati
|
|
resourceType
|
string
|
Tipo di risorsa dell'origine dati.
|
|
resourceUri
|
string
|
URI della risorsa.
|
DatasourceSet
Oggetto
Dettagli datasourceSet dell'origine dati di cui eseguire il backup
| Nome |
Tipo |
Descrizione |
|
datasourceType
|
string
|
DatasourceType della risorsa.
|
|
objectType
|
string
|
Tipo di oggetto Datasource, utilizzato per inizializzare il tipo ereditato corretto
|
|
resourceID
|
string
|
ID arm completo della risorsa. Per le risorse di Azure, si tratta dell'ID ARM. Per le risorse non di Azure, questo sarà l'ID creato dal servizio di backup tramite Fabric/Vault.
|
|
resourceLocation
|
string
|
Posizione dell'origine dati.
|
|
resourceName
|
string
|
Identificatore univoco della risorsa nel contesto dell'elemento padre.
|
|
resourceProperties
|
BaseResourceProperties:
DefaultResourceProperties
|
Proprietà specifiche del set di origini dati
|
|
resourceType
|
string
|
Tipo di risorsa dell'origine dati.
|
|
resourceUri
|
string
|
URI della risorsa.
|
DataStoreTypes
Enumerazione
tipo di archivio dati; Operational/Vault/Archive
| Valore |
Descrizione |
|
OperationalStore
|
|
|
VaultStore
|
|
|
ArchiveStore
|
|
DefaultResourceProperties
Oggetto
Proprietà di origine predefinite
| Nome |
Tipo |
Descrizione |
|
objectType
|
string:
DefaultResourceProperties
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
Error
Oggetto
Risposta di errore di gestione delle risorse.
| Nome |
Tipo |
Descrizione |
|
additionalInfo
|
ErrorAdditionalInfo[]
|
Informazioni aggiuntive sull'errore.
|
|
code
|
string
|
Codice di errore.
|
|
details
|
Error[]
|
Dettagli dell'errore.
|
|
message
|
string
|
Messaggio di errore.
|
|
target
|
string
|
Destinazione dell'errore.
|
ErrorAdditionalInfo
Oggetto
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome |
Tipo |
Descrizione |
|
info
|
object
|
Informazioni aggiuntive.
|
|
type
|
string
|
Tipo di informazioni aggiuntive.
|
IdentityDetails
Oggetto
| Nome |
Tipo |
Descrizione |
|
useSystemAssignedIdentity
|
boolean
|
Specifica se l'identità del sistema è protetta dall'identità del sistema.
|
|
userAssignedIdentityArmUrl
|
string
|
URL arm per identità assegnata dall'utente.
|
InnerError
Oggetto
Errore interno
| Nome |
Tipo |
Descrizione |
|
additionalInfo
|
object
|
Qualsiasi coppia chiave valore che può essere fornita al client per informazioni dettagliate aggiuntive.
|
|
code
|
string
|
Codice univoco per questo errore
|
|
embeddedInnerError
|
InnerError
|
Errore interno figlio, per consentire l'annidamento.
|
KubernetesClusterBackupDatasourceParameters
Oggetto
Parametri per l'origine dati di backup del cluster Kubernetes
| Nome |
Tipo |
Descrizione |
|
backupHookReferences
|
NamespacedNameResource[]
|
Ottiene o imposta i riferimenti all'hook di backup. Questa proprietà imposta il riferimento hook da eseguire durante il backup.
|
|
excludedNamespaces
|
string[]
|
Ottiene o imposta la proprietà exclude namespaces. Questa proprietà imposta gli spazi dei nomi da escludere durante il backup.
|
|
excludedResourceTypes
|
string[]
|
Ottiene o imposta la proprietà exclude resource types. Questa proprietà imposta i tipi di risorsa da escludere durante il backup.
|
|
includeClusterScopeResources
|
boolean
|
Ottiene o imposta la proprietà include risorse cluster. Questa proprietà se abilitata includerà le risorse dell'ambito del cluster durante il backup.
|
|
includedNamespaces
|
string[]
|
Ottiene o imposta la proprietà include namespaces. Questa proprietà imposta gli spazi dei nomi da includere durante il backup.
|
|
includedResourceTypes
|
string[]
|
Ottiene o imposta la proprietà include tipi di risorsa. Questa proprietà imposta i tipi di risorsa da includere durante il backup.
|
|
includedVolumeTypes
|
AKSVolumeTypes[]
|
Ottiene o imposta la proprietà include tipi di volume. Questa proprietà imposta i tipi di volume da includere durante il backup.
|
|
labelSelectors
|
string[]
|
Ottiene o imposta la proprietà LabelSelectors. Questa proprietà imposta la risorsa con tali selettori di etichetta da includere durante il backup.
|
|
objectType
|
string:
KubernetesClusterBackupDatasourceParameters
|
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
|
|
snapshotVolumes
|
boolean
|
Ottiene o imposta la proprietà snapshot del volume. Questa proprietà se abilitata creerà snapshot del volume durante il backup.
|
NamespacedNameResource
Oggetto
Classe per fare riferimento alle risorse che contengono spazio dei nomi e nome
| Nome |
Tipo |
Descrizione |
|
name
|
string
|
Nome della risorsa
|
|
namespace
|
string
|
Spazio dei nomi in cui esiste la risorsa
|
PolicyInfo
Oggetto
Informazioni sui criteri in backupInstance
| Nome |
Tipo |
Descrizione |
|
policyId
|
string
|
|
|
policyParameters
|
PolicyParameters
|
Parametri dei criteri per l'istanza di backup
|
|
policyVersion
|
string
|
|
PolicyParameters
Oggetto
Parametri nei criteri
| Nome |
Tipo |
Descrizione |
|
backupDatasourceParametersList
|
BackupDatasourceParameters[]:
|
Ottiene o imposta i parametri dell'origine dati di backup
|
|
dataStoreParametersList
|
DataStoreParameters[]:
AzureOperationalStoreParameters[]
|
Ottiene o imposta i parametri dell'archivio dati
|
ProtectionStatusDetails
Oggetto
Dettagli dello stato di protezione
| Nome |
Tipo |
Descrizione |
|
errorDetails
|
UserFacingError
|
Specifica l'errore di stato di protezione della risorsa
|
|
status
|
Status
|
Specifica lo stato di protezione della risorsa
|
ResourcePropertiesObjectType
Enumerazione
Tipo dell'oggetto specifico : utilizzato per la deserializzazione
| Valore |
Descrizione |
|
DefaultResourceProperties
|
|
SecretStoreBasedAuthCredentials
Oggetto
Credenziali di autenticazione basate sull'archivio segreto.
SecretStoreResource
Oggetto
Classe che rappresenta una risorsa dell'archivio segreti.
| Nome |
Tipo |
Descrizione |
|
secretStoreType
|
SecretStoreType
|
Ottiene o imposta il tipo di archivio segreti
|
|
uri
|
string
|
URI per accedere alla risorsa
|
|
value
|
string
|
Ottiene o imposta il valore archiviato nella risorsa dell'archivio segreti
|
SecretStoreType
Enumerazione
Ottiene o imposta il tipo di archivio segreti
| Valore |
Descrizione |
|
Invalid
|
|
|
AzureKeyVault
|
|
Status
Enumerazione
Specifica lo stato di protezione della risorsa
| Valore |
Descrizione |
|
ConfiguringProtection
|
|
|
ConfiguringProtectionFailed
|
|
|
ProtectionConfigured
|
|
|
ProtectionStopped
|
|
|
SoftDeleted
|
|
|
SoftDeleting
|
|
systemData
Oggetto
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome |
Tipo |
Descrizione |
|
createdAt
|
string
(date-time)
|
Timestamp della creazione della risorsa (UTC).
|
|
createdBy
|
string
|
Identità che ha creato la risorsa.
|
|
createdByType
|
createdByType
|
Tipo di identità che ha creato la risorsa.
|
|
lastModifiedAt
|
string
(date-time)
|
Timestamp dell'ultima modifica della risorsa (UTC)
|
|
lastModifiedBy
|
string
|
Identità che ha modificato l'ultima volta la risorsa.
|
|
lastModifiedByType
|
createdByType
|
Tipo di identità che ha modificato l'ultima volta la risorsa.
|
UserFacingError
Oggetto
Oggetto errore usato dai livelli che hanno accesso al contenuto localizzato e propagano tale oggetto all'utente
| Nome |
Tipo |
Descrizione |
|
code
|
string
|
Codice univoco per questo errore
|
|
details
|
UserFacingError[]
|
Errori correlati aggiuntivi
|
|
innerError
|
InnerError
|
Errore interno
|
|
isRetryable
|
boolean
|
Indica se l'operazione sarà riprovabile o meno
|
|
isUserError
|
boolean
|
Indica se l'operazione è dovuta a un errore dell'utente o di un servizio
|
|
message
|
string
|
|
|
properties
|
object
|
Qualsiasi coppia chiave-valore che può essere inserita all'interno dell'oggetto error
|
|
recommendedAction
|
string[]
|
RecommendedAction localizzato.
|
|
target
|
string
|
Destinazione dell'errore.
|
ValidationType
Enumerazione
Specifica il tipo di convalida. In caso di DeepValidation, tutte le convalide dell'API /validateForBackup verranno eseguite di nuovo.
| Valore |
Descrizione |
|
ShallowValidation
|
|
|
DeepValidation
|
|