Abortar Ficheiro de Cópia

A Abort Copy File operação cancela uma operação pendente Copy File e deixa um ficheiro de destino com comprimento zero e metadados completos. Esta operação aplica-se à versão 2015-02-21 e mais recente.

Disponibilidade do protocolo

Protocolo de partilha de ficheiros ativado	Disponível
SMB
NFS

Pedir

Pode construir o pedido da Abort Copy File seguinte forma. É recomendado HTTPS.

A partir da versão 2013-08-15, pode especificar uma assinatura de acesso partilhado para o ficheiro de destino se estiver na mesma conta que o ficheiro de origem. A partir da versão 2015-04-05, também pode especificar uma assinatura de acesso partilhado para o ficheiro de destino se estiver numa conta de armazenamento diferente.

Método	URI do pedido	Versão HTTP
PUT	https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=copy&copyid=<id>	HTTP/1.1

Substitua os componentes de caminho mostrados no URI do pedido pelo seu, da seguinte forma:

Componente caminho	Description
myaccount	O nome da sua conta de armazenamento.
myshare	O nome da partilha de ficheiros.
mydirectorypath	Opcional. O caminho para o diretório principal.
myfile	O nome do ficheiro.

Para obter detalhes sobre as restrições de nomenclatura de caminhos, veja Naming and referencing shares, directories, files, and metadata (Atribuir nomes e referenciar partilhas, diretórios, ficheiros e metadados).

Parâmetros do URI

Pode especificar o seguinte parâmetro adicional no URI do pedido.

Parâmetro	Description
timeout	Opcional. O parâmetro de tempo limite é expresso em segundos. Para obter mais informações, veja Setting timeouts for Ficheiros do Azure operations (Definir tempos limite para operações de Ficheiros do Azure).

Cabeçalhos do pedido

A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais.

Cabeçalho do pedido	Description
Authorization	Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
Date ou x-ms-date	Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
x-ms-version	Necessário para todos os pedidos autorizados. Especifica a versão da operação a utilizar para este pedido. Esta operação só está disponível nas versões 2015-02-21 e posteriores. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure.
x-ms-copy-action:abort	Obrigatório.
x-ms-lease-id:<ID>	Necessário se o ficheiro de destino tiver uma concessão ativa. Disponível para as versões 2019-02-02 e posteriores.
x-ms-client-request-id	Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar Ficheiros do Azure.
x-ms-file-request-intent	Necessário se o Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup. Este cabeçalho especifica que o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve ser concedido se estiver incluído na política RBAC atribuída à identidade autorizada com o Authorization cabeçalho. Disponível para a versão 2022-11-02 e posterior.
x-ms-allow-trailing-dot: { <Boolean> }	Opcional. Versão 2022-11-02 e posterior. O valor Booleano especifica se um ponto à direita presente no URL do pedido deve ser cortado ou não. Para obter mais informações, veja Naming and referencing shares, directories, files, and metadata (Atribuir nomes e referenciar partilhas, diretórios, ficheiros e metadados).

Corpo do pedido

Nenhum.

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de estado

Uma operação bem-sucedida devolve o código de estado 204 (Sem Conteúdo). Para obter informações sobre códigos de estado, veja Códigos de estado e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os seguintes cabeçalhos. A resposta também inclui cabeçalhos HTTP padrão adicionais. Todos os cabeçalhos padrão estão em conformidade com a especificação do protocolo HTTP/1.1.

Cabeçalho de resposta	Descrição
x-ms-request-id	Este cabeçalho identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido.
x-ms-version	Indica a versão do Ficheiros do Azure utilizado para executar o pedido.
Date ou x-ms-date	Um valor de data/hora UTC que indica a hora em que a resposta foi iniciada. O serviço gera este valor.
x-ms-client-request-id	Pode utilizar este cabeçalho para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho, se estiver presente no pedido. O valor é, no máximo, 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta.

Corpo da resposta

Nenhum.

Autorização

Apenas o proprietário da conta pode chamar esta operação.

Observações

Quando cancela uma operação pendente Copy File , o cabeçalho do ficheiro de x-ms-copy-status destino é definido como aborted. Cancelar uma operação de cópia resulta num ficheiro de destino de comprimento zero. No entanto, os metadados do ficheiro de destino terão os novos valores copiados do blob ou ficheiro de origem ou definidos explicitamente na chamada de Copy File operação.

Só pode cancelar uma operação de cópia pendente. Tentar cancelar uma cópia que tenha concluído ou falhado resulta num erro de conflito. Tentar cancelar uma operação de cópia com um ID de cópia incorreto também resulta num erro de conflito.