Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der vorgang Create Hard Link erstellt eine neue feste Verknüpfung zu einer vorhandenen Datei. Dieser Vorgang wird in Version 2025-05-05 und höher nur für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| KMU |
|
| NFS (falls abgekürzt von Network File System gemeint) |
|
Bitten
Die Create Hard Link Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| STELLEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myhardlink?restype=hardlink |
HTTP/1.1 |
Ersetzen Sie die Pfadkomponenten, die im Anforderungs-URI angezeigt werden, durch Ihre eigene, wie in der folgenden Tabelle beschrieben:
| Pfadkomponente | Beschreibung |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name Ihrer Dateifreigabe. |
mydirectorypath |
Wahlfrei. Der Pfad zum Verzeichnis, in dem die feste Verknüpfung erstellt werden soll. Wenn der Verzeichnispfad weggelassen wird, wird die feste Verknüpfung innerhalb der angegebenen Freigabe erstellt. Wenn das Verzeichnis angegeben ist, muss es bereits innerhalb der Freigabe vorhanden sein, bevor Sie den endgültigen Link erstellen können. |
myhardlink |
Der Name des zu erstellenden hardlinks. |
Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namen- und Referenzfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die folgenden zusätzlichen Parameter für den Anforderungs-URI angeben:
| Parameter | Beschreibung |
|---|---|
timeout |
Wahlfrei. Der parameter timeout wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle beschrieben:
| Anforderungsheader | Beschreibung |
|---|---|
Authorization |
Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
Date oder x-ms-date |
Erforderlich. Gibt die UTC-Zeit (Coordinated Universal Time) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage. |
x-ms-version |
Erforderlich für alle autorisierten Anforderungen. Gibt die Version des Vorgangs an, der für diese Anforderung verwendet werden soll. Dieser Vorgang wird in Version 2025-05-05 und höher für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste. |
Content-Length |
Wahlfrei. Muss null sein, wenn vorhanden. |
x-ms-content-length |
Wahlfrei. Muss null sein, wenn vorhanden. |
x-ms-type: file |
Erforderlich. Legen Sie diese Kopfzeile auf filefest. |
x-ms-file-target-file:path |
Erforderlich. Gibt den absoluten Pfad zur Zieldatei an, zu der die hard link erstellt wird, bis zu 2 KiB länge. Es sollte sich um den vollständigen/absoluten Pfad der Zieldatei aus dem Stammverzeichnis derselben Freigabe oder um den vollständigen URI für die Zieldatei handeln. Hier sind einige Beispiele für den Pfad der Zieldatei:
|
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen von Azure Files. |
x-ms-file-request-intent |
Erforderlich, wenn Authorization Header ein OAuth-Token angibt. Zulässiger Wert ist backup. Dieser Header gibt an, dass die Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action oder Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action gewährt werden sollen, wenn sie in der RBAC-Richtlinie enthalten sind, die der Identität zugewiesen ist, die mithilfe des Authorization-Headers autorisiert ist. Verfügbar für Version 2022-11-02 und höher. |
x-ms-allow-trailing-dot: { <Boolean> } |
Wahlfrei. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Anforderungs-URL gekürzt werden soll. Dieser Header wird ignoriert, wenn sich das Ziel auf einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, das den nachfolgenden Punkt standardmäßig unterstützt. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
Anforderungstext
Nichts.
Beispielanforderung
Request Syntax:
PUT https://myaccount.file.core.windows.net/myshare/myhardlink?restype=hardlink HTTP/1.1
Request Headers:
x-ms-version: 2025-05-05
x-ms-date: Wed, 20 Nov 2024 09:17:09 GMT
x-ms-type: file
x-ms-file-target-file: mydir/myfile
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
Antwort
Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.
Statuscode
Ein erfolgreicher Vorgang gibt den Statuscode 201 (Erstellt) zurück. Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang enthält die Kopfzeilen in der folgenden Tabelle:
Allgemeine Antwortheader
| Antwortheader | Beschreibung |
|---|---|
Date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
ETag |
Das ETag enthält einen Wert, der die Version der Datei darstellt. Der Wert wird in Anführungszeichen eingeschlossen. |
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Datei zurück. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Vorgang, der das Verzeichnis oder seine Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf die Uhrzeit der letzten Änderung des Verzeichnisses aus. |
x-ms-request-id |
Identifiziert die anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge |
x-ms-version |
Gibt die Azure Files-Version an, die zum Ausführen der Anforderung verwendet wird. |
x-ms-file-creation-time |
Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für die Datei darstellt. |
x-ms-file-last-write-time |
Der UTC-Datums-/Uhrzeitwert, der die letzte Schreibzeiteigenschaft für die Datei darstellt. |
x-ms-file-change-time |
Der UTC-Datums-/Uhrzeitwert, der die Änderungszeiteigenschaft für die Datei darstellt. |
x-ms-file-file-id |
Die Datei-ID der Datei. |
x-ms-file-parent-id |
Die übergeordnete Datei-ID des neu erstellten hardlinks. |
x-ms-client-request-id |
Wird verwendet, um Anforderungen und deren entsprechende Antworten zu behandeln. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id-Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden. |
x-ms-mode |
Der Modus der Datei. Siehe POSIX Dateiberechtigungen (Modus). |
x-ms-owner |
Der Benutzerbezeichner (UID) des Dateibesitzers. |
x-ms-group |
Der Gruppenbezeichner (GID) des Dateibesitzers. |
x-ms-link-count |
Die Anzahl der Verknüpfungen der Datei. |
x-ms-file-file-type |
Der Typ der Datei, der mögliche Wert ist: Regular. |
Antworttext
Nichts.
Beispielantwort
Response Status:
HTTP/1.1 201 Created
Response Headers:
Date: Wed, 20 Nov 2024 09:17:08 GMT
ETag: "0x8DD09441C5DB27A"
Last-Modified: Wed, 20 Nov 2024 09:17:09 GMT
x-ms-version: 2025-05-05
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Ermächtigung
Nur der Kontobesitzer kann diesen Vorgang aufrufen.
POSIX-Dateiberechtigungen (Modus)
POSIX-Dateiberechtigungen können numerisch in einem 12-Bit-Numerischen Oktalformat oder in einem symbolischen "rwx"-Format angegeben werden. Beispiele:
- "0644" oder "rw-r-r---": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreibberechtigungen. Gruppe verfügt über Leseberechtigungen. Andere Personen verfügen über Leseberechtigungen.
- "0755" oder "rwxr-xr-x": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. Die Gruppe verfügt über Lese- und Ausführungsberechtigungen. Andere Haben Lese- und Ausführungsberechtigungen.
Numerisches oktales Format
Die drei niedrigsten oktalen Zahlen der Reihenfolge stellen die Berechtigungen für Besitzer/Benutzer, Gruppe und andere dar und werden mit einer oktalen Zahl (0-7) angegeben, die mit einer bitweisen Kombination von "4" (Lesen), "2" (Schreiben), "1" (Ausführen) gebildet wird. Die höchste Oktale Zahl (0-7) wird verwendet, um eine Kombination von '4' (SetUID), '2' (SetGID), '1' (StickyBit)-Berechtigungen anzugeben.
| Format | Erlaubnis |
|---|---|
| 0700 | Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0400 | Der Benutzer verfügt über Leseberechtigungen. |
| 0200 | Der Benutzer verfügt über Schreibberechtigungen. |
| 0100 | Der Benutzer hat die Berechtigung "Ausführen". |
| 0070 | Die Gruppe verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0040 | Gruppe verfügt über Leseberechtigungen. |
| 0020 | Gruppe verfügt über Schreibberechtigungen. |
| 0010 | Die Gruppe hat die Berechtigung "Ausführen". |
| 0007 | Andere verfügen über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0004 | Andere Personen verfügen über Leseberechtigungen. |
| 0002 | Andere verfügen über Schreibberechtigungen. |
| 0001 | Andere haben die Berechtigung zum Ausführen. |
| 4000 | Legen Sie die effektive Benutzer-ID für die Datei fest. |
| 2000 | Legen Sie die effektive Gruppen-ID für die Datei fest. |
| 1000 | Legen Sie fest, dass die Datei gelöscht oder nur vom Dateibesitzer, Verzeichnisbesitzer oder Stammbenutzer umbenannt werden kann. |
Symbolisches "rwx"-Format
Berechtigungen für Besitzer/Benutzer, Gruppen und andere Personen werden mithilfe einer Kombination aus Zeichen "r" (Lesen), "w" (Schreiben) und "x" (Execute) angegeben.
| Format | Erlaubnis |
|---|---|
| rwx------ | Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| r-------- | Der Benutzer verfügt über Leseberechtigungen. |
| -w------- | Der Benutzer verfügt über Schreibberechtigungen. |
| --x------ | Der Benutzer hat die Berechtigung "Ausführen". |
| ---rwx--- | Die Gruppe verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| ---r----- | Gruppe verfügt über Leseberechtigungen. |
| ----w---- | Gruppe verfügt über Schreibberechtigungen. |
| -----x--- | Die Gruppe hat die Berechtigung "Ausführen". |
| ------rwx | Andere verfügen über Lese-, Schreib- und Ausführungsberechtigungen. |
| ------r-- | Andere Personen verfügen über Leseberechtigungen. |
| -------w- | Andere verfügen über Schreibberechtigungen. |
| --------x | Andere haben die Berechtigung zum Ausführen. |
Bemerkungen
Wenn die Freigabe nicht vorhanden ist, schlägt der Vorgang mit dem Statuscode 404/'Not Found' (ShareNotFound) fehl.
Wenn das übergeordnete Verzeichnis der Hardlinks oder die Zieldatei nicht vorhanden ist, schlägt der Vorgang mit dem Statuscode 404/'Not Found' (ParentNotFound) fehl.
Wenn die Zieldatei nicht vorhanden ist, schlägt der Vorgang mit dem Statuscode 404/'Not Found' (ResourceNotFound) fehl.
Wenn die zu erstellende harte Verknüpfung bereits vorhanden ist oder der Pfad auf eine Ressource verweist, die bereits vorhanden ist, schlägt der Vorgang mit dem Statuscode 409/'Conflict' (ResourceAlreadyExists) fehl.
Da hard links nur für Dateien erstellt werden können, wenn der Header x-ms-target-file nicht auf eine Datei verweist, schlägt die Anforderung mit dem Statuscode 400/'Bad Request' fehl.
Create Hard Link wird für eine Freigabemomentaufnahme nicht unterstützt, bei der es sich um eine schreibgeschützte Kopie einer Freigabe handelt. Ein Versuch, diesen Vorgang für eine Freigabemomentaufnahme auszuführen, schlägt mit dem Statuscode 400/'Bad Request' (InvalidQueryParameterValue) fehl.