Get Queue Service Stats

  • Articolo

L'operazione Get Queue Service Stats recupera le statistiche correlate alla replica per Archiviazione code di Azure. È disponibile solo nell'endpoint della posizione secondaria quando la replica con ridondanza geografica di accesso in lettura è abilitata per l'account di archiviazione.

Richiesta

La richiesta Get Queue Service Stats può essere costruita come segue. È consigliabile usare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione e notare che è necessario il suffisso -secondario :

Metodo URI richiesta Versione HTTP
GET https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1

Nota

L'URI deve sempre includere un carattere di barra (/) per separare il nome host dal percorso e dalle parti di query dell'URI. In questa operazione la parte del percorso dell'URI è vuota.

Parametri URI

I parametri aggiuntivi seguenti possono essere specificati nell'URI della richiesta:

Parametro Descrizione
Timeout Facoltativa. Il parametro timeout viene espresso in secondi.

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta Descrizione
Authorization Obbligatorio. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date or x-ms-date Obbligatorio. Specifica la data per la richiesta nel fuso orario UTC (Coordinated Universal Time). Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-version Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
x-ms-client-request-id Facoltativa. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando la registrazione è configurata. È consigliabile usare questa intestazione per correlare le attività lato client con le richieste ricevute dal server. Per altre informazioni, vedere Monitorare l'archiviazione code di Azure.

Testo della richiesta

Nessuno.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Codice stato

Un'operazione completata correttamente restituisce 200 (OK). Quando viene chiamato su un endpoint di posizione secondario non abilitato per una lettura secondaria, restituisce il codice di stato HTTP 403 (Autorizzazioni account insufficienti).

Intestazioni di risposta

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta include inoltre intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

Intestazione risposta Descrizione
x-ms-request-id Identifica in modo univoco la richiesta effettuata e può essere usata per risolvere la richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
x-ms-version Specifica la versione dell'operazione usata per la risposta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.
Date Valore di data/ora UTC generato dal servizio, che indica l'ora in cui è stata avviata la risposta.
x-ms-client-request-id Questa intestazione può essere usata per risolvere le richieste e le risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id se presente nella richiesta e il valore non contiene più di 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, non sarà presente nella risposta.

Corpo della risposta

Il formato del corpo della risposta è il seguente:

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

Nella tabella seguente vengono descritti gli elementi del corpo della risposta:

Intestazione risposta Descrizione
Status Stato della posizione secondaria. I valori possibili sono:

- live: indica che la posizione secondaria è attiva e operativa.
- bootstrap: indica che la sincronizzazione iniziale dalla posizione primaria alla posizione secondaria è in corso. Questo si verifica normalmente quando la replica è abilitata per la prima volta.
- non disponibile: indica che la posizione secondaria non è temporaneamente disponibile.
LastSyncTime Valore di data/ora UTC, in secondi. Tutte le scritture primarie che precedono questo valore sono garantite per essere disponibili per le operazioni di lettura nella scrittura secondaria. Le scritture primarie dopo questo momento potrebbero non essere disponibili per le letture.

Il valore potrebbe essere vuoto se LastSyncTime non è disponibile. Ciò può verificarsi se lo stato della replica è bootstrap o non disponibile.

Anche se la replica geografica è abilitata in modo continuo, il LastSyncTime risultato potrebbe riflettere un valore memorizzato nella cache dal servizio aggiornato ogni pochi minuti.

Autorizzazione

Solo il proprietario dell'account può chiamare questa operazione.

Commenti

Con la replica con ridondanza geografica, Archiviazione di Azure gestisce i dati duramente in due posizioni. In entrambe le posizioni Archiviazione di Azure gestisce costantemente più repliche integre dei dati.

La posizione in cui si leggono, creano, aggiornano o eliminano i dati è la posizione dell'account di archiviazione primaria. La posizione primaria esiste nell'area scelta quando si crea un account tramite il portale di Azure Management Azure classico(ad esempio, Stati Uniti centro-settentrionali).

La posizione in cui i dati vengono replicati è la posizione secondaria. La posizione secondaria si trova in un'area associata automaticamente all'area primaria. Dalla posizione secondaria è disponibile l'accesso in sola lettura se la replica geograficamente ridondante con accesso in lettura è abilitata per l'account di archiviazione.

Per altre informazioni sulla replica con ridondanza geografica di accesso in lettura, vedere Ridondanza dei dati.

Per costruire una richiesta per un'operazione di lettura sull'endpoint secondario, aggiungere -secondary come suffisso al nome dell'account nell'URI usato per leggere da Archiviazione code. Ad esempio, un URI secondario per l'operazione Messaggi peek è simile a https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.

Richiesta di esempio e risposta

Di seguito è illustrata una richiesta di esempio per l'operazione Get Queue Service Stats.

GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1

La richiesta viene inviata con le seguenti intestazioni:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=

Il codice di stato e le intestazioni della risposta vengono restituiti nel modo seguente:

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

Nella risposta è incluso il seguente corpo XML:

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

Vedi anche

Operazioni sull'account (servizio di accodamento)