次の方法で共有

ディレクトリの作成

  • [アーティクル]

Create Directory 操作では、指定した共有ディレクトリまたは親ディレクトリの下に新しいディレクトリが作成されます。 ディレクトリ リソースには、そのディレクトリのプロパティが含まれています。 ディレクトリに含まれるファイルまたはサブディレクトリの一覧は含まれません。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。

プロトコルの可用性

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

依頼

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

方式 要求 URI HTTP バージョン
配置する https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1

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

パス コンポーネント 形容
myaccount ストレージ アカウントの名前。
myshare ファイル共有の名前。
myparentdirectorypath 随意。 mydirectory 作成される親ディレクトリへのパス。 親ディレクトリ パスを省略すると、指定した共有内にディレクトリが作成されます。

親ディレクトリが指定されている場合は、mydirectory を作成する前に、そのディレクトリが既共有内に存在している必要があります。
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-meta-name:value 随意。 バージョン 2015-02-21 以降。 メタデータとしてディレクトリに関連付ける名前と値のペア。

メタデータ名は、C# 識別子の名前付け規則に従う必要があります。
x-ms-file-creation-time: { now ¦ <DateTime> } 必須: バージョン 2019-02-02 から 2021-04-10。 省略可能: バージョン 2021-06-08 以降。 ディレクトリの協定世界時 (UTC) の作成時刻プロパティ。 now の値を使用して、要求の時刻を示すことができます。 既定値は nowです。
x-ms-file-last-write-time: { now ¦ <DateTime> } 必須: バージョン 2019-02-02 から 2021-04-10。 省略可能: バージョン 2021-06-08 以降。 ディレクトリの協定世界時 (UTC) の最後の書き込みプロパティ。 now の値を使用して、要求の時刻を示すことができます。 既定値は nowです。
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> } 随意。 ISO 8601 形式のディレクトリの協定世界時 (UTC) 変更時刻プロパティ。 バージョン 2021-06-08 以降。 now の値を使用して、要求の時刻を示すことができます。 既定値は nowです。
x-ms-file-permission: { inherit ¦ <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) する必要があります。 親ディレクトリから継承する inherit の値を渡すことができます。

注意: x-ms-file-permission または x-ms-file-permission-keyを指定できます。 どちらのヘッダーも指定されていない場合は、inherit の既定値が使用されます。
x-ms-file-permission-format: { sddl ¦ binary } 随意。 バージョン 2024-11-04 以降。 x-ms-file-permission で渡される値が SDDL 形式かバイナリ形式かを指定します。 x-ms-file-permission が inheritに設定されている場合、このヘッダーは設定しないでください。 x-ms-file-permission が inherit以外の値に設定されている場合、このヘッダーが設定されていない場合は、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を指定できます。 どちらのヘッダーも指定されていない場合は、inherit の既定値が x-ms-file-permission ヘッダーに使用されます。
x-ms-file-attributes 必須: バージョン 2019-02-02 から 2021-04-10。 省略可能: バージョン 2021-06-08 以降。 ディレクトリに設定するファイル システム属性。 使用可能な属性 一覧を参照してください。 既定値は [ディレクトリ] です。

NFS 要求ヘッダーのみ

リクエストヘッダー 形容
x-ms-mode バージョン 2025-05-05 以降。 ファイルに設定するモード ビット。 モードは、12 ビット数値 8 進数形式またはシンボリック 'rwx' 形式で表されます。 既定値は 0755 です。 POSIX ファイル アクセス許可 (モード)を参照してください。 POSIX ファイル アクセス許可 (モード)を参照してください。
x-ms-owner バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のユーザー識別子 (UID)。 既定値は 0 (ルート) です。
x-ms-group バージョン 2025-05-05 以降。 ファイルに設定するファイル所有者のグループ識別子 (GID)。 既定値は 0 (ルート) です。

要求本文

何一つ。

要求のサンプル

PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1  
  
Request headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
x-ms-meta-Category: Images  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

応答

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

状態コード

操作が成功すると、状態コード 201 (Created) が返されます。 状態コードの詳細については、「状態コードとエラー コードを参照してください。

応答ヘッダー

この操作の応答には、次の表のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは、HTTP/1.1 プロトコル仕様に準拠しています。

一般的な応答ヘッダー

応答ヘッダー 形容
ETag ディレクトリのバージョンを表す値を引用符で囲んで格納します。
Last-Modified ディレクトリが最後に変更された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。 ディレクトリまたはそのプロパティを変更する操作は、最後に変更された時刻を更新します。 ファイルに対する操作は、ディレクトリの最終変更時刻には影響しません。
x-ms-request-id 作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用された Azure Files のバージョンを示します。
Date サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。
x-ms-request-server-encrypted: true/false バージョン 2017-04-17 以降。 このヘッダーの値は、要求の内容が指定されたアルゴリズムを使用して正常に暗号化された場合は true に設定され、それ以外の場合は false。
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 要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、1024 文字以下の 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-file-file-type バージョン 2025-05-05 以降。 ファイルの種類。指定できる値は Directoryです。

応答本文

何一つ。

応答のサンプル

Response status:  
HTTP/1.1 201 Created  
  
Response headers:  
Transfer-Encoding: chunked  
Date: Mon, 27 Jan 2014 23:00:12 GMT  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT  
x-ms-version: 2014-02-14  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

認可

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

ファイル システム属性

属性 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 他のユーザーには実行アクセス許可があります。

備考

Create Directory が呼び出されたときに同じ名前のディレクトリが削除されている場合、サーバーは状態コード 409 (競合) を返し、ディレクトリが削除されていることを示す追加のエラー情報を提供します。

同じ名前のディレクトリまたはファイルが既に存在する場合、操作は状態コード 409 (競合) で失敗します。 親ディレクトリが存在しない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。

1 つの Create Directory 操作でディレクトリ階層を作成することはできません。 ディレクトリを作成できるのは、パスで指定されている直前の親が既に存在する場合のみです。 親ディレクトリが存在しない場合、操作は状態コード 412 (前提条件に失敗) で失敗します。

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

関連項目

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