Parameter dan header umum
Informasi berikut umum untuk semua operasi yang mungkin Anda lakukan pada sumber daya Key Vault:
- Header HTTP
Host
harus selalu ada dan harus menentukan nama host vault. Contoh:Host: contoso.vault.azure.net
. Perhatikan bahwa sebagian besar teknologi klien mengisi headerHost
dari URI. Misalnya,GET https://contoso.vault.azure.net/secrets/mysecret{...}
akan mengaturHost
sebagaicontoso.vault.azure.net
. Jika Anda mengakses Key Vault menggunakan alamat IP mentah sepertiGET https://10.0.0.23/secrets/mysecret{...}
, nilaiHost
header otomatis akan salah, dan Anda harus memastikan bahwaHost
header berisi nama host vault secara manual. - Ganti
{api-version}
dengan api-version di URI. - Ganti
{subscription-id}
dengan pengidentifikasi langganan Anda di URI - Ganti
{resource-group-name}
dengan grup sumber daya. Untuk informasi selengkapnya, lihat Menggunakan Grup sumber daya untuk mengelola sumber daya Azure Anda. - Ganti
{vault-name}
dengan nama brankas kunci Anda di URI. - Atur header Jenis-Konten ke aplikasi/json.
- Atur header Otorisasi ke JSON Web Token yang Anda peroleh dari ID Microsoft Entra. Untuk informasi selengkapnya, lihat Permintaan mengautentikasi Azure Resource Manager.
Respons kesalahan umum
Layanan ini akan menggunakan kode status HTTP untuk menunjukkan keberhasilan atau kegagalan. Selain itu, kegagalan berisi respons dalam format berikut:
{
"error": {
"code": "BadRequest",
"message": "The key vault sku is invalid."
}
}
Nama elemen | Tipe | Deskripsi |
---|---|---|
kode | string | Jenis kesalahan yang terjadi. |
pesan | string | Deskripsi penyebab kesalahan. |