Get Table Service Stats
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>