Hämta katalogegenskaper
Åtgärden Get Directory Properties returnerar alla systemegenskaper för den angivna katalogen och kan också användas för att kontrollera om det finns en katalog. Returnerade data innehåller inte filerna i katalogen eller några underkataloger.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| SMB |
|
| NFS |
|
Förfrågan
Begäran Get Directory Properties kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt följande:
| Sökvägskomponent | Description |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
myparentdirectorypath |
Valfritt. Sökvägen till den överordnade katalogen. |
mydirectory |
Namnet på katalogen. |
Information om namngivningsbegränsningar för sökvägar finns i Namn och referensresurser, kataloger, filer och metadata.
URI-parametrar
Följande ytterligare parametrar kan anges på begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
sharesnapshot |
Valfritt. Version 2017-04-17 och senare. Parametern sharesnapshot är ett täckande DateTime-värde som, när det finns, anger resursögonblicksbilden för att fråga efter katalogegenskaperna |
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ärandehuvudena 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 eller x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden, valfritt för anonyma 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 loggning 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-file-request-intent |
Krävs om Authorization huvudet anger en OAuth-token. Acceptabelt värde är backup. Det här huvudet anger att Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action eller Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action ska beviljas om de ingår i DEN RBAC-princip som tilldelats den identitet som har behörighet med hjälp av Authorization huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfritt. Version 2022-11-02 och senare. Det booleska värdet anger om en avslutande punkt som finns i begärande-URL:en ska trimmas eller inte. Mer information finns i Namnge och referera till resurser, kataloger, filer och metadata. |
Begärandetext
Inga.
Exempelbegäran
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Svarsåtgärder
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 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 |
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 |
Returnerar datum och tid då katalogen senast ändrades. Datumformatet följer RFC 1123. Mer information finns i Representera datum-/tidsvärden i rubriker. Åtgärder på filer i katalogen påverkar inte den senaste ändringstiden för katalogen. |
x-ms-meta-name:value |
En uppsättning namn/värde-par som innehåller metadata för katalogen. |
x-ms-request-id |
Returnerar den unika identifieraren för begäran, vilket kan hjälpa dig att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger den tjänstversion som användes för att köra begäran. |
Date |
Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-server-encrypted: true/false |
Version 2017-04-17 och senare. Värdet för den här rubriken anges till true om katalogmetadata är helt krypterade med den angivna algoritmen. Om metadata inte krypteras anges värdet till false. |
x-ms-file-permission-key |
Version 2019-02-02 och senare. Nyckeln för behörigheten för katalogen. |
x-ms-file-attributes |
Version 2019-02-02 och senare. Filsystemattributen i katalogen. Mer information finns i listan över tillgängliga attribut. |
x-ms-file-creation-time |
Version 2019-02-02 och senare. Datum-/tidsvärdet UTC som representerar egenskapen för att skapa tid för en katalog. |
x-ms-file-last-write-time |
Version 2019-02-02 och senare. Datum-/tidsvärdet FÖR UTC som representerar den senaste skrivtidsegenskapen för katalogen. |
x-ms-file-change-time |
Version 2019-02-02 och senare. Datum-/tidsvärdet UTC som representerar egenskapen för ändringstid för katalogen. |
x-ms-file-file-id |
Version 2019-02-02 och senare. Fil-ID för katalogen. |
x-ms-file-parent-id |
Version 2019-02-02 och senare. Det överordnade fil-ID:t för katalogen. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och deras motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Inga.
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
Auktorisering
Endast kontoinnehavaren kan anropa den här åtgärden.
Kommentarer
Om den angivna katalogsökvägen inte finns misslyckas begäran med statuskod 404 (hittades inte).