Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
Åtgärden Create Symbolic Link skapar en ny symbolisk länk till en befintlig fil. Den här åtgärden stöds i version 2025-07-05 och senare endast för filresurser med NFS-protokoll aktiverat.
Protokolltillgänglighet
| Aktiverat filresursprotokoll | Tillgängligt |
|---|---|
| Små och medelstora företag (SMB) |
|
| NFS (Network File System) |
|
Begäran
Den Create Symbolic Link begäran skapas på följande sätt. Vi rekommenderar att du använder HTTPS.
| Metod | Begäran om URI | HTTP-version |
|---|---|---|
| LÄGG | https://myaccount.file.core.windows.net/myshare/mydirectorypath/mysymboliclink?restype=symboliclink |
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 |
Valfritt. Sökvägen till katalogen där den symboliska länken ska skapas. Om katalogsökvägen utelämnas skapas den symboliska länken i den angivna resursen. Om katalogen anges måste den redan finnas i resursen innan du kan skapa den symboliska länken. |
mysymboliclink |
Namnet på den symboliska länk 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 |
Valfritt. Parametern timeout uttrycks i sekunder. Mer information finns i Ange tidsgränser för filtjänståtgärder. |
Förfrågningsrubriker
De obligatoriska och valfria begäranderubrikerna beskrivs i följande tabell:
| Förfrågningshuvudrad | Beskrivning |
|---|---|
Authorization |
Obligatoriskt. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date eller x-ms-date |
Obligatoriskt. 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 |
Valfritt. Måste vara noll om det finns. |
x-ms-content-length |
Valfritt. Måste vara noll om det finns. |
x-ms-meta-name:value |
Valfritt. Namn/värde-par som är associerade med filen som metadata. Metadatanamn måste följa namngivningsreglerna för C#-identifierare. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Valfritt. 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> } |
Valfritt. 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-owner |
Valfritt. Användaridentifieraren (UID) för filägaren som ska anges för filen. Standardvärdet är 0 (rot). |
x-ms-group |
Valfritt. Gruppidentifieraren (GID) för den filägare som ska anges för filen. Standardvärdet är 0 (rotgrupp). |
x-ms-link-text |
Obligatoriskt. Anger sökvägen till målfilen som en symbolisk länk ska skapas till. Sökvägen, oavsett om den är absolut från resursens rot eller i förhållande till den symboliska länk som skapas, lagras som angiven utan att matchas. Värdet ska vara procentkodat. |
x-ms-client-request-id |
Valfritt. 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> } |
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. 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. |
begäranens innehåll
Ingen.
Exempelbegäran
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/mysymboliclink?restype=symboliclink HTTP/1.1
Request Headers:
x-ms-version: 2025-07-05
x-ms-date: Thu, 13 Mar 2025 06:58:30 GMT
x-ms-link-text: myfile
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.
Svarsrubriker
Svaret för den här åtgärden innehåller rubrikerna i följande tabell:
Vanliga svarshuvuden
| Svarsrubrik | Beskrivning |
|---|---|
Date |
Ett UTC-datum/tid-värde som genereras av tjänsten, vilket anger den tid då svaret initierades. |
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. |
x-ms-file-creation-time |
UTC-datum/tid-värdet som representerar egenskapen för skapandetid för den symboliska länken. |
x-ms-file-last-write-time |
UTC-datum-/tidsvärdet som representerar egenskapen för den senaste skrivtiden för den symboliska länken. |
x-ms-file-change-time |
UTC-datum/tid som representerar egenskapen för ändringstid för den symboliska länken. |
x-ms-file-file-id |
Fil-ID:t för den nyligen skapade symboliska länken. |
x-ms-file-parent-id |
Det överordnade fil-ID:t för den nyligen skapade symboliska länken. |
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. |
x-ms-mode |
Läget för den symboliska länken. Se POSIX-filbehörigheter (läge). |
x-ms-owner |
Användaridentifieraren (UID) för ägaren av den symboliska länken. |
x-ms-group |
Gruppidentifieraren (GID) för ägaren av den symboliska länken. |
x-ms-file-file-type |
Filtypen. Värdet blir: 'SymLink'. |
Svarsdel
Ingen.
Exempelsvar
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Thu, 13 Mar 2025 06:58:31 GMT
ETag: "0x8DD61FC7700E64D"
Last-Modified: Thu, 13 Mar 2025 06:58:31 GMT
x-ms-version: 2025-07-05
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Auktorisering
Endast kontoägaren kan anropa den här åtgärden.
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ändare (filägare) har läs-, skrivbehörighet, Grupp 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. |
| 1 000 | 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 r-tecken (Läs), W (Skriv) 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. |
| -v------- | 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 resursen inte finns misslyckas åtgärden med statuskoden 404/'Not Found' (ShareNotFound).
Om den överordnade katalogen för den symboliska länken inte finns misslyckas åtgärden med statuskoden 404/"Not Found" (ParentNotFound).
Om den symboliska länken som ska skapas redan finns misslyckas åtgärden med statuskoden 409/"Conflict" (ResourceAlreadyExists).
Create Symbolic Link 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/"Felaktig begäran" (InvalidQueryParameterValue).