Partilhar via


Obter Propriedades do Diretório

A Get Directory Properties operação devolve todas as propriedades do sistema para o diretório especificado e também pode ser utilizada para verificar a existência de um diretório. Os dados devolvidos não incluem os ficheiros no diretório ou subdiretórios.

Disponibilidade do protocolo

Protocolo de partilha de ficheiros ativado Disponível
SMB Yes
NFS No

Pedir

O Get Directory Properties pedido pode ser construído da seguinte forma. Recomendamos que utilize HTTPS.

Método URI do pedido Versão HTTP
GET/HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
GET/HEAD https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> HTTP/1.1

Substitua os componentes de caminho que são apresentados no URI do pedido pelo seu, da seguinte forma:

Componente caminho Description
myaccount O nome da sua conta de armazenamento.
myshare O nome da partilha de ficheiros.
myparentdirectorypath Opcional. O caminho para o diretório principal.
mydirectory O nome do diretório.

Para obter informações sobre restrições de nomenclatura de caminhos, veja Partilhas de nomes e referências, diretórios, ficheiros e metadados.

Parâmetros URI

Os seguintes parâmetros adicionais podem ser especificados no URI do pedido:

Parâmetro Description
sharesnapshot Opcional. Versão 2017-04-17 e posterior. O sharesnapshot parâmetro é um valor dateTime opaco que, quando presente, especifica o instantâneo de partilha a consultar para as propriedades do diretório
timeout Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, veja Definir tempos limite para operações de Ficheiros do Azure.

Cabeçalhos do pedido

Os cabeçalhos de pedido obrigatórios e opcionais estão descritos na seguinte tabela:

Cabeçalho do pedido Description
Authorization Obrigatório. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
Date ou x-ms-date Obrigatório. Especifica a Hora Universal Coordenada (UTC) do pedido. Para obter mais informações, veja Autorizar pedidos para o Armazenamento do Azure.
x-ms-version Necessário para todos os pedidos autorizados, opcional para pedidos anónimos. Especifica a versão da operação a utilizar para este pedido. Para obter mais informações, veja Controlo de versões dos serviços de Armazenamento do Azure.
x-ms-client-request-id Opcional. Fornece um valor opaco gerado pelo cliente com um limite de carateres de 1 kibibyte (KiB) que é registado nos registos quando o registo é configurado. Recomendamos vivamente que utilize este cabeçalho para correlacionar as atividades do lado do cliente com os pedidos que o servidor recebe. Para obter mais informações, veja Monitorizar Ficheiros do Azure.
x-ms-file-request-intent Necessário se o Authorization cabeçalho especificar um token OAuth. O valor aceitável é backup. Este cabeçalho especifica que o Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ou Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action deve ser concedido se estiverem incluídos na política RBAC atribuída à identidade autorizada com o Authorization cabeçalho. 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 no URL do pedido deve ser cortado ou não. Para obter mais informações, veja Nomenclatura e referência de partilhas, diretórios, ficheiros e metadados.

Corpo do pedido

Nenhum.

Pedido de exemplo

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=  

Resposta

A resposta inclui um código de estado HTTP e um conjunto de cabeçalhos de resposta.

Código de estado

Uma operação bem-sucedida devolve o código de estado 200 (OK).

Para obter mais informações sobre códigos de estado, veja Códigos de estado e de erro.

Cabeçalhos de resposta

A resposta para esta operação inclui os seguintes cabeçalhos. 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 de resposta Descrição
ETag O ETag contém um valor que pode utilizar para realizar operações condicionalmente. O valor está entre aspas.
Last-Modified Devolve a data e hora em que o diretório foi modificado pela última vez. O formato de data segue RFC 1123. Para obter mais informações, veja Representar valores de data/hora em cabeçalhos. As operações em ficheiros no diretório não afetam a última hora modificada do diretório.
x-ms-meta-name:value Um conjunto de pares name-value que contêm metadados para o diretório.
x-ms-request-id Devolve o identificador exclusivo do pedido, que pode ajudá-lo a resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API.
x-ms-version Indica a versão do serviço que foi utilizada para executar o pedido.
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 deste cabeçalho está definido como true se os metadados do diretório estiverem completamente encriptados com o algoritmo especificado. Se os metadados não estiverem encriptados, o valor será definido como false.
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 ficheiros no diretório. Para obter mais informações, veja a lista de atributos disponíveis.
x-ms-file-creation-time Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade de hora de criação de 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 hora de escrita do diretório.
x-ms-file-change-time Versão 2019-02-02 e posterior. O valor de data/hora UTC que representa a propriedade de hora de alteração do diretório.
x-ms-file-file-id Versão 2019-02-02 e posterior. O ID de ficheiro do diretório.
x-ms-file-parent-id Versão 2019-02-02 e posterior. O ID do ficheiro principal do diretório.
x-ms-client-request-id Pode ser utilizado para resolver problemas de pedidos e respostas correspondentes. O valor deste cabeçalho é igual ao valor do x-ms-client-request-id cabeçalho se estiver presente no pedido e o valor não contiver mais de 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, não está presente na resposta.

Corpo da resposta

Nenhum.

Resposta de amostra

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  

Autorização

Apenas o proprietário da conta pode chamar esta operação.

Observações

Se o caminho do diretório especificado não existir, o pedido falha com o código de estado 404 (Não Encontrado).

Ver também

Operações em diretórios