Mettre à jour la source de données (API REST Azure AI Search)
Remplace une définition de source de données existante par une version révisée.
PUT https://[service name].search.windows.net/datasources/[data source name]?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 source de données | Obligatoire. L’URI de requête spécifie le nom de la source de données à mettre à jour. |
| api-version | Obligatoire. La version stable actuelle est api-version=2020-06-30. Pour plus d’informations, 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 une source de données.
Lors de la mise à jour d’une source de données existante, 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 source de données avec un GET, à la modifier, puis à la mettre à jour avec PUT.
response
Pour une demande réussie : 201 Créé si une nouvelle source de données a été créée et 204 Aucun contenu si une source de données existante a été mise à jour
Notes
Certaines propriétés ne peuvent pas être mises à jour dans une source de données existante. Par exemple, vous ne pouvez pas modifier le type d'une source de données existante.