Documents - Get
Récupère un document à partir de l’index.
GET {endpoint}/indexes('{indexName}')/docs('{key}')?api-version=2023-11-01
GET {endpoint}/indexes('{indexName}')/docs('{key}')?$select={$select}&api-version=2023-11-01
Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
endpoint
|
path | True |
string |
URL du point de terminaison du service de recherche. |
|
index
|
path | True |
string |
Nom de l’index. |
|
key
|
path | True |
string |
Clé du document à récupérer. |
|
api-version
|
query | True |
string |
Version de l’API cliente. |
|
$select
|
query |
string[] |
Liste des noms de champs à récupérer pour le document ; Tout champ non récupéré est manquant dans le document retourné. |
En-tête de la demande
| Nom | Obligatoire | Type | Description |
|---|---|---|---|
| x-ms-client-request-id |
string (uuid) |
ID de suivi envoyé avec la demande pour faciliter le débogage. |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
Lookup |
Réponse contenant le document demandé. |
| Other Status Codes |
Réponse d’erreur. |
Exemples
SearchIndexGetDocument
Exemple de requête
GET https://myservice.search.windows.net/indexes('myindex')/docs('1')?$select=docId,title,description&api-version=2023-11-01
Exemple de réponse
{
"description": "Cheapest hotel in town",
"docId": "1",
"title": "Nice Hotel"
}
Définitions
SearchError
Décrit une condition d’erreur pour l’API.
| Nom | Type | Description |
|---|---|---|
| code |
string |
Un ensemble de codes d’erreur définis par le serveur. |
| details |
Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée. |
|
| message |
string |
Représentation lisible par l’homme de l’erreur. |