Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A operação Create Hard Link cria um novo link rígido para um arquivo existente. Essa operação tem suporte na versão 2025-05-05 e posterior somente para Compartilhamentos de Arquivos com o protocolo NFS habilitado.
Disponibilidade do protocolo
| Protocolo de compartilhamento de arquivos habilitado | Disponível |
|---|---|
| PME |
|
| NFS (Nota Fiscal de Serviços) |
|
Pedir
A solicitação Create Hard Link é 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/myhardlink?restype=hardlink |
HTTP/1.1 |
Substitua os componentes de caminho mostrados no URI da solicitação por seus próprios componentes, conforme descrito na tabela a seguir:
| 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 em que o link rígido deve ser criado. Se o caminho do diretório for omitido, o link rígido será criado no compartilhamento especificado. Se o diretório for especificado, ele já deverá existir dentro do compartilhamento antes que você possa criar o link rígido. |
myhardlink |
O nome do link rígido a ser criado. |
Para obter informações sobre restrições de nomenclatura de caminho, consulte Nome e compartilhamentos de referência, 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 serviço de arquivo. |
Cabeçalhos de solicitação
Os cabeçalhos de solicitação obrigatórios e opcionais são descritos na tabela a seguir:
| 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 a hora UTC (Tempo Universal Coordenado) da 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 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. |
Content-Length |
Opcional. Deve ser zero se estiver presente. |
x-ms-content-length |
Opcional. Deve ser zero se estiver presente. |
x-ms-type: file |
Necessário. Defina esse cabeçalho como file. |
x-ms-file-target-file:path |
Necessário. Especifica o caminho absoluto para o arquivo de destino ao qual o link rígido será criado, até 2 KiB de comprimento. Deve ser o caminho completo/absoluto do arquivo de destino da raiz do mesmo compartilhamento ou o URI completo do arquivo de destino. Aqui estão alguns exemplos de caminho de arquivo de destino:
|
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-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. |
Corpo da solicitação
Nenhum.
Solicitação de exemplo
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/myhardlink?restype=hardlink HTTP/1.1
Request Headers:
x-ms-version: 2025-05-05
x-ms-date: Wed, 20 Nov 2024 09:17:09 GMT
x-ms-type: file
x-ms-file-target-file: mydir/myfile
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
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 informações sobre códigos de status, consulte Status e códigos de erro.
Cabeçalhos de resposta
A resposta para esta operação inclui os cabeçalhos na tabela a seguir:
Cabeçalhos de resposta comuns
| Cabeçalho de resposta | Descrição |
|---|---|
Date |
Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada. |
ETag |
A ETag contém um valor que representa a versão do arquivo. O valor está entre aspas. |
Last-Modified |
Retorna 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 Representar valores de data/hora em cabeçalhos. Qualquer operação que modifique o diretório ou suas propriedades atualiza a hora da última modificação. As operações em arquivos não afetam a hora da última modificação do diretório. |
x-ms-request-id |
Identifica exclusivamente a solicitação que foi feita e pode ser usada 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. |
x-ms-file-creation-time |
O valor de data/hora UTC que representa a propriedade de hora de criação do arquivo. |
x-ms-file-last-write-time |
O valor de data/hora UTC que representa a última propriedade de tempo de gravação para o arquivo. |
x-ms-file-change-time |
A data/hora UTC que representa a propriedade de tempo de alteração para o arquivo. |
x-ms-file-file-id |
A ID do arquivo. |
x-ms-file-parent-id |
A ID do arquivo pai do link rígido recém-criado. |
x-ms-client-request-id |
Usado para solucionar problemas de solicitações e suas 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-mode |
O modo do arquivo. Consulte permissões de arquivo POSIX (modo). |
x-ms-owner |
O UID (identificador de usuário) do proprietário do arquivo. |
x-ms-group |
O GID (identificador de grupo) do proprietário do arquivo. |
x-ms-link-count |
A contagem de link do arquivo. |
x-ms-file-file-type |
O tipo do arquivo, o valor possível é: Regular. |
Corpo da resposta
Nenhum.
Resposta de exemplo
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Wed, 20 Nov 2024 09:17:08 GMT
ETag: "0x8DD09441C5DB27A"
Last-Modified: Wed, 20 Nov 2024 09:17:09 GMT
x-ms-version: 2025-05-05
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorização
Somente o proprietário da conta pode chamar essa operação.
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 outras pessoas 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
Se o compartilhamento não existir, a operação falhará com o código de status 404/'Not Found' (ShareNotFound).
Se o diretório pai do link rígido ou do arquivo de destino não existir, a operação falhará com o código de status 404/'Not Found' (ParentNotFound).
Se o arquivo de destino não existir, a operação falhará com o código de status 404/'Not Found' (ResourceNotFound).
Se o link rígido a ser criado já existir ou se o caminho apontar para um recurso que já existe, a operação falhará com o código de status 409/'Conflict' (ResourceAlreadyExists).
Como os links rígidos só podem ser criados para arquivos, se o cabeçalho x-ms-target-file não apontar para um arquivo, a solicitação falhará com o código de status 400/'Solicitação Incorreta'.
Create Hard Link não tem suporte em um instantâneo de compartilhamento, que é uma cópia somente leitura de um compartilhamento. Uma tentativa de executar essa operação em um instantâneo de compartilhamento falha com o código de status 400/'Solicitação Incorreta' (InvalidQueryParameterValue).
Consulte também
operações de em arquivos