List Queues
Inhaltsverzeichnis reduzieren
Inhaltsverzeichnis erweitern
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

List Queues

 

Dieser Vorgang listet alle Warteschlangen in einem angegebenen Speicherkonto auf.

Die List Queues -Anforderung kann wie folgt erstellt werden. HTTPS wird empfohlen. Ersetzen Sie Myaccount mit dem Namen Ihres Speicherkontos:

Methode

Anforderungs-URI

HTTP-Version

GET

https://myaccount.queue.core.windows.net?comp=list

HTTP/1.1

Wenn eine Anforderung für den emulierten Speicherdienst ausführen, geben Sie die Warteschlange den Port und 127.0.0.1:10001, gefolgt vom Namen emulierten Speicherkontos:

Methode

Anforderungs-URI

HTTP-Version

GET

http://127.0.0.1:10001/devstoreaccount1?comp=list

HTTP/1.1

Im Anforderungs-URI können die folgenden zusätzlichen Parameter angegeben werden.

Parameter

Beschreibung

prefix

Filtert die Ergebnisse, sodass nur Warteschlangen mit einem Namen zurückgegeben werden, der mit dem angegebenen Präfix beginnt.

marker

Ein Zeichenfolgenwert, der den Teil der Liste angibt, der mit dem nächsten Auflistungsvorgang zurückgegeben wird. Gibt der Vorgang ein NextMarker Element innerhalb der Antworttext, wenn die Liste zurückgegeben wurde nicht abgeschlossen. Dieser Wert kann anschließend als Abfrageparameter in einem nachfolgenden Aufruf angegeben werden, um den nächsten Teil der Warteschlangenliste anzufordern.

Der Markerwert ist für den Client nicht transparent.

maxresults

Gibt die maximale zurückzugebende Anzahl von Warteschlangen an. Wenn maxresults nicht angegeben ist, wird der Server bis zu 5.000 Elemente zurück.

include=metadata

Optional. Schließen Sie diesen Parameter ein, um anzugeben, dass die Metadaten des Containers als Teil des Antworttexts zurückgegeben werden sollen.

Beachten Sie, dass die mit diesem Parameter angeforderten Metadaten gemäß den Benennungsbeschränkungen gespeichert werden müssen, die für Version 2009-09-19 des Warteschlangendiensts gelten. Ab dieser Version alle müssen Metadatennamen den Benennungskonventionen für C#-Bezeichner.

timeout

Optional. Die timeout Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Vorgänge des Warteschlangendiensts.

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader

Beschreibung

Authorization

Erforderlich. Gibt das Authentifizierungsschema, den Kontonamen 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

Optional. 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-Protokollierung: Mithilfe von Protokollen zur Track-Speicheranforderungen.

Eine Beispielanforderung finden Sie unten im Abschnitt mit Beispielanforderung und -antwort.

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern sowie einen Antworttext mit der Liste der Warteschlangen.

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

Informationen zu Statuscodes finden Sie unter Status- 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

Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.

x-ms-version

Gibt die Version des Warteschlangendiensts an, der zum Ausführen der Abfrage verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.

Date

Ein vom Dienst generierter Datums-/Uhrzeitwert in UTC, der angibt, wann die Antwort initiiert wurde.

Der Antworttext weist das folgende Format auf. Beachten Sie, dass die Prefix, Marker, und MaxResults Elemente sind nur vorhanden, wenn sie den URI angegeben wurden. Die NextMarker Element verfügt über einen Wert nur dann, wenn die Listenergebnisse nicht vollständig sind.

Für Version 2013-08-15 und höher ist die AccountName Attribut für die EnumerationResults Element wurde umbenannt in ServiceEndpoint. Darüber hinaus die Url Element unter Queue wurde entfernt.

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>string-value</Prefix> <Marker>string-value</Marker> <MaxResults>int-value</MaxResults> <Queues> <Queue> <Name>string-value</Name> <Metadata> <metadata-name>value</metadata-name> <Metadata> </Queue> <NextMarker /> </EnumerationResults>

Das Metadata -Element vorhanden ist nur möglich, wenn die include=metadata Parameter im URI angegeben wurde. Innerhalb der Metadata -Element wird der Wert jedes Name-Wert-Paars in einem Element, das Paar entspricht aufgeführt ist.

Wenn ein Name-Wert-Paar von Metadaten die benennungsbeschränkungen von Version 2009-09-19 verstößt, gibt der Antworttext den problematischen Namen in ein x-ms-invalid-name Element, wie im folgenden XML-Fragment gezeigt:


… <Metadata> <MyMetadata1>first value</MyMetadata1> <MyMetadata2>second value</MyMetadata2> <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name> <Metadata> …

Eine Beispielantwort finden Sie unten im Abschnitt mit Beispielanforderung und -antwort.

Dieser Vorgang kann nur vom Kontobesitzer aufgerufen werden.

Bei der Angabe eines Werts für den maxresults -Parameter und die Anzahl der zurückzugebenden Warteschlangen diesen Wert überschreitet oder überschreitet den Standardwert für maxresults, enthält der Antworttext ein NextMarker Element, das die nächste Warteschlange in einer nachfolgenden Anforderung zurückgegeben angibt. Um den nächsten Satz von Elementen zurückzugeben, geben Sie den Wert des NextMarker als Markerparameter auf den URI für die nachfolgende Anforderung.

Beachten Sie, dass der Wert des NextMarker als nicht transparent behandelt werden soll.

Warteschlangen werden im Antworttext in alphabetischer Reihenfolge aufgeführt.

Es folgt ein Beispiel-URI, der die Liste der Warteschlangen für ein Konto anfordert, wobei die maximale Anzahl der für den anfänglichen Vorgang zurückzugebenden Ergebnisse auf 3 festgelegt ist.

GET https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata HTTP/1.1

Die Anforderung wird mit den folgenden Headern gesendet:

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 00:55:16 GMT Authorization: SharedKey myaccount:Q7tar7qqM2LD/Wey7OQNPP3hMNap9wjg+g9AlAYeFls=

Der Statuscode und die Antwortheader werden wie folgt zurückgegeben:

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Date: Wed, 23 Oct 2013 00:56:38 GMT x-ms-version: 2013-08-15 Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0

Das Antwort-XML für diese Anforderung lautet wie folgt. Beachten Sie, dass das NextMarker Element den Satz von Warteschlangen folgt und enthält den Namen der nächsten Warteschlange zurückgegeben werden.

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q1</Name> <Metadata> <Color>red</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q2</Name> <Metadata> <Color>blue</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q3</Name> <Metadata> <Color>yellow</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker>q4</NextMarker> </EnumerationResults>

Der folgende Auflistungsvorgang gibt den Marker im Anforderungs-URI wie folgt an. Der nächste Satz von Ergebnissen wird ab der vom Marker angegebenen Warteschlange zurückgegeben. Im Folgenden wird der URI für die nachfolgende Anforderung angegeben:

https://myaccount.queue.core.windows.net?comp=list&maxresults=3&include=metadata&prefix=q&marker=q4

Der Antworttext für diesen Vorgang lautet wie folgt:

<?xml version="1.0" encoding="utf-8"?> <EnumerationResults ServiceEndpoint="https://myaccount.queue.core.windows.net/"> <Prefix>q</Prefix> <Marker>q4</Marker> <MaxResults>3</MaxResults> <Queues> <Queue> <Name>q4</Name> <Metadata> <Color>green</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> <Queue> <Name>q5</Name> <Metadata> <Color>violet</Color> <SomeMetadataName>SomeMetadataValue</SomeMetadataName> <Metadata> </Queue> </Queues> <NextMarker /> </EnumerationResults>
Anzeigen:
© 2016 Microsoft