Alibaba Cloud Model Studio:DeleteFile

Elimina permanentemente un archivo especificado de los datos de la aplicación. No se admite la eliminación de tablas de datos mediante la API. Para más detalles, consulte la Guía de la API a continuación.

Descripción de la operación

• No se admite la eliminación de tablas de datos mediante API. Para eliminar una tabla de datos o datos específicos dentro de una tabla, vaya a Datos de la aplicación para realizar la operación.
• Esta API se utiliza para eliminar archivos en Datos de la aplicación y no afecta a ninguna base de conocimientos que ya se haya creado. Para eliminar un archivo de una base de conocimientos, invoque la API DeleteIndexDocument.
• Un usuario de RAM debe obtener primero los permisos de API para Alibaba Cloud Model Studio (lo cual requiere AliyunBailianDataFullAccess, que incluye el punto de permiso sfm:DeleteFile) y unirse a un espacio de trabajo antes de invocar esta API. Una cuenta de Alibaba Cloud puede invocar esta API directamente sin autorización. Le recomendamos utilizar la versión más reciente del SDK de Alibaba Cloud Model Studio para invocar esta API.
• Esta API solo puede eliminar archivos cuyo estado sea Error de análisis (PARSE_FAILED) o Análisis exitoso (PARSE_SUCCESS).
• Esta API es idempotente.

Aviso de limitación de tasa:
La invocación frecuente de esta API activará la limitación de tasa. No exceda las 10 solicitudes por segundo. Si se limita la tasa, reinténtelo después de una breve espera.

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:DeleteFile	eliminar	*Todos los recursos *	None	None

Sintaxis de la solicitud

DELETE /{WorkspaceId}/datacenter/file/{FileId}/ HTTP/1.1

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
FileId	string	Sí	El ID del archivo, que es el FileId devuelto por la API AddFile. También puede obtenerlo en la página de Datos de la aplicación haciendo clic en el icono de ID junto al nombre del archivo.	file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx
WorkspaceId	string	Sí	El ID del espacio de trabajo al que pertenece el archivo. Para obtener información sobre cómo obtener el ID, consulte Cómo usar espacios de trabajo.	llm-3shx2gu255oxxxx

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo

No se requieren parámetros.

Elementos de respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta
Code	string	El código de estado de error.	InvalidParameter
Data	object	El campo de datos comerciales de la respuesta de la API.
FileId	string	El ID del archivo.	file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx
Message	string	El mensaje de error.	El estado actual del archivo no admite la eliminación.
RequestId	string	ID de la solicitud	17204B98-xxxx-4F9A-8464-2446A84821CA
Status	string	El código de estado devuelto por la API.	200
Success	boolean	Indica si la llamada a la API fue exitosa. Valores válidos: true: Exitoso. false: Fallido.	true

Ejemplos

Respuesta exitosa

Formato JSON

{
  "Code": "InvalidParameter",
  "Data": {
    "FileId": "file_9a65732555b54d5ea10796ca5742ba22_xxxxxxxx"
  },
  "Message": "Current file status does not support delete.",
  "RequestId": "17204B98-xxxx-4F9A-8464-2446A84821CA",
  "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.