Backup Instances - Create Or Update

Riferimento

Servizio:: Data Protection

Versione API:: 2025-01-01

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=2025-01-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
backupInstanceName	path	True	string	Nome dell'istanza di backup.
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
vaultName	path	True	string	Nome dell'insieme di credenziali di backup.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome	Necessario	Tipo	Descrizione
x-ms-authorization-auxiliary		string

Corpo della richiesta

Nome	Tipo	Descrizione
properties	BackupInstance	Proprietà BackupInstanceResource
tags	object	Tag risorsa proxy.

Risposte

Nome	Tipo	Descrizione
200 OK	BackupInstanceResource	OK
201 Created	BackupInstanceResource	Creato
202 Accepted		Accettato Intestazioni Location: string Azure-AsyncOperation: string
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

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

Create BackupInstance to perform critical operation With MUA

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Create BackupInstance

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "objectType": "BackupInstance",
    "friendlyName": "harshitbi2",
    "dataSourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "dataSourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "datasourceAuthCredentials": {
      "secretStoreResource": {
        "uri": "https://samplevault.vault.azure.net/secrets/credentials",
        "secretStoreType": "AzureKeyVault"
      },
      "objectType": "SecretStoreBasedAuthCredentials"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "validationType": "ShallowValidation"
  }
}

Risposta di esempio

Codice di stato:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Codice di stato:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Codice di stato:: 200

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Create BackupInstance to perform critical operation With MUA

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "objectType": "BackupInstance",
    "friendlyName": "harshitbi2",
    "dataSourceSetInfo": {
      "objectType": "DatasourceSet",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceName": "viveksipgtest",
      "resourceType": "Microsoft.DBforPostgreSQL/servers",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "dataSourceInfo": {
      "objectType": "Datasource",
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceName": "testdb",
      "resourceType": "Microsoft.DBforPostgreSQL/servers/databases",
      "resourceUri": "",
      "resourceLocation": "",
      "datasourceType": "Microsoft.DBforPostgreSQL/servers/databases"
    },
    "datasourceAuthCredentials": {
      "secretStoreResource": {
        "uri": "https://samplevault.vault.azure.net/secrets/credentials",
        "secretStoreType": "AzureKeyVault"
      },
      "objectType": "SecretStoreBasedAuthCredentials"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/Backupvaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "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"
  }
}

Risposta di esempio

Codice di stato:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Codice di stato:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Codice di stato:: 200

{
  "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/harshitbi2",
  "name": "harshitbi2",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "harshitbi2",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest/databases/testdb",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "testdb",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest/providers/Microsoft.DBforPostgreSQL/servers/viveksipgtest",
      "resourceUri": "",
      "datasourceType": "OssDB",
      "resourceName": "viveksipgtest",
      "resourceType": "OssDB",
      "resourceLocation": "",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupPolicies/PratikPolicy1",
      "policyVersion": "3.2",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore",
            "resourceGroupId": "/subscriptions/f75d8d8b-6735-4697-82e1-1a7a3ff0d5d4/resourceGroups/viveksipgtest"
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Esempio di richiesta

HTTP

PUT https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi?api-version=2025-01-01

{
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourcegroups/aksrg/providers/Microsoft.DataProtection/BackupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "objectType": "BackupInstance"
  }
}

Risposta di esempio

Codice di stato:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/ZTA4YjQ0ZGYtYmNkNS00YTk1LWFjZTMtOTc1MjNmZWIxYWZlO2Y1ODg1MzA3LWJkNjItNDQ2OC05ZjZlLTJkMGM2NjNiNmJmNg==?api-version=2025-01-01
Retry-After: 60

{
  "id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
  "name": "aksbi",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioning",
    "objectType": "BackupInstance"
  }
}

Codice di stato:: 202

Azure-AsyncOperation: https://management.windowsazure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/operationStatus/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Location: https://management.windowsazure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi/operationResults/YWUzNDFkMzQtZmM5OS00MmUyLWEzNDMtZGJkMDIxZjlmZjgzOzdmYzBiMzhmLTc2NmItNDM5NS05OWQ1LTVmOGEzNzg4MWQzNA==?api-version=2025-01-01
Retry-After: 60

Codice di stato:: 200

{
  "id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupInstances/aksbi",
  "name": "aksbi",
  "type": "Microsoft.DataProtection/backupVaults/backupInstances",
  "tags": {
    "key1": "val1"
  },
  "properties": {
    "friendlyName": "aksbi",
    "dataSourceInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "resourceUri": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceName": "akscluster",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "Datasource"
    },
    "dataSourceSetInfo": {
      "resourceID": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.ContainerService/managedClusters/akscluster",
      "datasourceType": "Microsoft.ContainerService/managedclusters",
      "resourceType": "Microsoft.ContainerService/managedclusters",
      "resourceLocation": "eastus2euap",
      "objectType": "DatasourceSet"
    },
    "policyInfo": {
      "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg/providers/Microsoft.DataProtection/backupVaults/aksvault/backupPolicies/akspolicy",
      "policyParameters": {
        "dataStoreParametersList": [
          {
            "resourceGroupId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/aksrg",
            "objectType": "AzureOperationalStoreParameters",
            "dataStoreType": "OperationalStore"
          }
        ],
        "backupDatasourceParametersList": [
          {
            "objectType": "KubernetesClusterBackupDatasourceParameters",
            "includedNamespaces": [
              "test"
            ],
            "excludedNamespaces": [
              "kube-system"
            ],
            "includedResourceTypes": [],
            "excludedResourceTypes": [
              "v1/Secret"
            ],
            "includedVolumeTypes": [
              "AzureDisk",
              "AzureFileShareSMB"
            ],
            "labelSelectors": [],
            "snapshotVolumes": true,
            "includeClusterScopeResources": true
          }
        ]
      }
    },
    "protectionStatus": {
      "status": "NotProtected"
    },
    "provisioningState": "Provisioned",
    "objectType": "BackupInstance"
  }
}

Definizioni

Nome	Descrizione
AKSVolumeTypes	Ottiene o imposta la proprietà include tipi di volume. Questa proprietà imposta i tipi di volume da includere durante il backup.
AzureOperationalStoreParameters	Parametri per Operational-Tier Archivio dati
BackupInstance	Istanza di backup
BackupInstanceResource	BackupInstanceResource
BlobBackupDatasourceParameters	Parametri da usare durante la configurazione del backup dei BLOB
CloudError	CloudError
createdByType	Tipo di identità che ha creato la risorsa.
CurrentProtectionState	Specifica lo stato di protezione corrente della risorsa
Datasource	Origine dati
DatasourceSet	DatasourceSet
DataStoreTypes	tipo di archivio dati; Operational/Vault/Archive
DefaultResourceProperties	Proprietà di origine predefinite
Error	Risposta di errore di gestione delle risorse.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
IdentityDetails
InnerError	InnerError
KubernetesClusterBackupDatasourceParameters	Parametri per l'origine dati di backup del cluster Kubernetes
NamespacedNameResource	NamespacedNameResource
PolicyInfo	PolicyInfo
PolicyParameters	Parametri nei criteri
ProtectionStatusDetails	ProtectionStatusDetails
SecretStoreBasedAuthCredentials	Credenziali di autenticazione basate sull'archivio segreto.
SecretStoreResource	Classe che rappresenta una risorsa dell'archivio segreti.
SecretStoreType	Ottiene o imposta il tipo di archivio segreti
Status	Specifica lo stato di protezione della risorsa
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserFacingError	Oggetto errore usato dai livelli che hanno accesso al contenuto localizzato e propagano tale oggetto all'utente
ValidationType	Specifica il tipo di convalida. In caso di DeepValidation, tutte le convalide dell'API /validateForBackup verranno eseguite di nuovo.

AKSVolumeTypes

Ottiene o imposta la proprietà include tipi di volume. Questa proprietà imposta i tipi di volume da includere durante il backup.

Nome	Tipo	Descrizione
AzureDisk	string
AzureFileShareSMB	string

AzureOperationalStoreParameters

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

Istanza di backup

Nome	Tipo	Descrizione
currentProtectionState	CurrentProtectionState	Specifica lo stato di protezione corrente della risorsa
dataSourceInfo	Datasource	Origine dati Ottiene o imposta le informazioni sull'origine dati.
dataSourceSetInfo	DatasourceSet	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	PolicyInfo Ottiene o imposta le informazioni sui criteri.
protectionErrorDetails	UserFacingError	Specifica l'errore di protezione della risorsa
protectionStatus	ProtectionStatusDetails	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

Nome	Tipo	Descrizione
id	string	L'ID risorsa proxy rappresenta il percorso completo della risorsa.
name	string	Nome risorsa proxy associato alla risorsa.
properties	BackupInstance	Proprietà BackupInstanceResource
systemData	systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
tags	object	Tag risorsa proxy.
type	string	Tipo di risorsa proxy rappresenta il percorso completo del modulo Spazio dei nomi/ResourceType/ResourceType/...

BlobBackupDatasourceParameters

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

CloudError

Nome	Tipo	Descrizione
error	Error	Risposta di errore di gestione delle risorse.

createdByType

Tipo di identità che ha creato la risorsa.

Nome	Tipo	Descrizione
Application	string
Key	string
ManagedIdentity	string
User	string

CurrentProtectionState

Specifica lo stato di protezione corrente della risorsa

Nome	Tipo	Descrizione
BackupSchedulesSuspended	string
ConfiguringProtection	string
ConfiguringProtectionFailed	string
Invalid	string
NotProtected	string
ProtectionConfigured	string
ProtectionError	string
ProtectionStopped	string
RetentionSchedulesSuspended	string
SoftDeleted	string
SoftDeleting	string
UpdatingProtection	string

Datasource

Origine dati

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

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

tipo di archivio dati; Operational/Vault/Archive

Nome	Tipo	Descrizione
ArchiveStore	string
OperationalStore	string
VaultStore	string

DefaultResourceProperties

Proprietà di origine predefinite

Nome	Tipo	Descrizione
objectType	string: DefaultResourceProperties	Tipo dell'oggetto specifico : utilizzato per la deserializzazione

Error

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

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

IdentityDetails

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

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	InnerError Errore interno figlio, per consentire l'annidamento.

KubernetesClusterBackupDatasourceParameters

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

Nome	Tipo	Descrizione
name	string	Nome della risorsa
namespace	string	Spazio dei nomi in cui esiste la risorsa

PolicyInfo

Nome	Tipo	Descrizione
policyId	string
policyParameters	PolicyParameters	Parametri dei criteri per l'istanza di backup
policyVersion	string

PolicyParameters

Parametri nei criteri

Nome	Tipo	Descrizione
backupDatasourceParametersList	BackupDatasourceParameters[]: BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Ottiene o imposta i parametri dell'origine dati di backup
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Ottiene o imposta i parametri dell'archivio dati

ProtectionStatusDetails

Nome	Tipo	Descrizione
errorDetails	UserFacingError	Specifica l'errore di stato di protezione della risorsa
status	Status	Specifica lo stato di protezione della risorsa

SecretStoreBasedAuthCredentials

Credenziali di autenticazione basate sull'archivio segreto.

Nome	Tipo	Descrizione
objectType	string: SecretStoreBasedAuthCredentials	Tipo dell'oggetto specifico : utilizzato per la deserializzazione
secretStoreResource	SecretStoreResource	Risorsa dell'archivio segreti

SecretStoreResource

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

Ottiene o imposta il tipo di archivio segreti

Nome	Tipo	Descrizione
AzureKeyVault	string
Invalid	string

Status

Specifica lo stato di protezione della risorsa

Nome	Tipo	Descrizione
ConfiguringProtection	string
ConfiguringProtectionFailed	string
ProtectionConfigured	string
ProtectionStopped	string
SoftDeleted	string
SoftDeleting	string

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	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	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 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	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

Specifica il tipo di convalida. In caso di DeepValidation, tutte le convalide dell'API /validateForBackup verranno eseguite di nuovo.

Nome	Tipo	Descrizione
DeepValidation	string
ShallowValidation	string

Condividi tramite

Backup Instances - Create Or Update

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create BackupInstance

Esempio di richiesta

Risposta di esempio

Create BackupInstance to perform critical operation With MUA

Esempio di richiesta

Risposta di esempio

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Esempio di richiesta

Risposta di esempio

Definizioni

AKSVolumeTypes

AzureOperationalStoreParameters

BackupInstance

BackupInstanceResource

BlobBackupDatasourceParameters

CloudError

createdByType

CurrentProtectionState

Datasource

DatasourceSet

DataStoreTypes

DefaultResourceProperties

Error

ErrorAdditionalInfo

IdentityDetails

InnerError

KubernetesClusterBackupDatasourceParameters

NamespacedNameResource

PolicyInfo

PolicyParameters

ProtectionStatusDetails

SecretStoreBasedAuthCredentials

SecretStoreResource

SecretStoreType

Status

systemData

UserFacingError

ValidationType

Risorse aggiuntive