Eigenschappen van Table Service op halen

Met de bewerking worden de eigenschappen van de Table-service van een opslagaccount opgeslagen, inclusief eigenschappen voor Get Table Service Properties Storage Analytics- en CORS-regels (Cross-Origin Resource Sharing).

Zie CORS-ondersteuning voor de Storage Services voor gedetailleerde informatie over CORS-regels en evaluatielogica.

Aanvraag

De Get Table Service Properties aanvraag kan als volgt worden opgegeven. HTTPS wordt aanbevolen. Vervang <account-name> door de naam van uw opslagaccount:

Methode Aanvraag-URI HTTP-versie
GET https://<account-name>.table.core.windows.net/?restype=service&comp=properties 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

URI-parameter Beschrijving
restype=service&comp=properties Vereist. De combinatie van beide queryreeksen is vereist om de eigenschappen van de Tabelservice op te halen.
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 naam van het opslagaccount en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
Date of 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. Biedt een door de client gegenereerde, ondoorzichtige waarde met een limiet van 1 KiB die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests 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).

Antwoordheaders

Het antwoord voor deze bewerking bevat de volgende headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Reactieheader Beschrijving
x-ms-request-id Een waarde die op unieke manier een aanvraag aan de service identificeert.
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.
x-ms-client-request-id Deze header kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit ten beste 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

Voor versie 2012-02-12 en eerder is de indeling van de antwoord-body als volgt:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <Metrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Metrics>  
</StorageServiceProperties>  

Vanaf versie 2013-08-15 is de indeling van de antwoord-body als volgt:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>version-number</Version>  
        <Delete>true|false</Delete>  
        <Read>true|false</Read>  
        <Write>true|false</Write>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
    <MinuteMetrics>  
        <Version>version-number</Version>  
        <Enabled>true|false</Enabled>  
        <IncludeAPIs>true|false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true|false</Enabled>  
            <Days>number-of-days</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins>  
            <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods>  
            <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds>  
            <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders>  
            <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>  
  

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

Naam van element Beschrijving
Logboekregistratie Groeperen de instellingen voor Logboekregistratie van Azure Analytics.
Metrische gegevens Groeperen de instellingen voor metrische gegevens van Azure Analytics. De instellingen voor metrische gegevens bieden een samenvatting van de aanvraagstatistieken gegroepeerd op API in statistische functies per uur voor tabellen.
HourMetrics Groepeert de Azure Analytics HourMetrics-instellingen. De hourMetrics-instellingen bieden een samenvatting van de aanvraagstatistieken gegroepeerd op API in statistische functies per uur voor tabellen.
MinuteMetrics Groepeert de Azure Analytics MinuteMetrics-instellingen. De minuteMetrics-instellingen bieden aanvraagstatistieken voor elke minuut voor tabellen.
Versie De versie van Storage Analytics die momenteel wordt gebruikt.
Verwijderen Is alleen van toepassing op de configuratie van logboekregistratie. Geeft aan of verwijderaanvragen worden geregistreerd.
Lezen Is alleen van toepassing op de configuratie van logboekregistratie. Geeft aan of leesaanvragen worden geregistreerd.
Schrijven Is alleen van toepassing op de configuratie van logboekregistratie. Geeft aan of schrijfaanvragen worden geregistreerd.
Ingeschakeld Geeft aan of metrische gegevens zijn ingeschakeld voor de Table-service.

Als geografisch redundante replicatie met leestoegang is ingeschakeld, worden zowel primaire als secundaire metrische gegevens verzameld. Als geografisch redundante replicatie met leestoegang niet is ingeschakeld, worden alleen primaire metrische gegevens verzameld.
IncludeAPIs Is alleen van toepassing op de configuratie van metrische gegevens. Geeft aan of metrische gegevens samenvattingsstatistieken genereren voor aangeroepen API-bewerkingen.
RetentionPolicy/Enabled Geeft aan of een retentiebeleid is ingeschakeld voor de opslagservice.
RetentionPolicy/Days Hiermee wordt het aantal dagen aangegeven dat metrische gegevens of logboekgegevens worden bewaard. Alle gegevens die ouder zijn dan deze waarde worden verwijderd.
Cors Groepeert alle CORS-regels.
CorsRule Groepeert instellingen voor een CORS-regel.
AllowedOrigins Een door komma's gescheiden lijst met oorspronkelijke domeinen die zijn toegestaan via CORS, of '*' als alle domeinen zijn toegestaan.
ExposedHeaders Een door komma's gescheiden lijst met antwoordheaders om weer te geven aan CORS-clients.
MaxAgeInSeconds Het aantal seconden dat de client/browser een preflight antwoord in de cache moet cachen.
AllowedHeaders Een door komma's gescheiden lijst met headers die deel mogen uitmaken van de cross-origin-aanvraag.
AllowedMethods Een door komma's gescheiden lijst met HTTP-methoden die door de oorsprong mogen worden uitgevoerd. Voor Azure Storage zijn toegestane methoden DELETE, GET, HEAD, MERGE, POST, OPTIONS of PUT.

Autorisatie

Alleen de eigenaar van het opslagaccount kan deze bewerking aanroepen.

Voorbeeld van aanvraag en antwoord

Met de volgende voorbeeld-URI wordt een aanvraag ingediend om de eigenschappen van de Table-service op te halen voor het fictieve opslagaccount met de naam myaccount:

GET https://myaccount.table.core.windows.net/?restype=service&comp=properties HTTP/1.1  

De aanvraag wordt verzonden met de volgende headers:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 04:49:03 GMT  
Authorization: SharedKey  
myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE=  
Host: myaccount.table.core.windows.net  

Nadat de aanvraag is verzonden, wordt het volgende antwoord geretourneerd:

HTTP/1.1 200 OK  
Content-Length: 1020  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 04:49:04 GMT  
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
x-ms-version: 2013-08-15  
  

De antwoord-body is vergelijkbaar met het volgende:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceProperties>  
    <Logging>  
        <Version>1.0</Version>  
        <Delete>true</Delete>  
        <Read>false</Read>  
        <Write>true</Write>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </Logging>  
    <HourMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>false</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </HourMetrics>  
        <MinuteMetrics>  
        <Version>1.0</Version>  
        <Enabled>true</Enabled>  
        <IncludeAPIs>true</IncludeAPIs>  
        <RetentionPolicy>  
            <Enabled>true</Enabled>  
            <Days>7</Days>  
        </RetentionPolicy>  
    </MinuteMetrics>  
    <Cors>  
        <CorsRule>  
            <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins>  
            <AllowedMethods>GET,PUT</AllowedMethods>  
            <MaxAgeInSeconds>500</MaxAgeInSeconds>  
            <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders>  
            <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders>  
        </CorsRule>  
    </Cors>  
</StorageServiceProperties>  

Zie ook

Storage Analytics
CORS-ondersteuning voor de Storage Services
CORS HTTP-specificatie