Obter Informações da Conta

  • Artigo

A Get Account Information operação devolve o nome do SKU e o tipo de conta da conta especificada. Está disponível na versão 2018-03-28 e versões posteriores do serviço.

Pedir

Pode construir o Get Account Information pedido com um pedido válido autorizado através de uma chave partilhada ou autorização de assinatura de acesso partilhado (SAS).

Se adicionar um restype valor de account e um comp valor de properties, o pedido utilizará a Get Account Information operação. A tabela seguinte mostra exemplos:

Método URI do pedido Versão HTTP
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1
GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?restype=account&comp=properties&sv=myvalidsastoken HTTP/1.1

Parâmetros URI

Pode especificar os seguintes parâmetros adicionais no URI do pedido:

Parâmetro Description
restype Obrigatório. O valor do restype parâmetro tem de ser account.
comp Obrigatório. O valor do comp parâmetro tem de ser properties.

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 or 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 esta operação, a versão tem de ser 2018-03-28 ou posterior. 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.

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 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
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 Versão 2009-09-19 e posterior. Indica a versão do Armazenamento de Blobs do Azure que é utilizada para executar o pedido.
Date Um valor de data/hora UTC que indica a hora em que o serviço enviou a resposta.
Content-Length Especifica o comprimento do corpo do pedido. Para esta operação, o comprimento do conteúdo será sempre zero.
x-ms-sku-name Identifica o nome do SKU da conta especificada.
x-ms-account-kind Identifica o tipo de conta da conta especificada. Os valores possíveis são Storage, BlobStoragee StorageV2. O cabeçalho distingue entre Fins Gerais v1 (GPv1) e Fins Gerais contas de armazenamento v2 (GPv2) com a subcadeia V2 para contas GPv2.
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.
x-ms-is-hns-enabled Versão 2019-07-07 e posterior. Indica se a conta tem um espaço de nomes hierárquico ativado.

Corpo da resposta

Nenhum.

Resposta de amostra

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Date: Sat, 28 Mar 2018 12:43:08 GMT  
x-ms-version: 2018-03-28  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0  
x-ms-sku-name: Standard_LRS  
x-ms-account-kind: StorageV2

Autorização

A autorização é necessária ao chamar qualquer operação de acesso a dados no Armazenamento do Azure. Pode autorizar a Get Account Information operação conforme descrito abaixo.

Esta operação não suporta autorização baseada em OAuth através de um token de acesso do Azure Active Directory/MSI ou de uma SAS de delegação de utilizador.

Uma assinatura de acesso partilhado (SAS) fornece acesso delegado seguro aos recursos numa conta de armazenamento. Com uma SAS, tem controlo granular sobre como um cliente pode aceder aos dados. Pode especificar o recurso a que o cliente pode aceder, que permissões têm para esses recursos e quanto tempo a SAS é válida.

A Get Account Information operação suporta a autorização com uma SAS de conta ou uma SAS de serviço com, pelo menos, uma permissão disponível.

SAS de Conta

Uma SAS de conta é protegida com a chave da conta de armazenamento. Uma conta SAS delega o acesso aos recursos em um ou mais dos serviços de armazenamento. Todas as operações disponíveis através de um serviço ou saS de delegação de utilizador também estão disponíveis através de uma SAS de conta.

Para saber mais sobre a SAS da conta, consulte Criar uma SAS de conta.

SAS de Serviço

Uma SAS de serviço é protegida com a chave da conta de armazenamento. Um serviço SAS delega o acesso a um recurso num único serviço de Armazenamento do Azure, como o armazenamento de blobs.

Quando o acesso à Chave Partilhada não for permitido para a conta de armazenamento, não será permitido um token de SAS de serviço num pedido ao Armazenamento de Blobs. Para saber mais, veja Compreender como a desativação da Chave Partilhada afeta os tokens de SAS.

Para saber mais sobre a SAS do serviço, veja Criar uma SAS de serviço.

Observações

O caminho do URL do pedido não afeta as informações fornecidas por esta operação. O objetivo é permitir que o pedido autorize corretamente com um token de SAS que especifique o recurso permitido.

O recurso especificado não precisa de existir para que esta operação seja bem-sucedida. Por exemplo, um token de SAS gerado com um blob inexistente e permissões válidas terá êxito com um caminho de URL que inclui o nome de conta correto, o nome de contentor correto e o nome do blob inexistente.

Faturação

Os pedidos de preços podem ter origem em clientes que utilizam APIs de Armazenamento de Blobs, diretamente através da API REST do Armazenamento de Blobs ou a partir de uma biblioteca de cliente do Armazenamento do Azure. Estes pedidos acumulam custos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura acumulam-se numa categoria de faturação diferente das transações de escrita. A tabela seguinte mostra a categoria de faturação dos Get Account Information pedidos com base no tipo de conta de armazenamento:

Operação Tipo de conta de armazenamento Categoria de faturação
Obter Informações da Conta Blob de blocos Premium
Standard para fins gerais v2		 Outras operações
Obter Informações da Conta Standard para fins gerais v1 Operações de leitura

Para saber mais sobre os preços da categoria de faturação especificada, veja Preços do Armazenamento de Blobs do Azure.