Réinitialiser les compétences (API REST en préversion)
S’applique à : 2023-07-01-Preview, 2021-04-30-Preview, 2020-06-30-Preview
Important
2023-07-01-Preview (aucune modification).
2021-04-30-Preview (aucune modification).
2020-06-30-Preview ajoute l’API. Il prend en charge les enrichissements mis en cache et les scénariosde réinitialisation.
La demande Réinitialiser les compétences traite de manière sélective une ou plusieurs compétences lors de la prochaine exécution de l’indexeur. Pour les indexeurs pour lesquels la mise en cache est activée, vous pouvez demander explicitement le traitement des mises à jour de compétences que l’indexeur ne peut pas détecter. Par exemple, si vous apportez des modifications externes, telles que des révisions à une compétence personnalisée, vous pouvez utiliser cette API pour réexécuter la compétence. Les sorties, telles qu’une base de connaissances ou un index de recherche, sont actualisées à l’aide de données réutilisables provenant du cache et du nouveau contenu selon la compétence mise à jour.
Vous pouvez réinitialiser un ensemble de compétences existant à l’aide d’un HTTP POST, en spécifiant le nom de l’ensemble de compétences à mettre à jour sur l’URI de la requête.
POST https://[servicename].search.windows.net/skillsets/[skillset name]/resetskills?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
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’ensemble de compétences | Obligatoire. L’URI de requête spécifie le nom de l’ensemble de compétences à réinitialiser. |
| api-version | Obligatoire. La préversion actuelle est 2023-07-01-Preview. 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 réinitialisation 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
Le corps de la requête est un groupe de noms de compétences.
{
"skillNames" : ["<SKILL-1>", "SKILL-n"]
}
response
Code d'état : 204 Pas de contenu en cas de réponse correcte.