Obter Informações da Conta
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 , BlobStorage e 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.
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.