Aracılığıyla paylaş

REST API kullanarak Azure Backup kasası oluşturma

Bu makalede, REST API kullanarak bir Backup kasasının nasıl oluşturulacağı açıklanır. Azure portalını kullanarak bir Backup kasası da oluşturabilirsiniz.

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 ek 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. Bu belgeyi, West US içinde ve TestBkpVaultRG adlı kaynak grubunun altında testBkpVault adında bir kasa oluşturmak için referans olarak kullanalım.

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{subscription-id}için parametresi gereklidir. Birden çok aboneliğiniz varsa bkz . Birden çok abonelikle çalışma. Parametreleriyle {resourceGroupName} birlikte kaynaklarınız için bir {vaultName} ve api-version tanımlarsınız. Bu makalede kullanılır api-version=2021-01-01.

Aşağıdaki üstbilgiler gereklidir:

İstek üst bilgisi Açıklama
İçerik Türü: Gerekli. application/json olarak ayarlayın.
Yetkilendirme: Gerekli. Geçerli bir Bearererişim belirtecine 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:

Veri Akışı Adı Zorunlu Türü Açıklama
e-Etiket Dize İsteğe bağlı eTag
konum doğru Dize Kaynak konumu
özellikler doğru 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 ayrıca 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:

Veri Akışı 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 gelen sıkıştırılmış 201 Oluşturuldu 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:

  • Last updated on