Megosztási ACL lekérése
A Get Share ACL
művelet a megosztáson megadott tárolt hozzáférési szabályzatokkal kapcsolatos információkat adja vissza. További információ: Tárolt hozzáférési szabályzat definiálása.
Protokoll rendelkezésre állása
Engedélyezett fájlmegosztási protokoll | Elérhető |
---|---|
SMB | |
NFS |
Kérés
A Get Share 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.file.core.windows.net/myshare?restype=share&comp=acl |
HTTP/1.1 |
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 Azure Files 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 or x-ms-date |
Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ez a művelet csak a 2015-02-21-es és újabb verziókban érhető el. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
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ó: Monitorozási Azure Files. |
x-ms-lease-id:<ID> |
Választható. 2020-02-10-es és újabb verzió. Ha a fejléc meg van adva, a művelet csak akkor lesz végrehajtva, ha a fájlmegosztás bérlete jelenleg aktív, és a kérelemben megadott bérletazonosító megegyezik a fájlmegosztás bérletazonosítójával. Ha nincs egyezés, a művelet a 412-s állapotkóddal hiúsul meg (az előfeltétel sikertelen). |
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 |
---|---|
ETag |
Olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé kerül. |
Last-Modified |
Minden olyan művelet, amely módosítja a megosztást, illetve annak tulajdonságait vagy metaadatait, az utolsó módosítás időpontját frissíti. A fájlokon végzett műveletek nem befolyásolják a megosztás utolsó módosításának időpontját. |
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 Blob Storage verziót jelzi. A 2009-09-19-es vagy újabb verzióval kapcsolatos kérések esetén ad vissza. |
Date vagy x-ms-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 kapcsolódó 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 a megosztáshoz megosztási szintű hozzáférési szabályzat van megadva, Get Share 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: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
<?xml version="1.0" encoding="utf-8"?>
<SignedIdentifiers>
<SignedIdentifier>
<Id>MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=</Id>
<AccessPolicy>
<Start>2015-07-01T08:49:37.0000000Z</Start>
<Expiry>2015-07-02T08:49:37.0000000Z</Expiry>
<Permission>rwd</Permission>
</AccessPolicy>
</SignedIdentifier>
</SignedIdentifiers>
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
A megosztás hozzáférési szabályzata az összes megosztási pillanatképére is érvényes. A hozzáférési szabályzatok nem állíthatók be és nem kérhetők le megosztási pillanatképekhez. Hozzáférési szabályzat lekérésére tett kísérlet esetén a szolgáltatás a 400-ás állapotkódot adja vissza (érvénytelen lekérdezési paraméterérték).