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 förekomsten av en katalog. De returnerade data innehåller inte filerna i katalogen eller några underkataloger. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Get Directory Properties begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | 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 | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
myparentdirectorypath |
Valfri. 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 |
Valfri. Version 2017-04-17 och senare. Parametern sharesnapshot är ett ogenomskinliga DateTime-värde som när det finns anger resursögonblicksbilden för att fråga efter katalogegenskaperna |
timeout |
Valfri. 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 tabeller:
Vanliga begärandehuvuden
| 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 UTC (Coordinated Universal Time) 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. Anger vilken version av åtgärden som ska användas för den här begäran. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-client-request-id |
Valfri. Tillhandahåller ett klientgenererat, täckande värde med en kibibytesteckengräns (KiB) som registreras i loggarna när loggningen konfigureras. 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 rubrik 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 RBAC-principen som tilldelats den identitet som är auktoriserad med hjälp av Authorization-huvudet. Tillgänglig för version 2022-11-02 och senare. |
x-ms-allow-trailing-dot: { <Boolean> } |
Valfri. 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. Det här huvudet ignoreras om målet finns på en filresurs med NFS-protokollet aktiverat, vilket stöder avslutande punkt som standard. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Endast SMB-begärandehuvuden
Ingen.
Endast NFS-begärandehuvuden
Ingen.
Begärandetext
Ingen.
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=
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK). Information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna i följande tabeller. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
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/tid-värden i rubriker. Åtgärder på filer i katalogen påverkar inte den senaste ändrade tiden 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 UTC-datum/tid-värde 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 det här huvudet är inställt på true om katalogmetadata är helt krypterade med den angivna algoritmen. Om metadata inte krypteras anges värdet till false. |
x-ms-file-creation-time |
Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar egenskapen för att skapa tid för en katalog. |
x-ms-file-last-write-time |
Version 2019-02-02 och senare. UTC-datum/tid-värdet som representerar den senaste skrivtidsegenskapen för katalogen. |
x-ms-file-change-time |
Version 2019-02-02 och senare. UTC-datum/tid-värdet 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 för x-ms-client-request-id-huvudet om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om x-ms-client-request-id-huvudet inte finns i begäran finns det inte i svaret. |
Endast SMB-svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
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 lista över tillgängliga attribut. |
Endast NFS-svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
x-ms-mode |
Version 2025-05-05 och senare. Läget för katalogen. Se POSIX-filbehörigheter (läge). |
x-ms-owner |
Version 2025-05-05 och senare. Användaridentifieraren (UID) för katalogägaren. |
x-ms-group |
Version 2025-05-05 och senare. Gruppidentifieraren (GID) för katalogägaren. |
x-ms-file-file-type |
Version 2025-05-05 och senare. Filtypen, de möjliga värdena är: Directory. |
Svarstext
Ingen.
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
Tillstånd
Endast kontoägaren kan anropa den här åtgärden.
Filsystemattribut
| Attribut | Win32-filattribut | Definition |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | En fil som är skrivskyddad. Program kan läsa filen, men kan inte skriva till den eller ta bort den. |
| Dold | FILE_ATTRIBUTE_HIDDEN | Filen är dold. Den ingår inte i en vanlig kataloglista. |
| System | FILE_ATTRIBUTE_SYSTEM | En fil som operativsystemet använder en del av eller endast använder. |
| Ingen | FILE_ATTRIBUTE_NORMAL | En fil som inte har andra attribut angivna. Det här attributet är endast giltigt när det används ensamt. |
| Arkiv | FILE_ATTRIBUTE_ARCHIVE | En fil som är en arkivfil. Program använder vanligtvis det här attributet för att markera filer för säkerhetskopiering eller borttagning. |
| Temporär | FILE_ATTRIBUTE_TEMPORARY | En fil som används för tillfällig lagring. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Data för en fil är inte tillgängliga omedelbart. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows. Azure Files stöder inte lagringsalternativ offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Filen ska inte indexeras av innehållsindexeringstjänsten. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Användardataströmmen ska inte läsas av bakgrundsdataintegritetsskannern. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows. |
POSIX-filbehörigheter (läge)
POSIX-filbehörigheter kan anges antingen numeriskt i ett 12-bitars numeriskt oktalt format eller i ett symboliskt "rwx"-format. Exempel:
- "0644" eller "rw-r--r--": Användaren (filägaren) har läs-, skrivbehörighet. Gruppen har läsbehörighet. Andra har läsbehörighet.
- "0755" eller "rwxr-xr-x": Användaren (filägaren) har läs-, skriv- och körningsbehörighet. Gruppen har läs- och körningsbehörighet. Andra har läs- och körningsbehörighet.
Numeriskt oktalt format
De tre lägsta oktala nummerordningen representerar behörigheterna för ägare/användare, grupp och andra och anges med ett oktalt tal (0-7), som bildas med hjälp av en bitvis kombination av "4" (Läs), "2" (Skriv), "1" (Kör). Det högsta oktala antalet i ordningen (0–7) används för att ange en kombination av behörigheterna "4" (SetUID), "2" (SetGID), "1" (StickyBit).
| Format | Tillåtelse |
|---|---|
| 0700 | Användaren (filägaren) har läs-, skriv- och körningsbehörighet. |
| 0400 | Användaren har läsbehörighet. |
| 0200 | Användaren har skrivbehörighet. |
| 0100 | Användaren har körningsbehörighet. |
| 0070 | Gruppen har läs-, skriv- och körningsbehörighet. |
| 0040 | Gruppen har läsbehörighet. |
| 0020 | Gruppen har skrivbehörighet. |
| 0010 | Gruppen har körningsbehörighet. |
| 0007 | Andra har läs-, skriv- och körningsbehörighet. |
| 0004 | Andra har läsbehörighet. |
| 0002 | Andra har skrivbehörighet. |
| 0001 | Andra har körningsbehörighet. |
| 4000 | Ange ett effektivt användar-ID för filen. |
| 2000 | Ange effektivt grupp-ID för filen. |
| 1000 | Ange för att ange att filen endast kan tas bort eller byta namn på filens ägare, katalogägare eller rotanvändare. |
Symboliskt "rwx"-format
Behörigheter för ägare/användare, grupp och andra anges med hjälp av en kombination av tecknen "r" (Läs), "w" (Skrivning) och "x" (Kör).
| Format | Tillåtelse |
|---|---|
| rwx------ | Användaren (filägaren) har läs-, skriv- och körningsbehörighet. |
| r-------- | Användaren har läsbehörighet. |
| -w------- | Användaren har skrivbehörighet. |
| --x------ | Användaren har körningsbehörighet. |
| ---rwx--- | Gruppen har läs-, skriv- och körningsbehörighet. |
| -------- | Gruppen har läsbehörighet. |
| ----w---- | Gruppen har skrivbehörighet. |
| -----x--- | Gruppen har körningsbehörighet. |
| ------rwx | Andra har läs-, skriv- och körningsbehörighet. |
| ------r... | Andra har läsbehörighet. |
| ------- | Andra har skrivbehörighet. |
| --------x | Andra har körningsbehörighet. |
Anmärkningar
Om den angivna katalogsökvägen inte finns misslyckas begäran med statuskod 404 (hittades inte).