Definir Metadados de Partilha
A Set Share Metadata operação define um ou mais pares de nomes/valores definidos pelo utilizador para a partilha especificada. Embora esta operação seja totalmente suportada, é uma operação de gestão legada. Recomendamos que utilize a operação Partilhas de Ficheiros – Atualização fornecida pelo fornecedor de recursos de armazenamento (Microsoft.Storage). Para saber mais sobre a interação programática com recursos através FileShare do fornecedor de recursos de armazenamento, veja Operações em Recursos fileShare.
Disponibilidade do protocolo
| Protocolo de partilha de ficheiros ativado | Disponível |
|---|---|
| SMB |
|
| NFS |
|
Pedir
Vai construir o pedido da Set Share Metadata seguinte forma. Recomendamos HTTPS. Substitua myaccount pelo nome da sua conta de armazenamento.
| Método | URI do pedido | Versão HTTP |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata |
HTTP/1.1 |
Substitua os componentes de caminho 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 detalhes sobre as restrições de nomenclatura de caminhos, veja Nomenclatura e referência de partilhas, diretórios, ficheiros e metadados.
Parâmetros URI
Pode especificar os seguintes parâmetros adicionais no URI do pedido:
| Parâmetro | Description |
|---|---|
timeout |
Opcional. Expresso em segundos. Para obter mais informações, veja Definir tempos limite para operações de Ficheiros do Azure. |
Cabeçalhos do pedido
A tabela seguinte descreve os cabeçalhos de pedido obrigatórios e opcionais:
| 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-meta-name:value |
Opcional. Fornece um par de nomes/valores para conter metadados para a partilha. Cada chamada para esta operação substitui todos os metadados existentes anexados à partilha. Para remover todos os metadados da partilha, chame esta operação sem cabeçalhos de metadados. Os nomes de metadados têm de cumprir as regras de nomenclatura dos identificadores C#. |
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 Análise de Armazenamento quando o registo está 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 Armazenamento de Blobs do Azure. |
x-ms-lease-id:<ID> |
Necessário se a partilha de ficheiros de destino tiver uma concessão ativa. Disponível para a versão 2020-02-10 e posterior. Se o pedido não incluir o ID de concessão ou não for válido, a operação falhará com o código de estado 412 (Falha na Pré-condição). Se este cabeçalho for especificado e a partilha de ficheiros de destino não tiver atualmente uma concessão ativa, a operação falha com o código de estado 412 (Falha na Pré-condição). |
Corpo do pedido
Nenhum.
Pedido de exemplo
PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1
Request Headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
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 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 Representação dos valores de data/hora nos 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. |
ETag |
Contém um valor que representa a versão da partilha, em aspas. |
x-ms-request-id |
Identifica exclusivamente o pedido que foi feito. Pode utilizá-lo para resolver o pedido. Para obter mais informações, veja Resolver problemas de operações da API. |
x-ms-version |
Indica a versão do Ficheiros do Azure que foi utilizada para executar o pedido. |
Date ou x-ms-date |
Um valor de data/hora UTC que indica a hora em que o serviço enviou a resposta. |
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 for, no máximo, 1024 carateres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente no pedido, este cabeçalho não estará presente na resposta. |
Corpo da resposta
Nenhum.
Autorização
Apenas o proprietário da conta pode chamar esta operação.
Observações
A chamada Set Share Metadata substitui todos os metadados existentes associados à partilha. Não é possível modificar um par de nomes/valores individual.
Também pode definir metadados para uma partilha no momento em que é criada, como parte da operação Criar Partilha .
A chamada Set Share Metadata atualiza as ETag propriedades e Last-Modified-Time da partilha.
Set Share Metadata não é suportado para um instantâneo de partilha. Uma tentativa de executar esta operação num instantâneo de partilha falhará com o código de estado 400 (InvalidQueryParameterValue). Pode definir metadados para um instantâneo de partilha no momento em que é criado, como parte da Snapshot Share operação.