Get Table Service Stats

  • Articolo

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

Richiesta

La richiesta Get Table 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 -secondary :

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

Nota

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

Parametri URI

È possibile specificare i parametri aggiuntivi seguenti nell'URI della richiesta:

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

Intestazioni della richiesta

Le intestazioni di richiesta obbligatorie e facoltative sono descritte nella tabella seguente:

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 al momento della configurazione della registrazione. È consigliabile usare questa intestazione per correlare le attività lato client alle richieste ricevute dal server. Per altre informazioni, vedere [Monitorare l'archiviazione tabelle 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 i problemi della richiesta. Per altre informazioni, vedere Risolvere i problemi relativi alle operazioni api.
x-ms-version Specifica la versione dell'operazione utilizzata 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 di avvio della risposta.
x-ms-client-request-id Può essere usato per risolvere i problemi relativi alle richieste e alle 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. Questa situazione si verifica normalmente quando la replica è abilitata per la prima volta.
- non disponibile: indica che la posizione secondaria è temporaneamente non disponibile.
LastSyncTime Valore di data/ora UTC, al secondo. Tutte le scritture primarie che precedono questo valore sono sicuramente disponibili per le operazioni di lettura nella scrittura secondaria. Le scritture primarie dopo questo momento potrebbero non essere disponibili o meno 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 che viene 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 in modo durevole in due posizioni. In entrambe le posizioni Archiviazione di Azure mantiene 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 classico di gestione di Azure, ad esempio Stati Uniti centro-settentrionali.

La posizione in cui i dati vengono replicati è la posizione secondaria. La posizione secondaria risiede in un'area associata automaticamente geograficamente 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 e accesso in lettura, vedere Ridondanza dei dati.

Per costruire una richiesta per un'operazione di lettura sull'endpoint secondario, aggiungere -secondary al nome dell'account nell'URI usato per leggere da Archiviazione tabelle. Ad esempio, un URI secondario per l'operazione Query Entities sarà simile a https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').

Richiesta e risposta di esempio

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

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

La richiesta viene inviata con le intestazioni seguenti:

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-Table/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 tabelle)