Method: projects.locations.setUpDataConnector

Crée une Collection et configure le DataConnector correspondant. Pour arrêter un DataConnector après la configuration, utilisez la méthode CollectionService.DeleteCollection.

Requête HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}:setUpDataConnector

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Parent de Collection, au format projects/{project}/locations/{location}.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "collectionId": string,
  "collectionDisplayName": string,
  "dataConnector": {
    object (DataConnector)
  }
}
Champs
collectionId

string

Obligatoire. ID à utiliser pour le Collection, qui deviendra le composant final du nom de ressource du Collection. Une Collection est créée dans le cadre de la configuration du DataConnector. DataConnector est une ressource singleton sous Collection, qui gère tous les DataStores de la Collection.

Doit être conforme à la norme RFC-1034 avec une limite de 63 caractères. Sinon, une erreur INVALID_ARGUMENT est renvoyée.

collectionDisplayName

string

Obligatoire. Nom à afficher de la Collection.

Doit être lisible par un humain et utilisé pour afficher les collections dans le tableau de bord de la console. Chaîne encodée au format UTF-8 avec une limite de 1 024 caractères.

dataConnector

object (DataConnector)

Obligatoire. DataConnector à initialiser dans la Collection nouvellement créée.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.locations.setUpDataConnector

Pour en savoir plus, consultez la documentation IAM.