Create Hard Link 操作では、既存のファイルへの新しいハード リンクが作成されます。 この操作は、バージョン 2025-05-05 以降では、NFS プロトコルが有効になっているファイル共有でのみサポートされています。
プロトコルの可用性
| 有効なファイル共有プロトコル | 利用できる |
|---|---|
| 中小企業 |
なし |
| ネットワークファイルシステム（NFS） |
|
依頼
Create Hard Link 要求は次のように構成されます。 HTTPS を使用することをお勧めします。
| 方式 | 要求 URI | HTTP バージョン |
|---|---|---|
| 置く | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myhardlink?restype=hardlink |
HTTP/1.1 |
次の表に示すように、要求 URI に表示されるパス コンポーネントを独自のコンポーネントに置き換えます。
| パス コンポーネント | 形容 |
|---|---|
myaccount |
ストレージ アカウントの名前。 |
myshare |
ファイル共有の名前。 |
mydirectorypath |
随意。 ハード リンクを作成するディレクトリへのパス。 ディレクトリ パスを省略すると、指定した共有内にハード リンクが作成されます。 ディレクトリが指定されている場合は、ハード リンクを作成する前に、そのディレクトリが共有内に既に存在している必要があります。 |
myhardlink |
作成するハード リンクの名前。 |
パスの名前付けの制限については、「名前と参照共有、ディレクトリ、ファイル、およびメタデータを参照してください。
URI パラメーター
要求 URI には、次の追加パラメーターを指定できます。
| パラメーター | 形容 |
|---|---|
timeout |
随意。
timeout パラメーターは秒単位で表されます。 詳細については、「ファイル サービス操作のタイムアウトの設定」を参照してください。 |
要求ヘッダー
必須の要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 形容 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
Date または x-ms-date |
必須。 要求の協定世界時 (UTC) 時刻を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。 詳細については、Azure Storage サービス のバージョン管理のに関するページを参照してください。 |
Content-Length |
随意。 存在する場合は 0 にする必要があります。 |
x-ms-content-length |
随意。 存在する場合は 0 にする必要があります。 |
x-ms-type: file |
必須。 このヘッダーを fileに設定します。 |
x-ms-file-target-file:path |
必須。 ハード リンクを作成するターゲット ファイルへの絶対パスを指定します(最大 2 KiB)。 これは、同じ共有のルートからのターゲット ファイルの完全なパス/絶対パス、またはターゲット ファイルの完全な URI である必要があります。 次に、ターゲット・ファイル・パスの例をいくつか示します。
|
x-ms-client-request-id |
随意。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を持つクライアント生成の不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティと、サーバーが受信する要求を関連付けすることを強くお勧めします。 詳細については、「Monitor Azure Files」を参照してください。 |
x-ms-file-request-intent |
ヘッダー Authorization OAuth トークンを指定する場合は必須です。 許容される値は backupです。 このヘッダーは、Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action ヘッダーを使用して承認された ID に割り当てられた RBAC ポリシーに含まれている場合、Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action または Authorization を付与するように指定します。 バージョン 2022-11-02 以降で使用できます。 |
x-ms-allow-trailing-dot: { <Boolean> } |
随意。 バージョン 2022-11-02 以降。 ブール値は、要求 URL に存在する末尾のドットをトリミングするかどうかを指定します。 ターゲットが NFS プロトコルが有効なファイル共有上にある場合、このヘッダーは無視され、既定では末尾のドットがサポートされます。 詳細については、「共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。 |
要求本文
何一つ。
要求のサンプル
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=
応答
応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。
状態コード
操作が成功すると、状態コード 201 (Created) が返されます。 状態コードの詳細については、「状態コードとエラー コードを参照してください。
応答ヘッダー
この操作の応答には、次の表のヘッダーが含まれています。
一般的な応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
Date |
サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。 |
ETag |
ETag には、ファイルのバージョンを表す値が含まれています。 値は引用符で囲まれています。 |
Last-Modified |
ファイルが最後に変更された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。 ディレクトリまたはそのプロパティを変更する操作は、最後に変更された時刻を更新します。 ファイルに対する操作は、ディレクトリの最終変更時刻には影響しません。 |
x-ms-request-id |
作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「API 操作 のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用される Azure Files のバージョンを示します。 |
x-ms-file-creation-time |
ファイルの作成時刻プロパティを表す UTC 日付/時刻値。 |
x-ms-file-last-write-time |
ファイルの最後の書き込み時刻プロパティを表す UTC 日付/時刻値。 |
x-ms-file-change-time |
ファイルの変更時刻プロパティを表す UTC 日付/時刻。 |
x-ms-file-file-id |
ファイルのファイル ID。 |
x-ms-file-parent-id |
新しく作成されたハード リンクの親ファイル ID。 |
x-ms-client-request-id |
要求とそれに対応する応答のトラブルシューティングに使用されます。 このヘッダーの値は、要求に存在し、1,024 文字以下の ASCII 文字が含まれている場合、x-ms-client-request-id ヘッダーの値と同じです。
x-ms-client-request-id ヘッダーが要求に存在しない場合、応答には存在しません。 |
x-ms-mode |
ファイルのモード。 POSIX ファイル アクセス許可 (モード)を参照してください。 |
x-ms-owner |
ファイル所有者のユーザー識別子 (UID)。 |
x-ms-group |
ファイル所有者のグループ識別子 (GID)。 |
x-ms-link-count |
ファイルのリンク数。 |
x-ms-file-file-type |
ファイルの種類。指定できる値は Regularです。 |
応答本文
何一つ。
応答のサンプル
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
認可
この操作を呼び出すことができるのは、アカウント所有者だけです。
POSIX ファイルのアクセス許可 (モード)
POSIX ファイルのアクセス許可は、12 ビット数値 8 進数形式またはシンボリック "rwx" 形式で数値で指定できます。 例：
- "0644" または "rw-r--r--": ユーザー (ファイル所有者) に読み取り、書き込みアクセス許可があります。 グループには読み取りアクセス許可があります。 他のユーザーには読み取りアクセス許可があります。
- "0755" または "rwxr-xr-x": ユーザー (ファイル所有者) に読み取り、書き込み、実行のアクセス許可があります。 グループには読み取りと実行のアクセス許可があります。 他のユーザーには、読み取りと実行のアクセス許可があります。
数値の 8 進数形式
3 つの最下位の 8 進数は、所有者/ユーザー、グループなどのアクセス許可を表し、8 進数 (0 から 7) を使用して示されます。これは、ビットごとの組み合わせの '4' (読み取り)、'2' (書き込み)、'1' (実行) を使用して形成されます。 最上位の 8 進数 (0 から 7) は、'4' (SetUID)、'2' (SetGID)、'1' (StickyBit) のアクセス許可の組み合わせを示すために使用されます。
| 形式 | 許可 |
|---|---|
| 0700 | ユーザー (ファイル所有者) には、読み取り、書き込み、実行のアクセス許可があります。 |
| 0400 | ユーザーは読み取りアクセス許可を持っています。 |
| 0200 | ユーザーは書き込みアクセス許可を持っています。 |
| 0100 | ユーザーは実行アクセス許可を持っています。 |
| 0070 | グループには、読み取り、書き込み、実行のアクセス許可があります。 |
| 0040 | グループには読み取りアクセス許可があります。 |
| 0020 | グループには書き込みアクセス許可があります。 |
| 0010 | グループには実行アクセス許可があります。 |
| 0007 | 他のユーザーには、読み取り、書き込み、実行のアクセス許可があります。 |
| 0004 | 他のユーザーには読み取りアクセス許可があります。 |
| 0002 | 他のユーザーには書き込みアクセス許可があります。 |
| 0001 | 他のユーザーには実行アクセス許可があります。 |
| 4000 | ファイルに有効なユーザー ID を設定します。 |
| 2000 | ファイルに有効なグループ ID を設定します。 |
| 1000 | ファイルを削除または名前変更できるのは、ファイル所有者、ディレクトリ所有者、またはルート ユーザーのみであることを示すために設定します。 |
シンボリック "rwx" 形式
所有者/ユーザー、グループなどのアクセス許可は、'r' (読み取り)、'w' (書き込み)、および 'x' (実行) 文字の組み合わせを使用して示されます。
| 形式 | 許可 |
|---|---|
| RWXの------ | ユーザー (ファイル所有者) には、読み取り、書き込み、実行のアクセス許可があります。 |
| r-------- | ユーザーは読み取りアクセス許可を持っています。 |
| -w------- | ユーザーは書き込みアクセス許可を持っています。 |
| --バツ------ | ユーザーは実行アクセス許可を持っています。 |
| ---RWX--- | グループには、読み取り、書き込み、実行のアクセス許可があります。 |
| ---r----- | グループには読み取りアクセス許可があります。 |
| ----w---- | グループには書き込みアクセス許可があります。 |
| -----x--- | グループには実行アクセス許可があります。 |
| ------RWXの | 他のユーザーには、読み取り、書き込み、実行のアクセス許可があります。 |
| ------r-- | 他のユーザーには読み取りアクセス許可があります。 |
| -------w- | 他のユーザーには書き込みアクセス許可があります。 |
| --------x | 他のユーザーには実行アクセス許可があります。 |
備考
共有が存在しない場合、操作は状態コード 404/'Not Found' (ShareNotFound) で失敗します。
ハード リンクの親ディレクトリまたはターゲット ファイルが存在しない場合、操作は状態コード 404/'Not Found' (ParentNotFound) で失敗します。
ターゲット ファイルが存在しない場合、操作は状態コード 404/'Not Found' (ResourceNotFound) で失敗します。
作成するハード リンクが既に存在する場合、または既に存在するリソースへのパスである場合、操作は状態コード 409/'Conflict' (ResourceAlreadyExists) で失敗します。
ハード リンクはファイルに対してのみ作成できるため、ヘッダー x-ms-target-file がファイルを指していない場合、要求は状態コード 400/'Bad Request' で失敗します。
Create Hard Link は、共有スナップショット (共有の読み取り専用コピー) ではサポートされていません。 共有スナップショットに対してこの操作を実行しようとすると、状態コード 400/'Bad Request' (InvalidQueryParameterValue) で失敗します。
関連項目
ファイル に対する 操作