Ler em inglês

Partilhar via


Copiar ficheiro

A operação Copy File copia um blob ou arquivo para um arquivo de destino dentro da conta de armazenamento. Esta operação é suportada na versão 2015-02-21 e posterior para Partilhas de Ficheiros com protocolo SMB ativado e suportada na versão 2025-05-05 e posterior para Partilhas de Ficheiros com protocolo NFS ativado.

Disponibilidade do protocolo

Protocolo de compartilhamento de arquivos habilitado Disponível
PME Sim
NFS Sim

Solicitar

A solicitação Copy File é construída da seguinte forma. Recomendamos que você use HTTPS.

A partir da versão 2013-08-15, você pode especificar uma assinatura de acesso compartilhado para o arquivo de destino se ele estiver na mesma conta do arquivo de origem. A partir da versão 2015-04-05, você também pode especificar uma assinatura de acesso compartilhado para o arquivo de destino se ele estiver em uma conta de armazenamento diferente.

Método Solicitar URI Versão HTTP
COLOCAR https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile HTTP/1.1

Substitua os componentes de caminho mostrados no URI de solicitação pelo seu, da seguinte maneira:

Componente Caminho Descrição
myaccount O nome da sua conta de armazenamento.
myshare O nome do seu compartilhamento de arquivos.
mydirectorypath Opcional. O caminho para o diretório pai.
myfile O nome do arquivo.

Para obter detalhes sobre restrições de nomenclatura de caminho, consulte Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados.

Parâmetros de URI

Você pode especificar os seguintes parâmetros adicionais no URI de solicitação:

Parâmetro Descrição
timeout Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações do Azure Files.

Cabeçalhos de solicitação

Os cabeçalhos de solicitação obrigatórios e opcionais são descritos nas tabelas a seguir:

Cabeçalhos de solicitação comuns

Cabeçalho da solicitação Descrição
Authorization Necessário. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
Date ou x-ms-date Necessário. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
x-ms-version Obrigatório para todos os pedidos autorizados. Especifica a versão da operação a ser usada para essa solicitação. Esta operação é suportada na versão 2015-02-21 e posterior para Partilhas de Ficheiros com protocolo SMB ativado e suportada na versão 2025-05-05 e posterior para Partilhas de Ficheiros com protocolo NFS ativado.

Para obter mais informações, consulte controle de versão para os serviços de Armazenamento do Azure.
x-ms-meta-name:value Opcional. Especifica os pares nome/valor associados ao arquivo como metadados. Se nenhum par nome/valor for especificado, a operação copiará os metadados do blob ou arquivo de origem para o arquivo de destino. Se um ou mais pares nome/valor forem especificados, o arquivo de destino será criado com os metadados especificados e os metadados não serão copiados do blob ou arquivo de origem. Os nomes de metadados devem aderir às regras de nomenclatura para identificadores C#.

Os metadados de ficheiro especificados através dos Ficheiros do Azure não estão acessíveis a partir de um cliente SMB.
x-ms-copy-source:name Necessário. Especifica a URL do arquivo de origem ou blob, com até 2 kibibytes (KiB) de comprimento.

Para copiar um arquivo para outro arquivo dentro da mesma conta de armazenamento, você pode usar uma chave compartilhada para autorizar o arquivo de origem. Se estiver copiando um arquivo de outra conta de armazenamento ou se estiver copiando um blob da mesma conta de armazenamento ou de outra conta de armazenamento, você deverá autorizar o arquivo de origem ou blob usando uma assinatura de acesso compartilhado. Se a origem for um blob público, nenhuma autorização será necessária para executar a operação de cópia. Você também pode especificar um arquivo em um instantâneo de compartilhamento como uma fonte de cópia.

Aqui estão alguns exemplos de URLs de objeto de origem:
  • https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile
  • https://myaccount.blob.core.windows.net/mycontainer/myblob?sastoken
  • http://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sharesnapshot=<DateTime>
x-ms-lease-id:<ID> Necessário se o arquivo de destino tiver uma concessão ativa. Disponível para a versão 2019-02-02 e posterior. A ID de concessão especificada para este cabeçalho deve corresponder à ID de concessão do arquivo de destino. Se a solicitação não incluir o ID de concessão ou se o ID não for válido, a operação falhará com o código de status 412 (Falha na pré-condição).

Se esse cabeçalho for especificado e o arquivo de destino não tiver uma concessão ativa no momento, a operação falhará com o código de status 412 (Falha na pré-condição).

Esse cabeçalho será ignorado se o arquivo de destino estiver localizado em um compartilhamento de arquivos com o protocolo NFS habilitado, que não oferece suporte a concessões de arquivos.
x-ms-file-creation-time Opcional. Disponível para a versão 2019-07-07 e posterior. Este cabeçalho especifica a propriedade para o tempo de criação, em UTC, a ser definida no arquivo de destino. Você pode usar um valor de source para copiar o tempo de criação do arquivo de origem para o arquivo de destino.
x-ms-file-last-write-time Opcional. Disponível para a versão 2019-07-07 e posterior. Este cabeçalho especifica a propriedade para a última hora de gravação, em UTC, a ser definida no arquivo de destino. Você pode usar um valor de source para copiar a última hora de gravação do arquivo de origem para o arquivo de destino.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 KiB que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações que o servidor recebe. Para obter mais informações, consulte Monitor Azure Blob Storage.
x-ms-file-request-intent Obrigatório se Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup. Este cabeçalho especifica que os Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action devem ser concedidos se forem incluídos na política RBAC atribuída à identidade autorizada usando o cabeçalho Authorization. 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 na url da solicitação deve ser cortado ou não.

Esse cabeçalho será ignorado se o destino estiver localizado em um compartilhamento de arquivos com o protocolo NFS habilitado, que oferece suporte a pontos à direita por padrão.

Para obter mais informações, consulte Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados.
x-ms-source-allow-trailing-dot: { <Boolean> } Opcional. Versão 2022-11-02 e posterior. O valor booleano especifica se um ponto à direita presente na url de origem deve ser cortado ou não. Esse cabeçalho deve ser especificado somente se a fonte de cópia estiver localizada em um Compartilhamento de Arquivos do Azure. Este cabeçalho não é suportado para nenhum outro tipo de fonte de cópia.

Esse cabeçalho será ignorado se a fonte da cópia estiver localizada em um compartilhamento de arquivos com o protocolo NFS habilitado, que suporta ponto à direita por padrão.

Para obter mais informações, consulte Nomeando e referenciando compartilhamentos, diretórios, arquivos e metadados.

Cabeçalhos de solicitação somente SMB

Cabeçalho da solicitação Descrição
x-ms-file-change-time: { <DateTime> ¦ source } Opcional. Versão 2021-06-08 e posterior. A propriedade UTC change time para o arquivo, formatada no formato ISO 8601. Um valor de source pode ser usado para copiar o tempo de alteração do arquivo de origem para o arquivo de destino. O carimbo de data/hora padrão é a hora da solicitação.
x-ms-file-permission-copy-mode: { source ¦ override } Opcional. Disponível para a versão 2019-07-07 e posterior. Determina o comportamento de cópia do descritor de segurança do arquivo:
  • source: O descritor de segurança no arquivo de destino é copiado do arquivo de origem.
  • override: O descritor de segurança no ficheiro de destino é determinado através do cabeçalho x-ms-file-permission ou x-ms-file-permission-key.
x-ms-file-permission: { <SDDL> ¦ <binary> } Obrigatório se x-ms-file-permission-copy-mode for especificado como override e x-ms-file-permission-key não for especificado. Disponível para a versão 2019-07-07 e posterior. Essa permissão é o descritor de segurança para o arquivo especificado no Security Descriptor Definition Language (SDDL) ou (versão 2025-01-05 ou posterior) no formato de descritor de segurança binário codificado em base64. Você pode especificar qual formato usar com o cabeçalho x-ms-file-permission-format. Você pode usar esse cabeçalho se o tamanho das permissões for 8 kibibytes (KiB) ou menos. Caso contrário, você pode usar x-ms-file-permission-key. Se especificado, ele deve ter um proprietário, grupo e lista de controle de acesso discricionário (DACL).

Apenas um dos x-ms-file-permission ou x-ms-file-permission-key pode ser especificado.
x-ms-file-permission-key Obrigatório se x-ms-file-permission-copy-mode for especificado como override e x-ms-file-permission não for especificado. Disponível para a versão 2019-07-07 e posterior. Este cabeçalho especifica a chave da permissão a ser definida para o arquivo. Você pode criar essa chave usando a operação Create Permission.

Apenas um dos x-ms-file-permission ou x-ms-file-permission-key pode ser especificado.
x-ms-file-permission-format: { sddl ¦ binary } Opcional. Versão 2025-01-05 ou posterior. Especifica se o valor passado em x-ms-file-permission está em SDDL ou em formato binário. Se esse cabeçalho não estiver definido, o valor padrão de sddl será usado.
x-ms-file-attributes Opcional. Disponível para a versão 2019-07-07 e posterior. Este cabeçalho especifica os atributos do sistema de arquivos a serem definidos no arquivo de destino. Consulte a lista de atributos disponíveis. Você pode usar um valor de source para copiar os atributos do arquivo de origem para o arquivo de destino. Você pode usar um valor de none para limpar todos os atributos no arquivo de destino.
x-ms-file-copy-ignore-readonly Opcional. Disponível para a versão 2019-07-07 e posterior. Esse valor booleano especifica se o atributo ReadOnly em um arquivo de destino preexistente deve ser respeitado. Se for true, a operação de cópia será bem-sucedida. Caso contrário, um arquivo anterior no destino com o atributo ReadOnly definido fará com que a operação de cópia falhe.
x-ms-file-copy-set-archive Opcional. Disponível para a versão 2019-07-07 e posterior. Esse valor booleano especifica se o atributo Archive deve ser definido, independentemente do valor do cabeçalho x-ms-file-attributes.

Cabeçalhos de solicitação somente NFS

Cabeçalho da solicitação Descrição
x-ms-file-mode-copy-mode: { source ¦ override } Opcional. Versão 2025-05-05 e posterior. Aplicável somente quando a fonte de cópia é um arquivo localizado em um compartilhamento de arquivos com o protocolo NFS habilitado. Determina o comportamento de cópia dos bits de modo do arquivo:
  • source: O modo no arquivo de destino é copiado do arquivo de origem.
  • override: O modo no arquivo de destino é determinado através do cabeçalho x-ms-mode.
x-ms-mode Versão 2025-05-05 e posterior. Obrigatório se x-ms-file-mode-copy-mode for especificado como override. Os bits de modo a serem definidos no arquivo. O modo é representado no formato octal numérico de 12 bits ou no formato simbólico 'rwx'. Consulte permissões de arquivo POSIX (modo).
x-ms-file-owner-copy-mode: { source ¦ override } Opcional. Versão 2025-05-05 e posterior. Aplicável somente quando a fonte de cópia é um arquivo localizado em um compartilhamento de arquivos com o protocolo NFS habilitado. Determina o comportamento de cópia do identificador de usuário proprietário (UID) e identificador de grupo (GID) do arquivo:
  • source: O identificador de usuário proprietário (UID) e identificador de grupo (GID) no arquivo de destino é copiado do arquivo de origem.
  • override: O identificador de usuário proprietário (UID) e o identificador de grupo (GID) no arquivo de destino são determinados através dos cabeçalhos x-ms-owner e x-ms-group, respectivamente.
x-ms-owner Versão 2025-05-05 e posterior. O identificador de usuário (UID) do proprietário do arquivo a ser definido no arquivo. Obrigatório se x-ms-file-owner-copy-mode for especificado como override.
x-ms-group Versão 2025-05-05 e posterior. O identificador de grupo (GID) do proprietário do arquivo a ser definido no arquivo. Obrigatório se x-ms-file-owner-copy-mode for especificado como override.

Corpo do pedido

Nenhuma.

Resposta

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

Código de status

Uma operação bem-sucedida retorna o código de status 202 (Aceito). Para obter informações sobre códigos de status, consulte Códigos de status e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos nas tabelas a seguir. A resposta também pode incluir 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çalhos de resposta comuns

Cabeçalho da resposta Descrição
ETag Se a operação de cópia for concluída, conterá o valor ETag do arquivo de destino. Se a operação de cópia não for concluída, conterá o valor ETag do arquivo vazio criado no início da operação.
Last-Modified Retorna a data/hora em que a operação de cópia para o arquivo de destino foi concluída.
x-ms-request-id Identifica exclusivamente a solicitação que foi feita. Você pode usar esse cabeçalho para solucionar a solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
x-ms-version Indica a versão dos Arquivos do Azure usada para executar a solicitação.
Date Um valor de data/hora UTC que indica a hora em que o serviço enviou a resposta.
x-ms-copy-id: <id> Fornece um identificador de cadeia de caracteres para esta operação de cópia. Use com Get File ou Get File Properties para verificar o status dessa operação de cópia ou passe para Abort Copy File para cancelar uma operação de cópia pendente.
x-ms-copy-status: <success ¦ pending> Indica o estado da operação de cópia com estes valores:

- success: A operação de cópia foi concluída com êxito.
- pending: A operação de cópia ainda está em curso.
x-ms-client-request-id Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho é igual ao valor do cabeçalho x-ms-client-request-id se ele estiver presente na solicitação e o valor for no máximo 1.024 caracteres ASCII visíveis. Se o cabeçalho x-ms-client-request-id não estiver presente na solicitação, esse cabeçalho não estará presente na resposta.

Cabeçalhos de resposta somente SMB

Nenhuma.

Cabeçalhos de resposta somente NFS

Nenhuma.

Corpo de resposta

Nenhum

Resposta da amostra

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:   
Last-Modified: <date>   
ETag: "0x8CEB669D794AFE2"  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2015-02-21  
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-copy-status: pending  
Date: <date>  

Autorização

Essa operação pode ser chamada pelo proprietário da conta ou por um cliente que possua uma assinatura de acesso compartilhado que tenha permissão para gravar no arquivo de destino ou em seu compartilhamento. Observe que a assinatura de acesso compartilhado especificada na solicitação se aplica somente ao arquivo de destino.

O acesso ao arquivo de origem ou blob é autorizado separadamente, conforme descrito nos detalhes do cabeçalho da solicitação x-ms-copy-source.

A tabela a seguir descreve como os objetos de destino e origem de uma operação Copy File podem ser autorizados:

Ficheiro Autorização com Chave Partilhada ou Chave Partilhada Lite Autorização com assinatura de acesso compartilhado Objeto público não sujeito a autorização
Arquivo de destino Sim Sim Não aplicável
Arquivo de origem na mesma conta Sim Sim Não aplicável
Arquivo de origem em outra conta Não Sim Não aplicável
Blob de origem na mesma conta ou em outra conta Não Sim Sim

Atributos do sistema de arquivos

Atributo Atributo de arquivo Win32 Definição
ReadOnly FILE_ATTRIBUTE_READONLY O arquivo é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravá-lo ou excluí-lo.
Hidden FILE_ATTRIBUTE_HIDDEN O ficheiro está oculto. Ele não está incluído em uma listagem de diretório comum.
System FILE_ATTRIBUTE_SYSTEM O sistema operacional usa uma parte do arquivo ou usa o arquivo exclusivamente.
None FILE_ATTRIBUTE_NORMAL O arquivo não tem outros atributos definidos. Este atributo é válido apenas quando é usado sozinho.
Archive FILE_ATTRIBUTE_ARCHIVE O ficheiro é um ficheiro de arquivo. Os aplicativos normalmente usam esse atributo para marcar arquivos para backup ou remoção.
Temporary FILE_ATTRIBUTE_TEMPORARY O ficheiro está a ser utilizado para armazenamento temporário.
Offline FILE_ATTRIBUTE_OFFLINE Os dados do arquivo não estão disponíveis imediatamente. Este atributo do sistema de arquivos fornece principalmente compatibilidade com o Windows. O Azure Files não oferece suporte a ele com opções de armazenamento offline.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED O serviço de indexação de conteúdo não indexará o arquivo.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA O verificador de integridade de dados em segundo plano não lê o fluxo de dados do usuário. Este atributo do sistema de arquivos fornece principalmente compatibilidade com o Windows.

Permissões de arquivo POSIX (modo)

As permissões de arquivo POSIX podem ser especificadas numericamente em um formato octal numérico de 12 bits ou em um formato simbólico "rwx". Exemplos:

  • "0644" ou "rw-r--r--": o usuário (proprietário do arquivo) tem permissão de leitura, gravação. O grupo tem permissão de leitura. Outros têm permissão de leitura.
  • "0755" ou "rwxr-xr-x": O usuário (proprietário do arquivo) tem permissão de leitura, gravação e execução. O grupo tem permissão de leitura e execução. Outros têm permissão de leitura e execução.

Formato octal numérico

Os três números octais de ordem mais baixa representam as permissões para proprietário/usuário, grupo e outros e são indicados usando um número octal (0-7), formado usando uma combinação bit a bit de '4' (Ler), '2' (Gravar), '1' (Executar). O número octal de ordem mais alta (0-7) é usado para indicar uma combinação de permissões '4' (SetUID), '2' (SetGID), '1' (StickyBit).

Formato Permissão
0700 O usuário (proprietário do arquivo) tem permissão de leitura, gravação e execução.
0400 O usuário tem permissão de leitura.
0200 O usuário tem permissão de gravação.
0100 O usuário tem permissão de execução.
0070 O grupo tem permissão de leitura, gravação e execução.
0040 O grupo tem permissão de leitura.
0020 O grupo tem permissão de gravação.
0010 O grupo tem permissão de execução.
0007 Outros têm permissão de leitura, escrita e execução.
0004 Outros têm permissão de leitura.
0002 Outros têm permissão de escrita.
0001 Outros têm permissão de execução.
4000 Defina o ID de usuário efetivo no arquivo.
2000 Defina o ID de grupo efetivo no arquivo.
1000 Definido para indicar que o arquivo pode ser excluído ou renomeado somente pelo proprietário do arquivo, proprietário do diretório ou usuário raiz.

Formato simbólico "rwx"

As permissões para proprietário/usuário, grupo e outros são indicadas usando uma combinação de caracteres 'r' (Ler), 'w' (Gravar) e 'x' (Executar).

Formato Permissão
RWX------ O usuário (proprietário do arquivo) tem permissão de leitura, gravação e execução.
r-------- O usuário tem permissão de leitura.
-w------- O usuário tem permissão de gravação.
--x------ O usuário tem permissão de execução.
---rwx--- O grupo tem permissão de leitura, gravação e execução.
---r----- O grupo tem permissão de leitura.
----w---- O grupo tem permissão de gravação.
-----x--- O grupo tem permissão de execução.
------rwx Outros têm permissão de leitura, escrita e execução.
------r-- Outros têm permissão de leitura.
-------w- Outros têm permissão de escrita.
--------x Outros têm permissão de execução.

Comentários

A operação Copy File pode ser concluída de forma assíncrona. Você pode usar a ID de cópia que o cabeçalho de resposta x-ms-copy-id retorna para verificar o status da operação de cópia ou cancelá-la. Os Arquivos do Azure copiam arquivos com base no melhor esforço.

Se o arquivo de destino existir, ele será substituído. Não é possível modificar o arquivo de destino enquanto a operação de cópia estiver em andamento.

A operação Copy File sempre copia todo o blob ou arquivo de origem. Não há suporte para copiar um intervalo de bytes ou um conjunto de blocos.

A origem de uma operação Copy File pode ser um arquivo que reside em um instantâneo de compartilhamento. O destino de uma operação de Copy File não pode ser um arquivo que reside em um instantâneo de compartilhamento.

Quando a origem de uma operação de cópia fornece valores ETag, se houver alterações na origem enquanto a operação está em andamento, ela falhará. Uma tentativa de alterar o arquivo de destino enquanto uma operação de cópia está em andamento falha com o código de status 409 (Conflito).

O valor ETag para o arquivo de destino muda quando a operação Copy File é iniciada. Ele continua a mudar com freqüência durante a operação de cópia.

Copiando propriedades e metadados

Quando um blob ou arquivo é copiado, as seguintes propriedades do sistema são copiadas para o arquivo de destino com os mesmos valores:

  • Content-Type
  • Content-Encoding
  • Content-Language
  • Content-Length
  • Cache-Control
  • Content-MD5
  • Content-Disposition

O arquivo de destino é sempre do mesmo tamanho que o blob ou arquivo de origem. O valor do cabeçalho Content-Length para o arquivo de destino corresponde ao valor desse cabeçalho para o blob ou arquivo de origem.

Copiando um blob ou arquivo alugado para um arquivo

A operação Copy File só lê o blob ou arquivo de origem, portanto, uma concessão no objeto de origem não afeta a operação. A operação Copy File salva o valor ETag do blob ou arquivo de origem quando a operação é iniciada. Se o valor do ETag for alterado antes da conclusão da operação de cópia, a operação falhará. Você pode impedir alterações no blob de origem do arquivo alugando-o durante a operação de cópia.

Se o arquivo de destino tiver uma concessão infinita ativa, você deverá especificar sua ID de concessão na chamada para a operação Copy File. Enquanto a operação de cópia estiver pendente, qualquer operação de concessão no arquivo de destino falhará com o código de status 409 (Conflito). Uma concessão infinita no arquivo de destino é bloqueada dessa forma durante a operação de cópia, quer você esteja copiando para um arquivo de destino que tenha um nome diferente da origem ou copiando para um arquivo de destino com o mesmo nome da origem. Se o cliente especificar uma ID de concessão em um arquivo que ainda não existe, os Arquivos do Azure retornarão o código de status 412 (Falha na pré-condição).

Trabalhando com uma operação de cópia pendente

A operação Copy File pode terminar de copiar os arquivos de forma assíncrona. Use a tabela a seguir para determinar a próxima etapa com base no código de status que Copy File retorna:

Código de status Significado
202 (Aceito), x-ms-copy-status: sucesso Operação de cópia concluída com êxito.
202 (Aceito), x-ms-copy-status: pendente A operação de cópia não foi concluída. Sonde o blob de destino usando Get File Properties para examinar x-ms-copy-status até que a operação de cópia termine ou falhe.
4xx, 500 ou 503 Falha na operação de cópia.

Durante e após uma operação de Copy File, as propriedades do arquivo de destino contêm a ID de cópia da operação de Copy File e a URL do blob ou arquivo de origem. Quando a operação é concluída, os Arquivos do Azure gravam o valor de tempo e resultado (success, failedou aborted) nas propriedades do arquivo de destino. Se a operação tiver um resultado failed, o cabeçalho x-ms-copy-status-description conterá uma cadeia de caracteres de detalhes de erro.

Uma operação Copy File pendente tem um tempo limite de duas semanas. Uma tentativa de cópia que não foi concluída após duas semanas expira e deixa um arquivo vazio com o campo x-ms-copy-status definido como failed e o campo x-ms-status-description definido como 500 (OperationCancelled). Erros intermitentes e não fatais que podem ocorrer durante uma operação de cópia podem impedir o progresso da operação, mas não fazer com que ela falhe. Nestes casos, x-ms-copy-status-description descreve os erros intermitentes.

Qualquer tentativa de modificar o arquivo de destino durante a operação de cópia falha com o código de status 409 (Conflito), "Copiar arquivo em andamento".

Se você chamar uma operação Abort Copy File, verá um cabeçalho x-ms-copy-status:aborted. O arquivo de destino terá metadados intactos e um comprimento de arquivo de 0 bytes. Você pode repetir a chamada original para Copy File para tentar a operação novamente.

Faturação

A conta de destino de uma operação Copy File é cobrada por uma transação para iniciar a operação. A conta de destino também incorre em uma transação para cada solicitação de cancelamento ou solicitação do status da operação de cópia.

Quando o arquivo de origem ou blob está em outra conta, a conta de origem incorre em custos de transação. Além disso, se as contas de origem e de destino residirem em regiões diferentes (por exemplo, Norte dos EUA e Sul dos EUA), a largura de banda usada para transferir a solicitação será cobrada na conta de origem como saída. A saída entre contas dentro da mesma região é gratuita.

Ver também