Get Table Service Properties

Artículo
06/27/2023

La Get Table Service Properties operación obtiene las propiedades de una cuenta de Azure Table Storage, incluidas las propiedades de Storage Analytics y reglas de uso compartido de recursos entre orígenes (CORS).

Para más información sobre las reglas de CORS y la lógica de evaluación, consulte Compatibilidad de CORS con los servicios de Azure Storage.

Request

La solicitud Get Table Service Properties se puede especificar como sigue. Se recomienda usar 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>.table.core.windows.net/?restype=service&comp=properties`	HTTP/1.1

Nota

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

Parámetros del identificador URI

Parámetro de URI	Descripción
`restype=service&comp=properties`	Necesario. Ambas cadenas de consulta son necesarias para obtener las propiedades de Table Storage.
`timeout`	Opcional. El parámetro `timeout` se expresa en segundos.

Encabezados de solicitud

Los encabezados de solicitud obligatorios y opcionales se describen en la tabla siguiente:

Encabezado de solicitud	Descripción
`Authorization`	Necesario. Especifica el esquema de autorización, el nombre de la cuenta de almacenamiento y la firma. Para obtener más información, vea Autorización de solicitudes a Azure Storage.
`Date` o `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`	Necesario para todas las solicitudes autorizadas. 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 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 de Storage Analytics 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. Para más información, consulte Supervisión de Azure Table Storage.

Cuerpo de la solicitud

Ninguno.

Response

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

status code

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

Encabezados de respuesta

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 se ajustan a la especificación del protocolo HTTP/1.1.

Encabezado de respuesta	Descripción
`x-ms-request-id`	Identifica de forma única una solicitud realizada en el servicio.
`x-ms-version`	Especifica la versión de la operación que se usó para la respuesta. Para obtener más información, vea Versiones de los servicios de Azure Storage.
`x-ms-client-request-id`	Se puede usar para solucionar problemas de solicitudes y sus 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 no contiene más de 1024 caracteres ASCII visibles. Si el `x-ms-client-request-id` encabezado no está presente en la solicitud, no estará presente en la respuesta.

Response body

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>  
</StorageServiceProperties>

A partir de la versión 2013-08-15, 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>  
    <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-separated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-separated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>

Los elementos del cuerpo de respuesta se describen en la tabla siguiente:

Elemento	Descripción
Logging	Agrupa la configuración de registro de Storage Analytics.
Métricas	Agrupa la configuración de métricas de Storage Analytics. La configuración de métricas proporciona un resumen de las estadísticas de solicitud, agrupadas por API en agregados por hora para tablas.
HourMetrics	Agrupa la configuración de Storage Analytics HourMetrics. La configuración hourMetrics proporciona un resumen de las estadísticas de solicitud, agrupadas por API en agregados por hora para las tablas.
MinuteMetrics	Agrupa la configuración de Storage Analytics MinuteMetrics. Los valores de MinuteMetrics proporcionan estadísticas de solicitudes para cada minuto para las tablas.
Versión	La versión de Storage Analytics que está actualmente en uso.
Eliminar	Solo se aplica a la configuración de registro. Indica si se están registrando las solicitudes de eliminación.
Lectura	Solo se aplica a la configuración de registro. Indica si se están registrando las solicitudes de lectura.
Escritura	Solo se aplica a la configuración de registro. Indica si se están registrando las solicitudes de escritura.
Enabled	Indica si las métricas están habilitadas para Table Storage. Si está habilitada la replicación con redundancia geográfica con acceso de lectura, se recopilan las métricas principales y secundarias. Si la replicación con redundancia geográfica con acceso de lectura no está habilitada, solo se recopilan las métricas principales.
IncludeAPIs	Solo se aplica a la configuración de métricas. Indica si las métricas generan estadísticas de resumen para las operaciones de API llamadas.
RetentionPolicy/Enabled	Indica si se ha habilitado una directiva de retención para el servicio de almacenamiento.
RetentionPolicy/Days	Número de días que se conservan las métricas o los datos de registro. Se eliminan todos los datos anteriores a este valor.
Cors	Agrupa todas las reglas de CORS.
CorsRule	Agrupa los valores de una regla de CORS.
AllowedOrigins	Una lista separada por comas de dominios de origen que se permiten a través de CORS o un asterisco (*) 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 que el cliente o explorador debe almacenar en caché una respuesta preparatoria.
AllowedHeaders	Lista separada por comas de encabezados que pueden formar 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.

Authorization

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

Solicitud y respuesta de ejemplo

El siguiente URI de ejemplo realiza una solicitud para obtener las propiedades de Table Storage para una cuenta de almacenamiento ficticia denominada myaccount:

GET https://myaccount.table.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:49:03 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.table.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:49:04 GMT  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15

El cuerpo de respuesta es similar al 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>  
</StorageServiceProperties>

Consulte también

Storage Analytics
Compatibilidad de CORS con los servicios de Azure Storage
Especificación HTTP de CORS