VERTRIEB: 1-800-867-1380

Abrufen von Blob-Diensteigenschaften

Letzte Aktualisierung: November 2014

Der Vorgang Get Blob Service Properties ruft die Eigenschaften des Blob-Diensts eines Speicherkontos ab, einschließlich Eigenschaften für Speicheranalyse und CORS (Cross-Origin Resource Sharing)-Regeln.

Ausführliche Informationen zu CORS-Regeln und Auswertungslogik finden Sie unter CORS (Cross-Origin Resource Sharing)-Unterstützung für Azure-Speicherdienste.

Die Get Blob Service Properties-Anforderung kann wie folgt angegeben werden. HTTPS wird empfohlen. Ersetzen Sie <account-name> durch den Namen des Speicherkontos:

 

Methode Anforderungs-URI HTTP-Version

GET

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Beachten Sie, dass der URI immer einen Schrägstrich (/) enthalten muss, um den Hostnamen vom Pfad- und Abfrageteil des URIs zu trennen. Bei diesem Vorgang ist der Pfadteil des URIs leer.

 

URI-Parameter Beschreibung

restype=service&comp=properties

Erforderlich. Zum Abrufen der Speicherdiensteigenschaften ist die Kombination beider Abfragezeichenfolgen erforderlich.

timeout

Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Blob-Dienstvorgänge.

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

 

Anforderungsheader Beschreibung

Authorization

Erforderlich. Gibt das Authentifizierungsschema, den Speicherkontonamen und die Signatur an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

Date - oder - x-ms-date

Erforderlich. Gibt die Uhrzeit der Anforderung in koordinierter Weltzeit (UTC) an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

x-ms-version

Erforderlich für alle authentifizierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für den Blob-Dienst, den Warteschlangendienst und den Tabellendienst in Windows Azure.

x-ms-client-request-id

Optional. Stellt einen vom Client generierten, nicht transparenten Wert mit einer Zeichenbeschränkung von 1 KB bereit, der bei Aktivierung der Speicheranalyse-Protokollierung in den Analyseprotokollen erfasst wird. Die Verwendung dieses Headers wird dringend empfohlen, um clientseitige Aktivitäten mit den vom Server empfangenen Anforderungen zu korrelieren. Weitere Informationen finden Sie unter Informationen zur Protokollierung durch die Speicheranalyse und Azure-Speicherprotokollierung: Verwenden von Protokollen zur Nachverfolgung von Speicheranforderungen.

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Weitere Informationen zu Statuscodes finden Sie unter Dienstverwaltungsstatus und Fehlercodes.

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

 

Antwortheader Beschreibung

x-ms-request-id

Ein Wert, der eine für den Dienst ausgeführte Anforderung eindeutig identifiziert.

x-ms-version

Gibt die Version des für die Antwort verwendeten Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für den Blob-Dienst, den Warteschlangendienst und den Tabellendienst in Windows Azure.

Bei Version 2012-02-12 und früheren Versionen weist der Antworttext folgendes Format auf:

<?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>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

Ab Version 2013-08-15 weist der Antworttext das folgende Format auf:

 <?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>     <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties> 

In der folgenden Tabelle werden die Elemente des Antworttexts beschrieben:

 

Name des Elements Beschreibung

Logging

Gruppiert die Logging -Einstellungen für Azure-Analysen.

Metrics

Gruppiert die Metrics -Einstellungen für Azure-Analysen. Die Metrics -Einstellungen stellen eine Zusammenfassung der Anforderungsstatistiken bereit, die in stündlichen Aggregaten für BLOBs nach API gruppiert sind.

HourMetrics

Gruppiert die HourMetrics -Einstellungen für Azure-Analysen. Die HourMetrics -Einstellungen stellen eine Zusammenfassung der Anforderungsstatistiken bereit, die in stündlichen Aggregaten für BLOBs nach API gruppiert sind.

MinuteMetrics

Gruppiert die MinuteMetrics -Einstellungen für Azure-Analysen. Die MinuteMetrics -Einstellungen stellen Anforderungsstatistiken für BLOBs im Minutentakt bereit.

Version

Die Version der derzeit verwendeten Speicheranalyse.

Löschen

Gilt nur für die Protokollierungskonfiguration. Gibt an, ob Löschanforderungen protokolliert werden.

Überwachungsdaten

Gilt nur für die Protokollierungskonfiguration. Gibt an, ob Leseanforderungen protokolliert werden.

Überwachungsdaten

Gilt nur für die Protokollierungskonfiguration. Gibt an, ob Schreibanforderungen protokolliert werden.

Aktiviert

Gibt an, ob Metriken für den Blob-Dienst aktiviert sind.

Wenn die georedundante Replikation mit Lesezugriff aktiviert ist, werden sowohl primäre als auch sekundäre Metriken gesammelt. Wenn die georedundante Replikation mit Lesezugriff nicht aktiviert ist, werden nur primäre Metriken gesammelt.

IncludeAPIs

Gilt nur für die Konfiguration von Metriken. Gibt an, ob von einer Metrik eine Zusammenfassungsstatistik für aufgerufene API-Vorgänge generiert wird.

Aufbewahrungsrichtlinie/Aktiviert

Gibt an, ob eine Beibehaltungsrichtlinie für den Speicherdienst aktiviert ist.

Aufbewahrungsrichtlinie/Tage

Gibt die Anzahl von Tagen an, für die Metrik- oder Protokollierungsdaten beibehalten werden. Alle Daten, die älter als dieser Wert sind, werden gelöscht.

DefaultServiceVersion

DefaultServiceVersion gibt die Standardversion an, die für Anforderungen des Blob-Diensts verwendet werden soll, wenn die Version einer eingehenden Anforderung nicht angegeben ist. Zulässige Werte sind Version 2008-10-27 und neuere Versionen. Weitere Informationen zu den anwendbaren Versionen finden Sie unter Versionsverwaltung für den Blob-Dienst, den Warteschlangendienst und den Tabellendienst in Windows Azure.

Cors

Gruppiert alle CORS-Regeln.

CorsRule

Gruppiert Einstellungen für eine CORS-Regel.

AllowedOrigins

Eine durch Trennzeichen getrennte Liste von Ursprungsdomänen, die über CORS zulässig sind, oder "*", falls alle Domänen zulässig sind.

ExposedHeaders

Eine durch Trennzeichen getrennte Liste mit Antwortheadern, die für CORS-Clients verfügbar gemacht werden sollen.

MaxAgeInSeconds

Gibt an, wie viele Sekunden eine Preflight-Antwort vom Client/Browser zwischengespeichert werden soll.

AllowedHeaders

Eine durch Trennzeichen getrennte Liste mit Headern, die als Teil der ursprungsübergreifenden Anforderung zulässig sind.

AllowedMethods

Eine durch Trennzeichen getrennte Liste von HTTP-Methoden, die vom Ursprung ausgeführt werden dürfen. Für den Azure-Speicher zulässige Methoden sind DELETE, GET, HEAD, MERGE, POST, OPTIONS oder PUT.

Dieser Vorgang kann nur vom Speicherkontobesitzer aufgerufen werden.

Der folgende Beispiel-URI sendet eine Anforderung zum Abrufen der Blob-Diensteigenschaften für das fiktive Speicherkonto meinkonto:

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

Die Anforderung wird mit den folgenden Headern gesendet;

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

Nachdem die Anforderung gesendet wurde, wird die folgende Antwort zurückgegeben:

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

Die Antwort enthält den folgenden XML-Text:

<?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>     <DefaultServiceVersion>2013-08-15</DefaultServiceVersion> </StorageServiceProperties> 

Siehe auch

Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.
Anzeigen:
© 2015 Microsoft