Anular copiar archivo

  • Artículo

La Abort Copy File operación cancela una operación pendiente Copy File y deja un archivo de destino con una longitud cero y metadatos completos. Esta operación se aplica a la versión 2015-02-21 y posteriores.

Disponibilidad del protocolo

Protocolo de recurso compartido de archivos habilitado Disponible
SMB Sí
NFS No

Solicitud

Puede construir la Abort Copy File solicitud como se indica a continuación. Se recomienda HTTPS.

A partir de la versión 2013-08-15, puede especificar una firma de acceso compartido para el archivo de destino si se encuentra en la misma cuenta que el archivo de origen. A partir de la versión 2015-04-05, también puede especificar una firma de acceso compartido para el archivo de destino si se encuentra en otra cuenta de almacenamiento.

Método URI de solicitud Versión de HTTP
PUT https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id> HTTP/1.1

Reemplace los componentes de la ruta de acceso que se muestran en el URI de solicitud por los suyos de la siguiente manera:

Componente de ruta de acceso Descripción
myaccount El nombre de la cuenta de almacenamiento.
myshare El nombre del recurso compartido de archivos.
mydirectorypath Opcional. La ruta de acceso al directorio principal.
myfile Nombre del archivo.

Para más información sobre las restricciones de nomenclatura de rutas de acceso, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos.

Parámetros del identificador URI

Puede especificar el siguiente parámetro adicional en el URI de solicitud.

Parámetro Descripción
timeout Opcional. El parámetro de tiempo de espera se expresa en segundos. Para obtener más información, consulte Configuración de tiempos de espera para operaciones de Azure Files.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date o x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Esta operación solo está disponible en las versiones 2015-02-21 y posteriores.

Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-copy-action:abort Necesario.
x-ms-lease-id:<ID> Obligatorio si el archivo de destino tiene una concesión activa. Disponible para las versiones 2019-02-02 y posteriores.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor. Para obtener más información, vea Supervisar Azure Files.
x-ms-file-request-intent Obligatorio si Authorization el encabezado especifica un token de OAuth. El valor aceptable es backup. Este encabezado especifica que se debe conceder o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/actionMicrosoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action si se incluyen en la directiva de RBAC asignada a la identidad autorizada mediante el Authorization encabezado . Disponible para la versión 2022-11-02 y posteriores.
x-ms-allow-trailing-dot: { <Boolean> } Opcional. Versión 2022-11-02 y posteriores. El valor booleano especifica si se debe recortar o no un punto final presente en la dirección URL de la solicitud. Para obtener más información, consulte Nomenclatura y referencia a recursos compartidos, directorios, archivos y metadatos.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

status code

Una operación correcta devuelve el código de estado 204 (Sin contenido). Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también incluye otros encabezados HTTP estándar. Todos los encabezados estándar son conformes a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta Descripción
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud.
x-ms-version Indica la versión de Azure Files usada para ejecutar la solicitud.
Date o x-ms-date Valor de fecha y hora UTC que indica la hora a la que se inició la respuesta. El servicio genera este valor.
x-ms-client-request-id Puede usar este encabezado para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud. El valor es como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.

Response body

Ninguno.

Authorization

Solo el propietario de la cuenta puede llamar a esta operación.

Observaciones

Al cancelar una operación pendiente Copy File , el encabezado del archivo de x-ms-copy-status destino se establece aborteden . La cancelación de una operación de copia da como resultado un archivo de destino de longitud cero. Sin embargo, los metadatos del archivo de destino tendrán los nuevos valores copiados del blob o archivo de origen, o se establecerán explícitamente en la llamada a la Copy File operación.

Solo puede cancelar una operación de copia pendiente. Si se intenta cancelar una copia que se ha completado o se ha producido un error en conflicto, se producirá un error de conflicto. Al intentar cancelar una operación de copia mediante un identificador de copia incorrecto, también se produce un error de conflicto.