Backup Instances - Create Or Update

Reference

Služba:: Data Protection

Verze rozhraní API:: 2025-01-01

Vytvoření nebo aktualizace instance zálohování v trezoru záloh

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
backupInstanceName	path	True	string	Název instance zálohování.
resourceGroupName	path	True	string	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string uuid	ID cílového předplatného. Hodnota musí být UUID.
vaultName	path	True	string	Název trezoru záloh.
api-version	query	True	string	Verze rozhraní API, která se má použít pro tuto operaci.

Hlavička požadavku

Name	Vyžadováno	Typ	Description
x-ms-authorization-auxiliary		string

Text požadavku

Name	Typ	Description
properties	BackupInstance	Vlastnosti BackupInstanceResource
tags	object	Značky prostředků proxy serveru.

Odpovědi

Name	Typ	Description
200 OK	BackupInstanceResource	OK
201 Created	BackupInstanceResource	Vytvořil
202 Accepted		Přijal Hlavičky Location: string Azure-AsyncOperation: string
Other Status Codes	CloudError	Chybová odpověď popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnit váš uživatelský účet.

Příklady

Create BackupInstance

Create BackupInstance to perform critical operation With MUA

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Create BackupInstance

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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

Stavový kód:: 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

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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

Stavový kód:: 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"
  }
}

Definice

Name	Description
AKSVolumeTypes	Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.
AzureOperationalStoreParameters	Parametry úložiště dat Operational-Tier
BackupInstance	Instance zálohování
BackupInstanceResource	BackupInstanceResource
BlobBackupDatasourceParameters	Parametry, které se mají použít při konfiguraci zálohování objektů blob
CloudError	CloudError
createdByType	Typ identity, která prostředek vytvořila.
CurrentProtectionState	Určuje aktuální stav ochrany prostředku.
Datasource	Zdroj dat
DatasourceSet	Sada zdrojů dat
DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
DefaultResourceProperties	Výchozí vlastnosti zdroje
Error	Odpověď na chybu správy prostředků.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
IdentityDetails
InnerError	Vnitřní chyba
KubernetesClusterBackupDatasourceParameters	Parametry pro zdroj dat zálohování clusteru Kubernetes
NamespacedNameResource	NamespacedNameResource
PolicyInfo	PolicyInfo
PolicyParameters	Parametry v zásadách
ProtectionStatusDetails	ProtectionStatusDetails
SecretStoreBasedAuthCredentials	Přihlašovací údaje pro ověřování založené na úložišti tajných kódů.
SecretStoreResource	Třída představující prostředek úložiště tajných kódů
SecretStoreType	Získá nebo nastaví typ úložiště tajných kódů.
Status	Určuje stav ochrany prostředku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
UserFacingError	Objekt chyby používaný vrstvami, které mají přístup k lokalizovaného obsahu, a rozšířit ho na uživatele
ValidationType	Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

AKSVolumeTypes

Enumeration

Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.

Hodnota	Description
AzureDisk
AzureFileShareSMB

AzureOperationalStoreParameters

Object

Parametry úložiště dat Operational-Tier

Name	Typ	Description
dataStoreType	DataStoreTypes	typ úložiště dat; Provozní/ Trezor / Archiv
objectType	string: AzureOperationalStoreParameters	Typ konkrétního objektu – slouží k deserializaci
resourceGroupId	string	Získá nebo nastaví identifikátor URI skupiny prostředků snímku.

BackupInstance

Object

Instance zálohování

Name	Typ	Description
currentProtectionState	CurrentProtectionState	Určuje aktuální stav ochrany prostředku.
dataSourceInfo	Datasource	Zdroj dat Získá nebo nastaví informace o zdroji dat.
dataSourceSetInfo	DatasourceSet	Sada zdrojů dat Získá nebo nastaví informace o sadě zdrojů dat.
datasourceAuthCredentials	AuthCredentials: SecretStoreBasedAuthCredentials	Přihlašovací údaje, které se mají použít k ověření u poskytovatele zdroje dat.
friendlyName	string	Získá nebo nastaví popisný název instance zálohování.
identityDetails	IdentityDetails	Obsahuje informace opodrobnostch Pokud má hodnotu null, bude výchozí hodnota považována za přiřazenou systémem.
objectType	string
policyInfo	PolicyInfo	PolicyInfo Získá nebo nastaví informace o zásadách.
protectionErrorDetails	UserFacingError	Určuje chybu ochrany prostředku.
protectionStatus	ProtectionStatusDetails	ProtectionStatusDetails Určuje stav ochrany prostředku.
provisioningState	string	Určuje stav zřizování prostředku, tj. zřizování, aktualizace, úspěch nebo selhání.
resourceGuardOperationRequests	string[]	ResourceGuardOperationRequests, na které se provede kontrola LAC
validationType	ValidationType	Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

BackupInstanceResource

Object

BackupInstanceResource

Name	Typ	Description
id	string	ID prostředku proxy představuje úplnou cestu k prostředku.
name	string	Název prostředku proxy serveru přidružený k prostředku
properties	BackupInstance	Vlastnosti BackupInstanceResource
systemData	systemData	Metadata týkající se vytvoření a poslední změny prostředku.
tags	object	Značky prostředků proxy serveru.
type	string	Typ prostředku proxy představuje úplnou cestu k oboru názvů,ResourceType/ResourceType/...

BlobBackupDatasourceParameters

Object

Parametry, které se mají použít při konfiguraci zálohování objektů blob

Name	Typ	Description
containersList	string[]	Seznam kontejnerů, které se mají zálohovat během konfigurace zálohování objektů blob
objectType	string: BlobBackupDatasourceParameters	Typ konkrétního objektu – slouží k deserializaci

CloudError

Object

CloudError

Name	Typ	Description
error	Error	Odpověď na chybu správy prostředků.

createdByType

Enumeration

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

CurrentProtectionState

Enumeration

Určuje aktuální stav ochrany prostředku.

Hodnota	Description
BackupSchedulesSuspended
ConfiguringProtection
ConfiguringProtectionFailed
Invalid
NotProtected
ProtectionConfigured
ProtectionError
ProtectionStopped
RetentionSchedulesSuspended
SoftDeleted
SoftDeleting
UpdatingProtection

Datasource

Object

Zdroj dat

Name	Typ	Description
datasourceType	string	DatasourceType prostředku.
objectType	string	Typ objektu Datasource, který se používá k inicializaci zděděného typu vpravo
resourceID	string	Úplné ID ARM prostředku U prostředků Azure se jedná o ID ARM. V případě jiných prostředků než Azure to bude ID vytvořené službou backup prostřednictvím prostředků Fabric/Vault.
resourceLocation	string	Umístění zdroje dat
resourceName	string	Jedinečný identifikátor prostředku v kontextu nadřazeného objektu.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Vlastnosti specifické pro zdroj dat
resourceType	string	Typ zdroje dat
resourceUri	string	Identifikátor URI prostředku.

DatasourceSet

Object

Sada zdrojů dat

Name	Typ	Description
datasourceType	string	DatasourceType prostředku.
objectType	string	Typ objektu Datasource, který se používá k inicializaci zděděného typu vpravo
resourceID	string	Úplné ID ARM prostředku U prostředků Azure se jedná o ID ARM. V případě jiných prostředků než Azure to bude ID vytvořené službou backup prostřednictvím prostředků Fabric/Vault.
resourceLocation	string	Umístění zdroje dat
resourceName	string	Jedinečný identifikátor prostředku v kontextu nadřazeného objektu.
resourceProperties	BaseResourceProperties: DefaultResourceProperties	Vlastnosti specifické pro sadu zdrojů dat
resourceType	string	Typ zdroje dat
resourceUri	string	Identifikátor URI prostředku.

DataStoreTypes

Enumeration

typ úložiště dat; Provozní/ Trezor / Archiv

Hodnota	Description
ArchiveStore
OperationalStore
VaultStore

DefaultResourceProperties

Object

Výchozí vlastnosti zdroje

Name	Typ	Description
objectType	string: DefaultResourceProperties	Typ konkrétního objektu – slouží k deserializaci

Error

Object

Odpověď na chybu správy prostředků.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	Error[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorAdditionalInfo

Object

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

IdentityDetails

Object

Name	Typ	Description
useSystemAssignedIdentity	boolean	Určuje, jestli je BI chráněná identitou systému.
userAssignedIdentityArmUrl	string	Adresa URL ARM pro identitu přiřazenou uživatelem

InnerError

Object

Vnitřní chyba

Name	Typ	Description
additionalInfo	object	Všechny páry klíčových hodnot, které lze klientovi poskytnout pro další podrobné informace.
code	string	Jedinečný kód pro tuto chybu
embeddedInnerError	InnerError	Vnitřní chyba Podřízená vnitřní chyba, která umožňuje vnoření.

KubernetesClusterBackupDatasourceParameters

Object

Parametry pro zdroj dat zálohování clusteru Kubernetes

Name	Typ	Description
backupHookReferences	NamespacedNameResource[]	Získá nebo nastaví odkazy na zálohovací háky. Tato vlastnost nastaví odkaz na háku, který se má spustit během zálohování.
excludedNamespaces	string[]	Získá nebo nastaví vyloučit obory názvů vlastnost. Tato vlastnost nastaví obory názvů, které mají být vyloučeny během zálohování.
excludedResourceTypes	string[]	Získá nebo nastaví vlastnost vyloučit typy prostředků. Tato vlastnost nastaví typy prostředků, které mají být vyloučeny během zálohování.
includeClusterScopeResources	boolean	Získá nebo nastaví vlastnost zahrnout prostředky clusteru. Pokud je tato vlastnost povolená, bude během zálohování zahrnovat prostředky oboru clusteru.
includedNamespaces	string[]	Získá nebo nastaví include obory názvů vlastnost. Tato vlastnost nastaví obory názvů, které mají být zahrnuty během zálohování.
includedResourceTypes	string[]	Získá nebo nastaví zahrnout typ prostředku vlastnost. Tato vlastnost nastaví typy prostředků, které se mají zahrnout během zálohování.
includedVolumeTypes	AKSVolumeTypes[]	Získá nebo nastaví zahrnout typ svazku vlastnost. Tato vlastnost nastaví typy svazků, které mají být zahrnuty během zálohování.
labelSelectors	string[]	Získá nebo nastaví LabelSelectors vlastnost. Tato vlastnost nastaví prostředek s těmito selektory popisků, které se mají zahrnout během zálohování.
objectType	string: KubernetesClusterBackupDatasourceParameters	Typ konkrétního objektu – slouží k deserializaci
snapshotVolumes	boolean	Získá nebo nastaví vlastnost snímku svazku. Pokud je tato vlastnost povolená, pořídí snímky svazků během zálohování.

NamespacedNameResource

Object

NamespacedNameResource

Name	Typ	Description
name	string	Název prostředku
namespace	string	Obor názvů, ve kterém prostředek existuje

PolicyInfo

Object

PolicyInfo

Name	Typ	Description
policyId	string
policyParameters	PolicyParameters	Parametry zásad pro instanci zálohování
policyVersion	string

PolicyParameters

Object

Parametry v zásadách

Name	Typ	Description
backupDatasourceParametersList	BackupDatasourceParameters[]: BlobBackupDatasourceParameters[] KubernetesClusterBackupDatasourceParameters[]	Získá nebo nastaví parametry záložního zdroje dat.
dataStoreParametersList	DataStoreParameters[]: AzureOperationalStoreParameters[]	Získá nebo nastaví parametry úložiště dat.

ProtectionStatusDetails

Object

ProtectionStatusDetails

Name	Typ	Description
errorDetails	UserFacingError	Určuje chybu stavu ochrany prostředku.
status	Status	Určuje stav ochrany prostředku.

SecretStoreBasedAuthCredentials

Object

Přihlašovací údaje pro ověřování založené na úložišti tajných kódů.

Name	Typ	Description
objectType	string: SecretStoreBasedAuthCredentials	Typ konkrétního objektu – slouží k deserializaci
secretStoreResource	SecretStoreResource	Prostředek úložiště tajných kódů

SecretStoreResource

Object

Třída představující prostředek úložiště tajných kódů

Name	Typ	Description
secretStoreType	SecretStoreType	Získá nebo nastaví typ úložiště tajných kódů.
uri	string	Identifikátor URI pro přístup k prostředku
value	string	Získá nebo nastaví hodnotu uloženou v prostředku úložiště tajných kódů.

SecretStoreType

Enumeration

Získá nebo nastaví typ úložiště tajných kódů.

Hodnota	Description
AzureKeyVault
Invalid

Status

Enumeration

Určuje stav ochrany prostředku.

Hodnota	Description
ConfiguringProtection
ConfiguringProtectionFailed
ProtectionConfigured
ProtectionStopped
SoftDeleted
SoftDeleting

systemData

Object

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

UserFacingError

Object

Objekt chyby používaný vrstvami, které mají přístup k lokalizovaného obsahu, a rozšířit ho na uživatele

Name	Typ	Description
code	string	Jedinečný kód pro tuto chybu
details	UserFacingError[]	Další související chyby
innerError	InnerError	Vnitřní chyba Vnitřní chyba
isRetryable	boolean	Jestli bude operace opakovatelná, nebo ne
isUserError	boolean	Jestli je operace způsobená chybou uživatele nebo chybou služby
message	string
properties	object	Všechny páry klíč-hodnota, které je možné vloženého do objektu chyby
recommendedAction	string[]	Lokalizovaná doporučená akce.
target	string	Cíl chyby.

ValidationType

Enumeration

Určuje typ ověření. V případě DeepValidation se všechna ověření z rozhraní /validateForBackup API spustí znovu.

Hodnota	Description
DeepValidation
ShallowValidation

Sdílet prostřednictvím

Backup Instances - Create Or Update

Parametry identifikátoru URI

Hlavička požadavku

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Create BackupInstance

Ukázkový požadavek

Ukázková odpověď

Create BackupInstance to perform critical operation With MUA

Ukázkový požadavek

Ukázková odpověď

Create BackupInstance With KubernetesClusterBackupDatasourceParameters

Ukázkový požadavek

Ukázková odpověď

Definice

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

Další materiály