Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Create Symbolic Link művelet új szimbolikus hivatkozást hoz létre egy meglévő fájlhoz. Ez a művelet a 2025-07-05-ös és újabb verziókban csak az NFS protokollt engedélyező fájlmegosztások esetében támogatott.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| Kis- és középvállalkozások (SMB) |
|
| Hálózati fájlrendszer (NFS) |
|
Kérelem
A Create Symbolic Link kérés a következőképpen jön létre. Javasoljuk, hogy HTTPS-t használjon.
| Metódus | URI-kérés | HTTP-verzió |
|---|---|---|
| Helyezze | https://myaccount.file.core.windows.net/myshare/mydirectorypath/mysymboliclink?restype=symboliclink |
HTTP/1.1 |
Cserélje le a kérelem URI-jában látható elérésiút-összetevőket a sajátjára, az alábbi táblázatban leírtak szerint:
| Elérésiút-összetevő | Leírás |
|---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
mydirectorypath |
Opcionális. Annak a könyvtárnak az elérési útja, ahol a szimbolikus hivatkozást létre kell hozni. Ha a könyvtár elérési útja nincs megadva, a szimbolikus hivatkozás a megadott megosztáson belül jön létre. Ha a könyvtár meg van adva, akkor a szimbolikus hivatkozás létrehozása előtt már léteznie kell a megosztáson belül. |
mysymboliclink |
A létrehozni kívánt szimbolikus hivatkozás neve. |
Az elérésiút-elnevezési korlátozásokról további információt Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatokcímű témakörben talál.
URI-paraméterek
A kérelem URI-ján a következő további paramétereket adhatja meg:
| Paraméter | Leírás |
|---|---|
timeout |
Opcionális. A timeout paraméter másodpercben van kifejezve. További információ: Fájlszolgáltatás-műveletek időtúllépéseinek beállítása. |
HTTP-kérés fejlécek
A szükséges és nem kötelező kérelemfejléceket az alábbi táblázat ismerteti:
| Kérések fejrész | Leírás |
|---|---|
Authorization |
Szükséges. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-. |
Date vagy x-ms-date |
Szükséges. A kérelem koordinált egyetemes idő (UTC) idejét adja meg. További információ: Kérelmek engedélyezése az Azure Storage-. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ezt a műveletet a 2025-05-05-ös és újabb verzió támogatja az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
Content-Length |
Opcionális. Ha jelen van, akkor nullának kell lennie. |
x-ms-content-length |
Opcionális. Ha jelen van, akkor nullának kell lennie. |
x-ms-meta-name:value |
Opcionális. A fájlhoz metaadatként társított név-érték párok. A metaadatok nevének meg kell felelnie C#-azonosítókelnevezési szabályainak. |
x-ms-file-creation-time: { now ¦ <DateTime> } |
Opcionális. A fájl koordinált univerzális idő (UTC) létrehozási ideje tulajdonsága. A kérés időpontjának jelzésére now érték használható. Az alapértelmezett érték a now. |
x-ms-file-last-write-time: { now ¦ <DateTime> } |
Opcionális. A fájl utolsó írási tulajdonsága a koordinált univerzális idő (UTC). A kérés időpontját a now értékével jelezheti. Az alapértelmezett érték a now. |
x-ms-owner |
Opcionális. A fájl tulajdonosának felhasználói azonosítója (UID) a fájlon. Az alapértelmezett érték a 0 (gyökér). |
x-ms-group |
Opcionális. A fájl tulajdonosának csoportazonosítója (GID) a fájlon. Az alapértelmezett érték a 0 (gyökércsoport). |
x-ms-link-text |
Szükséges. Megadja annak a célfájlnak az elérési útját, amelyre a szimbolikus hivatkozás létrejön. Az elérési út, akár a megosztás gyökerétől vagy a létrehozott szimbolikus kapcsolathoz viszonyítva, a megadott módon tárolódik, feloldás nélkül. Az értéknek százalékos kódolásúnak kell lennie. |
x-ms-client-request-id |
Opcionális. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Monitor Azure Files. |
x-ms-file-request-intent |
Kötelező, ha Authorization fejléc OAuth-jogkivonatot ad meg. Az elfogadható érték backup. Ez a fejléc azt határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action meg kell adni, ha azok szerepelnek a Authorization fejléc használatával engedélyezett identitáshoz rendelt RBAC-szabályzatban. A 2022-11-02-es és újabb verziókhoz érhető el. |
x-ms-allow-trailing-dot: { <Boolean> } |
Opcionális. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a kérelem URL-címében található záró pont levágható-e vagy sem. Ez a fejléc figyelmen kívül lesz hagyva, ha a cél olyan fájlmegosztáson található, amelyen engedélyezve van az NFS protokoll, amely alapértelmezés szerint támogatja a záró pont használatát. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés tartalma
Nincs.
Mintakérés
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=
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 201-ben (létrehozva) állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.
Válaszfejlécek
A műveletre adott válasz a következő táblázat fejléceit tartalmazza:
Gyakori válaszfejlécek
| Válaszfejléc | Leírás |
|---|---|
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
ETag |
Az ETag egy olyan értéket tartalmaz, amely a fájl verzióját jelöli. Az érték idézőjelek közé van zárva. |
Last-Modified |
A fájl utolsó módosításának dátumát és időpontját adja vissza. A dátumformátum az RFC 1123-at követi. További információ: Dátum/idő értékek megjelenítése fejlécekben. Minden olyan művelet, amely módosítja a könyvtárat vagy annak tulajdonságait, a legutóbbi módosítás időpontját frissíti. A fájlokon végzett műveletek nem befolyásolják a címtár utolsó módosításának időpontját. |
x-ms-request-id |
Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása |
x-ms-version |
A kérés végrehajtásához használt Azure Files-verziót jelzi. |
x-ms-file-creation-time |
A szimbolikus hivatkozás létrehozási idő tulajdonságát jelölő UTC dátum/idő érték. |
x-ms-file-last-write-time |
A szimbolikus hivatkozás utolsó írási idő tulajdonságát jelölő UTC dátum/idő érték. |
x-ms-file-change-time |
Az UTC dátum/idő értéke, amely a szimbolikus hivatkozás változási idő tulajdonságát jelöli. |
x-ms-file-file-id |
Az újonnan létrehozott szimbolikus hivatkozás fájlazonosítója. |
x-ms-file-parent-id |
Az újonnan létrehozott szimbolikus hivatkozás szülőfájl-azonosítója. |
x-ms-client-request-id |
A kérések és a hozzájuk tartozó válaszok hibaelhárítására szolgál. Ennek az élőfejnek az értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor az nem szerepel a válaszban. |
x-ms-mode |
A szimbolikus kapcsolat módja. Lásd: POSIX-fájlengedélyek (mód). |
x-ms-owner |
A szimbolikus hivatkozás tulajdonosának felhasználói azonosítója (UID). |
x-ms-group |
A szimbolikus hivatkozás tulajdonosának csoportazonosítója (GID). |
x-ms-file-file-type |
A fájl típusa. Az érték a következő lesz: 'SymLink'. |
Válaszüzenet tartalma
Nincs.
Mintaválasz
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
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
POSIX-fájlengedélyek (mód)
A POSIX-fájlengedélyek numerikusan 12 bites numerikus oktális formátumban vagy szimbolikus "rwx" formátumban adhatók meg. Példák:
- "0644" vagy "rw-r--r---": A felhasználó (fájltulajdonos) olvasási, írási engedéllyel rendelkezik, a csoport olvasási engedéllyel rendelkezik, mások olvasási engedéllyel rendelkeznek.
- "0755" vagy "rwxr-xr-x": A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik, a csoport olvasási és végrehajtási engedéllyel rendelkezik, mások olvasási és végrehajtási engedéllyel rendelkeznek.
Numerikus oktális formátum
A három legalacsonyabb sorrendű oktális szám a tulajdonos/felhasználó, a csoport és mások engedélyeit jelöli, és egy oktális számmal (0-7) van jelölve, amely a "4" (Olvasás), a "2" (Írás), az "1" (Végrehajtás) bitenkénti kombinációjával jön létre. A legmagasabb rendű oktális szám (0-7) a "4" (SetUID), "2" (SetGID), "1" (StickyBit) engedélyek kombinációjának jelzésére szolgál.
| Formátum | Engedély |
|---|---|
| 0700 | A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik. |
| 0400 | A felhasználó olvasási engedéllyel rendelkezik. |
| 0200 | A felhasználó írási engedéllyel rendelkezik. |
| 0100 | A felhasználó rendelkezik végrehajtási engedéllyel. |
| 0070 | A csoport olvasási, írási és végrehajtási engedéllyel rendelkezik. |
| 0040 | A csoport olvasási engedéllyel rendelkezik. |
| 0020 | A csoport írási engedéllyel rendelkezik. |
| 0010 | A csoport rendelkezik végrehajtási engedéllyel. |
| 0007 | Mások olvasási, írási és végrehajtási engedéllyel rendelkeznek. |
| 0004 | Mások olvasási engedéllyel rendelkeznek. |
| 0002 | Mások írási engedéllyel rendelkeznek. |
| 0001 | Mások végrehajtási engedéllyel rendelkeznek. |
| 4000 | Állítsa be az érvényes felhasználói azonosítót a fájlban. |
| 2000. | Állítsa be az érvényes csoportazonosítót a fájlban. |
| 1000 | A beállítás azt jelzi, hogy a fájlt csak a fájl tulajdonosa, a címtár tulajdonosa vagy a gyökérfelhasználó törölheti vagy átnevezheti. |
Szimbolikus "rwx" formátum
A tulajdonosra/felhasználóra, csoportra és másokra vonatkozó engedélyek az "r" (Olvasás), a "w" (Írás) és az "x" (Végrehajtás) karakterek kombinációjával vannak megjelölve.
| Formátum | Engedély |
|---|---|
| rwx------ | A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik. |
| r-------- | A felhasználó olvasási engedéllyel rendelkezik. |
| -w------- | A felhasználó írási engedéllyel rendelkezik. |
| --x------ | A felhasználó rendelkezik végrehajtási engedéllyel. |
| ---rwx--- | A csoport olvasási, írási és végrehajtási engedéllyel rendelkezik. |
| ---r----- | A csoport olvasási engedéllyel rendelkezik. |
| ----w---- | A csoport írási engedéllyel rendelkezik. |
| -----x--- | A csoport rendelkezik végrehajtási engedéllyel. |
| ------rwx | Mások olvasási, írási és végrehajtási engedéllyel rendelkeznek. |
| ------r- | Mások olvasási engedéllyel rendelkeznek. |
| -------w- | Mások írási engedéllyel rendelkeznek. |
| --------x | Mások végrehajtási engedéllyel rendelkeznek. |
Megjegyzések
Ha a megosztás nem létezik, a művelet a 404/'Not Found' állapotkóddal (ShareNotFound) meghiúsul.
Ha a szimbolikus hivatkozás szülőkönyvtára nem létezik, akkor a művelet a 404/"Nem található" (ParentNotFound) állapotkóddal meghiúsul.
Ha a létrehozandó szimbolikus hivatkozás már létezik, akkor a művelet a 409/"Conflict" (ResourceAlreadyExists) állapotkóddal meghiúsul.
Create Symbolic Link nem támogatott a megosztás pillanatképe, amely egy megosztás írásvédett másolata. A megosztási pillanatképen végrehajtott művelet végrehajtása a 400/"Bad Request" (InvalidQueryParameterValue) állapotkóddal meghiúsul.