Obter informações da conta

  • Artigo

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

Solicitação

Você pode construir a Get Account Information solicitação usando uma solicitação válida autorizada por meio de chave compartilhada ou autorização de SAS (assinatura de acesso compartilhado).

Se você adicionar um restype valor de account e um comp valor de properties, a solicitação usará a Get Account Information operação . A tabela a seguir mostra exemplos:

Método URI da solicitação 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 do URI

Você pode especificar os seguintes parâmetros adicionais no URI da solicitação:

Parâmetro Descrição
restype Obrigatórios. O valor do restype parâmetro deve ser account.
comp Obrigatórios. O valor do comp parâmetro deve ser properties.

Cabeçalhos da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais:

Cabeçalho da solicitação Descrição
Authorization Obrigatórios. Especifica o esquema de autorização, o nome da conta e a assinatura. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
Date or x-ms-date Obrigatórios. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para saber mais, confira Autorizar solicitações para o Armazenamento do Azure.
x-ms-version Necessário para todas as solicitações autorizadas. Especifica a versão da operação a ser usada para esta solicitação. Para essa operação, a versão deve ser 2018-03-28 ou posterior. 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 kib (1 kibibyte) que é registrado nos logs quando o registro em log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor.

Corpo da solicitação

Nenhum.

Resposta

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

Código de status

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.

Cabeçalhos de resposta

A resposta para esta operação inclui os cabeçalhos 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 de resposta Descrição
x-ms-request-id Identifica exclusivamente a solicitação que foi feita. Você pode usá-lo para solucionar problemas da solicitação. Para obter mais informações, consulte Solucionar problemas de operações de API.
x-ms-version Versão 2009-09-19 e posterior. Indica a versão do Armazenamento de Blobs do Azure usada para executar a solicitação.
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 da solicitação. Para essa operação, o comprimento do conteúdo sempre será zero.
x-ms-sku-name Identifica o nome da SKU da conta especificada.
x-ms-account-kind Identifica o tipo de conta da conta especificada. Os valores possíveis são Storage, BlobStorage e StorageV2. O cabeçalho distingue entre as contas de armazenamento Uso Geral v1 (GPv1) e Uso Geral v2 (GPv2) usando a subcadeia V2 de caracteres para contas GPv2.
x-ms-client-request-id Pode ser usado para solucionar problemas de solicitações e respostas correspondentes. O valor desse cabeçalho será igual ao valor do x-ms-client-request-id cabeçalho, se ele estiver presente na solicitação e o valor for no máximo 1.024 caracteres ASCII visíveis. Se o x-ms-client-request-id cabeçalho não estiver presente na solicitação, esse 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 namespace hierárquico habilitado.

Corpo da resposta

Nenhum.

Resposta de exemplo

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. Você pode autorizar a Get Account Information operação conforme descrito abaixo.

Essa operação não dá suporte à autorização baseada em OAuth por meio de um token de acesso do Azure Active Directory/MSI ou de uma SAS de delegação de usuário.

Uma SAS (assinatura de acesso compartilhado) fornece acesso delegado seguro aos recursos em uma conta de armazenamento. Com uma SAS, você tem controle granular sobre como um cliente pode acessar dados. Você pode especificar qual recurso o cliente pode acessar, quais permissões eles têm para esses recursos e por quanto tempo a SAS é válida.

A Get Account Information operação dá suporte à autorização usando 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 SAS de conta delega acesso a recursos em um ou mais dos serviços de armazenamento. Todas as operações disponíveis através de uma SAS de serviço ou de delegação do usuário também estão disponíveis por meio 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. Uma SAS de serviço delega acesso a um recurso em um único serviço de Armazenamento do Azure, como o armazenamento de blobs.

Quando o acesso à Chave Compartilhada não for permitido para a conta de armazenamento, um token SAS de serviço não será permitido em uma solicitação para o Armazenamento de Blobs. Para saber mais, confira Entender como a não permissão da Chave Compartilhada afeta os tokens SAS.

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

Comentários

O caminho da URL da solicitação não afeta as informações fornecidas por essa operação. Sua finalidade é permitir que a solicitação autorize corretamente com um token SAS que especifica o recurso permitido.

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

Cobrança

As solicitações de preços podem ser originadas de clientes que usam APIs de Armazenamento de Blobs, diretamente por meio da API REST do Armazenamento de Blobs ou de uma biblioteca de clientes do Armazenamento do Azure. Essas solicitações acumulam encargos por transação. O tipo de transação afeta a forma como a conta é cobrada. Por exemplo, as transações de leitura se acumulam em uma categoria de cobrança diferente das transações de gravação. A tabela a seguir mostra a categoria de cobrança para Get Account Information solicitações com base no tipo de conta de armazenamento:

Operação Tipo de conta de armazenamento Categoria de cobrança
Obter informações da conta Blob de blocos Premium
Uso geral v2 Standard		 Outras operações
Obter informações da conta Uso geral v1 Standard Operações de leitura

Para saber mais sobre os preços da categoria de cobrança especificada, confira Preços Armazenamento de Blobs do Azure.