次の方法で共有

ディレクトリのプロパティを設定する

  • [アーティクル]

Set Directory Properties 操作は、指定したディレクトリのシステム プロパティを設定します。 この操作は、SMB プロトコルが有効なファイル共有ではバージョン 2019-02-02 以降でサポートされ、NFS プロトコルが有効なファイル共有ではバージョン 2025-05-05 以降でサポートされています。

プロトコルの可用性

有効なファイル共有プロトコル 利用できる
SMB はい
NFS はい

依頼

Set Directory Properties 要求は次のように構成されます。 HTTPS を使用することをお勧めします。

方式 要求 URI HTTP バージョン
置く https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&comp=properties HTTP/1.1

次のように、要求 URI に表示されているパス コンポーネントを独自のコンポーネントに置き換えます。

パス コンポーネント 形容
myaccount ストレージ アカウントの名前。
myshare ファイル共有の名前。
mydirectorypath 随意。 親ディレクトリへのパス。
mydirectory ファイルの名前。

パスの名前付けの制限については、「名前と参照共有、ディレクトリ、ファイル、およびメタデータのを参照してください。

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-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です。
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) または base64 でエンコードされたバイナリ セキュリティ記述子形式 (バージョン 2024-11-04 以降) で指定されたディレクトリ セキュリティ記述子。 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 ヘッダーに使用されます。
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)。

応答本文

何一つ。

認可

アカウント所有者のみがこの操作を呼び出すことができます。

ファイル システム属性

属性 Win32 ファイル属性 定義
ReadOnly FILE_ATTRIBUTE_READONLY 読み取り専用のディレクトリ。
隠れた FILE_ATTRIBUTE_HIDDEN ディレクトリは非表示になっています。 通常のディレクトリ 一覧には含まれません。
制 FILE_ATTRIBUTE_SYSTEM オペレーティング システムが一部を使用するディレクトリ、または排他的に使用するディレクトリ。
何一つ FILE_ATTRIBUTE_NORMAL 他の属性が設定されていないディレクトリ。 この属性は、単独で使用されている場合にのみ有効です。
ディレクトリ FILE_ATTRIBUTE_DIRECTORY ディレクトリを識別するハンドル。
アーカイブ FILE_ATTRIBUTE_ARCHIVE アーカイブ ディレクトリであるディレクトリ。 通常、アプリケーションではこの属性を使用して、バックアップまたは削除のためにファイルをマークします。
オフライン 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 他のユーザーには実行アクセス許可があります。

備考

Set Directory Properties は、共有スナップショット (共有の読み取り専用コピー) ではサポートされていません。 共有スナップショットに対してこの操作を実行しようとすると、400 (InvalidQueryParameterValue) で失敗します。

Set Directory Properties を持つディレクトリに設定されているプロパティは、そのディレクトリの下のサブディレクトリには反映されません。 プロパティを更新するディレクトリごとに Set Directory Properties を呼び出す必要があります。

関連項目

ディレクトリ に対する 操作