Partilhar via

Obter informações da conta

  • Artigo

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

Solicitar

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

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 Solicitar URI 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 de 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 da 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 Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autorizar solicitações para o Armazenamento do Azure.
x-ms-version Obrigatório para todos os pedidos autorizados. Especifica a versão da operação a ser usada para essa solicitação. Para esta 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 de 1 kibibyte (KiB) que é registrado nos logs quando o log é configurado. É altamente recomendável que você use esse cabeçalho para correlacionar atividades do lado do cliente com solicitações que o servidor recebe.

Corpo do pedido

Nenhuma.

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 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 da resposta Descrição
x-ms-request-id Identifica exclusivamente a solicitação que foi feita. Você pode usá-lo para solucionar a 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 será sempre zero.
x-ms-sku-name Identifica o nome de 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 contas de armazenamento de Propósito Geral v1 (GPv1) e Propósito Geral v2 (GPv2) usando a 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 de resposta

Nenhuma.

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

Importante

A Microsoft recomenda o uso do Microsoft Entra ID com identidades gerenciadas para autorizar solicitações ao Armazenamento do Azure. O Microsoft Entra ID oferece segurança superior e facilidade de uso em comparação com a autorização de chave compartilhada.

O Armazenamento do Azure dá suporte ao uso da ID do Microsoft Entra para autorizar solicitações de dados de blob. Com o Microsoft Entra ID, você pode usar o controle de acesso baseado em função do Azure (Azure RBAC) 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 pelo Microsoft Entra ID para retornar um token OAuth 2.0. O token pode ser usado para autorizar uma solicitação no serviço Blob.

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

Permissões

Abaixo está listada 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 Get Account Information:

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.

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

Faturação

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

Funcionamento Tipo de conta de armazenamento Categoria de faturação
Obter informações da conta Blob de bloco premium
Padrão de uso geral v2		 Outras operações
Obter informações da conta Padrão de uso geral v1 Operações de leitura

Para saber mais sobre os preços para a categoria de cobrança especificada, consulte de preços do armazenamento de Blob do Azure .