Colocar intervalo a partir do URL
A operação Put Range From URL cria um novo intervalo a ser confirmado como parte de um arquivo onde o conteúdo é lido de uma URL. Esta operação é suportada na versão 2019-02-02 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 |
|
| NFS |
|
Solicitar
A solicitação Put Range From URL é construída da seguinte forma. Recomendamos que você use HTTPS.
| Método | Solicitar URI | Versão HTTP |
|---|---|---|
| COLOCAR | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=range |
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 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 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. Consulte Autorizar solicitações ao de Armazenamento do Azure para obter mais informações. |
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 2019-02-02 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-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 por URL como apareceria em um URI de solicitação. O ficheiro de origem tem de ser público ou tem de ser autorizado através de uma assinatura de acesso partilhado. 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 para a fonte de cópia. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure. Apenas o portador do esquema é suportado para o Microsoft Entra. Este cabeçalho é suportado 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 ser gravado. O início e o fim do intervalo devem ser especificados. Este cabeçalho é definido pela especificação do protocolo HTTP/1.1. Para uma operação de atualização, o intervalo pode ser de 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 do intervalo para operações do Azure Files. |
x-ms-source-range |
Necessário. Especifica o intervalo de bytes a serem lidos da origem. O início e o fim 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 fontes 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 deste 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 de 1 kibibyte (KiB) que é registrado nos logs quando o 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 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. Nota: 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 lido da origem corresponder à 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> |
Obrigató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 oferece suporte a concessões de arquivos. |
x-ms-client-request-id |
Opcional. Fornece um valor opaco gerado pelo cliente com um limite de caracteres de 1 kibibyte (KiB), que é registrado nos logs de análise quando o log do Azure Storage Analytics está habilitado. É altamente recomendável que você use esse cabeçalho quando estiver correlacionando atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Monitor Blob Storage. |
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 |
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 qualquer 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
Nenhuma.
Cabeçalhos de solicitação somente NFS
Nenhuma.
Corpo do pedido
Nenhum órgão de solicitação.
Pedido de amostra
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 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 |
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 que foi 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 é calculado pelos Arquivos do Azure. Não é necessariamente o mesmo que o valor especificado nos cabeçalhos da 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
Nenhuma.
Cabeçalhos de resposta somente NFS
Nenhuma.
Corpo de resposta
Nenhuma.
Resposta da amostra
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
Apenas o proprietário da conta pode chamar esta operação.
Comentários
A operação Put Range From URL grava um intervalo de dados em um arquivo e é semelhante em comportamento à operação 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 é suportada para a origem da operação de cópia.
A operação Put Range From URL retorna o êxito 201 (Criado) somente se o intervalo especificado for gravado no arquivo.