Bagikan melalui

Buat Akun Pencadangan Azure menggunakan REST API

Artikel ini menjelaskan cara membuat vault Backup menggunakan REST API. Anda juga dapat membuat vault Backup menggunakan portal Microsoft Azure.

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 {i>vault

Langkah-langkah untuk membuat Azure Backup vault menggunakan REST API diuraikan dalam dokumentasi membuat vault REST API. Mari kita gunakan dokumen ini guna referensi untuk membuat vault yang disebut testBkpVault di West US, dalam grup sumber daya TestBkpVaultRG.

Untuk membuat atau memperbarui vault 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.

Header berikut diperlukan:

Header permintaan Deskripsi
Jenis-Konten: Harus diisi. Atur ke application/json.
Otorisasi: Harus 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 Wajib Tipe Deskripsi
eTag string eTag opsional
lokasi benar string Lokasi sumber daya
Properti benar BackupVault Properti brankas
Identitas DPPIdentityDetails Mengidentifikasi pengidentifikasi sistem unik untuk setiap sumber daya pada Azure.
tag Objek Tag sumber daya

Perhatikan bahwa nama vault dan grup sumber daya tercantum di alamat URI PUT. Isi permintaan mendefinisikan lokasi.

Contoh isi permintaan

Berikut ini adalah contoh teks yang digunakan untuk membuat vault di "Amerika Serikat bagian Barat". Tentukan lokasinya.

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

Jika Anda ingin membuat brankas cadangan dan juga menghasilkan identitas yang ditetapkan oleh sistem, maka badan permintaan berikut harus disediakan.

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

Tanggapan

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

Nama Tipe Deskripsi
200 OK BackupVaultResource OKE
201 - Dibuat BackupVaultResource Dibuat
Kode status lainnya CloudError

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

Contoh tanggapan

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 cadangan untuk mencadangkan blob di vault ini.

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

  • Last updated on