Buat vault Microsoft Azure Backup menggunakan REST API

  • Artikel

Platform Perlindungan Data baru Azure Backup menyediakan kemampuan yang ditingkatkan untuk pencadangan dan pemulihan untuk beban kerja yang lebih baru seperti blob di akun penyimpanan, disk terkelola, dan platform PaaS server PostgreSQL. Hal ini bertujuan untuk meminimalkan overhead manajemen sekaligus memudahkan mengatur cadangan. 'Vault Backup' adalah landasan platform perlindungan Data dan ini berbeda dari vault 'Layanan Pemulihan'.

Langkah-langkah untuk membuat vault Microsoft Azure Backup menggunakan REST API diuraikan dalam dokumentasi membuat vault REST API. Mari gunakan dokumen ini sebagai referensi untuk membuat vault yang disebut "testBkpVault" di "AS Barat" dan di bawah grup sumber daya 'TestBkpVaultRG'.

Untuk membuat atau memperbarui vault Microsoft Azure Backup, gunakan operasi PUT berikut.

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

Buat permintaan

Untuk membuat permintaan PUT,{subscription-id} parameter diperlukan. Jika Anda memiliki beberapa langganan, lihat Bekerja dengan beberapa langganan. Anda menentukan {resourceGroupName} dan {vaultName} untuk sumber daya Anda, bersama dengan api-version parameternya. Artikel ini menggunakan api-version=2021-01-01.

Kop berikut diperlukan:

Meminta kop Deskripsi
Jenis-Konten: Wajib diisi. Atur ke application/json.
Otorisasi: Wajib diisi. Atur ke Bearertoken akses yang valid.

Untuk informasi selengkapnya tentang cara membuat permintaan, lihat Komponen permintaan/respons REST API.

Buat isi permintaan

Berikut definisi umum yang digunakan untuk membuat isi permintaan:

Nama Diperlukan Jenis Deskripsi
eTag String eTag opsional
lokasi benar String Lokasi sumber daya
properti TRUE BackupVault Properti vault
Identitas DPPIdentityDetails Mengidentifikasi sistem unik untuk setiap sumber daya Azure
tag Objek Tag sumber daya

Perhatikan nama vault dan grup sumber daya disediakan di PUT URI. Isi permintaan mendefinisikan lokasi.

Contoh isi permintaan

Berikut contoh isi yang digunakan untuk membuat vault di "US Barat". Tentukan lokasinya.

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

Jika Anda ingin membuat vault cadangan dan juga menghasilkan identitas yang ditetapkan sistem, maka badan permintaan berikut harus diberikan.

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

Respons

Pembuatan vault cadangan adalah operasi asinkron. Hal ini berarti operasi tersebut menciptakan operasi lain yang perlu dilacak secara terpisah. Ada dua respons yang berhasil untuk operasi membuat atau memperbarui vault Microsoft Azure Backup:

Nama Jenis Deskripsi
200 OK BackupVaultResource OK
201 Dibuat BackupVaultResource Dibuat
Kode status lainnya CloudError

Untuk informasi selengkapnya tentang respons REST API, lihat Memproses pesan respons.

Contoh respons

Respons 201 Created yang diringkas dari contoh isi permintaan sebelumnya menunjukkan id telah ditetapkan dan provisioningStateberhasil:

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

Langkah berikutnya

Buat kebijakan pencadangan untuk mencadangkan blob di vault ini.

Untuk informasi selengkapnya tentang Azure REST API, lihat dokumen berikut ini: