Skapa fil
Åtgärden Create File skapar en ny fil eller ersätter en fil. Den här åtgärden stöds i version 2025-05-05 och senare för filresurser med NFS-protokollet aktiverat. När du anropar Create Fileinitierar du bara filen. Om du vill lägga till innehåll i en fil anropar du åtgärden Put Range.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgänglig |
|---|---|
| SMB |
|
| NFS |
|
Begäran
Den Create File begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | Begärande-URI | HTTP-version |
|---|---|---|
| LÄGG | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile |
HTTP/1.1 |
Ersätt sökvägskomponenterna som visas i begärande-URI:n med dina egna, enligt beskrivningen i följande tabell:
| Sökvägskomponent | Beskrivning |
|---|---|
myaccount |
Namnet på ditt lagringskonto. |
myshare |
Namnet på filresursen. |
mydirectorypath |
Valfri. Sökvägen till katalogen där filen ska skapas. Om katalogsökvägen utelämnas skapas filen inom den angivna resursen. Om katalogen har angetts måste den redan finnas i resursen innan du kan skapa filen. |
myfile |
Namnet på filen som ska skapas. |
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ä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-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. 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. |
Content-Length |
Valfri. Måste vara noll om det finns. |
x-ms-content-length: byte value |
Krävs. Det här huvudet anger den maximala storleken för filen, upp till 4 tebibyte (TiB). |
Content-Type eller x-ms-content-type |
Valfri. MIME-innehållstypen för filen. Standardtypen är application/octet-stream. |
Content-Encoding eller x-ms-content-encoding |
Valfri. Anger vilka innehållskodningar som har tillämpats på filen. Det här värdet returneras till klienten när åtgärden Hämta fil utförs på filresursen och du kan använda det för att avkoda filinnehåll. |
Content-Language eller x-ms-content-language |
Valfri. Anger de naturliga språk som används av den här resursen. |
Cache-Control eller x-ms-cache-control |
Valfri. Azure Files lagrar det här värdet men använder inte eller ändrar det. |
x-ms-content-md5 |
Valfri. Anger filens MD5-hash. |
x-ms-content-disposition |
Valfri. Anger filens Content-Disposition-huvud. |
x-ms-type: file |
Krävs. Ställ in rubriken på file. |
x-ms-meta-name:value |
Valfri. Namn/värde-par som är associerade med filen som metadata. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. Obs: Filmetadata som anges via Azure Files är inte tillgängliga från en SMB-klient (Server Message Block). |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Krävs: version 2019-02-02 till 2021-04-10. Valfritt: version 2021-06-08 och senare. Egenskapen Coordinated Universal Time (UTC) creation time för filen. Ett värde på now kan användas 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 och senare. Den senaste skrivegenskapen coordinated Universal Time (UTC) för filen. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now. |
x-ms-lease-id:<ID> |
Krävs om filen har ett aktivt lån. Tillgänglig för version 2019-02-02 och senare. Det här huvudet ignoreras om filen finns på en filresurs med NFS-protokollet aktiverat, vilket inte stöder fillån. |
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
| Begärandehuvud | Beskrivning |
|---|---|
x-ms-file-change-time: { now ¦ <DateTime> } |
Valfri. Version 2021-06-08 och senare. Egenskapen Coordinated Universal Time (UTC) ändrar tid för filen i FORMATET ISO 8601. Du kan använda värdet now för att ange tidpunkten för begäran. Standardvärdet är now. |
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 filen som anges i Security Descriptor Definition Language (SDDL) eller (version 2024-11-04 eller senare) i base64-kodad binär säkerhetsbeskrivningsformat. Du kan ange vilket format som ska användas med x-ms-file-permission-format-huvudet. Du kan använda det här huvudet om behörighetsstorleken är 8 kibibyte (KiB) eller mindre. Annars kan du använda x-ms-file-permission-key. Om du anger rubriken 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. |
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 är inställt på inheritbör det här huvudet inte anges. Om x-ms-file-permission ä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> |
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. Om inget av huvudena anges används standardvärdet för inherit för x-ms-file-permission-huvudet.Du kan skapa nyckeln genom att anropa Create Permission-API:et. |
x-ms-file-attributes |
Krävs: version 2019-02-02 till 2021-04-10. Valfritt: version 2021-06-08 och senare. Det här huvudet innehåller de filsystemattribut som ska anges för filen. Mer information finns i listan över tillgängliga attribut. Standardvärdet är None. |
Endast NFS-begärandehuvuden
| Begärandehuvud | Beskrivning |
|---|---|
x-ms-mode |
Valfri. Version 2025-05-05 och senare. De lägesbitar som ska anges i filen. Läget representeras i 12-bitars numeriskt oktalt format eller det symboliska rwx-formatet. Standardvärdet är 0644. Se POSIX-filbehörigheter (läge). |
x-ms-owner |
Valfri. Version 2025-05-05 och senare. Användaridentifieraren (UID) för filägaren som ska anges för filen. Standardvärdet är 0 (rot). |
x-ms-group |
Valfri. Version 2025-05-05 och senare. Gruppidentifieraren (GID) för den filägare som ska anges för filen. Standardvärdet är 0 (rotgrupp). |
x-ms-file-file-type |
Valfri. Version 2025-05-05 och senare. Filtypen. Måste vara "Vanlig" om det finns. |
Begärandetext
Ingen.
Exempelbegäran
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1
Request Headers:
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT
Content-Type: text/plain; charset=UTF-8
x-ms-content-length: 1024
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
Svar
Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.
Statuskod
En lyckad åtgärd returnerar statuskoden 201 (skapad). 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 standard-HTTP-huvuden. Alla standardhuvuden överensstämmer med HTTP/1.1-protokollspecifikationen.
Vanliga svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
ETag |
ETag innehåller ett värde som representerar filens version. Värdet omges av citattecken. |
Last-Modified |
Returnerar datum och tid när filen 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änds 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 och senare. Värdet för det här huvudet är inställt på true om du har krypterat innehållet i begäran med hjälp av den angivna algoritmen. Om krypteringen misslyckas är värdet false. |
x-ms-file-creation-time |
UTC-datum/tid-värdet som representerar egenskapen för att skapa tid för filen. |
x-ms-file-last-write-time |
UTC-datum/tid-värdet som representerar den senaste skrivtidsegenskapen för filen. |
x-ms-file-change-time |
UTC-datum/tid som representerar egenskapen för ändringstid för filen. |
x-ms-file-file-id |
Fil-ID:t för filen. |
x-ms-file-parent-id |
Filens överordnade fil-ID. |
x-ms-client-request-id |
Används 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 filens behörighet. |
x-ms-file-attributes |
Version 2019-02-02 och senare. Filsystemattributen för filen. Mer information finns i lista över tillgängliga attribut. |
Endast NFS-svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
x-ms-mode |
Version 2025-05-05 och senare. Filens läge. Se POSIX-filbehörigheter (läge). |
x-ms-owner |
Version 2025-05-05 och senare. Filägarens användaridentifierare (UID). |
x-ms-group |
Version 2025-05-05 och senare. Filägarens gruppidentifierare (GID). |
x-ms-file-file-type |
Version 2025-05-05 och senare. Typ av fil, det möjliga värdet är: "Regular". |
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 fil som är skrivskyddad. Program kan läsa filen, men de 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 det inte med 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 som 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 du vill skapa en ny fil initierar du den först genom att anropa Create File och ange dess maximala storlek, upp till 4 TiB. När du utför den här åtgärden ska du inte inkludera innehåll i begärandetexten. När du har skapat filen anropar du Put Range för att lägga till innehåll i filen eller ändra den.
Du kan ändra storleken på filen genom att anropa Set File Properties.
Om resursen eller den överordnade katalogen inte finns misslyckas åtgärden med statuskoden 412 (Förhandsvillkoret misslyckades).
Not
Filegenskaperna cache-control, content-type, content-md5, content-encodingoch content-language är separata från filsystemegenskaperna som är tillgängliga för SMB-klienter. SMB-klienter kan inte läsa, skriva eller ändra dessa egenskapsvärden.
Om den befintliga filen har ett aktivt lån måste klienten ange ett giltigt låne-ID för begäran för att kunna skapa filen. Om klienten antingen inte anger något låne-ID eller anger ett ogiltigt låne-ID returnerar Azure Files statuskod 412 (förhandsvillkoret misslyckades). Om klienten anger ett låne-ID men filen inte har ett aktivt lån returnerar Azure Files även statuskoden 412 (förhandsvillkoret misslyckades) i den här instansen. Om klienten anger ett låne-ID för en fil som ännu inte finns returnerar Azure Files statuskod 412 (förhandsvillkoret misslyckades) för begäranden som görs mot version 2019-02-02 och senare.
Om en befintlig fil med ett aktivt lån skrivs över av en Create File åtgärd sparas lånet på den uppdaterade filen tills den släpps.
Create File 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 statuskoden 400 (InvalidQueryParameterValue).