ファイルのプロパティを設定する
Set File Properties 操作は、ファイルのシステム プロパティを設定します。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。
プロトコルの可用性
| 有効なファイル共有プロトコル | 利用できる |
|---|---|
| SMB |
|
| NFS |
|
依頼
Set File Properties 要求は次のように構成されます。 HTTPS を使用することをお勧めします。
| 方式 | 要求 URI | HTTP バージョン |
|---|---|---|
| 置く | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
HTTP/1.1 |
次のように、要求 URI に表示されているパス コンポーネントを独自のコンポーネントに置き換えます。
| パス コンポーネント | 形容 |
|---|---|
myaccount |
ストレージ アカウントの名前。 |
myshare |
ファイル共有の名前。 |
mydirectorypath |
随意。 親ディレクトリへのパス。 |
myfile |
ファイルの名前。 |
パスの名前付けの制限については、「名前と参照共有、ディレクトリ、ファイル、およびメタデータのを参照してください。
URI パラメーター
要求 URI には、次の追加パラメーターを指定できます。
| パラメーター | 形容 |
|---|---|
timeout |
随意。
timeout パラメーターは秒単位で表されます。 詳細については、「ファイル サービス操作のタイムアウトを設定する」を参照してください。 |
要求ヘッダー
必須および省略可能な要求ヘッダーについては、次の表で説明します。
一般的な要求ヘッダー
| 要求ヘッダー | 形容 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
Date または x-ms-date |
必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。 |
x-ms-version |
すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。 詳細については、Azure Storage サービス のバージョン管理のに関するページを参照してください。 |
x-ms-cache-control |
随意。 ファイルのキャッシュ 制御文字列を変更します。 要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-type |
随意。 ファイルのコンテンツ タイプを設定します。 要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-md5 |
随意。 ファイルの MD5 ハッシュを設定します。 要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-encoding |
随意。 ファイルのコンテンツ エンコードを設定します。 要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-language |
随意。 ファイルのコンテンツ言語を設定します。 要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-disposition |
随意。 ファイルの Content-Disposition ヘッダーを設定します。要求でこのプロパティが指定されていない場合、ファイルのプロパティはクリアされます。 ファイルプロパティの取得 に対する後続の呼び出しでは、ファイルに対して明示的に設定されていない限り、このプロパティは返されません。 |
x-ms-content-length: bytes |
随意。 指定したサイズにファイルのサイズを変更します。 指定したバイト値がファイルの現在のサイズより小さい場合、指定したバイト値より上のすべての範囲がクリアされます。 |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
必須、バージョン 2019-02-02 から 2021-04-10。 オプション、バージョン 2021-06-08 以降。 ファイルの協定世界時 (UTC) の作成時刻プロパティ。
preserve の値を渡して、既存の値を変更せずに保持できます。 既定値は preserveです。 |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
必須、バージョン 2019-02-02 から 2021-04-10。 オプション、バージョン 2021-06-08 以降。 ファイルの協定世界時 (UTC) の最後の書き込みプロパティ。
preserve の値を渡して、既存の値を変更せずに保持できます。
preserve を指定し、ファイルのサイズを変更すると、最後の書き込み時刻が現在の時刻に更新されます。 ファイルのサイズが変更されても、明示的なタイムスタンプが指定されている場合は、明示的なタイムスタンプが使用されます。 既定値は preserveです。 |
x-ms-lease-id:<ID> |
ファイルにアクティブなリースがある場合に必要です。 バージョン 2019-02-02 以降で使用できます。 このヘッダーは、ファイルが NFS プロトコルが有効になっているファイル共有上にあり、ファイルリースをサポートしていない場合は無視されます。 |
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 プロトコルが有効なファイル共有上にある場合、このヘッダーは無視され、既定では末尾のドットがサポートされます。 詳細については、「共有、ディレクトリ、ファイル、およびメタデータの名前付けと参照」を参照してください。 |
SMB のみの要求ヘッダー
| 要求ヘッダー | 形容 |
|---|---|
x-ms-file-change-time: { now ¦ <DateTime> } |
随意。 バージョン 2021-06-08 以降。 ISO 8601 形式で書式設定されたファイルの協定世界時 (UTC) 変更時刻プロパティ。
now の値を使用して、要求の時刻を示すことができます。 既定値は nowです。 |
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } |
バージョン 2019-02-02 から 2021-04-10 では、x-ms-file-permission-key が指定されていない場合は、このヘッダーが必要です。 バージョン 2021-06-08 の時点では、両方のヘッダーは省略可能です。 このアクセス許可は、セキュリティ記述子定義言語 (SDDL) または (バージョン 2024-11-04 以降) base64 でエンコードされたバイナリ セキュリティ記述子形式で指定されたファイル セキュリティ記述子です。
x-ms-file-permission-format ヘッダーで使用する形式を指定できます。 このヘッダーは、アクセス許可のサイズが 8 kibibytes (KiB) 以下の場合に使用できます。 それ以外の場合は、x-ms-file-permission-keyを使用できます。 指定する場合は、所有者、グループ、および随意アクセス制御リスト (DACL) する必要があります。
preserve の値を渡して、既存の値を変更せずに保持できます。注意: x-ms-file-permission または x-ms-file-permission-keyを指定できます。 どちらのヘッダーも指定されていない場合は、preserve の既定値が使用されます。 |
x-ms-file-permission-format: { sddl ¦ binary } |
随意。 バージョン 2024-11-04 以降。
x-ms-file-permission で渡される値が SDDL 形式かバイナリ形式かを指定します。
x-ms-file-permission が preserveに設定されている場合、このヘッダーは設定しないでください。
x-ms-file-permission が preserve以外の値に設定されている場合、このヘッダーが設定されていない場合は、sddl の既定値が使用されます。 |
x-ms-file-permission-key: <PermissionKey> |
バージョン 2019-02-02 から 2021-04-10 では、x-ms-file-permission が指定されていない場合は、このヘッダーが必要です。 バージョン 2021-06-08 の時点では、両方のヘッダーは省略可能です。 ファイルに設定するアクセス許可のキー。 これは、Create-Permission API を使用して作成できます。注意: x-ms-file-permission または x-ms-file-permission-keyを指定できます。 どちらのヘッダーも指定されていない場合は、preserve の既定値が x-ms-file-permission ヘッダーに使用されます。 |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
必須、バージョン 2019-02-02 から 2021-04-10。 オプション、バージョン 2021-06-08 以降。 ファイルに設定するファイル システム属性。 使用可能な属性 一覧を参照してください。
preserve の値を渡して、既存の値を変更せずに保持できます。 既定値は preserveです。 |
NFS 要求ヘッダーのみ
| 要求ヘッダー | 形容 |
|---|---|
x-ms-mode |
バージョン 2025-05-05 以降。 ファイルに設定するモード ビット。 モードは、12 ビット数値 8 進数形式またはシンボリック 'rwx' 形式で表されます。 POSIX ファイル アクセス許可 (モード)を参照してください。 |
x-ms-owner |
バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のユーザー識別子 (UID)。 |
x-ms-group |
バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のグループ識別子 (GID)。 |
要求本文
何一つ。
応答
応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。
状態コード
操作が成功すると、状態コード 200 (OK) が返されます。 状態コードの詳細については、「状態コードとエラー コードを参照してください。 状態コードの詳細については、「状態コードとエラー コードを参照してください。
応答ヘッダー
この操作の応答には、次の表のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。
一般的な応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
ETag |
ファイルのバージョンを表す値を格納します。 値は引用符で囲まれています。 |
Last-Modified |
ファイルが最後に変更された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。 ディレクトリまたはそのプロパティを変更する操作は、最後に変更された時刻を更新します。 ファイルに対する操作は、ディレクトリの最終変更時刻には影響しません。 |
x-ms-request-id |
作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用されるファイル サービスのバージョンを示します。 |
Date または x-ms-date |
サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。 |
x-ms-request-server-encrypted: true/false |
バージョン 2017-04-17 以降。 このヘッダーの値は、指定したアルゴリズムを使用して要求の内容が正常に暗号化された場合に true に設定されます。 それ以外の場合、値は falseに設定されます。 |
x-ms-file-creation-time |
バージョン 2019-02-02 以降。 ファイルの作成時刻プロパティを表す UTC 日付/時刻値。 |
x-ms-file-last-write-time |
バージョン 2019-02-02 以降。 ファイルの最後の書き込み時刻プロパティを表す UTC 日付/時刻値。 |
x-ms-file-change-time |
バージョン 2019-02-02 以降。 ファイルの変更時刻プロパティを表す UTC 日付/時刻値。 |
x-ms-client-request-id |
要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、1,024 文字以下の ASCII 文字が含まれている場合、x-ms-client-request-id ヘッダーの値と同じです。
x-ms-client-request-id ヘッダーが要求に存在しない場合、応答には存在しません。 |
SMB のみの応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
x-ms-file-permission-key |
バージョン 2019-02-02 以降。 ファイルのアクセス許可のキー。 |
x-ms-file-attributes |
バージョン 2019-02-02 以降。 ファイルのファイル システム属性。 詳細については、使用可能な属性の一覧を参照してください。 |
NFS のみの応答ヘッダー
| 応答ヘッダー | 形容 |
|---|---|
x-ms-mode |
バージョン 2025-05-05 以降。 ファイルのモード。 POSIX ファイル アクセス許可 (モード)を参照してください。 |
x-ms-owner |
バージョン 2025-05-05 以降。 ファイル所有者のユーザー識別子 (UID)。 |
x-ms-group |
バージョン 2025-05-05 以降。 ファイル所有者のグループ識別子 (GID)。 |
x-ms-link-count |
バージョン 2025-05-05 以降。 ファイルのリンク数。 |
応答本文
何一つ。
認可
この操作を呼び出すことができるのは、アカウント所有者だけです。
ファイル システム属性
| 属性 | Win32 ファイル属性 | 定義 |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | 読み取り専用のファイル。 アプリケーションはファイルを読み取ることができますが、ファイルに書き込んだり削除したりすることはできません。 |
| 隠れた | FILE_ATTRIBUTE_HIDDEN | ファイルは非表示になっています。 通常のディレクトリ 一覧には含まれません。 |
| 制 | FILE_ATTRIBUTE_SYSTEM | オペレーティング システムが一部を使用するファイル、または排他的に使用するファイル。 |
| 何一つ | FILE_ATTRIBUTE_NORMAL | 他の属性が設定されていないファイル。 この属性は、単独で使用されている場合にのみ有効です。 |
| アーカイブ | FILE_ATTRIBUTE_ARCHIVE | アーカイブ ファイルであるファイル。 通常、アプリケーションではこの属性を使用して、バックアップまたは削除のためにファイルをマークします。 |
| 一時的 | FILE_ATTRIBUTE_TEMPORARY | 一時ストレージに使用されているファイル。 |
| オフライン | FILE_ATTRIBUTE_OFFLINE | ファイルのデータはすぐには使用できません。 このファイル システム属性は、主に Windows との互換性を提供するために表示されます。 Azure Files では、オフライン ストレージ オプションはサポートされていません。 |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | ファイルは、コンテンツ インデックス 作成サービスによってインデックス付けされることはありません。 |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | ユーザー データ ストリームは、バックグラウンド データ整合性スキャナーによって読み取られることはありません。 このファイル システム属性は、主に Windows との互換性を提供するために表示されます。 |
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------- | ユーザーは書き込みアクセス許可を持っています。 |
| --x------ | ユーザーは実行アクセス許可を持っています。 |
| ---rwx--- | グループには、読み取り、書き込み、実行のアクセス許可があります。 |
| ---r----- | グループには読み取りアクセス許可があります。 |
| ----w---- | グループには書き込みアクセス許可があります。 |
| -----x--- | グループには実行アクセス許可があります。 |
| ------rwx | 他のユーザーには、読み取り、書き込み、実行のアクセス許可があります。 |
| ------r-- | 他のユーザーには読み取りアクセス許可があります。 |
| -------w- | 他のユーザーには書き込みアクセス許可があります。 |
| --------x | 他のユーザーには実行アクセス許可があります。 |
備考
ファイルのプロパティを更新するためのセマンティクスは次のとおりです。
ファイルのサイズは、要求で
x-ms-content-lengthヘッダーの値が指定されている場合にのみ変更されます。要求が
x-ms-content-lengthのみを設定し、他のプロパティを設定しない場合:- ファイルが SMB プロトコルが有効なファイル共有にある場合、ファイルの他のプロパティは変更されていません。
- ファイルが NFS プロトコルが有効なファイル共有にある場合、ファイルの変更時刻と最終書き込み時刻が変更されます。
要求で次のプロパティのいずれかが 1 つ以上設定されている場合、これらのプロパティはすべてまとめて設定されます。 次のプロパティの少なくとも 1 つが設定されているときに、指定されたプロパティの値が指定されていない場合、そのプロパティはファイルに対してクリアされます。
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
手記
上記のファイル プロパティは、SMB クライアントで使用できるファイル システム のプロパティとは別です。 SMB クライアントは、これらのプロパティ値の読み取り、書き込み、または変更を行うことはできません。
Set File properties は、共有スナップショット (共有の読み取り専用コピー) ではサポートされていません。 共有スナップショットに対してこの操作を実行しようとすると、400 (InvalidQueryParameterValue) で失敗します。
ファイルにアクティブなリースがある場合、クライアントは、ファイルにプロパティを書き込む要求で有効なリース ID を指定する必要があります。 クライアントがリース ID を指定しない場合、または無効なリース ID を指定した場合、File サービスは状態コード 412 (前提条件に失敗) を返します。 クライアントがリース ID を指定しても、ファイルにアクティブなリースがない場合、File サービスは状態コード 412 (前提条件に失敗) も返します。
関連項目
ファイル に対する 操作