Obtener información de la cuenta

La operación Get Account Information 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.

Pedir

Puede construir la solicitud de Get Account Information 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 valor restype de account y un valor de comp de properties, la solicitud usará la operación de Get Account Information. En la tabla siguiente se muestran ejemplos:

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

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

Parámetro	Descripción
restype	Obligatorio. El valor del parámetro restype debe ser account.
comp	Obligatorio. El valor del parámetro comp 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	Obligatorio. Especifica el esquema de autorización, el nombre de la cuenta y la firma. Para más información, consulte Autorizar solicitudes a Azure Storage.
Date or x-ms-date	Obligatorio. Especifica la hora universal coordinada (UTC) de la solicitud. Para más información, consulte Autorizar solicitudes a Azure Storage.
x-ms-version	Necesario para todas las solicitudes autorizadas. Especifica la versión de la operación que se va a usar para esta solicitud. Para esta operación, la versión debe ser 2018-03-28 o posterior. Para más información, consulte Control de versiones de para 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.

Respuesta

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

Código de estado

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 de esta operación incluye los siguientes encabezados. 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 de .

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 obtener 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 la SKU de de la cuenta especificada.
x-ms-account-kind	Identifica el tipo de cuenta de la cuenta especificada. Los valores posibles son Storage, BlobStoragey StorageV2. El encabezado distingue entre las cuentas de almacenamiento de uso general v1 (GPv1) y de uso general v2 (GPv2) mediante la subcadena V2 para las 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 encabezado x-ms-client-request-id, si está presente en la solicitud y el valor es como máximo 1024 caracteres ASCII visibles. Si el encabezado x-ms-client-request-id 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.

Cuerpo de la respuesta

Ninguno.

Respuesta de ejemplo

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  

Autorización

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

Importante

Microsoft recomienda usar el identificador de Entra de Microsoft con identidades administradas para autorizar solicitudes a Azure Storage. Microsoft Entra ID proporciona seguridad y facilidad de uso superiores en comparación con la autorización de clave compartida.

id. de Microsoft Entra (recomendado)

Azure Storage admite el uso de Microsoft Entra ID para autorizar solicitudes a datos de blobs. Con microsoft Entra ID, puede usar el control de acceso basado en rol de Azure (RBAC de Azure) para conceder permisos a una entidad de seguridad. La entidad de seguridad puede ser un usuario, un grupo, una entidad de servicio de aplicación o una identidad administrada de Azure. Microsoft Entra ID autentica la entidad de seguridad para devolver un token de OAuth 2.0. Después, el token se puede usar para autorizar una solicitud en Blob service.

Para obtener más información sobre la autorización mediante el identificador de Entra de Microsoft, consulte Autorizar el acceso a blobs mediante el identificador de Microsoft Entra.

Permisos

A continuación se muestra la acción de RBAC necesaria para que un usuario, grupo, identidad administrada o entidad de servicio de Microsoft Entra llame a la operación de Get Account Information:

• acción RBAC de Azure:Microsoft.Storage/storageAccounts/blobServices/getInfo/action

Esta acción de RBAC se incluye en el rol Propietario o puede asignar esta acción a un rol personalizado.

Para más información sobre cómo asignar roles mediante Azure RBAC, consulte Asignación de un rol de Azure para el acceso a datos de blobs.

Una firma de acceso compartido (SAS) proporciona acceso delegado seguro a los recursos de una cuenta de almacenamiento. Con una SAS, tiene un control pormenorizado 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 operación de Get Account Information admite la autorización mediante una SAS de cuenta.

SAS de cuenta

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

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

clave compartida

La operación de Get Account Information admite autorización de clave compartida. No se recomienda autorizar con claves de cuenta para la mayoría de los escenarios, ya que es menos seguro. Microsoft recomienda no permitir la autorización de clave compartida para la cuenta de almacenamiento siempre que sea posible. Para obtener más información, consulte Impedir autorización con clave compartida.

Observaciones

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 las solicitudes de Get Account Information en función del tipo de cuenta de almacenamiento:

Operación	Tipo de cuenta de almacenamiento	Categoría de facturación
Obtener información de la cuenta	Blob en bloques Premium Uso general estándar v2	Otras operaciones
Obtener información de la cuenta	Uso general estándar v1	Operaciones de lectura

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