Skapa katalog
Åtgärden Create Directory skapar en ny katalog under den angivna resursen eller den överordnade katalogen. Katalogresursen innehåller egenskaperna för katalogen. Den innehåller inte en lista över de filer eller underkataloger som finns i katalogen.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Du kan skapa Create Directory begäran enligt följande. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
Ersätt sökvägskomponenterna i begärande-URI:n med din egen, som du ser i följande tabell:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
myparentdirectorypath |
Valfri. Sökvägen till den överordnade katalogen där mydirectory- ska skapas. Om den överordnade katalogsökvägen utelämnas skapas katalogen inom den angivna resursen. Om den överordnade katalogen har angetts måste den redan finnas i resursen innan du kan skapa mydirectory-. |
mydirectory |
Namnet på den katalog som ska skapas. |
Mer information om sökvägsnamnsbegränsningar finns i Namn och referensresurser, kataloger, filer och metadata.
URI-parametrar
Du kan ange följande ytterligare parametrar på begärande-URI:n.
| Parameter | Beskrivning |
|---|---|
timeout |
Valfri. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
Begärandetext
Ingen.
Begärandehuvuden
De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:
| Parameter | 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-tid (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. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-meta-name:value |
Valfri. Version 2015-02-21 eller senare. Ett namn/värde-par som ska associeras med katalogen som metadata. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. |
x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> } |
I version 2019-02-02 till 2021-04-10 krävs det här huvudet om x-ms-file-permission-key inte anges. Från och med version 2021-06-08 är båda rubrikerna valfria. Den här behörigheten är säkerhetsbeskrivningen för den katalog som anges i SDDL(Security Descriptor Definition Language) eller (version 2024-11-04 eller senare) i base64-kodad binära säkerhetsbeskrivningsformatet. Du kan ange vilket format som ska användas med x-ms-file-permission-format-huvudet. Det här huvudet kan användas om behörighetsstorleken är över 8 kibibyte (KiB). Annars kan du använda x-ms-file-permission-key. Om den anges måste den ha en ägare, grupp och diskretionär åtkomstkontrollista (DACL). Du kan skicka ett värde på inherit att ärva från den överordnade katalogen.Obs: Du kan ange antingen x-ms-file-permission eller x-ms-file-permission-key. Om inget av huvudena anges används standardvärdet för inherit. |
x-ms-file-permission-format: { sddl ¦ binary } |
Valfri. Version 2024-11-04 eller senare. Anger om värdet som skickas i x-ms-file-permission är i SDDL eller i binärt format. Om x-ms-file-permission-key har angetts till inheritska det här huvudet inte anges. Om x-ms-file-permission-key är inställt på något annat värde än inheritoch om det här huvudet inte har angetts används standardvärdet för sddl. |
x-ms-file-permission-key: <PermissionKey> |
Nyckeln för behörigheten som ska anges för katalogen. I version 2019-02-02 till 2021-04-10 krävs det här huvudet om x-ms-file-permission inte anges. Från och med version 2021-06-08 är båda rubrikerna valfria. Du kan skapa den här nyckeln med hjälp av api:et Create-Permission.Obs: Du kan ange antingen x-ms-file-permission eller x-ms-file-permission-key. Om inget av huvudena anges används standardvärdet för inherit för x-ms-file-permission-huvudet. |
x-ms-file-attributes |
Krävs: version 2019-02-02 till 2021-04-10. Valfritt: version 2021-06-08 och senare. De filsystemattribut som ska anges i katalogen. Se listan över tillgängliga attribut. Standardvärdet är Katalog. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Krävs: version 2019-02-02 till 2021-04-10. Valfritt: version 2021-06-08 och senare. UtC-egenskapen (Coordinated Universal Time) creation time för katalogen. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Krävs: version 2019-02-02 till 2021-04-10. Valfritt: version 2021-06-08 eller senare. Den senaste skrivegenskapen coordinated Universal Time (UTC) för katalogen. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now. |
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-change-time: { now ¦ <DateTime> } |
Valfri. Utc-egenskapen (Coordinated Universal Time) ändrar tid för katalogen i FORMATET ISO 8601. Version 2021-06-08 och senare. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now. |
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. Mer information finns i Namngivning och referens av resurser, kataloger, filer och metadata. |
Exempelbegäran
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad).
Mer information om statuskoder finns i Status och felkoder.
Svarshuvuden
Svaret för den här åtgärden innehåller rubrikerna som beskrivs i följande tabell. Svaret kan också innehålla ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
| Svarsrubrik | Beskrivning |
|---|---|
ETag |
Innehåller ett värde som representerar katalogens version, omgiven 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. Alla åtgärder som ändrar katalogen eller dess egenskaper uppdaterar den senaste ändrade tiden. Åtgärder på filer påverkar inte den senaste ändrade tiden för katalogen. |
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 Files-version 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-request-server-encrypted: true/false |
Version 2017-04-17 eller senare. Värdet för det här huvudet är inställt på true om innehållet i begäran har krypterats med den angivna algoritmen och false annat. |
x-ms-file-permission-key |
Nyckeln för behörigheten för katalogen. |
x-ms-file-attributes |
Filsystemattributen i katalogen. Se listan över tillgängliga attribut. |
x-ms-file-creation-time |
UTC-datum/tid-värdet som representerar egenskapen för att skapa tid för katalogen. |
x-ms-file-last-write-time |
UTC-datum/tid-värdet som representerar den senaste skrivtidsegenskapen för katalogen. |
x-ms-file-change-time |
UTC-datum/tid som representerar egenskapen för ändringstid för katalogen. |
x-ms-file-file-id |
Fil-ID för katalogen. |
x-ms-file-parent-id |
Det överordnade fil-ID:t för katalogen. |
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 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 inte det här huvudet i svaret. |
Svarstext
Ingen.
Exempelsvar
Response status:
HTTP/1.1 201 Created
Response headers:
Transfer-Encoding: chunked
Date: Mon, 27 Jan 2014 23:00:12 GMT
ETag: "0x8CB14C3E29B7E82"
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT
x-ms-version: 2014-02-14
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 katalog som är skrivskyddad. |
| Dold | FILE_ATTRIBUTE_HIDDEN | Katalogen är dold. Den ingår inte i en vanlig kataloglista. |
| System | FILE_ATTRIBUTE_SYSTEM | En katalog som operativsystemet använder en del av eller endast använder. |
| Ingen | FILE_ATTRIBUTE_NORMAL | En katalog som inte har andra attribut angivna. Det här attributet är endast giltigt när det används ensamt. |
| Katalog | FILE_ATTRIBUTE_DIRECTORY | Referensen som identifierar en katalog. |
| Arkiv | FILE_ATTRIBUTE_ARCHIVE | En katalog som är en arkivkatalog. Program använder vanligtvis det här attributet för att markera filer för säkerhetskopiering eller borttagning. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Data i en katalog är inte tillgängliga omedelbart. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows. Azure Files stöder det inte med lagringsalternativ offline. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Katalogen ska inte indexeras av innehållsindexeringstjänsten. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Användardataströmmen som inte läsas av bakgrundsdataintegritetsskannern. Det här filsystemattributet visas främst för att ge kompatibilitet med Windows. |
Anmärkningar
Om en katalog med samma namn tas bort när Create Directory anropas returnerar servern statuskoden 409 (konflikt) och den innehåller ytterligare felinformation som anger att katalogen tas bort.
Om det redan finns en katalog eller fil med samma namn misslyckas åtgärden med statuskoden 409 (konflikt). Om den överordnade katalogen inte finns misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).
Det går inte att skapa en kataloghierarki med en enda Create Directory åtgärd. Du kan bara skapa katalogen om den överordnade katalogen redan finns, enligt beskrivningen i sökvägen. Om den överordnade katalogen inte finns misslyckas åtgärden med statuskoden 412 (förhandsvillkoret misslyckades).
Create Directory stöds inte i en resursögonblicksbild, vilket är en skrivskyddad kopia av en resurs. Ett försök att utföra den här åtgärden på en resursögonblicksbild misslyckas med 400 (InvalidQueryParameterValue)