Alibaba Cloud Model Studio:AddTable

Agregar una tabla para el conector de datos de tabla.

Descripción de la operación

• Los usuarios de RAM (subcuentas) deben obtener primero los permisos de API para Chinese China Bailian (requiere AliyunBailianDataFullAccess, que incluye el permiso sfm:AddTable) y unirse a un espacio de trabajo antes de llamar a esta API. Las cuentas de Alibaba Cloud (cuentas principales) pueden llamar a esta API directamente sin autorización. Le recomendamos que llame a esta API utilizando el SDK de Chinese China Bailian más reciente.
• Esta API no es idempotente.

Limitación: Esta API está sujeta a limitaciones cuando se llama con frecuencia. No exceda 10 llamadas por segundo. Si se activa la limitación, 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:AddTable	create	*Todos los recursos *	None	None

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
WorkspaceId	string	Sí	El ID del espacio de trabajo al que pertenece el archivo. Para obtener información sobre cómo obtener el ID del espacio de trabajo, consulte Cómo usar un espacio de trabajo.	llm-3shx2gu255oqxxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
TableName	string	Sí	El nombre de la tabla.	ads_wjjr_basc_enterprise_di
TableDesc	string	No	La descripción de la tabla.	descripción de la tabla
ConnectorId	string	Sí	El ID del conector.	connector-d51861492df64257
TableColumns	array<object>	Sí	La información de columnas de la tabla.
	object	Sí	La información de una sola columna.
ColumnName	string	Sí	El nombre de la columna.	columna1
ColumnDesc	string	No	La descripción de la columna.	desc
DataType	string	Sí	El tipo de datos.	string

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta
Code	string	El código de estado de error.	Index.Forbidden
Data	object	Los datos devueltos.
TableId	string	El ID de la tabla.	table_b6ddc67e7df14db38b74ef5e2e0fe24e_12792097
Message	string	El mensaje de error.	Falta el parámetro obligatorio (%s) o no es válido; compruebe los parámetros de la solicitud.
RequestId	string	El ID de la solicitud.	778C0B3B-03C1-5FC1-A947-36EDD13606AB
Status	string	El código de estado devuelto por la interfaz.	200
Success	boolean	Indica si la llamada a la API fue exitosa. Valores válidos: true: La llamada se realizó correctamente. false: La llamada falló.	True

Ejemplos

Respuesta exitosa

Formato JSON

{
  "Code": "Index.Forbidden",
  "Data": {
    "TableId": "table_b6ddc67e7df14db38b74ef5e2e0fe24e_12792097"
  },
  "Message": "Required parameter(%s) missing or invalid, please check the request parameters.",
  "RequestId": "778C0B3B-03C1-5FC1-A947-36EDD13606AB",
  "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.