VENTAS: 1-800-867-1389

Get Blob Service Properties

Actualizado: abril de 2015

La operación Get Blob Service Properties obtiene las propiedades del servicio Blob de una cuenta de almacenamiento, incluidas las propiedades de Análisis de almacenamiento y reglas de CORS (Uso compartido de recursos entre orígenes).

Para obtener información detallada sobre las reglas de CORS y la lógica de evaluación, vea Compatibilidad con Uso compartido de recursos entre orígenes (CORS) para los Servicios de almacenamiento de Azure.

La solicitud Get Blob Service Properties se puede especificar como sigue. Se recomienda HTTPS. Reemplace <account-name> por el nombre de la cuenta de almacenamiento:

 

Método URI de solicitud Versión de HTTP

GET

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Tenga en cuenta que el URI debe incluir siempre la barra diagonal (/) para separar el nombre de host de las partes de la ruta de acceso y de la consulta del URI. En el caso de esta operación, la parte de la ruta de acceso del URI está vacía.

 

Parámetro URI Descripción

restype=service&comp=properties

Obligatorio. Es necesaria la combinación de ambas cadenas de consulta para obtener las propiedades del servicio de almacenamiento.

timeout

Opcional. El parámetro timeout se expresa en segundos. Para obtener más información, vea Establecer los tiempos de espera para las operaciones del servicio Blob.

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.

 

Encabezado de solicitud Descripción

Authorization

Obligatorio. Especifica el esquema de autenticación, el nombre de la cuenta de almacenamiento y la firma. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

Date O bien x-ms-date

Obligatorio. Especifica la hora universal coordinada (UTC) para la solicitud. Para obtener más información, vea Autenticación para los servicios de almacenamiento de Azure.

x-ms-version

Obligatorio para todas las solicitudes autenticadas. Especifica la versión de la operación que se utiliza para esta solicitud. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

x-ms-client-request-id

Opcional. Proporciona un valor opaco generado por el cliente con un límite de caracteres de 1 KB que se graba en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor. Para obtener más información, vea Acerca del registro del análisis de almacenamiento y Registro de Azure: usar registros para realizar el seguimiento de las solicitudes de almacenamiento.

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

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

Para obtener información acerca de los códigos de estado, vea Estado y códigos de error de administración del servicio.

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

 

Encabezado de respuesta Descripción

x-ms-request-id

Valor que identifica de forma exclusiva una solicitud realizada ante el servicio.

x-ms-version

Especifica la versión de la operación utilizada para la respuesta. Para obtener más información, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

Para la versión 2012-02-12 y otras anteriores, el formato del cuerpo de la respuesta es el siguiente:

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties>     <Logging>         <Version>version-number</Version>         <Delete>true|false</Delete>         <Read>true|false</Read>         <Write>true|false</Write>         <RetentionPolicy>             <Enabled>true|false</Enabled>             <Days>number-of-days</Days>         </RetentionPolicy>     </Logging>     <Metrics>         <Version>version-number</Version>         <Enabled>true|false</Enabled>         <IncludeAPIs>true|false</IncludeAPIs>         <RetentionPolicy>             <Enabled>true|false</Enabled>             <Days>number-of-days</Days>         </RetentionPolicy>     </Metrics>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

A partir de la versión 2013-08-15, el formato del cuerpo de respuesta es el siguiente:

 <?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties>     <Logging>         <Version>version-number</Version>         <Delete>true|false</Delete>         <Read>true|false</Read>         <Write>true|false</Write>         <RetentionPolicy>             <Enabled>true|false</Enabled>             <Days>number-of-days</Days>         </RetentionPolicy>     </Logging>     <HourMetrics>         <Version>version-number</Version>         <Enabled>true|false</Enabled>         <IncludeAPIs>true|false</IncludeAPIs>         <RetentionPolicy>             <Enabled>true|false</Enabled>             <Days>number-of-days</Days>         </RetentionPolicy>     </HourMetrics>     <MinuteMetrics>         <Version>version-number</Version>         <Enabled>true|false</Enabled>         <IncludeAPIs>true|false</IncludeAPIs>         <RetentionPolicy>             <Enabled>true|false</Enabled>             <Days>number-of-days</Days>         </RetentionPolicy>     </MinuteMetrics>     <Cors>         <CorsRule>             <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>             <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>             <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>             <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>             <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>         </CorsRule>     </Cors>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties> 

En la tabla siguiente se describen los elementos del cuerpo de respuesta:

 

Nombre de elemento Descripción

Registro

Agrupa los valores de Registro de análisis de Azure.

Metrics

Agrupa los valores de Metrics de análisis de Azure. Los valores de Metrics proporcionan un resumen de las estadísticas de solicitudes agrupadas por API en agregados a intervalos de una hora para los blobs.

HourMetrics

Agrupa los valores de HourMetrics de análisis de Azure. Los valores de HourMetrics proporcionan un resumen de las estadísticas de solicitudes agrupadas por API en agregados a intervalos de una hora para los blobs.

MinuteMetrics

Agrupa los valores de MinuteMetrics de análisis de Azure. Los valores de MinuteMetrics proporcionan estadísticas de solicitudes para cada minuto para los blobs.

Versión

La versión de Análisis de almacenamiento que se usa actualmente.

Eliminar

Se aplica solamente a la configuración de registro. Indica si se están registrando las solicitudes de eliminación.

Lectura

Se aplica solamente a la configuración de registro. Indica si se están registrando las solicitudes de lectura.

Escribir

Se aplica solamente a la configuración de registro. Indica si se están registrando las solicitudes de escritura.

Habilitado

Indica si están habilitadas las métricas para el servicio Blob.

Si está habilitada la replicación con redundancia geográfica con acceso de lectura, se recopilan las métricas principales y secundarias. Si no está habilitada la replicación con redundancia geográfica con acceso de lectura, solo se recopilan las métricas principales.

IncludeAPIs

Se aplica solamente a la configuración de métricas. Indica si las métricas generan estadísticas de resumen para las operaciones de API a las que se ha llamado.

RetentionPolicy/Enabled

Indica si se ha habilitado una directiva de retención para el servicio de almacenamiento.

RetentionPolicy/Days

Indica el número de días que se conservan los datos de métricas o de registro. Todos los datos anteriores a este valor se eliminarán.

DefaultServiceVersion

DefaultServiceVersion indica la versión predeterminada que se debe usar para las solicitudes que se realizan en el servicio Blob si en una solicitud entrante no se ha especificado la versión. Los valores incluyen la versión 2008-10-27 y las versiones más recientes. Para obtener más información sobre las versiones aplicables, vea Versiones de los servicios Blob, Cola y Tabla de Windows Azure.

Cors

Agrupa todas las reglas de CORS.

CorsRule

Agrupa los valores de una regla de CORS.

AllowedOrigins

Lista delimitada por comas de dominios de origen que se permiten mediante CORS, o “*” si se permiten todos los dominios.

ExposedHeaders

Lista delimitada por comas de encabezados de respuesta para exponer a los clientes de CORS.

MaxAgeInSeconds

Número de segundos durante los cuales el cliente/explorador debe almacenar en memoria caché una respuesta de comprobaciones preparatorias.

AllowedHeaders

Lista delimitada por comas de encabezados que se permite que formen parte de la solicitud entre orígenes.

AllowedMethods

Lista delimitada por comas de los métodos HTTP que puede ejecutar el origen. En Almacenamiento de Azure, los métodos permitidos son DELETE, GET, HEAD, MERGE, POST, OPTIONS o PUT.

Solo el propietario de la cuenta de almacenamiento puede llamar a esta operación.

El URI de ejemplo siguiente realiza una solicitud para obtener las propiedades del servicio BLOB para la cuenta de almacenamiento ficticia denominada myaccount:

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

La solicitud se envía con los encabezados siguientes:

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.blob.core.windows.net

Una vez enviada la solicitud, se devuelve la respuesta siguiente:

HTTP/1.1 200 OK Content-Length: 1020 Content-Type: application/xml Date: Wed, 23 Oct 2013 04:28:20 GMT Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 x-ms-version: 2013-08-15 

La respuesta incluye el cuerpo XML siguiente.

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties>     <Logging>         <Version>1.0</Version>         <Delete>true</Delete>         <Read>false</Read>         <Write>true</Write>         <RetentionPolicy>             <Enabled>true</Enabled>             <Days>7</Days>         </RetentionPolicy>     </Logging>     <HourMetrics>         <Version>1.0</Version>         <Enabled>true</Enabled>         <IncludeAPIs>false</IncludeAPIs>         <RetentionPolicy>             <Enabled>true</Enabled>             <Days>7</Days>         </RetentionPolicy>     </HourMetrics>     <MinuteMetrics>         <Version>1.0</Version>         <Enabled>true</Enabled>         <IncludeAPIs>true</IncludeAPIs>         <RetentionPolicy>             <Enabled>true</Enabled>             <Days>7</Days>         </RetentionPolicy>     </MinuteMetrics>     <Cors>         <CorsRule>       <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>       <AllowedMethods>GET,PUT</AllowedMethods>       <MaxAgeInSeconds>500</MaxAgeInSeconds>       <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>       <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>   </CorsRule>     </Cors>     <DefaultServiceVersion>2013-08-15</DefaultServiceVersion> </StorageServiceProperties> 

Vea también

¿Te ha resultado útil?
(Caracteres restantes: 1500)
Gracias por sus comentarios
Mostrar:
© 2015 Microsoft