Obter informações da conta

A operação Get Account Information 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.

Pedir

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

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

Método	URI de 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 de URI

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

Parâmetro	Descrição
restype	Necessário. O valor do parâmetro restype deve ser account.
comp	Necessário. O valor do parâmetro comp deve ser properties.

Cabeçalhos de solicitação

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

Cabeçalho de solicitação	Descrição
Authorization	Necessário. Especifica o esquema de autorização, o nome da conta e a assinatura. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
Date or x-ms-date	Necessário. Especifica o UTC (Tempo Universal Coordenado) para a solicitação. Para obter mais informações, consulte 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 essa 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 Status e códigos de erro.

Cabeçalhos de resposta

A resposta dessa 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 de 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á-la 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 esta operação, o comprimento do conteúdo sempre será 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 as contas de armazenamento GPv1 (Uso Geral v1) e GPv2 (Uso Geral v2) usando o V2 de subcadeia 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 é igual ao valor do cabeçalho x-ms-client-request-id, se ele estiver presente na solicitação e o valor for no máximo 1.024 caracteres ASCII visíveis. Se o cabeçalho x-ms-client-request-id 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 operação de Get Account Information, conforme descrito abaixo.

Importante

A Microsoft recomenda usar a ID do Microsoft Entra com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. A ID do Microsoft Entra fornece segurança superior e facilidade de uso em comparação com a autorização de Chave Compartilhada.

a ID do Microsoft Entra (recomendada)

O Armazenamento do Azure dá suporte ao uso da ID do Microsoft Entra para autorizar solicitações para dados de blob. Com a ID do Microsoft Entra, você pode usar o RBAC (controle de acesso baseado em função) do Azure para conceder permissões a uma entidade de segurança. A entidade de segurança pode ser um usuário, grupo, entidade de serviço de aplicativo ou identidade gerenciada do Azure. A entidade de segurança é autenticada pela ID do Microsoft Entra para retornar um token OAuth 2.0. Em seguida, o token pode ser usado para autorizar uma solicitação no serviço Blob.

Para saber mais sobre a autorização usando a ID do Microsoft Entra, consulte Autorizar o acesso a blobs usando a ID do Microsoft Entra.

Permissões

Listada abaixo está a ação RBAC necessária para que um usuário, grupo, identidade gerenciada ou entidade de serviço do Microsoft Entra chame a operação de Get Account Information:

• ação rbac do Azure:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Essa ação RBAC está incluída na função Proprietário ou você pode atribuir essa ação a uma função personalizada.

Para saber mais sobre como atribuir funções usando o RBAC do Azure, consulte Atribuir uma função do Azure para acesso a dados de blob.

sas (assinaturas de acesso compartilhado)

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 operação Get Account Information dá suporte à autorização usando uma SAS de conta.

SAS da conta

Uma SAS de conta é protegida com a chave da conta de armazenamento. Uma CONTA SAS delega acesso a recursos em um ou mais dos serviços de armazenamento. Todas as operações disponíveis por meio de uma SAS de delegação de serviço ou 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 conta sas.

chave compartilhada

A operação Get Account Information dá suporte a de autorização de chave compartilhada. A autorização com chaves de conta não é recomendada para a maioria dos cenários, pois é menos segura. A Microsoft recomenda não permitir a autorização de Chave Compartilhada para a conta de armazenamento quando possível. Para obter mais informações, consulte Impedir autorização com a chave compartilhada.

Observações

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 esta 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 da conta correto, o nome do contêiner correto e o nome do blob inexistente.

Faturamento

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 solicitações Get Account Information 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 padrão v2	Outras operações
Obter informações da conta	Uso geral padrão v1	Operações de leitura

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