Alibaba Cloud Model Studio:AddConnector

Crea un conector. Esta API actualmente solo admite conectores de archivos.

Descripción de la operación

• Para llamar a esta operación, un usuario de RAM (subcuenta) debe tener primero los permisos de API necesarios para Model Studio y ser miembro de un espacio de negocio. Esto requiere la política AliyunBailianDataFullAccess, que incluye el permiso sfm:AddCategory. Una cuenta principal puede llamar a esta operación directamente sin autorización. Se recomienda utilizar la última versión del SDK de Model Studio para llamar a esta operación.
• Esta operación no es idempotente.

Limitación: No llame a esta operación más de 5 veces por segundo. Si una solicitud se limita, inténtelo de nuevo más tarde.

Probar ahora

Pruebe esta API en OpenAPI Explorer; no es necesaria la firma manual. Las llamadas exitosas generan automáticamente código SDK que coincide con sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Prueba

Autorización de RAM

La siguiente tabla describe la autorización necesaria para llamar a esta API. Puede definirla en una política de Resource Access Management (RAM). Las columnas de la tabla se detallan a continuación:

• Action: Las acciones se pueden utilizar en el elemento Action de las declaraciones de políticas de permisos de RAM para otorgar permisos para realizar la operación.

• API: La API que puede llamar para realizar la acción.

• Nivel de acceso: El nivel de acceso predefinido otorgado para cada API. Valores válidos: create, list, get, update y delete.

• Tipo de recurso: El tipo de recurso que admite la autorización para realizar la acción. Indica si la acción admite permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción. De lo contrario, la política será ineficaz.

  • Para las API con permisos a nivel de recurso, los tipos de recursos requeridos están marcados con un asterisco (*). Especifique el Nombre de recurso de Alibaba Cloud (ARN) correspondiente en el elemento Resource de la política.
  • Para las API sin permisos a nivel de recurso, se muestra como Todos los recursos. Utilice un asterisco (*) en el elemento Resource de la política.

• Clave de condición: Las claves de condición definidas por el servicio. La clave permite un control granular, aplicándose ya sea solo a las acciones o a las acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de claves de condición comunes aplicables a todos los servicios compatibles con RAM.

• Acción dependiente: Las acciones dependientes necesarias para ejecutar la acción. Para completar la acción, el usuario de RAM o el rol de RAM debe tener los permisos para realizar todas las acciones dependientes.

Acción	Nivel de acceso	Tipo de recurso	Clave de condición	Acción dependiente
sfm:AddConnector	create	*Todos los recursos *	None	None

Sintaxis de la solicitud

POST /{WorkspaceId}/datacenter/connector HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo que contiene la base de conocimientos.	llm-3shx2gu255oxxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ConnectorName	string	Sí	El nombre del conector.	test-connector
ConnectorType	string	Sí	El tipo de conector.	FILE
Description	string	Sí	La descripción del conector.	Conector de archivos
FileConnectorConfig	object	No	Los parámetros para el conector de archivos.
RegionId	string	No	La región del bucket.	cn-hangzhou
BucketName	string	No	El nombre del bucket.	zyb-docker-registry-jn
StorageType	string	No	La ubicación de almacenamiento de archivos. Valores válidos: OSS_CUSTOM: Utilice su propio bucket de Object Storage Service (OSS). OSS_PLATFORM: Utilice el bucket de OSS proporcionado por la plataforma.	OSS_CUSTOM

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	El objeto de respuesta.
Code	string	El código de error. Un valor de Success indica que la solicitud se realizó correctamente.	Éxito
Data	object	Los datos devueltos por la operación.
ConnectorId	string	El ID del conector.	conn_file_e0c9db4030b2465a9478028f7d76cd92_1234
Message	string	El mensaje de error.	El estado actual del archivo no admite la eliminación.
RequestId	string	El ID de la solicitud.	35A267BF-FBFA-54DB-8394-AA3B0742D833
Status	string	El código de estado HTTP.	200
Success	boolean	Indica si la solicitud se realizó correctamente. Valores válidos: true: La solicitud fue exitosa. false: La solicitud falló.	true

Ejemplos

Respuesta exitosa

Formato JSON

{
  "Code": "Success",
  "Data": {
    "ConnectorId": "conn_file_e0c9db4030b2465a9478028f7d76cd92_1234"
  },
  "Message": "Current file status does not support delete.",
  "RequestId": "35A267BF-FBFA-54DB-8394-AA3B0742D833",
  "Status": "200",
  "Success": true
}

Códigos de error

Consulte Códigos de error para obtener una lista completa.

Notas de lanzamiento

Consulte Notas de lanzamiento para obtener una lista completa.