REST API kullanarak Azure Backup kasası oluşturma

  • Makale

Azure Backup'ın yeni Data Protection platformu depolama hesaplarındaki bloblar, yönetilen disk ve PostgreSQL sunucusunun PaaS platformu gibi daha yeni iş yükleri için yedekleme ve geri yükleme için gelişmiş özellikler sağlar. Yedeklemeleri düzenlemeyi kolaylaştırırken yönetim yükünü en aza indirmeyi amaçlar. 'Backup kasası', Veri koruma platformunun temel taşıdır ve bu , 'Kurtarma Hizmetleri' kasasından farklıdır.

REST API kullanarak Azure Backup kasası oluşturma adımları, kasa REST API'sini oluşturma belgelerinde özetlenmiştir. Şimdi bu belgeyi " Batı ABD" ve 'TestBkpVaultRG' kaynak grubu altında "testBkpVault" adlı bir kasa oluşturmak için başvuru olarak kullanalım.

bir Azure Backup kasası oluşturmak veya güncelleştirmek için aşağıdaki PUT işlemini kullanın.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/testBkpVault?api-version=2021-01-01

İstek oluşturma

PUT isteğini {subscription-id} oluşturmak için parametresi gereklidir. Birden çok aboneliğiniz varsa bkz. Birden çok abonelikle çalışma. Parametreleriyle api-version birlikte kaynaklarınız için bir {resourceGroupName} ve {vaultName} tanımlarsınız. Bu makalede kullanılır api-version=2021-01-01.

Aşağıdaki üstbilgiler gereklidir:

İstek üst bilgisi Açıklama
Content-Type: Gereklidir. application/json olarak ayarlayın.
Yetkilendirme: Gereklidir. Geçerli Bearer bir erişim belirteci olarak ayarlayın.

İsteği oluşturma hakkında daha fazla bilgi için bkz. REST API isteğinin/yanıtının bileşenleri.

İstek gövdesini oluşturma

İstek gövdesi oluşturmak için aşağıdaki yaygın tanımlar kullanılır:

Name Gerekli Tür Açıklama
Etag Dize İsteğe bağlı eTag
location true Dize Kaynak konumu
properties true BackupVault Kasanın özellikleri
Kimlik DPPIdentityDetails Her Azure kaynağı için benzersiz sistem tanımlayıcısını tanımlar
etiketler Nesne Kaynak etiketleri

Kasa adı ve kaynak grubu adının PUT URI'sinde sağlandığını unutmayın. İstek gövdesi konumu tanımlar.

Örnek istek gövdesi

Aşağıdaki örnek gövde, "Batı ABD" içinde bir kasa oluşturmak için kullanılır. Konumu belirtin.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "None"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Bir yedekleme kasası oluşturmak ve sistem tarafından atanan bir kimlik oluşturmak istiyorsanız, aşağıdaki istek gövdesi verilmelidir.

{
  "location": "WestUS",
  "tags": {
    "key1": "val1"
  },
  "identity": {
    "type": "systemAssigned"
  },
  "properties": {
    "storageSettings": [
      {
        "datastoreType": "VaultStore",
        "type": "LocallyRedundant"
      }
    ]
  }
}

Yanıtlar

Yedekleme kasası oluşturma işlemi zaman uyumsuz bir işlemdir. Bu, bu işlemin ayrı olarak izlenmesi gereken başka bir işlem oluşturduğu anlamına gelir. Backup kasası oluşturma veya güncelleştirme işlemi için iki başarılı yanıt vardır:

Ad Tür Açıklama
200 Tamam BackupVaultResource Tamam
201 Oluşturuldu BackupVaultResource Oluşturulan
Diğer durum kodları CloudError

REST API yanıtları hakkında daha fazla bilgi için bkz . Yanıt iletisini işleme.

Örnek yanıt

Önceki örnek istek gövdesinden oluşturulan sıkıştırılmış 201 yanıtı bir kimliğin atandığını ve provisioningState değerinin Başarılı olduğunu gösterir:

{
    "eTag": null,
    "id": "/subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourcegroups/TestBkpVaultRG/providers/Microsoft.DataProtection/BackupVaults/testBkpVault",
    "identity": {
      "principalId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "tenantId": "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "SystemAssigned"
    },
    "location": "westUS",
    "name": "testBkpVault",
    "properties": {
      "provisioningState": "Succeeded",
      "storageSettings": [
        {
          "datastoreType": "VaultStore",
          "type": "GeoRedundant"
        }
      ]
    },
    "resourceGroup": "TestBkpVaultRG",
    "systemData": null,
    "tags": {},
    "type": "Microsoft.DataProtection/backupVaults"
  }

Sonraki adımlar

Bu kasadaki blobları yedeklemek için bir yedekleme ilkesi oluşturun.

Azure REST API'leri hakkında daha fazla bilgi için aşağıdaki belgelere bakın: