Backup Instances - Create Or Update

Referenz

Dienst:: Data Protection

API-Version:: 2025-01-01

Erstellen oder Aktualisieren einer Sicherungsinstanz in einem Sicherungstresor

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}?api-version=2025-01-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
backupInstanceName	path	True	string	Der Name der Sicherungsinstanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string uuid	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
vaultName	path	True	string	Der Name des Sicherungstresors.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungsheader

Name	Erforderlich	Typ	Beschreibung
x-ms-authorization-auxiliary		string

Anforderungstext

Name	Typ	Beschreibung
properties	BackupInstance	BackupInstanceResource-Eigenschaften
tags	object	Proxyressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	BackupInstanceResource	OKAY
201 Created	BackupInstanceResource	Erstellt
202 Accepted		Angenommen Header Location: string Azure-AsyncOperation: string
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	identitätswechseln Sie Ihr Benutzerkonto.

Beispiele

Create BackupInstance

Create BackupInstance to perform critical operation With MUA

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Create BackupInstance

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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

Statuscode:: 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

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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

Statuscode:: 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

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
AKSVolumeTypes	Dient zum Abrufen oder Festlegen der Include Volume types -Eigenschaft. Diese Eigenschaft legt die Volumetypen fest, die während der Sicherung eingeschlossen werden sollen.
AzureOperationalStoreParameters	Parameter für Operational-Tier DataStore
BackupInstance	Sicherungsinstanz
BackupInstanceResource	BackupInstanceResource
BlobBackupDatasourceParameters	Parameter, die während der Konfiguration der Sicherung von Blobs verwendet werden sollen
CloudError	CloudError
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CurrentProtectionState	Gibt den aktuellen Schutzstatus der Ressource an.
Datasource	Datenquelle
DatasourceSet	DatasourceSet
DataStoreTypes	Art des Datenspeichers; Operational/Vault/Archive
DefaultResourceProperties	Standardquelleigenschaften
Error	Die Fehlerantwort für die Ressourcenverwaltung.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
IdentityDetails
InnerError	InnerError
KubernetesClusterBackupDatasourceParameters	Parameter für Kubernetes Cluster Backup Datasource
NamespacedNameResource	NamespacedNameResource
PolicyInfo	PolicyInfo
PolicyParameters	Parameter in Richtlinie
ProtectionStatusDetails	ProtectionStatusDetails
SecretStoreBasedAuthCredentials	Anmeldeinformationen für geheimen Speicherspeicher.
SecretStoreResource	Klasse, die eine Geheimspeicherressource darstellt.
SecretStoreType	Dient zum Abrufen oder Festlegen des Typs des geheimen Speichers.
Status	Gibt den Schutzstatus der Ressource an.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
UserFacingError	Fehlerobjekt, das von Layern verwendet wird, die Zugriff auf lokalisierte Inhalte haben und dies an den Benutzer weitergeben
ValidationType	Gibt den Typ der Überprüfung an. Bei DeepValidation werden alle Überprüfungen aus der /validateForBackup-API erneut ausgeführt.

AKSVolumeTypes

Enumeration

Dient zum Abrufen oder Festlegen der Include Volume types -Eigenschaft. Diese Eigenschaft legt die Volumetypen fest, die während der Sicherung eingeschlossen werden sollen.

Wert	Beschreibung
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Parameter für Operational-Tier DataStore

Name	Typ	Beschreibung
dataStoreType	DataStoreTypes	Art des Datenspeichers; Operational/Vault/Archive
objectType	string: AzureOperationalStoreParameters	Typ des spezifischen Objekts – wird für die Deserialisierung verwendet
resourceGroupId	string	Dient zum Abrufen oder Festlegen des Snapshot Resource Group URI.

BackupInstance

Object

Sicherungsinstanz

Name	Typ	Beschreibung
currentProtectionState	CurrentProtectionState	Gibt den aktuellen Schutzstatus der Ressource an.
dataSourceInfo	Datasource	Datenquelle Ruft die Datenquelleninformationen ab oder legt sie fest.
dataSourceSetInfo	DatasourceSet	DatasourceSet Ruft die Datenquellensatzinformationen ab oder legt sie fest.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Anmeldeinformationen, die für die Authentifizierung beim Datenquellenanbieter verwendet werden sollen.
friendlyName	string	Ruft den Anzeigenamen der Sicherungsinstanz ab oder legt diesen fest.
identityDetails	IdentityDetails	Enthält Informationen zu den Identitätsdetails für die BI. Wenn er null ist, wird der Standardwert als "System zugewiesen" betrachtet.
objectType	string
policyInfo	PolicyInfo	PolicyInfo Ruft die Richtlinieninformationen ab oder legt sie fest.
protectionErrorDetails	UserFacingError	Gibt den Schutzfehler der Ressource an.
protectionStatus	ProtectionStatusDetails	ProtectionStatusDetails Gibt den Schutzstatus der Ressource an.
provisioningState	string	Gibt den Bereitstellungsstatus der Ressource an, d. h. Bereitstellung/Aktualisierung/Erfolgreich/Fehlgeschlagen
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests, für die LAC-Überprüfung ausgeführt wird
validationType	ValidationType	Gibt den Typ der Überprüfung an. Bei DeepValidation werden alle Überprüfungen aus der /validateForBackup-API erneut ausgeführt.

BackupInstanceResource

Object

BackupInstanceResource

Name	Typ	Beschreibung
id	string	Die Proxyressourcen-ID stellt den vollständigen Pfad zur Ressource dar.
name	string	Der Name der Proxyressource, der der Ressource zugeordnet ist.
properties	BackupInstance	BackupInstanceResource-Eigenschaften
systemData	systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
tags	object	Proxyressourcentags.
type	string	Proxy Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/...

BlobBackupDatasourceParameters

Object

Parameter, die während der Konfiguration der Sicherung von Blobs verwendet werden sollen

Name	Typ	Beschreibung
containersList	string[]	Liste der Container, die während der Konfiguration der Sicherung von Blobs gesichert werden sollen
objectType	string: BlobBackupDatasourceParameters	Typ des spezifischen Objekts – wird für die Deserialisierung verwendet

CloudError

Object

CloudError

Name	Typ	Beschreibung
error	Error	Die Fehlerantwort für die Ressourcenverwaltung.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

CurrentProtectionState

Enumeration

Gibt den aktuellen Schutzstatus der Ressource an.

Wert	Beschreibung
BackupSchedulesSuspended
ConfiguringProtection
ConfiguringProtectionFailed
Invalid
NotProtected
ProtectionConfigured
ProtectionError
ProtectionStopped
RetentionSchedulesSuspended
SoftDeleted
SoftDeleting
UpdatingProtection

Datasource

Object

Datenquelle

Name	Typ	Beschreibung
datasourceType	string	DatasourceType der Ressource.
objectType	string	Typ des Datasource-Objekts, der zum Initialisieren des richtigen geerbten Typs verwendet wird
resourceID	string	Vollständige ARM-ID der Ressource. Bei Azure-Ressourcen ist dies ARM-ID. Bei Nicht-Azure-Ressourcen ist dies die ID, die vom Sicherungsdienst über Fabric/Vault erstellt wird.
resourceLocation	string	Speicherort der Datenquelle.
resourceName	string	Eindeutiger Bezeichner der Ressource im Kontext des übergeordneten Elements.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Eigenschaften, die für die Datenquelle spezifisch sind
resourceType	string	Ressourcentyp der Datenquelle.
resourceUri	string	URI der Ressource.

DatasourceSet

Object

DatasourceSet

Name	Typ	Beschreibung
datasourceType	string	DatasourceType der Ressource.
objectType	string	Typ des Datasource-Objekts, der zum Initialisieren des richtigen geerbten Typs verwendet wird
resourceID	string	Vollständige ARM-ID der Ressource. Bei Azure-Ressourcen ist dies ARM-ID. Bei Nicht-Azure-Ressourcen ist dies die ID, die vom Sicherungsdienst über Fabric/Vault erstellt wird.
resourceLocation	string	Speicherort der Datenquelle.
resourceName	string	Eindeutiger Bezeichner der Ressource im Kontext des übergeordneten Elements.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Eigenschaften, die für datenquellenspezifischen Satz spezifisch sind
resourceType	string	Ressourcentyp der Datenquelle.
resourceUri	string	URI der Ressource.

DataStoreTypes

Enumeration

Art des Datenspeichers; Operational/Vault/Archive

Wert	Beschreibung
ArchiveStore
OperationalStore
VaultStore

DefaultResourceProperties

Object

Standardquelleigenschaften

Name	Typ	Beschreibung
objectType	string: DefaultResourceProperties	Typ des spezifischen Objekts – wird für die Deserialisierung verwendet

Error

Object

Die Fehlerantwort für die Ressourcenverwaltung.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	Error[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorAdditionalInfo

Object

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

IdentityDetails

Object

Name	Typ	Beschreibung
useSystemAssignedIdentity	boolean	Gibt an, ob die BI durch Systemidentität geschützt ist.
userAssignedIdentityArmUrl	string	ARM-URL für Benutzer zugewiesene Identität.

InnerError

Object

InnerError

Name	Typ	Beschreibung
additionalInfo	object	Alle Schlüsselwertpaare, die dem Client zur Verfügung gestellt werden können, um weitere ausführliche Informationen zu erhalten.
code	string	Eindeutiger Code für diesen Fehler
embeddedInnerError	InnerError	InnerError Untergeordneter innerer Fehler, um die Schachtelung zuzulassen.

KubernetesClusterBackupDatasourceParameters

Object

Parameter für Kubernetes Cluster Backup Datasource

Name	Typ	Beschreibung
backupHookReferences	NamespacedNameResource[]	Ruft die Sicherungshakenverweise ab oder legt sie fest. Diese Eigenschaft legt den Hook-Verweis fest, der während der Sicherung ausgeführt werden soll.
excludedNamespaces	string[]	Dient zum Abrufen oder Festlegen der Exclude Namespaces -Eigenschaft. Diese Eigenschaft legt fest, dass die Namespaces während der Sicherung ausgeschlossen werden.
excludedResourceTypes	string[]	Dient zum Abrufen oder Festlegen der Eigenschaft "Ausschließen von Ressourcentypen". Diese Eigenschaft legt die Ressourcentypen fest, die während der Sicherung ausgeschlossen werden sollen.
includeClusterScopeResources	boolean	Dient zum Abrufen oder Festlegen der Include-Clusterressourcen-Eigenschaft. Diese Eigenschaft, wenn diese Option aktiviert ist, enthält Clusterbereichsressourcen während der Sicherung.
includedNamespaces	string[]	Dient zum Abrufen oder Festlegen der Include-Namespaces-Eigenschaft. Diese Eigenschaft legt die Namespaces fest, die während der Sicherung eingeschlossen werden sollen.
includedResourceTypes	string[]	Dient zum Abrufen oder Festlegen der Include-Ressourcentypen-Eigenschaft. Diese Eigenschaft legt die Ressourcentypen fest, die während der Sicherung eingeschlossen werden sollen.
includedVolumeTypes	AKSVolumeTypes[]	Dient zum Abrufen oder Festlegen der Include Volume types -Eigenschaft. Diese Eigenschaft legt die Volumetypen fest, die während der Sicherung eingeschlossen werden sollen.
labelSelectors	string[]	Dient zum Abrufen oder Festlegen der LabelSelectors -Eigenschaft. Diese Eigenschaft legt die Ressource mit solchen Bezeichnungsmarkierern fest, die während der Sicherung eingeschlossen werden sollen.
objectType	string: KubernetesClusterBackupDatasourceParameters	Typ des spezifischen Objekts – wird für die Deserialisierung verwendet
snapshotVolumes	boolean	Dient zum Abrufen oder Festlegen der Volumemomentaufnahmeeigenschaft. Diese Eigenschaft, wenn diese Option aktiviert ist, nimmt während der Sicherung Volumemomentaufnahmen auf.

NamespacedNameResource

Object

NamespacedNameResource

Name	Typ	Beschreibung
name	string	Name der Ressource
namespace	string	Namespace, in dem die Ressource vorhanden ist

PolicyInfo

Object

PolicyInfo

Name	Typ	Beschreibung
policyId	string
policyParameters	PolicyParameters	Richtlinienparameter für die Sicherungsinstanz
policyVersion	string

PolicyParameters

Object

Parameter in Richtlinie

Name	Typ	Beschreibung
backupDatasourceParametersList	BackupDatasourceParameters[]: BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Ruft die Parameter der Sicherungsdatenquelle ab oder legt diese fest.
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Dient zum Abrufen oder Festlegen der DataStore-Parameter

ProtectionStatusDetails

Object

ProtectionStatusDetails

Name	Typ	Beschreibung
errorDetails	UserFacingError	Gibt den Schutzstatusfehler der Ressource an.
status	Status	Gibt den Schutzstatus der Ressource an.

SecretStoreBasedAuthCredentials

Object

Anmeldeinformationen für geheimen Speicherspeicher.

Name	Typ	Beschreibung
objectType	string: SecretStoreBasedAuthCredentials	Typ des spezifischen Objekts – wird für die Deserialisierung verwendet
secretStoreResource	SecretStoreResource	Ressource für geheimen Speicher

SecretStoreResource

Object

Klasse, die eine Geheimspeicherressource darstellt.

Name	Typ	Beschreibung
secretStoreType	SecretStoreType	Dient zum Abrufen oder Festlegen des Typs des geheimen Speichers.
uri	string	URI zum Abrufen der Ressource
value	string	Dient zum Abrufen oder Festlegen des Werts, der in der Ressource für den geheimen Speicher gespeichert ist.

SecretStoreType

Enumeration

Dient zum Abrufen oder Festlegen des Typs des geheimen Speichers.

Wert	Beschreibung
AzureKeyVault
Invalid

Status

Enumeration

Gibt den Schutzstatus der Ressource an.

Wert	Beschreibung
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

systemData

Object

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserFacingError

Object

Fehlerobjekt, das von Layern verwendet wird, die Zugriff auf lokalisierte Inhalte haben und dies an den Benutzer weitergeben

Name	Typ	Beschreibung
code	string	Eindeutiger Code für diesen Fehler
details	UserFacingError[]	Weitere verwandte Fehler
innerError	InnerError	InnerError Innerer Fehler
isRetryable	boolean	Gibt an, ob der Vorgang erneut ausgeführt werden kann oder nicht.
isUserError	boolean	Gibt an, ob der Vorgang auf einen Benutzerfehler oder Dienstfehler zurückzuführen ist.
message	string
properties	object	Alle Schlüsselwertpaare, die innerhalb des Fehlerobjekts eingefügt werden können
recommendedAction	string[]	RecommendedAction lokalisiert.
target	string	Ziel des Fehlers.

ValidationType

Enumeration

Gibt den Typ der Überprüfung an. Bei DeepValidation werden alle Überprüfungen aus der /validateForBackup-API erneut ausgeführt.

Wert	Beschreibung
DeepValidation
ShallowValidation

Freigeben über

Backup Instances - Create Or Update

URI-Parameter

Anforderungsheader

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Create BackupInstance

Beispielanforderung

Beispiel für eine Antwort

Create BackupInstance to perform critical operation With MUA

Beispielanforderung

Beispiel für eine Antwort

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Beispielanforderung

Beispiel für eine Antwort

Definitionen

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

Zusätzliche Ressourcen