Tabelservicestatistieken ophalen
Met Get Table Service Stats de bewerking worden statistieken opgehaald die betrekking hebben op replicatie voor Azure Table Storage. Het is alleen beschikbaar op het eindpunt van de secundaire locatie wanneer geografisch redundante replicatie met leestoegang is ingeschakeld voor het opslagaccount.
Aanvraag
De Get Table Service Stats aanvraag kan als volgt worden samengesteld. U wordt aangeraden HTTPS te gebruiken. Vervang myaccount door de naam van uw opslagaccount en houd er rekening mee dat het secundaire achtervoegsel -vereist is:
| Methode | Aanvraag-URI | HTTP-versie |
|---|---|---|
| GET | https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Notitie
De URI moet altijd een slash (/) bevatten om de hostnaam te scheiden van het pad en de querygedeelten van de URI. In deze bewerking is het padgedeelte van de URI leeg.
URI-parameters
De volgende aanvullende parameters kunnen worden opgegeven voor de aanvraag-URI:
| Parameter | Beschrijving |
|---|---|
Timeout |
Optioneel. De timeout parameter wordt uitgedrukt in seconden. |
Aanvraagheaders
De vereiste en optionele aanvraagheaders worden beschreven in de volgende tabel:
| Aanvraagheader | Beschrijving |
|---|---|
Authorization |
Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
Date or x-ms-date |
Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie. |
x-ms-version |
Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
x-ms-client-request-id |
Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 kibibyte (KiB) die wordt vastgelegd in de logboeken wanneer logboekregistratie is geconfigureerd. We raden u ten zeerste aan deze header te gebruiken om activiteiten aan de clientzijde te correleren met aanvragen die de server ontvangt. Zie [Azure Table Storage bewaken) voor meer informatie. |
Aanvraagbody
Geen.
Antwoord
Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst
Statuscode
Een geslaagde bewerking retourneert statuscode 200 (OK). Wanneer het wordt aangeroepen op een eindpunt voor een secundaire locatie dat niet is ingeschakeld voor een secundaire leesbewerking, wordt de HTTP-statuscode 403 (Onvoldoende accountmachtigingen) geretourneerd.
Antwoordheaders
Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord bevat ook aanvullende standaard-HTTP-headers. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.
| Antwoordheader | Beschrijving |
|---|---|
x-ms-request-id |
Identificeert op unieke wijze de aanvraag die is gedaan en kan worden gebruikt om problemen met de aanvraag op te lossen. Zie Problemen met API-bewerkingen oplossen voor meer informatie. |
x-ms-version |
Hiermee geeft u de versie van de bewerking die is gebruikt voor het antwoord. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
Date |
Een UTC-datum/tijd-waarde die wordt gegenereerd door de service, die de tijd aangeeft waarop het antwoord is gestart. |
x-ms-client-request-id |
Kan worden gebruikt om problemen met aanvragen en de bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde niet meer dan 1024 zichtbare ASCII-tekens bevat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze niet aanwezig in het antwoord. |
Hoofdtekst van de reactie
De indeling van de antwoordtekst is als volgt:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
De elementen van de antwoordtekst worden beschreven in de volgende tabel:
| Antwoordheader | Beschrijving |
|---|---|
Status |
De status van de secundaire locatie. Mogelijke waarden zijn: - live: geeft aan dat de secundaire locatie actief en operationeel is. - bootstrap: geeft aan dat de initiële synchronisatie van de primaire locatie naar de secundaire locatie wordt uitgevoerd. Dit gebeurt meestal wanneer replicatie voor het eerst wordt ingeschakeld. - niet beschikbaar: geeft aan dat de secundaire locatie tijdelijk niet beschikbaar is. |
LastSyncTime |
Een UTC-datum/tijd-waarde, tot de seconde. Alle primaire schrijfbewerkingen die voorafgaan aan deze waarde zijn gegarandeerd beschikbaar voor leesbewerkingen op de secundaire schrijfbewerkingen. Primaire schrijfbewerkingen na dit tijdstip zijn mogelijk wel of niet beschikbaar voor leesbewerkingen. De waarde is mogelijk leeg als LastSyncTime deze niet beschikbaar is. Dit kan gebeuren als de replicatiestatus bootstrap of niet beschikbaar is.Hoewel geo-replicatie continu is ingeschakeld, kan het resultaat een waarde in de LastSyncTime cache weergeven van de service die om de paar minuten wordt vernieuwd. |
Autorisatie
Alleen de accounteigenaar kan deze bewerking aanroepen.
Opmerkingen
Met geografisch redundante replicatie onderhoudt Azure Storage uw gegevens op twee locaties. Op beide locaties onderhoudt Azure Storage voortdurend meerdere goede replica's van de gegevens.
De locatie waar u gegevens leest, maakt, bijwerkt of verwijdert, is de primaire opslagaccountlocatie. De primaire locatie bestaat in de regio die u kiest wanneer u een account maakt via de klassieke Azure-portal van Azure Management (bijvoorbeeld VS - noord-centraal).
De locatie waarnaar uw gegevens worden gerepliceerd, is de secundaire locatie. De secundaire locatie bevindt zich in een regio die automatisch geografisch is gekoppeld aan de primaire regio. Alleen-lezentoegang is beschikbaar vanaf de secundaire locatie, als geografisch redundante replicatie met leestoegang is ingeschakeld voor uw opslagaccount.
Zie Gegevensredundantie voor meer informatie over geografisch redundante replicatie met leestoegang.
Als u een aanvraag voor een leesbewerking wilt maken voor het secundaire eindpunt, voegt u -secundair toe aan de accountnaam in de URI die u gebruikt om te lezen uit Table Storage. Een secundaire URI voor de bewerking Query Entities is bijvoorbeeld vergelijkbaar met https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').
Voorbeeld van aanvraag en antwoord
Hier volgt een voorbeeldaanvraag voor de Get Table Service Stats bewerking:
GET http://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats HTTP/1.1
De aanvraag wordt verzonden met de volgende headers:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=
De statuscode en antwoordheaders worden als volgt geretourneerd:
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
Het antwoord bevat de volgende XML-hoofdtekst:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live</Status>
<LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>
</GeoReplication>
</StorageServiceStats>