Abortar Ficheiro de Cópia

  • Artigo

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 Yes
NFS No

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.