Obtener estadísticas del servicio Cola
La Get Queue Service Stats operación recupera estadísticas relacionadas con la replicación de Azure Queue 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 Queue 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.queue.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
En la tabla siguiente se describen los encabezados de solicitud requeridos 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 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 Queue 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 secundaria 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 a la que se inició la respuesta. |
x-ms-client-request-id |
Este encabezado 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 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 se produce 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, en segundos. 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 estar disponibles o no para 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 podría 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 las dos ubicaciones, Azure Storage mantiene constantemente réplicas en estado correcto 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 a través del 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 para una operación de lectura en el punto de conexión secundario, anexe -secondary como sufijo al nombre de cuenta en el URI que se usa para leer desde Queue Storage. Por ejemplo, un URI secundario para la operación Ver mensajes es similar a https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.
Solicitud y respuesta de ejemplo
A continuación figura una solicitud de ejemplo de la operación Get Queue Service Stats:
GET http://myaccount-secondary.queue.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-Queue/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>