Statistieken van Table Service op halen

Met Get Table Service Stats de bewerking worden statistieken opgehaald die betrekking hebben op replicatie voor de Table-service. Deze is alleen beschikbaar op het secundaire locatie-eindpunt wanneer geografisch redundante replicatie met leestoegang is ingeschakeld voor het opslagaccount.

Aanvraag

De Get Table Service Stats aanvraag kan als volgt worden samengesteld. HTTPS wordt aanbevolen. Vervang myaccount door de naam van uw opslagaccount en merk op dat het -secondary achtervoegsel vereist is:

Methode Aanvraag-URI HTTP-versie
GET https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats HTTP/1.1

Houd er rekening mee dat de URI altijd de slash (/) moet bevatten om de hostnaam te scheiden van het pad en de querygedeelten van de URI. In het geval van deze bewerking is het padgedeelte van de URI leeg.

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de aanvraag-URI.

Parameter Beschrijving
Timeout Optioneel. De timeout parameter wordt uitgedrukt in seconden.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de accountnaam en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
Date or x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking moet worden gebruikt voor deze aanvraag. Zie Versioning for the Azure Storage services (Versie Azure Storage services) voor meer informatie.
x-ms-client-request-id Optioneel. Door de client gegenereerde ondoorzichtige waarde met een tekenlimiet van 1 KB die wordt vastgelegd in de analyselogboeken wanneer Storage Analytics-logboekregistratie is ingeschakeld. Het gebruik van deze header wordt sterk aanbevolen voor het correeren van activiteiten aan de clientzijde met aanvragen die door de server worden ontvangen. Zie Azure Logging: Using Logs to Track Storage Requests (Azure-logboekregistratie: logboeken gebruiken om aanvragen Storage volgen) 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 deze wordt aangeroepen op het eindpunt van de secundaire locatie dat niet is ingeschakeld voor secundair lezen, wordt de HTTP-statuscode 403 met fout InsufficientAccountPermissions retourneerd.

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.

Reactieheader Beschrijving
x-ms-request-id Deze header identificeert op unieke manier de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Troubleshooting API Operations (Problemen met API-bewerkingen oplossen) voor meer informatie.
x-ms-version Hiermee geeft u de versie van de bewerking die wordt gebruikt voor het antwoord. Zie Versioning for the Azure Storage services (Versie Azure Storage services) voor meer informatie.
Date Een UTC-datum/tijd-waarde die wordt gegenereerd door de service die het tijdstip aangeeft waarop het antwoord is gestart.
x-ms-client-request-id Deze header kan worden gebruikt voor het oplossen van problemen met aanvragen en bijbehorende antwoorden. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit x-ms-client-request-id 1024 zichtbare ASCII-tekens bestaat. Als de x-ms-client-request-id header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Antwoord body

De indeling van de antwoord-body is als volgt:

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

In de volgende tabel worden de elementen van de antwoord-body beschreven:

Reactieheader 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 GMT-datum/-tijdwaarde tot de tweede. Alle primaire schrijfbewerkingen voorafgaand aan deze waarde zijn gegarandeerd beschikbaar voor leesbewerkingen op de secundaire. Primaire schrijf schrijf schrijfingen na dit tijdstip zijn mogelijk wel of niet beschikbaar voor lees- en schrijfingen.

De waarde is mogelijk leeg als LastSyncTime niet beschikbaar is. Dit kan gebeuren als de replicatiestatus of bootstrap unavailable is.

Hoewel geo-replicatie continu is ingeschakeld, kan het resultaat een waarde in de cache van de service weerspiegelen die om LastSyncTime de paar minuten wordt vernieuwd.

Autorisatie

Alleen de accounteigenaar kan deze bewerking aanroepen.

Opmerkingen

Met geografisch redundante replicatie blijven Azure Storage gegevens duurzaam op twee locaties. Op beide locaties worden Azure Storage meerdere gezonde replica's van uw gegevens onderhouden.

De locatie waar u gegevens leest, maakt, bijwerkt of verwijdert, is de primaire opslagaccountlocatie. De primaire locatie bevindt zich in de regio die u kiest op het moment dat u een account maakt via de klassieke Azure-portal van Azure Management, bijvoorbeeld VS - noord-centraal. De locatie waar 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 de teamblog van Azure Storage meer informatie over geografisch redundante replicatie met leestoegang.

Als u een aanvraag voor een leesbewerking voor het secundaire eindpunt wilt maken, moet u als achtervoegsel toevoegen aan de accountnaam in de URI die u gebruikt om te lezen uit -secondary Table Storage. Een secundaire URI voor de bewerking Query-entiteiten 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 voorbeeld van een aanvraag 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-body:

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

Zie ook

Bewerkingen op het account (Table Service)