Hämta resurs-ACL (FileREST API) – Azure Files

Artikel
07/19/2023

Åtgärden Get Share ACL returnerar information om lagrade åtkomstprinciper som anges på resursen. Mer information finns i Definiera en lagrad åtkomstprincip.

Protokolltillgänglighet

Aktiverat filresursprotokoll	Tillgängligt
SMB
NFS

Förfrågan

Begäran Get Share ACL kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto:

Metod	URI för förfrågan	HTTP-version
GET/HEAD	`https://myaccount.file.core.windows.net/myshare?restype=share&comp=acl`	HTTP/1.1

URI-parametrar

Följande ytterligare parametrar kan anges i begärande-URI:n:

Parameter	Beskrivning
`timeout`	Valfritt. Parametern `timeout` uttrycks i sekunder. Mer information finns i Ange tidsgränser för Azure Files åtgärder.

Begärandehuvuden

De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:

Begärandehuvud	Beskrivning
`Authorization`	Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage.
`Date or x-ms-date`	Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden är endast tillgänglig i version 2015-02-21 och senare. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`x-ms-version`	Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna.
`x-ms-client-request-id`	Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggningen har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i Övervaka Azure Files.
`x-ms-lease-id:<ID>`	Valfritt. Version 2020-02-10 och senare. Om rubriken anges utförs åtgärden endast om filresursens lån för närvarande är aktivt och låne-ID:t som anges i begäran matchar filresursens låne-ID. Om det inte finns någon matchning misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskoden 200 (OK).

Mer information om statuskoder finns i Status och felkoder.

Svarshuvuden

Svaret för den här åtgärden innehåller följande rubriker. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.

Svarsrubrik	Description
`ETag`	Innehåller ett värde som du kan använda för att utföra åtgärder villkorligt. Värdet omges av citattecken.
`Last-Modified`	Alla åtgärder som ändrar resursen eller dess egenskaper eller metadata uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte resursens senast ändrade tid.
`x-ms-request-id`	Identifierar unikt den begäran som gjordes och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder.
`x-ms-version`	Anger den Azure Blob Storage version som användes för att köra begäran. Returneras för begäranden som görs mot version 2009-09-19 eller senare.
`Date` eller `x-ms-date`	Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades.
`x-ms-client-request-id`	Kan användas för att felsöka begäranden och motsvarande svar. Värdet för det här huvudet är lika med värdet `x-ms-client-request-id` för huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. `x-ms-client-request-id` Om rubriken inte finns i begäran visas den inte i svaret.

Själva svaret

Om en åtkomstprincip på resursnivå har angetts för resursen Get Share ACL returnerar den signerade identifieraren och åtkomstprincipen i svarstexten.

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

Exempelsvar

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>

Auktorisering

Endast kontoägaren kan anropa den här åtgärden.

Kommentarer

Åtkomstprincipen för resursen gäller även för alla dess resursögonblicksbilder. Det går inte att ange eller hämta en åtkomstprincip för en resursögonblicksbild. Om ett försök görs att hämta en åtkomstprincip returnerar tjänsten statuskoden 400 (ogiltigt frågeparametervärde).

Dela via