Udostępnij za pośrednictwem

Utwórz dowiązanie symboliczne

Operacja Create Symbolic Link tworzy nowe dowiązanie symboliczne do istniejącego pliku. Ta operacja jest obsługiwana w wersji 2025-07-05 i nowszych tylko dla udziałów plików z włączonym protokołem NFS.

Dostępność protokołu

Włączony protokół udziału plików Dostępny
Małe i Średnie Przedsiębiorstwa (SMB) Nie.
System plików sieciowych (NFS) Tak

Żądanie

Żądanie Create Symbolic Link jest konstruowane w następujący sposób. Zalecamy używanie protokołu HTTPS.

Metoda Żądanie URI Wersja protokołu HTTP
POŁÓŻ https://myaccount.file.core.windows.net/myshare/mydirectorypath/mysymboliclink?restype=symboliclink HTTP/1.1

Zastąp składniki ścieżki wyświetlane we własnym identyfikatorze URI żądania, zgodnie z opisem w poniższej tabeli:

Składnik ścieżki Opis
myaccount Nazwa konta magazynowego.
myshare Nazwa udziału plików.
mydirectorypath Opcjonalny. Ścieżka do katalogu, w którym ma zostać utworzone dowiązanie symboliczne. Jeśli ścieżka katalogu zostanie pominięta, dowiązanie symboliczne zostanie utworzone w określonym udziale.

Jeśli katalog jest określony, musi on już istnieć w udziale, aby można było utworzyć dowiązanie symboliczne.
mysymboliclink Nazwa dowiązania symbolicznego, które ma zostać utworzone.

Aby uzyskać informacje o ograniczeniach nazewnictwa ścieżek, zobacz Nazwa i dokumentacja udziałów, katalogów, plików i metadanych.

Parametry identyfikatora URI

Dla identyfikatora URI żądania można określić następujące dodatkowe parametry:

Parametr Opis
timeout Opcjonalny. Parametr timeout jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji usługi plików.

Nagłówki zapytań

Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:

Nagłówek żądania Opis
Authorization To jest wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
Date lub x-ms-date To jest wymagane. Określa czas uniwersalny koordynowany (UTC) dla żądania. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage.
x-ms-version Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Ta operacja jest obsługiwana w wersji 2025-05-05 i nowszych dla udziałów plików z włączonym protokołem NFS.

Aby uzyskać więcej informacji, zobacz Przechowywanie wersji dla usług Azure Storage.
Content-Length Opcjonalny. Wartość musi być równa zero, jeśli istnieje.
x-ms-content-length Opcjonalny. Wartość musi być równa zero, jeśli istnieje.
x-ms-meta-name:value Opcjonalny. Pary nazwa-wartość, które są skojarzone z plikiem jako metadane. Nazwy metadanych muszą być zgodne z regułami nazewnictwa dla identyfikatorów języka C# .
x-ms-file-creation-time: { now ¦ <DateTime> } Opcjonalny. Właściwość czasu utworzenia uniwersalnego czasu koordynowanego (UTC) dla pliku. Wartość now może służyć do wskazania czasu żądania. Wartość domyślna to now.
x-ms-file-last-write-time: { now ¦ <DateTime> } Opcjonalny. Właściwość ostatniego zapisu koordynowanego czasu uniwersalnego (UTC) dla pliku. Możesz użyć wartości now, aby wskazać czas żądania. Wartość domyślna to now.
x-ms-owner Opcjonalny. Identyfikator użytkownika (UID) właściciela pliku, który ma zostać ustawiony w pliku. Wartość domyślna to 0 (root).
x-ms-group Opcjonalny. Identyfikator grupy (GID) właściciela pliku, który ma zostać ustawiony w pliku. Wartość domyślna to 0 (grupa główna).
x-ms-link-text To jest wymagane. Określa ścieżkę do pliku docelowego, do którego zostanie utworzone dowiązanie symboliczne. Ścieżka, niezależnie od tego, czy jest bezwzględna od katalogu głównego udziału, czy względna w stosunku do tworzonego dowiązania symbolicznego, jest przechowywana w takiej postaci, w jakiej została podana, bez rozpoznawania. Wartość powinna być zakodowana w procentach.
x-ms-client-request-id Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitor Azure Files.
x-ms-file-request-intent Wymagane, jeśli nagłówek Authorization określa token OAuth. Akceptowalna wartość to backup. Ten nagłówek określa, że Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action lub Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action należy przyznać, jeśli są one uwzględnione w zasadach RBAC przypisanych do tożsamości autoryzowanej przy użyciu nagłówka Authorization. Dostępne dla wersji 2022-11-02 lub nowszej.
x-ms-allow-trailing-dot: { <Boolean> } Opcjonalny. Wersja 2022-11-02 lub nowsza. Wartość logiczna określa, czy końcowa kropka obecna w adresie URL żądania powinna zostać przycięta, czy nie.

Ten nagłówek jest ignorowany, jeśli element docelowy znajduje się w udziale plików z włączonym protokołem NFS, który domyślnie obsługuje kropkę końcową.

Aby uzyskać więcej informacji, zobacz Nazewnictwo i odwoływanie się do udziałów, katalogów, plików i metadanych.

Ciało żądania

Żaden.

Przykładowe żądanie

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=

Odpowiedź

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kod stanu

Pomyślna operacja zwraca kod stanu 201 (Utworzono). Aby uzyskać informacje o kodach stanu, zobacz Stan i kody błędów.

Nagłówki odpowiedzi

Odpowiedź dla tej operacji zawiera nagłówki w poniższej tabeli:

Typowe nagłówki odpowiedzi

Nagłówek odpowiedzi Opis
Date Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi.
ETag Element ETag zawiera wartość reprezentującą wersję pliku. Wartość jest ujęta w cudzysłów.
Last-Modified Zwraca datę i godzinę ostatniej modyfikacji pliku. Format daty jest zgodny z RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentowanie wartości daty/godziny w nagłówkach.

Każda operacja modyfikując katalog lub jego właściwości aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie mają wpływu na czas ostatniej modyfikacji katalogu.
x-ms-request-id Jednoznacznie identyfikuje żądanie, które zostało wykonane i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API
x-ms-version Wskazuje wersję usługi Azure Files używaną do wykonania żądania.
x-ms-file-creation-time Wartość daty/godziny UTC reprezentująca właściwość czasu utworzenia dla dowiązania symbolicznego.
x-ms-file-last-write-time Wartość daty/godziny UTC reprezentująca właściwość czasu ostatniego zapisu dla dowiązania symbolicznego.
x-ms-file-change-time Data/godzina UTC wartość reprezentująca właściwość czasu zmiany dla dowiązania symbolicznego.
x-ms-file-file-id Identyfikator pliku nowo utworzonego dowiązania symbolicznego.
x-ms-file-parent-id Identyfikator pliku nadrzędnego nowo utworzonego dowiązania symbolicznego.
x-ms-client-request-id Służy do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka x-ms-client-request-id, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII. Jeśli nagłówek x-ms-client-request-id nie znajduje się w żądaniu, nie jest obecny w odpowiedzi.
x-ms-mode Tryb dowiązania symbolicznego. Zobacz uprawnienia do plików POSIX (tryb).
x-ms-owner Identyfikator użytkownika (UID) właściciela dowiązania symbolicznego.
x-ms-group Identyfikator grupy (GID) właściciela dowiązania symbolicznego.
x-ms-file-file-type Typ pliku. Wartość będzie miała postać: "SymLink".

Ciało odpowiedzi

Żaden.

Przykładowa odpowiedź

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

Autoryzacja

Tylko właściciel konta może wywołać tę operację.

Uprawnienia do plików POSIX (tryb)

Uprawnienia do plików POSIX można określić numerycznie w 12-bitowym formacie ósemkowym lub w formacie symbolicznym "rwx". Przykłady:

  • "0644" lub "rw-r--r--": Użytkownik (właściciel pliku) ma uprawnienie do odczytu, zapisu, grupa ma uprawnienia do odczytu, inne mają uprawnienia do odczytu.
  • "0755" lub "rwxr-xr-x": Użytkownik (właściciel pliku) ma uprawnienie do odczytu, zapisu i wykonywania, grupa ma uprawnienie do odczytu i wykonywania, inni mają uprawnienia do odczytu i wykonywania.

Format ósemki liczbowej

Trzy najniższe liczby ósemkowe reprezentują uprawnienia właściciela/użytkownika, grupy i innych oraz są wskazywane przy użyciu liczby ósemkowej (0–7), utworzonej przy użyciu kombinacji bitowej "4" (Odczyt), "2" (Zapis), "1" (Wykonaj). Najwyższa liczba ósemkowa zamówienia (0–7) służy do wskazywania kombinacji uprawnień "4" (SetUID), "2" (SetGID), "1" (StickyBit).

Forma Pozwolenie
0700 Użytkownik (właściciel pliku) ma uprawnienia do odczytu, zapisu i wykonywania.
0400 Użytkownik ma uprawnienia do odczytu.
0200 Użytkownik ma uprawnienia do zapisu.
0100 Użytkownik ma uprawnienie do wykonywania.
0070 Grupa ma uprawnienia do odczytu, zapisu i wykonywania.
0040 Grupa ma uprawnienia do odczytu.
0020 Grupa ma uprawnienia do zapisu.
0010 Grupa ma uprawnienie do wykonywania.
0007 Inne osoby mają uprawnienia do odczytu, zapisu i wykonywania.
0004 Inne osoby mają uprawnienia do odczytu.
0002 Inni mają uprawnienia do zapisu.
0001 Inne osoby mają uprawnienia do wykonywania.
4000 Ustaw obowiązujący identyfikator użytkownika w pliku.
2000 Ustaw obowiązujący identyfikator grupy w pliku.
1000 Ustaw wartość wskazującą, że plik można usunąć lub zmienić jego nazwę tylko przez właściciela pliku, właściciela katalogu lub użytkownika głównego.

Format symboliczny "rwx"

Uprawnienia właściciela/użytkownika, grupy i innych osób są wskazywane przy użyciu kombinacji znaków "r" (Read), "w" (Write) i "x" (Execute).

Forma Pozwolenie
RWX------ Użytkownik (właściciel pliku) ma uprawnienia do odczytu, zapisu i wykonywania.
r-------- Użytkownik ma uprawnienia do odczytu.
-w------- Użytkownik ma uprawnienia do zapisu.
--x------ Użytkownik ma uprawnienie do wykonywania.
---rwx--- Grupa ma uprawnienia do odczytu, zapisu i wykonywania.
---r----- Grupa ma uprawnienia do odczytu.
----w---- Grupa ma uprawnienia do zapisu.
-----x--- Grupa ma uprawnienie do wykonywania.
------rwx Inne osoby mają uprawnienia do odczytu, zapisu i wykonywania.
------r — Inne osoby mają uprawnienia do odczytu.
-------w- Inni mają uprawnienia do zapisu.
--------x Inne osoby mają uprawnienia do wykonywania.

Uwagi

Jeśli udział nie istnieje, operacja zakończy się niepowodzeniem z kodem stanu 404/'Not Found' (ShareNotFound).

Jeśli katalog nadrzędny dowiązania symbolicznego nie istnieje, operacja zakończy się niepowodzeniem z kodem stanu 404/"Nie znaleziono" (ParentNotFound).

Jeśli dowiązanie symboliczne, które ma zostać utworzone, już istnieje, operacja zakończy się niepowodzeniem z kodem stanu 409/"Konflikt" (ResourceAlreadyExists).

Create Symbolic Link nie jest obsługiwana w migawce udziału, która jest kopią udziału tylko do odczytu. Próba wykonania tej operacji na migawki udziału kończy się niepowodzeniem z kodem stanu 400/'Bad Request' (InvalidQueryParameterValue).

Zobacz także

Operacje na plikach