Obter Metadados de Partilha
A Get Share Metadata operação devolve todos os metadados definidos pelo utilizador para a partilha de ficheiros do Azure ou o instantâneo de partilha.
Embora esta API seja totalmente suportada, é uma API de gestão legada. Por este motivo, recomendamos que utilize Partilhas de Ficheiros – Get, que é fornecido pelo fornecedor de recursos de armazenamento (Microsoft.Storage).
Para saber mais sobre como interagir programaticamente com recursos com FileShare o fornecedor de recursos de armazenamento, veja Operações em partilhas de ficheiros do Azure.
Disponibilidade do protocolo
| Protocolo de partilha de ficheiros ativado | Disponível |
|---|---|
| SMB |
|
| NFS |
|
Pedir
O Get Share Metadata pedido é 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?restype=share&comp=metadata |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata&sharesnapshot=<DateTime> |
HTTP/1.1 |
Substitua os componentes do 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. |
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 do 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 de data/hora opaco que, quando presente, especifica o instantâneo de partilha a consultar para obter os metadados |
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
| 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. 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-lease-id:<ID> |
Opcional. Versão 2020-02-10 e posterior. Se o cabeçalho for especificado, a operação só será efetuada se a concessão da partilha de ficheiros estiver atualmente ativa e o ID de concessão especificado no pedido corresponder ao ID de concessão da partilha de ficheiros. Se não houver correspondência, a operação falha com o código de estado 412 (Falha na Pré-condição). |
Corpo do pedido
Nenhum.
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 |
|---|---|
Last-Modified |
Devolve a data e hora em que a partilha foi modificada pela última vez. O formato de data segue RFC 1123. Para obter mais informações, veja Representar valores de data/hora em cabeçalhos. Qualquer operação que modificou a partilha ou as respetivas propriedades atualiza a hora da última modificação. As operações em ficheiros não afetam a hora da última modificação da partilha. |
x-ms-meta-name:value |
Um conjunto de pares nome-valor que contêm metadados definidos pelo utilizador para a partilha. |
ETag |
Contém um valor que pode utilizar para realizar operações condicionalmente. O valor está entre aspas. |
x-ms-request-id |
Identifica exclusivamente o pedido que foi feito e pode ser utilizado para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API. |
x-ms-version |
Indica a versão Ficheiros do Azure que foi utilizada para executar o pedido. |
Date ou x-ms-date |
Um valor de data/hora UTC gerado pelo serviço, que indica a hora em que a resposta foi iniciada. |
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 estará presente na resposta. |
Corpo da resposta
Nenhum.
Resposta de amostra
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-name: somemetadata
Date: Mon, 27 Jan 2014 22:49:18 GMT
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: Mon, 27 Jan 2014 22:48:29 GMT
x-ms-version: 2014-02-14
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
Esta operação devolve apenas metadados definidos pelo utilizador na partilha. Para devolver também as propriedades do sistema, chame Obter Propriedades de Partilha.