Colocar intervalo da URL
A operação Put Range From URL cria um novo intervalo a ser confirmado como parte de um arquivo em que o conteúdo é lido de uma URL. Essa operação tem suporte na versão 2019-02-02 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 Put Range From URL é construída da seguinte maneira. Recomendamos que você use HTTPS.
| Método | URI de solicitação | Versão HTTP |
|---|---|---|
| PÔR | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
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 informações sobre restrições de nomenclatura de caminho, consulte compartilhamentos de nome e referência, diretórios, arquivos e metadados.
Parâmetros de URI
| 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. Consulte Autorizar solicitações para o Armazenamento do Azure para obter mais informações. |
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 2019-02-02 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-copy-source:name |
Necessário. Especifica a URL do arquivo de origem. O valor pode ser uma URL de até 2 KiB de comprimento que especifica um arquivo. O valor deve ser codificado em URL como seria exibido em um URI de solicitação. O arquivo de origem deve ser público ou deve ser autorizado por meio de uma assinatura de acesso compartilhado. Se o arquivo de origem for público, nenhuma autorização será necessária para executar a operação. Aqui estão alguns exemplos de URLs de objeto de origem:
|
x-ms-copy-source-authorization: <scheme> <signature> |
Opcional. Especifica o esquema de autorização e a assinatura da origem da cópia. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. Somente o portador do esquema tem suporte para o Microsoft Entra. Esse cabeçalho tem suporte na versão 2020-10-02 e posterior. |
x-ms-write: { update } |
Necessário. Você deve especificar apenas update. A solicitação falhará se for chamada com clear. O valor update grava os bytes especificados pelo corpo da solicitação nos intervalos especificados. |
Range ou x-ms-range |
Necessário. É necessário Range ou x-ms-range.Especifica o intervalo de bytes a serem gravados. O início e o final do intervalo devem ser especificados. Esse cabeçalho é definido pela especificação de protocolo HTTP/1.1 . Para uma operação de atualização, o intervalo pode ter até 4 MiB de tamanho. Os Arquivos do Azure aceitam apenas um único intervalo de bytes para os cabeçalhos Range e x-ms-range e o intervalo de bytes deve ser especificado no seguinte formato: bytes=startByte-endByte.Se Range e x-ms-range forem especificados, o serviço usará o valor de x-ms-range. Para obter mais informações, consulte Especificar o cabeçalho de intervalo para operações de Arquivos do Azure. |
x-ms-source-range |
Necessário. Especifica o intervalo de bytes a serem lidos da origem. O início e o final do intervalo devem ser especificados. Os Arquivos do Azure aceitam apenas um único intervalo de bytes para os cabeçalhos Range e x-ms-range e o intervalo de bytes deve ser especificado no seguinte formato: bytes=startByte-endByte.O intervalo de origem pode ter até 4 MiB de tamanho. Se o tamanho do intervalo de origem exceder 4 MiB, os Arquivos do Azure retornarão o código de status 413 (Entidade de Solicitação Muito Grande). Se o tamanho do intervalo de origem não corresponder ao tamanho do intervalo (intervalo de destino), o serviço retornará o código de status 400 (Solicitação Incorreta). |
Content-Length |
Necessário. Especifica o número de bytes que estão sendo transmitidos no corpo da solicitação. O valor desse cabeçalho deve ser definido como 0. Quando o comprimento não é 0, a operação falha com o código de status 400 (Solicitação Incorreta). |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres kib (1 kibibyte) 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 arquivos do Azure. |
x-ms-source-content-crc64 |
Opcional. Um hash CRC64 do intervalo especificado do URI. Esse hash é usado para verificar a integridade do intervalo durante o transporte dos dados do URI. Quando esse cabeçalho é especificado, os Arquivos do Azure comparam o hash do conteúdo que chegou da fonte de cópia com esse valor de cabeçalho. Observação: este hash CRC64 não é armazenado com o arquivo. Se os dois hashes não corresponderem, a operação falhará com o código de erro 400 (Solicitação Incorreta). |
x-ms-source-if-match-crc64 |
Opcional. Um valor de soma de verificação CRC64. Especifique esse cabeçalho para executar a operação somente se a soma de verificação do intervalo determinado for lida de correspondências de origem da soma de verificação fornecida. Se a condição especificada não for atendida, os Arquivos do Azure retornarão o código de status 412 (Falha na pré-condição). |
x-ms-source-if-none-match-crc64 |
Opcional. Um valor de soma de verificação CRC64. Especifique esse cabeçalho para executar a operação somente se a soma de verificação do intervalo determinado lido da origem for diferente da soma de verificação fornecida. Se a condição especificada não for atendida, os Arquivos do Azure retornarão o código de status 412 (Falha na pré-condição). |
x-ms-lease-id: <ID> |
Necessário se o arquivo tiver uma concessão ativa. Disponível para a versão 2019-02-02 e posterior. Esse cabeçalho será ignorado se o arquivo estiver localizado em um Compartilhamento de Arquivos com o protocolo NFS habilitado, que não dá suporte a concessões de arquivo. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres kib (1 kibibyte), que é registrado nos logs de análise quando o log da Análise de Armazenamento do Azure está habilitado. É altamente recomendável que você use esse cabeçalho ao correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitorarde Armazenamento de Blobs. |
x-ms-file-last-write-time: { now ¦ preserve } |
Opcional. Versão 2021-06-08 e posterior. Você pode especificar uma das seguintes opções:
|
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. Não há suporte para esse cabeçalho para qualquer 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
Nenhum.
Cabeçalhos de solicitação somente NFS
Nenhum.
Corpo da solicitação
Nenhum corpo da solicitação.
Solicitação de exemplo
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mydir/myfile?comp=range HTTP/1.1
Request Headers:
x-ms-page-write: update
x-ms-copy-source: http://myaccount2.file.core.windows.net/myshare2/mydirectory2/myfile2?sv=2018-11-09&sp=r&sr=s&se=2018-08-22T09%3A59%3A28.2185790Z&sig=Qn6QEET3Gn%2FhCEVcXuwG7ssatIYiYRM5pNIy4Q3N0cQ%3D
x-ms-date: Fri, 22 Aug 2018 01:15:50 GMT
x-ms-version: 2019-02-02
x-ms-range: bytes=100-1023
x-ms-source-range: bytes=200-1123
x-ms-source-content-crc64: 3bedb8b3730fc205
Authorization: SharedKey myaccount:4KdWDiTdA9HmIF9+WF/8WfYOpUrFhieGIT7f0av+GEI=
Content-Length: 0
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 201 (Criado). Para obter mais 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 |
Contém um valor que você pode usar para executar operações condicionalmente. O valor está entre aspas. |
Last-Modified |
A data e a hora em que o arquivo foi modificado pela última vez. O formato de data segue o RFC 1123. Para obter mais informações, consulte Representação de valores de data/hora em cabeçalhos. Qualquer operação de gravação no arquivo, incluindo atualizações nos metadados ou propriedades do arquivo, altera a hora da última modificação do arquivo. |
x-ms-request-id |
Identifica exclusivamente a solicitação que foi feita e você pode usá-la 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 da API FileREST usada para executar a solicitação. |
Date |
Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada. |
x-ms-content-crc64 |
Retornado para que o cliente possa verificar a integridade do conteúdo da mensagem. O valor desse cabeçalho é computado pelos Arquivos do Azure. Não é necessariamente o mesmo que o valor especificado nos cabeçalhos de solicitação. |
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 não contiver mais de 1.024 caracteres ASCII visíveis. Se o cabeçalho x-ms-client-request-id não estiver presente na solicitação, ele não estará presente na resposta. |
x-ms-file-last-write-time |
Versão 2021-06-08 e posterior. A última hora de gravação do arquivo, no formato ISO 8601 (por exemplo, 2017-05-10T17:52:33.9551861Z). |
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 201 Created
Response Headers:
Date: Sun, 22 Aug 2020 01:33:35 GMT
ETag: "0x8CB171BA9E94B0B"
Last-Modified: Wed, 22 Aug 2020 01:13:31 GMT
x-ms-version: 2019-02-02
x-ms-content-crc64: 3bedb8b3730fc205
Content-Length: 0
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorização
Somente o proprietário da conta pode chamar essa operação.
Observações
A operação Put Range From URL grava um intervalo de dados em um arquivo e é semelhante ao comportamento da operação de Put Range. Ele usa a operação Get File na fonte especificada para ler dados, metadados e outras propriedades do arquivo de origem. Na versão 2020-10-02 e posterior, a autorização do Microsoft Entra tem suporte para a origem da operação de cópia.
A operação Put Range From URL retornará êxito 201 (Criado) somente se o intervalo especificado for gravado no arquivo.
Consulte também
operações de em arquivos