Update Indexer (API REST Azure AI Search)
Vous pouvez mettre à jour une définition d’indexeur existante à l’aide d’une requête HTTP PUT. Spécifiez le nom de l’indexeur à mettre à jour sur l’URI de la demande :
PUT https://[service name].search.windows.net/indexers/[indexer name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
La mise à jour d’une définition d’indexeur ne l’exécute pas automatiquement, mais en fonction de vos modifications et de la source de données associée, une réinitialisation et une réexécution peuvent être nécessaires.
Paramètres URI
| Paramètre | Description |
|---|---|
| nom du service | Obligatoire. Définissez cette valeur sur le nom unique défini par l’utilisateur de votre service de recherche. |
| nom de l’indexeur | Obligatoire. L’URI de requête spécifie le nom de l’indexeur à mettre à jour. |
| api-version | Obligatoire. La version stable actuelle est api-version=2020-06-30. Pour plus d’informations sur les versions, consultez Versions de l’API . |
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires et facultatifs.
| Champs | Description |
|---|---|
| Content-Type | Obligatoire. À définir avec la valeur application/json |
| api-key | Facultatif si vous utilisez des rôles Azure et qu’un jeton de porteur est fourni sur la demande, sinon une clé est requise. Une clé API est une chaîne unique générée par le système qui authentifie la demande auprès de votre service de recherche. Les demandes de mise à jour doivent inclure un api-key en-tête défini sur votre clé d’administration (par opposition à une clé de requête). Pour plus d’informations, consultez Se connecter à Azure AI Search à l’aide de l’authentification par clé . |
Corps de la demande
La syntaxe du corps de la requête est la même que pour Créer un indexeur.
Lors de la mise à jour d’un indexeur existant, la définition entière est remplacée par le contenu du corps de la requête. En général, le meilleur modèle à utiliser pour les mises à jour consiste à récupérer la définition de l’indexeur avec un GET, à la modifier, puis à la mettre à jour avec PUT.
response
Pour une requête réussie : 201 Créé si un indexeur a été créé, et 204 Pas de contenu si un indexeur existant a été mis à jour.