Bagikan melalui

Header

  • Artikel

Artikel ini menyediakan tautan ke halaman referensi untuk header yang digunakan dengan REST API Azure App Configuration.

Header Permintaan

Tabel berikut ini menjelaskan header permintaan umum yang digunakan dalam Azure App Configuration.

Header Deskripsi Contoh
Authorization Digunakan untuk mengautentikasi permintaan ke layanan. Lihat bagian 14.8 Authorization: HMAC-SHA256 Credential=<Credential>&SignedHeaders=Host;x-ms-date;x-ms-content-sha256&Signature=<Signature>
Terima Memberi tahu server jenis media apa yang akan diterima klien dalam respons HTTP. Lihat bagian 14.1 Accept: application/vnd.microsoft.appconfig.kv+json;
Terima-Tanggalwaktu Meminta server untuk menampilkan kontennya sebagai representasi dari keadaan sebelumnya. Nilai header ini adalah tanggalwaktu yang diminta dari status tersebut. Lihat RFC 7089 Accept-Datetime: Sat, 12 May 2018 02:10:00 GMT
Jenis-Konten Berisi jenis media konten dalam isi permintaan HTTP. Lihat bagian 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
Tanggal Tanggalwaktu permintaan HTTP dikeluarkan. Header ini digunakan dalam autentikasi HMAC. Lihat bagian 14.18 Date: Fri, 11 May 2018 18:48:36 GMT
Host Menentukan penyewa untuk permintaan yang telah dikeluarkan. Header ini digunakan dalam autentikasi HMAC. Lihat bagian 14.23 Host: contoso.azconfig.io
If-Match Digunakan untuk membuat permintaan HTTP kondisional. Permintaan ini seharusnya hanya berhasil jika ETag sumber daya yang ditargetkan cocok dengan nilai header ini. Nilai '*' cocok dengan ETag apa pun. Lihat bagian 14.24 If-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
If-None-Match Digunakan untuk membuat permintaan HTTP kondisional. Permintaan ini seharusnya hanya berhasil jika ETag sumber daya yang ditargetkan tidak cocok dengan nilai header ini. Nilai '*' cocok dengan ETag apa pun. Lihat bagian 14.26 If-None-Match: "4f6dd610dd5e4deebc7fbaef685fb903"
Sync-Token Digunakan untuk mengaktifkan konsistensi real time selama urutan permintaan. Sync-Token: jtqGc1I4=MDoyOA==;sn=28
x-ms-client-request-id ID unik yang disediakan oleh klien yang digunakan untuk melacak suatu perjalanan dua arah permintaan. x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
x-ms-content-sha256 Hash sha256 dari isi permintaan HTTP. Header ini digunakan dalam autentikasi HMAC. x-ms-content-sha256: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
x-ms-date Header ini dapat diatur dan digunakan untuk menggantikan header Date jika header tanggal tidak dapat diakses. Header ini digunakan dalam autentikasi HMAC. x-ms-date: Fri, 11 May 2018 18:48:36 GMT
x-ms-return-client-request-id Digunakan bersama dengan header x-ms-client-request-id. Jika nilai header ini 'true', maka server akan diinstruksikan untuk menampilkan nilai header permintaan x-ms-client-request-id. x-ms-return-client-request-id: true

Header Respons

Server bisa menyertakan header HTTP berikut ini dalam respon yang diberikan.

Header Deskripsi Contoh
Jenis-Konten Berisi tipe media konten dalam isi permintaan HTTP. Lihat bagian 14.17 Content-Type: application/vnd.microsoft.appconfig.kv+json; charset=utf-8;
ETag Token buram yang mewakili status sumber daya yang diberikan. Dapat digunakan dalam operasi kondisional. Lihat bagian 14.19 ETag: "4f6dd610dd5e4deebc7fbaef685fb903"
Terakhir-Diubah Menjelaskan kapan sumber daya yang diminta terakhir diubah. Diformat sebagai Tanggal-HTTP. Lihat bagian 14.29 Last-Modified: Tue, 05 Dec 2017 02:41:26 GMT
Tautan Menyediakan tautan ke sumber daya yang terkait dengan respons. Header ini digunakan untuk penomoran halaman dengan menggunakan tautan berikutnya. Lihat RFC 5988 Link: </kv?after={token}>; rel="next"
Tanggalwaktu-Memento Menunjukkan bahwa konten yang terkandung dalam respons mewakili status sebelumnya. Nilai header ini adalah tanggalwaktu dari status tersebut. Lihat RFC 7089 Memento-Datetime: Sat, 12 May 2018 02:10:00 GMT
retry-after-ms Menyediakan periode yang disarankan (dalam milidetik) untuk durasi waktu tunggu klien sebelum mencoba kembali permintaan yang gagal. retry-after-ms: 10
x-ms-request-id ID unik yang dihasilkan oleh server yang digunakan untuk melacak permintaan dalam layanan. x-ms-request-id: 00000000-0000-0000-0000-000000000000
WWW-Authenticate Digunakan untuk memberi tantangan kepada klien untuk autentikasi dan memberikan alasan mengapa upaya autentikasi gagal. Lihat bagian 14.47 WWW-Authenticate: HMAC-SHA256 error="invalid_token" error_description="Invalid Signature"