Üzenetsor ACL-ének lekérése

A Get Queue ACL művelet adatokat ad vissza az üzenetsoron megadott tárolt hozzáférési szabályzatokról, amelyek közös hozzáférésű jogosultságkódokkal használhatók. További információ: Tárolt hozzáférési szabályzat definiálása.

Megjegyzés

A Get Queue ACL művelet a 2012-02-12-es és újabb verzióban érhető el.

Kérés

A Get Queue ACL kérelem a következőképpen hozható létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le a myaccount kifejezést a tárfiók nevére:

Metódus	Kérés URI-ja	HTTP-verzió
GET/HEAD	https://myaccount.queue.core.windows.net/myqueue?comp=acl	HTTP/1.1

Emulált tárolási szolgáltatás kérése

Amikor kérést küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépnevét és az Azure Queue Storage-portot , 127.0.0.1:10001majd az emulált tárfiók nevét:

Metódus	Kérés URI-ja	HTTP-verzió
GET/HEAD	http://127.0.0.1:10001/devstoreaccount1/myqueue?comp=acl	HTTP/1.1

További információ: Az Azurite emulátor használata helyi Azure Storage-fejlesztéshez.

URI-paraméterek

A kérelem URI-ja a következő további paramétereket határozhatja meg.

Paraméter	Leírás
timeout	Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása az Azure Queue Storage-műveletekhez.

Kérésfejlécek

A szükséges és nem kötelező kérésfejléceket az alábbi táblázatban ismertetjük:

Kérelem fejléce	Leírás
Authorization	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérések engedélyezése az Azure Storage-ba.
Date vagy x-ms-date	Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérések engedélyezése az Azure Storage-ba.
x-ms-version	Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása.
x-ms-client-request-id	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kib-os (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Az Azure Queue Storage monitorozása.

A kérés törzse

Nincsenek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot, egy válaszfejléceket és egy választörzset.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza.

További információ az állapotkódokról: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
x-ms-request-id	Egyedileg azonosítja a végrehajtott kérést, és a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
x-ms-version	A kérés végrehajtásához használt Azure Queue Storage-verziót jelzi. Ez a fejléc a 2009-09-19-es vagy újabb verzióval kapcsolatos kérések esetén jelenik meg.
Date	A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi.
x-ms-client-request-id	A kérések és a hozzájuk tartozó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, az nem jelenik meg a válaszban.

Választörzs

Ha az üzenetsorhoz tárolt hozzáférési szabályzat van megadva, Get Queue ACL az aláírt azonosítót és hozzáférési szabályzatot adja vissza a válasz törzsében.

<?xml version="1.0" encoding="utf-8"?>  
<SignedIdentifiers>  
  <SignedIdentifier>  
    <Id>unique-value</Id>  
    <AccessPolicy>  
      <Start>start-time</Start>  
      <Expiry>expiry-time</Expiry>  
      <Permission>abbreviated-permission-list</Permission>  
    </AccessPolicy>  
  </SignedIdentifier>  
</SignedIdentifiers>  

Mintaválasz

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: Sun, 10 Jun 2012 20:28:22 GMT  
x-ms-version: 2012-02-12  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  
  
<?xml version="1.0" encoding="utf-8"?>  
<SignedIdentifiers>  
  <SignedIdentifier>   
    <Id>MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=</Id>  
    <AccessPolicy>  
      <Start>2009-09-28T08:49:37.0000000Z</Start>  
      <Expiry>2009-09-29T08:49:37.0000000Z</Expiry>  
      <Permission>raup</Permission>  
    </AccessPolicy>  
  </SignedIdentifier>  
</SignedIdentifiers>  
  

Engedélyezés

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Megjegyzések

Csak a fióktulajdonos olvashatja egy adott tárfiók üzenetsoradatait, kivéve, ha a fióktulajdonos megosztott hozzáférési aláírással tette elérhetővé az üzenetsor erőforrásait.

Lásd még

Tárolt hozzáférési szabályzat meghatározása
Tárolt hozzáférési szabályzat meghatározása
Queue ACL beállítása
Kérések engedélyezése az Azure Storage-ba
Állapot- és hibakódok