Obtener estadísticas del servicio Tabla

La Get Table Service Stats operación recupera estadísticas relacionadas con la replicación de Azure Table Storage. Solo está disponible en el punto de conexión de ubicación secundaria cuando la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento.

Request

La solicitud Get Table Service Stats se puede construir como sigue. Se recomienda usar HTTPS. Reemplace myaccount por el nombre de la cuenta de almacenamiento y tenga en cuenta que se requiere el sufijo -secondary :

Método URI de solicitud Versión de HTTP
GET https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats 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

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

Parámetro Descripción
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 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 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 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. Cuando se llama a en un punto de conexión de ubicación secundario que no está habilitado para una lectura secundaria, devuelve el código de estado HTTP 403 (Permisos de cuenta insuficientes).

Encabezados de respuesta

La respuesta para esta operación incluye los encabezados siguientes. La respuesta también incluye 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 la solicitud que se realizó y se puede usar para solucionar problemas de la solicitud. Para más información, consulte Solución de problemas de operaciones de API.
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.
Date Valor de fecha y hora UTC generado por el servicio, que indica la hora en que se inició la respuesta.
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

El formato del cuerpo de respuesta es el siguiente:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>  

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

Encabezado de respuesta Descripción
Status El estado de la ubicación secundaria. Los valores posibles son:

- live: indica que la ubicación secundaria está activa y operativa.
- bootstrap: indica que la sincronización inicial desde la ubicación principal a la ubicación secundaria está en curso. Normalmente, esto ocurre cuando la replicación está habilitada por primera vez.
- no disponible: indica que la ubicación secundaria no está disponible temporalmente.
LastSyncTime Valor de fecha y hora UTC, al segundo. Se garantiza que todas las escrituras principales que preceden a este valor estén disponibles para las operaciones de lectura en la escritura secundaria. Las escrituras principales después de este momento en el tiempo podrían o no estar disponibles para las lecturas.

El valor puede estar vacío si LastSyncTime no está disponible. Esto puede ocurrir si el estado de replicación es de arranque o no está disponible.

Aunque la replicación geográfica está habilitada continuamente, el LastSyncTime resultado puede reflejar un valor almacenado en caché del servicio que se actualiza cada pocos minutos.

Authorization

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

Comentarios

Con la replicación con redundancia geográfica, Azure Storage mantiene los datos de forma duradera en dos ubicaciones. En ambas ubicaciones, Azure Storage mantiene constantemente varias réplicas correctas de los datos.

La ubicación en la que lee, crea, actualiza o elimina los datos es la ubicación de la cuenta de almacenamiento principal. La ubicación principal existe en la región que elija al crear una cuenta mediante el Portal de Administración de Azure clásico de Azure (por ejemplo, Centro-norte de EE. UU.).

La ubicación en la que se replican los datos es la ubicación secundaria. La ubicación secundaria reside en una región que se empareja geográficamente automáticamente con la región primaria. El acceso de solo lectura está disponible en la ubicación secundaria, si la replicación con redundancia geográfica con acceso de lectura está habilitada para la cuenta de almacenamiento.

Para obtener más información sobre la replicación con redundancia geográfica con acceso de lectura, consulte Redundancia de datos.

Para construir una solicitud de una operación de lectura en el punto de conexión secundario, anexe -secondary al nombre de cuenta en el URI que se usa para leer desde Table Storage. Por ejemplo, un URI secundario para la operación Entidades de consulta será similar a https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').

Solicitud y respuesta de ejemplo

A continuación figura una solicitud de ejemplo de la operación Get Table Service Stats:

GET http://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats 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 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=  

El código de estado y los encabezados de respuesta se devuelven de la forma siguiente:

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

La respuesta incluye el cuerpo XML siguiente.

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>  

Consulte también

Operaciones en la cuenta (Table Service)