次の方法で共有

ディレクトリのプロパティを取得する

  • [アーティクル]

Get Directory Properties 操作は、指定されたディレクトリのすべてのシステム プロパティを返します。また、ディレクトリの存在を確認するために使用することもできます。 返されるデータには、ディレクトリまたはサブディレクトリ内のファイルは含まれません。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。

プロトコルの可用性

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

依頼

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

方式 要求 URI HTTP バージョン
GET/HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
GET/HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> HTTP/1.1

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

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

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

URI パラメーター

要求 URI には、次の追加パラメーターを指定できます。

パラメーター 形容
sharesnapshot 随意。 バージョン 2017-04-17 以降。 sharesnapshot パラメーターは不透明な DateTime 値であり、存在する場合は、ディレクトリ プロパティに対してクエリを実行する共有スナップショットを指定します。
timeout 随意。 timeout パラメーターは秒単位で表されます。 詳細については、「Azure Files 操作のタイムアウトを設定する」を参照してください。

要求ヘッダー

必須および省略可能な要求ヘッダーについては、次の表で説明します。

一般的な要求ヘッダー

要求ヘッダー 形容
Authorization 必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
Date または x-ms-date 必須。 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
x-ms-version すべての承認された要求に必要です。 この要求に使用する操作のバージョンを指定します。 この操作は、NFS プロトコルが有効になっているファイル共有のバージョン 2025-05-05 以降でサポートされています。

詳細については、Azure Storage サービス のバージョン管理のに関するページを参照してください。
x-ms-client-request-id 随意。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を持つクライアント生成の不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティと、サーバーが受信する要求を関連付けすることを強くお勧めします。 詳細については、「Monitor Azure Files」を参照してください。
x-ms-file-request-intent ヘッダー Authorization OAuth トークンを指定する場合は必須です。 許容される値は backupです。 このヘッダーは、Authorization ヘッダーを使用して承認された ID に割り当てられた RBAC ポリシーに含まれている場合、Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action または Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action を付与するように指定します。 バージョン 2022-11-02 以降で使用できます。
x-ms-allow-trailing-dot: { <Boolean> } 随意。 バージョン 2022-11-02 以降。 ブール値は、要求 URL に存在する末尾のドットをトリミングするかどうかを指定します。

ターゲットが NFS プロトコルが有効なファイル共有上にある場合、このヘッダーは無視され、既定では末尾のドットがサポートされます。

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

SMB のみの要求ヘッダー

何一つ。

NFS 要求ヘッダーのみ

何一つ。

要求本文

何一つ。

要求のサンプル

HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

応答

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

状態コード

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

応答ヘッダー

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

一般的な応答ヘッダー

応答ヘッダー 形容
ETag ETag には、条件付きで操作を実行するために使用できる値が含まれています。 値は引用符で囲まれています。
Last-Modified ディレクトリが最後に変更された日時を返します。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。 ディレクトリ内のファイルに対する操作は、ディレクトリの最終変更時刻には影響しません。
x-ms-meta-name:value ディレクトリのメタデータを含む名前と値のペアのセット。
x-ms-request-id 要求の一意識別子を返します。要求のトラブルシューティングに役立ちます。 詳細については、「API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用されたサービス バージョンを示します。
Date サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。
x-ms-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-file-file-id バージョン 2019-02-02 以降。 ディレクトリのファイル ID。
x-ms-file-parent-id バージョン 2019-02-02 以降。 ディレクトリの親ファイル ID。
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-file-file-type バージョン 2025-05-05 以降。 ファイルの種類、使用可能な値は次のとおりです:Directory。

応答本文

何一つ。

応答のサンプル

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
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_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 他のユーザーには実行アクセス許可があります。

備考

指定したディレクトリ パスが存在しない場合、要求は状態コード 404 (Not Found) で失敗します。

関連項目

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