Copiar Arquivo
A operação Copy File copia um blob ou arquivo para um arquivo de destino dentro da conta de armazenamento. Essa operação tem suporte na versão 2015-02-21 e posterior para Compartilhamentos de Arquivos com o protocolo SMB habilitado e tem suporte na versão 2025-05-05 e posterior para Compartilhamentos de Arquivos com o protocolo NFS habilitado.
Disponibilidade do protocolo
| Protocolo de compartilhamento de arquivos habilitado | Disponível |
|---|---|
| SMB |
|
| NFS |
|
Pedir
A solicitação Copy File é construída da seguinte maneira. 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 que o 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 | URI de solicitação | Versão HTTP |
|---|---|---|
| PÔR | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Substitua os componentes de caminho mostrados no URI da solicitação por seus próprios, da seguinte maneira:
| Componente path | Descrição |
|---|---|
myaccount |
O nome da sua conta de armazenamento. |
myshare |
O nome do 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 Nomenclatura e referência a compartilhamentos, diretórios, arquivos e metadados.
Parâmetros de URI
Você pode especificar os seguintes parâmetros adicionais no URI da 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 de Arquivos do Azure. |
Cabeçalhos de solicitação
Os cabeçalhos de solicitação obrigatórios e opcionais são descritos nas seguintes tabelas:
Cabeçalhos de solicitação comuns
| Cabeçalho de 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 UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. |
x-ms-version |
Necessário para todas as solicitações autorizadas. Especifica a versão da operação a ser usada para essa solicitação. Essa operação tem suporte na versão 2015-02-21 e posterior para Compartilhamentos de Arquivos com o protocolo SMB habilitado e tem suporte na versão 2025-05-05 e posterior para Compartilhamentos de Arquivos com o protocolo NFS habilitado. 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 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 seguir as regras de nomenclatura para identificadores C#. Os metadados de arquivo especificados por meio dos Arquivos do Azure não são acessíveis de um cliente SMB. |
x-ms-copy-source:name |
Necessário. Especifica a URL do arquivo de origem ou blob, até 2 kibibytes (KiB) de comprimento. Para copiar um arquivo para outro arquivo na mesma conta de armazenamento, você pode usar uma chave compartilhada para autorizar o arquivo de origem. Se você 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, deverá autorizar o arquivo de origem ou o 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:
|
x-ms-lease-id:<ID> |
Obrigató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 esse cabeçalho deve corresponder à ID de concessão do arquivo de destino. Se a solicitação não incluir a ID de concessão ou a ID não for válida, 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 dá suporte a concessões de arquivo. |
x-ms-file-creation-time |
Opcional. Disponível para a versão 2019-07-07 e posterior. Esse 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. Esse cabeçalho especifica a propriedade para a hora da última gravação, em UTC, a ser definida no arquivo de destino. Você pode usar um valor de source para copiar a hora da última 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 recebidas pelo servidor. Para obter mais informações, consulte Monitorar o Armazenamento de Blobs do Azure. |
x-ms-file-request-intent |
Necessário se Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup. Esse 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 booliano 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, o que dá suporte ao ponto à direita por padrão. Para obter mais informações, consulte Nomenclatura e referência a compartilhamentos, diretórios, arquivos e metadados. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Opcional. Versão 2022-11-02 e posterior. O valor booliano especifica se um ponto à direita presente na URL de origem deve ser cortado ou não. Esse cabeçalho só deverá ser especificado se a origem da cópia estiver localizada em um Compartilhamento de Arquivos do Azure. Esse cabeçalho não tem suporte para nenhum outro tipo de origem de cópia. Esse cabeçalho será ignorado se a origem da cópia estiver localizada em um Compartilhamento de Arquivos com o protocolo NFS habilitado, o que dá suporte ao ponto à direita por padrão. Para obter mais informações, consulte Nomenclatura e referência a compartilhamentos, diretórios, arquivos e metadados. |
Cabeçalhos de solicitação somente SMB
| Cabeçalho de 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:
|
x-ms-file-permission: { <SDDL> ¦ <binary> } |
Necessá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 do arquivo especificado no SDDL (Security Descriptor Definition Language) 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ê poderá usar esse cabeçalho se o tamanho das permissões for de 8 kibibytes (KiB) ou menos. Caso contrário, você pode usar x-ms-file-permission-key. Se especificado, ele deve ter um proprietário, um grupo e da DACL (lista de controle de acesso discricionário). Somente um dos x-ms-file-permission ou x-ms-file-permission-key pode ser especificado. |
x-ms-file-permission-key |
Necessá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. Esse 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.Somente 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á no SDDL ou no 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. Esse 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 booliano especifica se o atributo ReadOnly em um arquivo de destino preexistência 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 conjunto de atributos ReadOnly 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 booliano 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 de 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 origem da 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:
|
x-ms-mode |
Versão 2025-05-05 e posterior. Necessá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 origem da cópia é um arquivo localizado em um Compartilhamento de Arquivos com o protocolo NFS habilitado. Determina o comportamento de cópia do UID (identificador de usuário) proprietário e do GID (identificador de grupo) do arquivo:
|
x-ms-owner |
Versão 2025-05-05 e posterior. O UID (identificador de usuário) do proprietário do arquivo a ser definido no arquivo. Necessário se x-ms-file-owner-copy-mode for especificado como override. |
x-ms-group |
Versão 2025-05-05 e posterior. O GID (identificador de grupo) do proprietário do arquivo a ser definido no arquivo. Necessário se x-ms-file-owner-copy-mode for especificado como override. |
Corpo da solicitação
Nenhum.
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 Status e códigos de erro.
Cabeçalhos de resposta
A resposta dessa 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 de protocolo HTTP/1.1 .
Cabeçalhos de resposta comuns
| Cabeçalho de 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 estiver 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 problemas da 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 desta operação de cópia ou passar 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 andamento. |
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
Nenhum.
Cabeçalhos de resposta somente NFS
Nenhum.
Corpo da resposta
Nenhum
Resposta de exemplo
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 possui uma assinatura de acesso compartilhado que tem 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 de solicitação x-ms-copy-source.
A tabela a seguir descreve como os objetos de destino e de origem de uma operação de Copy File podem ser autorizados:
| Arquivo | Autorização com Chave Compartilhada ou Chave Compartilhada Lite | Autorização com assinatura de acesso compartilhado | Objeto público que não exige 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 arquivo 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. Esse atributo só é válido quando é usado sozinho. |
Archive |
FILE_ATTRIBUTE_ARCHIVE |
O arquivo é um arquivo morto. Normalmente, os aplicativos usam esse atributo para marcar arquivos para backup ou remoção. |
Temporary |
FILE_ATTRIBUTE_TEMPORARY |
O arquivo está sendo usado para armazenamento temporário. |
Offline |
FILE_ATTRIBUTE_OFFLINE |
Os dados do arquivo não estão disponíveis imediatamente. Esse atributo do sistema de arquivos fornece principalmente compatibilidade com o Windows. Os Arquivos do Azure não dão 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 indexa o arquivo. |
NoScrubData |
FILE_ATTRIBUTE_NO_SCRUB_DATA |
O verificador de integridade de dados em segundo plano não lerá o fluxo de dados do usuário. Esse 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 e 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 baixos 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' (Leitura), '2' (Gravação), '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, gravação e execução. |
| 0004 | Outros têm permissão de leitura. |
| 0002 | Outros têm permissão de gravação. |
| 0001 | Outros têm permissão de execução. |
| 4000 | Defina a ID de usuário efetiva no arquivo. |
| 2000 | Defina a ID efetiva do grupo no arquivo. |
| 1000 | Defina para indicar que o arquivo pode ser excluído ou renomeado apenas pelo proprietário do arquivo, proprietário do diretório ou usuário raiz. |
Formato simbólico "rwx"
Permissões para proprietário/usuário, grupo e outros são indicadas usando uma combinação de caracteres 'r' (Leitura), 'w' (Gravação) 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. |
| -------- | O grupo tem permissão de leitura. |
| -------- | 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, gravação e execução. |
| ------r... | Outros têm permissão de leitura. |
| -------w- | Outros têm permissão de gravação. |
| --------x | Outros têm permissão de execução. |
Observações
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. Você não pode modificar o arquivo de destino enquanto a operação de cópia está em andamento.
A operação Copy File sempre copia todo o arquivo ou blob de origem. Não há suporte para copiar um intervalo de bytes ou conjunto de blocos.
A origem de uma operação de 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 estiver 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 é alterado quando a operação de Copy File é iniciada. Ele continua a ser alterado com frequê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-TypeContent-EncodingContent-LanguageContent-LengthCache-ControlContent-MD5Content-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 lê somente do 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 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 de Copy File. Enquanto a operação de cópia está pendente, qualquer operação de concessão no arquivo de destino falha 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, seja você 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: êxito | 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. Pesquise o blob de destino usando Get File Properties para examinar x-ms-copy-status até que a operação de cópia seja concluída 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 Copy File e a URL do blob ou arquivo de origem. Quando a operação for concluída, os Arquivos do Azure gravarão 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 de 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 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 causar falha. Nesses 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 de 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.
Faturamento
A conta de destino de uma operação de 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 cancelar ou solicitar o 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 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 para a conta de origem como saída. A saída entre contas na mesma região é gratuita.
Consulte também
- operações de em arquivos
- autorizar solicitações para o Armazenamento do Azure
- status e códigos de erro
- códigos de erro dos Arquivos do Azure
- anular de arquivo de cópia