一般的な HTTP 要求ヘッダーと応答ヘッダー (Azure AI Search)

Azure AI Search REST API では、一連の一般的な HTTP 要求/応答ヘッダーがサポートされています。参考のために以下にまとめられています。

要求ヘッダー 説明
Accept Content type 応答に対して要求されたコンテンツの種類。 既定値は application/json;odata.metadata=minimal です。 その他の許容値は application/json、application/json です。odata.metadata=full, application/json;odata.metadata=none、text/plain ($countのみ)。
api-key 文字列 API に応じて、 クエリまたは管理者キーに設定します。
authorization 文字列 要求の OAuth 2.0 アクセス トークン。 ロールベースのアクセスには、検索サービスへの構成が必要です。 この要求ヘッダーは、Microsoft Entra ID認証とロールの割り当てを使用するクライアント アプリ用です。 クライアント コードでトークンを指定する必要があります。 この要求ヘッダーは、検索サービスが データ プレーン認証用に構成されている限り、サポートされている REST API バージョンで使用できます。
Content-Type Content-Type 要求の本文 (PUT または POST) のコンテンツの種類。 既定値は application/json です。
client-request-id GUID 省略可能な呼び出し元指定の要求 ID(中かっこなどの装飾のない GUID の形式です (例: client-request-id: 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0)。 指定した要求を識別する、呼び出し元で定義された値。 指定した場合、この値は要求をマップする方法として応答情報に含まれます。
OData-MaxVersion "4.0" クライアントでサポートされている OData プロトコルの最大バージョンを指定します。 既定値は「4.0」です。
Prefer 「return=representation」または「return=minimal」 PUT や POST /indexes 要求から応答ペイロードを制御するために使用します。 POST または PUT を使用して新しいインデックスを作成する場合の既定値は "return=representation" で、PUT を使用して既存のインデックスを更新する場合は "return=minimal" です。
return-client-request-id に True または False client-request-id が指定されている場合にこれを指定すると、client-request-id ヘッダーを応答に含めるようにサーバーに指示します。 既定値は False です。
If-Match ETag または * 現在のバージョンが指定された ETag と一致する場合にのみ、リソースを変更するために使用されます。 このヘッダーを、リソース (インデクサー、インデックス、データ ソースなど、ドキュメントではなく) の POST、PUT、または DELETE メソッドと共に使用して、 オプティミスティック コンカレンシー制御を有効にします。
If-None-Match ETag または * 現在のバージョンが指定された ETag と一致しない場合にのみ、リソースを変更するために使用されます。 このヘッダーを、リソース (インデクサー、インデックス、データ ソースなど、ドキュメントではなく) の POST、PUT、または DELETE メソッドと共に使用して、 オプティミスティック コンカレンシー制御を有効にします。
応答ヘッダー 説明
client-request-id GUID 元の要求の呼び出し元によって指定された識別子 (存在する場合)。
Content-Type Content-Type 応答本文のコンテンツの種類。
場所 URL POST および PUT /indexes 要求用に新しく作成されたインデックス定義の URL。
OData-Version "4.0" 応答の OData プロトコルのバージョン。
request-id GUID 現在の操作の一意の識別子。 指定した場合は、client-request-id と同じです。それ以外の場合、値はサーバーで生成されます。
elapsed-time 数値 サービスが要求の処理に費やした時間 (ミリ秒単位)。 この値には、要求の処理に費やされた時間のみが含まれており、ネットワーク転送時間は含まれません。
ETag 文字列 リソースの現在のバージョンを表す不透明な文字列 (インデクサー、インデックス、データ ソースに対して返されますが、ドキュメントには返されません)。 オプティミスティック コンカレンシー制御には、この文字列を If-Match ヘッダーまたは If-None-Match ヘッダーで使用します。

こちらもご覧ください

Azure AI Search REST API