Filesystem - List

リファレンス

サービス:: Storage Services

API バージョン:: 2023-08-03

特定のアカウントのファイルシステムとそのプロパティを一覧表示します。

GET https://{accountName}.{dnsSuffix}/?resource=account

省略可能なパラメーターを含む:

GET https://{accountName}.{dnsSuffix}/?resource=account&prefix={prefix}&continuation={continuation}&maxResults={maxResults}&timeout={timeout}

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string	Azure Storage アカウント名。
dnsSuffix	path	True	string	Azure Data Lake Storage エンドポイントの DNS サフィックス。
resource	query	True	AccountResourceType	この値は、すべてのアカウント操作で "account" である必要があります。
continuation	query		string	各呼び出しで返されるファイルシステムの数は限られています。返されるファイルシステムの数がこの制限を超えると、応答ヘッダー x-ms-continuation に継続トークンが返されます。応答で継続トークンが返された場合、ファイルシステムのリストを続行するには、リスト操作の後続の呼び出しで継続トークンを指定する必要があります。
maxResults	query		integer (int32) minimum: 1	返される項目の最大数を指定する省略可能な値。省略した場合、または 5,000 を超える場合、応答には最大 5,000 個の項目が含まれます。
prefix	query		string	指定したプレフィックス内のファイルシステムに結果をフィルター処理します。
timeout	query		integer (int32) minimum: 1	オプションの操作タイムアウト値 (秒単位)。期間は、サービスが要求を受信したときに開始されます。操作が完了する前にタイムアウト値が経過すると、操作は失敗します。

要求ヘッダー

名前	型	説明
x-ms-client-request-id	string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$	トラブルシューティングと相関関係のために分析ログに記録された UUID。
x-ms-date	string	要求の世界協定時刻 (UTC) を指定します。これは、共有キーの承認を使用する場合に必要です。
x-ms-version	string	要求の処理に使用される REST プロトコルのバージョンを指定します。これは、共有キーの承認を使用する場合に必要です。

応答

名前	型	説明
200 OK	FilesystemList	わかりましたヘッダー Date: string x-ms-request-id: string x-ms-version: string x-ms-continuation: string Content-Type: string x-ms-default-encryption-scope: string x-ms-deny-encryption-scope-override: boolean
Other Status Codes	DataLakeStorageError	エラーが発生しました。可能な HTTP 状態、コード、およびメッセージ文字列を次に示します。 400 Bad Request、ContentLengthMustBeZero、"The Content-Length request header must be zero" 400 Bad Request、InvalidAuthenticationInfo、"認証情報が正しい形式で指定されていません。 Authorization ヘッダーの値を確認してください。 400 Bad Request、InvalidFlushPosition、"アップロードされたデータが連続していないか、位置クエリパラメーターの値が、アップロードされたデータを追加した後のファイルの長さと等しくありません。" 400 Bad Request、InvalidHeaderValue、"いずれかの HTTP ヘッダーの値が正しい形式ではありません。" 400 Bad Request、InvalidHttpVerb、"指定された HTTP 動詞は無効です。サーバーによって認識されません。" 400 無効な要求、InvalidInput、"要求入力の 1 つが無効です。" 400 Bad Request、InvalidPropertyName、"A property name cannot be empty." 400 Bad Request、InvalidPropertyName、"プロパティ名に無効な文字が含まれています。" 400 Bad Request、InvalidQueryParameterValue、"要求 URI で指定されたクエリパラメーターの値が無効です。" 400 Bad Request、InvalidResourceName、"指定されたリソース名に無効な文字が含まれています。" 400 無効な要求、InvalidSourceUri、"ソース URI が無効です。" 400 無効な要求、InvalidUri、"要求 URI が無効です。" 400 Bad Request、MissingRequiredHeader、"この要求に必須の HTTP ヘッダーが指定されていません。" 400 Bad Request、MissingRequiredQueryParameter、"この要求に必須のクエリパラメーターが指定されていません。" 400 Bad Request、MultipleConditionHeadersNotSupported、"複数の条件ヘッダーはサポートされていません。" 400 Bad Request、OutOfRangeInput、"要求入力の 1 つが範囲外です。" 400 Bad Request、OutOfRangeQueryParameterValue、"要求 URI で指定されたクエリパラメーターの 1 つが許容範囲外です。" 400 Bad Request、UnsupportedHeader、"要求で指定されたヘッダーの 1 つがサポートされていません。" 400 無効な要求、UnsupportedQueryParameter、"要求 URI で指定されたクエリパラメーターの 1 つがサポートされていません。" 400 無効な要求、UnsupportedRestVersion、"指定された Rest バージョンはサポートされていません。" 403 Forbidden、AccountIsDisabled、"指定されたアカウントが無効になっています。" 403 Forbidden、AuthorizationFailure、"この要求は、この操作を実行する権限がありません。" 403 Forbidden、InsufficientAccountPermissions、"アクセスされているアカウントには、この操作を実行するための十分なアクセス許可がありません。" 404 Not Found,FilesystemNotFound, "The specified filesystem does not exist." (指定されたファイルシステムが存在しません。) 404 Not Found、PathNotFound、"指定したパスが存在しません。" 404 Not Found,RenameDestinationParentPathNotFound, "The parent directory of the destination path does not exist." 404 Not Found、ResourceNotFound、"指定されたリソースが存在しません。" 404 Not Found、SourcePathNotFound、"名前変更操作のソースパスが存在しません。" 405 メソッド Not Allowed、UnsupportedHttpVerb、"リソースは指定された HTTP 動詞をサポートしていません。" 409 Conflict、DestinationPathIsBeingDeleted、"指定された宛先パスは削除対象としてマークされています。" 409 Conflict、DirectoryNotEmpty、"空でないディレクトリを削除するには、再帰クエリパラメーター値が true である必要があります。" 409 Conflict、FilesystemAlreadyExists、"指定されたファイルシステムは既に存在します。" 409 競合、FilesystemBeingDeleted、"指定されたファイルシステムが削除されています。" 409 Conflict、InvalidDestinationPath、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。"* 409 Conflict、InvalidFlushOperation、"リソースは Blob Service API によって作成または変更され、Data Lake Storage Service API によって書き込むことができません。" 409 Conflict、InvalidRenameSourcePath、"ソースディレクトリをコピー先ディレクトリと同じにすることも、コピー先をソースディレクトリのサブディレクトリにすることもできません。" 409 Conflict、InvalidSourceOrDestinationResourceType、"ソースとターゲットのリソースの種類は同じである必要があります。" 409 Conflict、LeaseAlreadyPresent、"既にリースが存在しています。" 409 Conflict, LeaseIdMismatchWithLeaseOperation, "指定されたリース ID が、指定したリース操作を持つリソースのリース ID と一致しませんでした。" 409 Conflict、LeaseIsAlreadyBroken、"リースは既に破損しており、再び破損することはできません。" 409 Conflict、LeaseIsBreakingAndCannotBeAcquired、"リース ID は一致しましたが、リースは現在中断状態にあり、破損するまで取得できません。" 409 Conflict、LeaseIsBreakingAndCannotBeChanged、"リース ID は一致しましたが、リースは現在中断状態にあり、変更できません。" 409 Conflict、LeaseIsBrokenAndCannotBeRenewed、"リース ID が一致しましたが、リースが明示的に破損しており、更新できません。" 409 Conflict、LeaseNameMismatch、"指定されたリース名が既存のリース名と一致しませんでした。" 409 Conflict, LeaseNotPresentWithLeaseOperation, "リース ID が指定されたリース操作と共に存在しません。" 409 Conflict、PathAlreadyExists、"指定したパスは既に存在します。" 409 Conflict、PathConflict、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。" 409 競合、SourcePathIsBeingDeleted、"指定されたソースパスは削除対象としてマークされています。" 409 Conflict、ResourceTypeMismatch、"要求で指定されたリソースの種類がリソースの種類と一致しません。" 412 前提条件の失敗、ConditionNotMet、"HTTP 条件付きヘッダーを使用して指定された条件が満たされていません。" 412 前提条件に失敗しました。LeaseIdMismatch、"指定されたリース ID がリソースのリース ID と一致しませんでした。" 412 前提条件に失敗しました。LeaseIdMissing。"現在、リソースにリースがあり、要求でリース ID が指定されていません。 412 前提条件に失敗しました。LeaseNotPresent、"現在、リソースにリースはありません。" 412 前提条件に失敗しました。LeaseLost、"リース ID が指定されましたが、リソースのリースの有効期限が切れています。" 412 Precondition Failed、SourceConditionNotMet、"HTTP 条件付きヘッダーを使用して指定されたソース条件が満たされていません。" 413 要求エンティティが大きすぎる、RequestBodyTooLarge、"要求本文が大きすぎて、許容される上限を超えています。" 416 要求された範囲が満たされていません。InvalidRange、"指定された範囲は、リソースの現在のサイズに対して無効です。" 500 内部サーバーエラー、InternalError、"サーバーで内部エラーが発生しました。要求を再試行してください。 500 内部サーバーエラー、OperationTimedOut、"許可された時間内に操作を完了できませんでした。" 503 サービス利用不可、ServerBusy、"エグレスがアカウント制限を超えています。" 503 サービス利用不可、ServerBusy、"イングレスがアカウントの制限を超えています。" 503 サービス利用不可、ServerBusy、"1 秒あたりの操作数がアカウントの制限を超えています。" 503 サービス利用不可、ServerBusy、"サーバーは現在要求を受信できません。要求を再試行してください。ヘッダー x-ms-request-id: string x-ms-version: string

名前

型

説明

200 OK

FilesystemList

わかりました

ヘッダー

Date: string
x-ms-request-id: string
x-ms-version: string
x-ms-continuation: string
Content-Type: string
x-ms-default-encryption-scope: string
x-ms-deny-encryption-scope-override: boolean

Other Status Codes

DataLakeStorageError

エラーが発生しました。可能な HTTP 状態、コード、およびメッセージ文字列を次に示します。

400 Bad Request、ContentLengthMustBeZero、"The Content-Length request header must be zero"
400 Bad Request、InvalidAuthenticationInfo、"認証情報が正しい形式で指定されていません。 Authorization ヘッダーの値を確認してください。
400 Bad Request、InvalidFlushPosition、"アップロードされたデータが連続していないか、位置クエリパラメーターの値が、アップロードされたデータを追加した後のファイルの長さと等しくありません。"
400 Bad Request、InvalidHeaderValue、"いずれかの HTTP ヘッダーの値が正しい形式ではありません。"
400 Bad Request、InvalidHttpVerb、"指定された HTTP 動詞は無効です。サーバーによって認識されません。"
400 無効な要求、InvalidInput、"要求入力の 1 つが無効です。"
400 Bad Request、InvalidPropertyName、"A property name cannot be empty."
400 Bad Request、InvalidPropertyName、"プロパティ名に無効な文字が含まれています。"
400 Bad Request、InvalidQueryParameterValue、"要求 URI で指定されたクエリパラメーターの値が無効です。"
400 Bad Request、InvalidResourceName、"指定されたリソース名に無効な文字が含まれています。"
400 無効な要求、InvalidSourceUri、"ソース URI が無効です。"
400 無効な要求、InvalidUri、"要求 URI が無効です。"
400 Bad Request、MissingRequiredHeader、"この要求に必須の HTTP ヘッダーが指定されていません。"
400 Bad Request、MissingRequiredQueryParameter、"この要求に必須のクエリパラメーターが指定されていません。"
400 Bad Request、MultipleConditionHeadersNotSupported、"複数の条件ヘッダーはサポートされていません。"
400 Bad Request、OutOfRangeInput、"要求入力の 1 つが範囲外です。"
400 Bad Request、OutOfRangeQueryParameterValue、"要求 URI で指定されたクエリパラメーターの 1 つが許容範囲外です。"
400 Bad Request、UnsupportedHeader、"要求で指定されたヘッダーの 1 つがサポートされていません。"
400 無効な要求、UnsupportedQueryParameter、"要求 URI で指定されたクエリパラメーターの 1 つがサポートされていません。"
400 無効な要求、UnsupportedRestVersion、"指定された Rest バージョンはサポートされていません。"
403 Forbidden、AccountIsDisabled、"指定されたアカウントが無効になっています。"
403 Forbidden、AuthorizationFailure、"この要求は、この操作を実行する権限がありません。"
403 Forbidden、InsufficientAccountPermissions、"アクセスされているアカウントには、この操作を実行するための十分なアクセス許可がありません。"
404 Not Found,FilesystemNotFound, "The specified filesystem does not exist." (指定されたファイルシステムが存在しません。)
404 Not Found、PathNotFound、"指定したパスが存在しません。"
404 Not Found,RenameDestinationParentPathNotFound, "The parent directory of the destination path does not exist."
404 Not Found、ResourceNotFound、"指定されたリソースが存在しません。"
404 Not Found、SourcePathNotFound、"名前変更操作のソースパスが存在しません。"
405 メソッド Not Allowed、UnsupportedHttpVerb、"リソースは指定された HTTP 動詞をサポートしていません。"
409 Conflict、DestinationPathIsBeingDeleted、"指定された宛先パスは削除対象としてマークされています。"
409 Conflict、DirectoryNotEmpty、"空でないディレクトリを削除するには、再帰クエリパラメーター値が true である必要があります。"
409 Conflict、FilesystemAlreadyExists、"指定されたファイルシステムは既に存在します。"
409 競合、FilesystemBeingDeleted、"指定されたファイルシステムが削除されています。"
409 Conflict、InvalidDestinationPath、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。"* 409 Conflict、InvalidFlushOperation、"リソースは Blob Service API によって作成または変更され、Data Lake Storage Service API によって書き込むことができません。"
409 Conflict、InvalidRenameSourcePath、"ソースディレクトリをコピー先ディレクトリと同じにすることも、コピー先をソースディレクトリのサブディレクトリにすることもできません。"
409 Conflict、InvalidSourceOrDestinationResourceType、"ソースとターゲットのリソースの種類は同じである必要があります。"
409 Conflict、LeaseAlreadyPresent、"既にリースが存在しています。"
409 Conflict, LeaseIdMismatchWithLeaseOperation, "指定されたリース ID が、指定したリース操作を持つリソースのリース ID と一致しませんでした。"
409 Conflict、LeaseIsAlreadyBroken、"リースは既に破損しており、再び破損することはできません。"
409 Conflict、LeaseIsBreakingAndCannotBeAcquired、"リース ID は一致しましたが、リースは現在中断状態にあり、破損するまで取得できません。"
409 Conflict、LeaseIsBreakingAndCannotBeChanged、"リース ID は一致しましたが、リースは現在中断状態にあり、変更できません。"
409 Conflict、LeaseIsBrokenAndCannotBeRenewed、"リース ID が一致しましたが、リースが明示的に破損しており、更新できません。"
409 Conflict、LeaseNameMismatch、"指定されたリース名が既存のリース名と一致しませんでした。"
409 Conflict, LeaseNotPresentWithLeaseOperation, "リース ID が指定されたリース操作と共に存在しません。"
409 Conflict、PathAlreadyExists、"指定したパスは既に存在します。"
409 Conflict、PathConflict、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。"
409 競合、SourcePathIsBeingDeleted、"指定されたソースパスは削除対象としてマークされています。"
409 Conflict、ResourceTypeMismatch、"要求で指定されたリソースの種類がリソースの種類と一致しません。"
412 前提条件の失敗、ConditionNotMet、"HTTP 条件付きヘッダーを使用して指定された条件が満たされていません。"
412 前提条件に失敗しました。LeaseIdMismatch、"指定されたリース ID がリソースのリース ID と一致しませんでした。"
412 前提条件に失敗しました。LeaseIdMissing。"現在、リソースにリースがあり、要求でリース ID が指定されていません。
412 前提条件に失敗しました。LeaseNotPresent、"現在、リソースにリースはありません。"
412 前提条件に失敗しました。LeaseLost、"リース ID が指定されましたが、リソースのリースの有効期限が切れています。"
412 Precondition Failed、SourceConditionNotMet、"HTTP 条件付きヘッダーを使用して指定されたソース条件が満たされていません。"
413 要求エンティティが大きすぎる、RequestBodyTooLarge、"要求本文が大きすぎて、許容される上限を超えています。"
416 要求された範囲が満たされていません。InvalidRange、"指定された範囲は、リソースの現在のサイズに対して無効です。"
500 内部サーバーエラー、InternalError、"サーバーで内部エラーが発生しました。要求を再試行してください。
500 内部サーバーエラー、OperationTimedOut、"許可された時間内に操作を完了できませんでした。"
503 サービス利用不可、ServerBusy、"エグレスがアカウント制限を超えています。"
503 サービス利用不可、ServerBusy、"イングレスがアカウントの制限を超えています。"
503 サービス利用不可、ServerBusy、"1 秒あたりの操作数がアカウントの制限を超えています。"
503 サービス利用不可、ServerBusy、"サーバーは現在要求を受信できません。要求を再試行してください。

ヘッダー

x-ms-request-id: string
x-ms-version: string

定義

名前	説明
AccountResourceType	この値は、すべてのアカウント操作で "account" である必要があります。
DataLakeStorageError
Error	サービスエラー応答オブジェクト。
Filesystem
FilesystemList

AccountResourceType

列挙

この値は、すべてのアカウント操作で "account" である必要があります。

値	説明
account

DataLakeStorageError

Object

名前	型	説明
error	Error	サービスエラー応答オブジェクト。

Error

Object

サービスエラー応答オブジェクト。

名前	型	説明
code	string	サービスエラーコード。
message	string	サービスエラーメッセージ。

Filesystem

Object

名前	型	説明
eTag	string
lastModified	string
name	string

FilesystemList

Object

名前	型	説明
filesystems	Filesystem[]

次の方法で共有

Filesystem - List

URI パラメーター

要求ヘッダー

応答

定義

AccountResourceType

DataLakeStorageError

Error

Filesystem

FilesystemList

その他のリソース