Obtener información de la cuenta

  • Artículo

La Get Account Information operación devuelve el nombre de la SKU y el tipo de cuenta de la cuenta especificada. Está disponible en la versión 2018-03-28 y versiones posteriores del servicio.

Solicitud

Puede construir la Get Account Information solicitud mediante una solicitud válida autorizada a través de la clave compartida o la autorización de firma de acceso compartido (SAS).

Si agrega un restype valor de account y un comp valor de properties, la solicitud usará la Get Account Information operación . En la tabla siguiente se muestran ejemplos:

Método URI de solicitud Versión de 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 del identificador URI

Puedes especificar los siguientes parámetros adicionales en el URI de la solicitud:

Parámetro Descripción
restype Necesario. El valor del restype parámetro debe ser account.
comp Necesario. El valor del comp parámetro debe ser properties.

Encabezados de solicitud

En la tabla siguiente se describen los encabezados de solicitud obligatorios y opcionales:

Encabezado de solicitud Descripción
Authorization Necesario. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
Date or x-ms-date Necesario. Especifica la hora universal coordinada (UTC) de la solicitud. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para esta operación, la versión debe ser 2018-03-28 o posterior. Para obtener más información, vea Versiones de los servicios de Azure Storage.
x-ms-client-request-id Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 kibibyte (KiB) que se registra en los registros cuando se configura el registro. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes que recibe el servidor.

Cuerpo de la solicitud

Ninguno.

Response

La respuesta incluye un código de estado HTTP y un conjunto de encabezados de respuesta.

status code

Una operación correcta devuelve el código de estado 200 Correcto.

Para obtener información sobre los códigos de estado, vea Códigos de estado y de error.

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también puede incluir encabezados HTTP estándar adicionales. Todos los encabezados estándar se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta Descripción
x-ms-request-id Identifica de forma única la solicitud que se realizó. Puede usarlo para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
x-ms-version Versión 2009-09-19 y posteriores. Indica la versión de Azure Blob Storage que se usa para ejecutar la solicitud.
Date Valor de fecha y hora UTC que indica la hora a la que el servicio envió la respuesta.
Content-Length Especifica la longitud del cuerpo de la solicitud. Para esta operación, la longitud del contenido siempre será cero.
x-ms-sku-name Identifica el nombre de SKU de la cuenta especificada.
x-ms-account-kind Identifica el tipo de cuenta de la cuenta especificada. Los valores posibles son Storage, BlobStorage y StorageV2. El encabezado distingue entre las cuentas de almacenamiento de De uso general v1 (GPv1) y De uso general v2 (GPv2) mediante la subcadena V2 para cuentas de GPv2.
x-ms-client-request-id Se puede usar para solucionar problemas de solicitudes y respuestas correspondientes. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado, si está presente en la solicitud y el valor tiene como máximo 1024 caracteres ASCII visibles. Si el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.
x-ms-is-hns-enabled Versión 2019-07-07 y posteriores. Indica si la cuenta tiene habilitado un espacio de nombres jerárquico.

Response body

Ninguno.

Respuesta de muestra

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

Authorization

Se requiere autorización al llamar a cualquier operación de acceso a datos en Azure Storage. Puede autorizar la Get Account Information operación como se describe a continuación.

Esta operación no admite la autorización basada en OAuth a través de un token de acceso desde Azure Active Directory/MSI o una SAS de delegación de usuarios.

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control granular sobre cómo un cliente puede acceder a los datos. Puede especificar a qué recurso puede tener acceso el cliente, a qué permisos tienen esos recursos y cuánto tiempo es válido la SAS.

La Get Account Information operación admite la autorización mediante una SAS de cuenta o una SAS de servicio con al menos un permiso disponible.

SAS de cuenta

Una SAS de cuenta está protegida con la clave de cuenta de almacenamiento. SAS de cuenta delega el acceso a los recursos en uno o varios de los servicios de almacenamiento. Todas las operaciones disponibles con una SAS de servicio o delegación de usuarios están también disponibles con una SAS de cuenta.

Para más información sobre la SAS de la cuenta, consulte Creación de una SAS de cuenta.

SAS de servicio

Una SAS de servicio está protegida con la clave de cuenta de almacenamiento. Una SAS de servicio delega el acceso a un recurso en un único servicio de Azure Storage, como Blob Storage.

Cuando no se permite el acceso a la clave compartida para la cuenta de almacenamiento, no se permitirá un token de SAS de servicio en una solicitud a Blob Storage. Para más información, consulte Descripción de cómo no permitir la clave compartida afecta a los tokens de SAS.

Para más información sobre la SAS de servicio, consulte Creación de una SAS de servicio.

Comentarios

La ruta de acceso URL de la solicitud no afecta a la información que proporciona esta operación. Su propósito es permitir que la solicitud autorice correctamente con un token de SAS que especifique el recurso permitido.

El recurso especificado no necesita existir para que esta operación se realice correctamente. Por ejemplo, un token de SAS generado con un blob inexistente y los permisos válidos se realizarán correctamente con una ruta de acceso url que incluya el nombre de cuenta correcto, el nombre de contenedor correcto y el nombre del blob inexistente.

Facturación

Las solicitudes de precios pueden originarse en clientes que usan API de Blob Storage, ya sea directamente a través de la API REST de Blob Storage o desde una biblioteca cliente de Azure Storage. Estas solicitudes acumulan cargos por transacción. El tipo de transacción afecta a cómo se cobra la cuenta. Por ejemplo, las transacciones de lectura se acumulan en una categoría de facturación diferente a las transacciones de escritura. En la tabla siguiente se muestra la categoría de facturación de Get Account Information las solicitudes basadas en el tipo de cuenta de almacenamiento:

Operación Tipo de cuenta de almacenamiento Categoría de facturación
Obtener información de la cuenta Blobs en bloques Premium
De uso general, estándar, v2		 Otras operaciones
Obtener información de la cuenta De uso general, estándar, v1 Lee operaciones.

Para obtener información sobre los precios de la categoría de facturación especificada, consulte precios Azure Blob Storage.