Obter propriedades do diretório
A operação Get Directory Properties retorna todas as propriedades do sistema para o diretório especificado e também pode ser usada para verificar a existência de um diretório. Os dados retornados não incluem os arquivos no diretório ou em quaisquer subdiretórios. Esta operação é suportada na versão 2025-05-05 e posterior para Partilhas de Ficheiros com o protocolo NFS ativado.
| Protocolo de compartilhamento de arquivos habilitado | Disponível |
|---|---|
| PME |
|
| NFS |
|
A solicitação Get Directory Properties é construída da seguinte forma. Recomendamos que você use HTTPS.
| Método | Solicitar URI | Versão HTTP |
|---|---|---|
| GET/CABEÇA | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
| GET/CABEÇA | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
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. |
myparentdirectorypath |
Opcional. O caminho para o diretório pai. |
mydirectory |
O nome do diretório. |
Para obter informações sobre restrições de nomenclatura de caminho, consulte Compartilhamentos de nome e referência, diretórios, arquivos e metadados.
Os seguintes parâmetros adicionais podem ser especificados no URI da solicitação:
| Parâmetro | Descrição |
|---|---|
sharesnapshot |
Opcional. Versão 2017-04-17 e posterior. O parâmetro sharesnapshot é um valor DateTime opaco que, quando presente, especifica o instantâneo de compartilhamento para consultar as propriedades do diretório |
timeout |
Opcional. O parâmetro timeout é expresso em segundos. Para obter mais informações, consulte Definir tempos limite para operações do Azure Files. |
Os cabeçalhos de solicitação obrigatórios e opcionais são descritos nas tabelas a seguir:
| 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 2025-05-05 e posterior para Partilhas de Ficheiros com o protocolo NFS ativado. Para obter mais informações, consulte controle de versão para os serviços de Armazenamento do Azure. |
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-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. |
Nenhuma.
Nenhuma.
Nenhuma.
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.
Uma operação bem-sucedida retorna o código de status 200 (OK). Para obter informações sobre códigos de status, consulte Códigos de status e de erro.
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çalho da resposta | Descrição |
|---|---|
ETag |
O ETag contém um valor que você pode usar para executar operações condicionalmente. O valor está entre aspas. |
Last-Modified |
Retorna a data e a hora em que o diretório 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. As operações em arquivos dentro do diretório não afetam a hora da última modificação do diretório. |
x-ms-meta-name:value |
Um conjunto de pares nome-valor que contêm metadados para o diretório. |
x-ms-request-id |
Retorna o identificador exclusivo da solicitação, que pode ajudá-lo a solucionar a solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API. |
x-ms-version |
Indica a versão de serviço 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-server-encrypted: true/false |
Versão 2017-04-17 e posterior. O valor desse cabeçalho é definido como true se os metadados do diretório forem completamente criptografados usando o algoritmo especificado. Se os metadados não estiverem criptografados, o valor será definido como false. |
x-ms-file-creation-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade de tempo de criação para um diretório. |
x-ms-file-last-write-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a última propriedade de tempo de gravação para o diretório. |
x-ms-file-change-time |
Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade change time para o diretório. |
x-ms-file-file-id |
Versão 2019-02-02 e posterior. O ID do arquivo do diretório. |
x-ms-file-parent-id |
Versão 2019-02-02 e posterior. O ID do arquivo pai do diretório. |
x-ms-client-request-id |
Pode ser 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. |
| Cabeçalho da resposta | Descrição |
|---|---|
x-ms-file-permission-key |
Versão 2019-02-02 e posterior. A chave da permissão do diretório. |
x-ms-file-attributes |
Versão 2019-02-02 e posterior. Os atributos do sistema de arquivos no diretório. Para obter mais informações, consulte a lista de atributos disponíveis. |
| Cabeçalho da resposta | Descrição |
|---|---|
x-ms-mode |
Versão 2025-05-05 e posterior. O modo do diretório. Consulte permissões de arquivo POSIX (modo). |
x-ms-owner |
Versão 2025-05-05 e posterior. O identificador de usuário (UID) do proprietário do diretório. |
x-ms-group |
Versão 2025-05-05 e posterior. O identificador de grupo (GID) do proprietário do diretório. |
x-ms-file-file-type |
Versão 2025-05-05 e posterior. O tipo do arquivo, os valores possíveis são: Directory. |
Nenhuma.
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Somente o proprietário da conta pode chamar essa operação.
| Atributo | Atributo de arquivo Win32 | Definição |
|---|---|---|
| Somente leitura | FILE_ATTRIBUTE_READONLY | Um arquivo que é somente leitura. Os aplicativos podem ler o arquivo, mas não podem gravá-lo ou excluí-lo. |
| Escondido | FILE_ATTRIBUTE_HIDDEN | O ficheiro está oculto. Ele não está incluído em uma listagem de diretório comum. |
| Sistema | FILE_ATTRIBUTE_SYSTEM | Um arquivo que o sistema operacional usa uma parte ou usa exclusivamente. |
| Nenhum | FILE_ATTRIBUTE_NORMAL | Um arquivo que não tem outros atributos definidos. Este atributo é válido apenas quando é usado sozinho. |
| Arquivo | FILE_ATTRIBUTE_ARCHIVE | Um arquivo que é um arquivo morto. Os aplicativos normalmente usam esse atributo para marcar arquivos para backup ou remoção. |
| Temporário | FILE_ATTRIBUTE_TEMPORARY | Um arquivo que está sendo usado para armazenamento temporário. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Os dados de um ficheiro não estão disponíveis imediatamente. Este atributo do sistema de arquivos é apresentado principalmente para fornecer compatibilidade com o Windows. O Azure Files não oferece suporte a opções de armazenamento offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | O arquivo não deve ser indexado pelo serviço de indexação de conteúdo. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | O fluxo de dados do usuário não deve ser lido pelo scanner de integridade de dados em segundo plano. Este atributo do sistema de arquivos é apresentado principalmente para fornecer compatibilidade com o Windows. |
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.
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 | Defina 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. |
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. |
Se o caminho do diretório especificado não existir, a solicitação falhará com o código de status 404 (Não encontrado).