Todos los productos
Search
Centro de documentos

:DeleteFile

Última actualización: Sep 04, 2026

Elimina un archivo de DataStudio. Si el archivo ya se confirmó, se activa un proceso asíncrono para eliminarlo del sistema de programación. Use el valor del parámetro DeploymentId devuelto para llamar a la operación GetDeployment y consultar el estado del proceso asíncrono.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDKs.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

DeleteFile

La operación que desea ejecutar.

ProjectId

Long

No

10000

El ID del espacio de trabajo de DataWorks. Inicie sesión en la DataWorks console y vaya a la página Work space para obtener el ID del espacio de trabajo.

Configure este parámetro o el parámetro ProjectIdentifier para determinar el espacio de trabajo de DataWorks al que se aplica la operación.

ProjectIdentifier

String

No

dw_project

El nombre del espacio de trabajo de DataWorks. Inicie sesión en la DataWorks console y vaya a la página Work space para obtener el nombre del espacio de trabajo.

Configure este parámetro o el parámetro ProjectId para determinar el espacio de trabajo de DataWorks al que se aplica la operación.

FileId

Long

Sí

10000001

El ID del archivo. Llame a la operación ListFiles para consultar el ID del archivo.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

HttpStatusCode

Integer

200

El código de estado HTTP.

DeploymentId

Long

1000000001

El ID del paquete de despliegue utilizado para desplegar el archivo. Si el archivo ya se confirmó, se activa un proceso asíncrono para eliminarlo del sistema de programación. Use el valor de este parámetro para llamar a la operación GetDeployment y consultar el estado del proceso asíncrono.

Si este parámetro está vacío, el archivo se elimina y no es necesario consultar el estado.

RequestId

String

0000-ABCD-EFG****

El ID de la solicitud.

ErrorMessage

String

The connection does not exist.

El mensaje de error.

Success

Boolean

true

Indica si la solicitud fue exitosa. Valores válidos:

  • true

  • false

ErrorCode

String

Invalid.Tenant.ConnectionNotExists

El código de error.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=DeleteFile
&ProjectId=10000
&ProjectIdentifier=dw_project
&FileId=10000001
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteFileResponse>
    <HttpStatusCode>200</HttpStatusCode>
    <DeploymentId>1000000001</DeploymentId>
    <RequestId>0000-ABCD-EFG****</RequestId>
    <ErrorMessage>The connection does not exist.</ErrorMessage>
    <Success>true</Success>
    <ErrorCode>Invalid.Tenant.ConnectionNotExists</ErrorCode>
</DeleteFileResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "HttpStatusCode" : 200,
  "DeploymentId" : 1000000001,
  "RequestId" : "0000-ABCD-EFG****",
  "ErrorMessage" : "The connection does not exist.",
  "Success" : true,
  "ErrorCode" : "Invalid.Tenant.ConnectionNotExists"
}

Códigos de error

Código de estado HTTP

Código de error

Mensaje de error

Descripción

403

Forbidden.Access

Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.

Sin permisos.

429

Throttling.Api

The request for this resource has exceeded your available limit.

El número de solicitudes para el recurso ha superado el límite superior.

429

Throttling.System

The DataWorks system is busy. Try again later.

El sistema de DataWorks está ocupado. Inténtelo de nuevo más tarde.

429

Throttling.User

Your request is too frequent. Try again later.

Se han enviado demasiadas solicitudes en un periodo corto. Inténtelo de nuevo más tarde.

500

InternalError.System

An internal system error occurred. Try again later.

Ocurrió un error interno del sistema. Inténtelo de nuevo más tarde.

500

InternalError.UserId.Missing

An internal system error occurred. Try again later.

Ocurrió un error interno del sistema. Inténtelo de nuevo más tarde.

Para obtener una lista de códigos de error, consulte los Códigos de error del servicio.