Získání seznamu ACL pro sdílení (FileREST API) – Azure Files

Článek
08/05/2023

Operace Get Share ACL vrátí informace o uložených zásadách přístupu, které jsou zadané ve sdílené složce. Další informace najdete v tématu Definování uložených zásad přístupu.

Dostupnost protokolu

Povolený protokol sdílené složky	K dispozici.
SMB
NFS

Žádost

Požadavek Get Share ACL může být vytvořen následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště:

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET/HEAD	`https://myaccount.file.core.windows.net/myshare?restype=share&comp=acl`	HTTP/1.1

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Parametr	Popis
`timeout`	Nepovinný parametr. Parametr se `timeout` vyjadřuje v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files.

Hlavičky požadavku

Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date or x-ms-date`	Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Tato operace je k dispozici pouze ve verzi 2015-02-21 a novější. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-version`	Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files.
`x-ms-lease-id:<ID>`	Nepovinný parametr. Verze 2020-02-10 a novější. Pokud je zadána hlavička, operace se provede pouze v případě, že je zapůjčení sdílené složky aktuálně aktivní a ID zapůjčení zadané v žádosti odpovídá ID zapůjčení sdílené složky. Pokud neexistuje žádná shoda, operace selže se stavovým kódem 412 (Předběžná podmínka se nezdařila).

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK).

Další informace o stavových kódech najdete v tématu Kódy stavu a chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`ETag`	Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Hodnota je uzavřena v uvozovkách.
`Last-Modified`	Každá operace, která upraví sdílenou složku, její vlastnosti či metadata, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny sdílené složky.
`x-ms-request-id`	Jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Označuje Azure Blob Storage verzi, která se použila ke spuštění požadavku. Vráceno pro požadavky, které jsou provedeny proti verzi 2009-09-19 nebo novější.
`Date` nebo `x-ms-date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`x-ms-client-request-id`	Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička `x-ms-client-request-id` v požadavku nenachází, v odpovědi se nezobrazí.

Text odpovědi

Pokud jsou pro sdílenou složku zadané zásady přístupu na úrovni sdílené složky, Get Share ACL vrátí podepsaný identifikátor a zásadu přístupu v textu odpovědi.

<?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>

Ukázková odpověď

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>

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Zásady přístupu sdílené složky platí také pro všechny snímky sdílené složky. Pro snímek sdílené složky nejde nastavit ani načíst zásady přístupu. Pokud dojde k pokusu o načtení zásad přístupu, vrátí služba stavový kód 400 (neplatná hodnota parametru dotazu).

Získání seznamu ACL pro sdílení