Obter informações da conta
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.
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.