ファイルの削除 |ディレクトリの削除
ファイルまたはディレクトリを削除します。 この操作では、条件付き HTTP 要求がサポートされます。 詳細については、「BLOB サービス操作の条件ヘッダーの指定」を参照してください。
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}
With optional parameters:
DELETE https://{accountName}.{dnsSuffix}/{filesystem}/{path}?recursive={recursive}&continuation={continuation}&paginated={paginated}&timeout={timeout}
URI パラメーター
| 名前 |
/ |
必須 |
型 |
説明 |
|
accountName
|
path |
True
|
string
|
Azure Storage のアカウント名。
|
|
dnsSuffix
|
path |
True
|
string
|
Azure Data Lake Storage エンドポイントの DNS サフィックス。
|
|
filesystem
|
path |
True
|
string
|
ファイルシステム識別子。
Regex pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$
|
|
path
|
path |
True
|
string
|
ファイルまたはディレクトリのパス。
|
|
continuation
|
query |
|
string
|
省略可能。 ディレクトリを削除する場合、各呼び出しで削除されるパスの数は制限されます。 削除するパスの数がこの制限を超えた場合は、この応答ヘッダーに継続トークンが返されます。 応答で継続トークンが返される場合、ディレクトリの削除を続行するには、削除操作の後続の呼び出しで継続トークンを指定する必要があります。
|
|
paginated
|
query |
|
boolean
|
アカウントに対して階層型名前空間が有効で、リソースが "recursive" クエリ パラメーターが "true" に設定されたディレクトリである場合にのみ、省略可能で有効です。 再帰的なディレクトリ削除の場合、使用される承認メカニズムが ACL であり、呼び出し元がスーパー 以外のユーザーである場合、各呼び出しで削除できるパスの数は制限されます。既定のタイムアウトは 30 秒であるためです。 "ページ分割された" クエリ パラメーターが "true" に設定されている場合、上記の制限に達した場合、応答ヘッダーに "x-ms-continuation" が含まれる可能性があります。 subsequnt 要求で "x-ms-continuation" を送信するときに、"改ページ対応" および "recursive" クエリ パラメーターを "true" に設定する必要があります。 応答に "x-ms-continuation" が含まれていない場合、再帰的なディレクトリの削除は成功します。 実際のディレクトリの削除は最後の呼び出しでのみ行われます。前の呼び出しでは、再帰的に削除されるディレクトリの下にあるファイルとディレクトリのサーバーでの ACL チェックが含まれます。
|
|
recursive
|
query |
|
boolean
|
必須で、リソースがディレクトリの場合にのみ有効です。 "true" の場合、ディレクトリの下にあるすべてのパスが削除されます。 "false" でディレクトリが空でない場合は、エラーが発生します。
|
|
timeout
|
query |
|
integer
int32
|
オプションの操作タイムアウト値 (秒単位)。 期間は、サービスが要求を受信したときに開始されます。 操作が完了する前にタイムアウト値が経過すると、操作は失敗します。
|
| 名前 |
必須 |
型 |
説明 |
|
x-ms-lease-id
|
|
string
|
アクティブなリースがある場合は、リース ID を指定する必要があります。
Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
|
|
If-Match
|
|
string
|
省略可能。 ETag 値。 このヘッダーを指定すると、リソースの ETag が指定値と一致する場合に限り操作が実行されます。 ETag は引用符で囲む必要があります。
|
|
If-None-Match
|
|
string
|
省略可能。 ETag 値または特殊なワイルドカード ("*") 値。 このヘッダーを指定すると、リソースの ETag が指定値と一致しない場合に限り操作が実行されます。 ETag は引用符で囲む必要があります。
|
|
If-Modified-Since
|
|
string
|
省略可能。 日付と時刻の値。 指定した日時以降にリソースが変更された場合にのみ、このヘッダーを指定して操作を実行します。
|
|
If-Unmodified-Since
|
|
string
|
省略可能。 日付と時刻の値。 指定した日時以降にリソースが変更されていない場合にのみ、このヘッダーを指定して操作を実行します。
|
|
x-ms-client-request-id
|
|
string
|
トラブルシューティングと関連付けのために分析ログに記録された UUID。
Regex pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$
|
|
x-ms-date
|
|
string
|
要求に対して協定世界時 (UTC) を指定します。 これは、共有キーの承認を使用する場合に必要です。
|
|
x-ms-version
|
|
string
|
要求の処理に使用される REST プロトコルのバージョンを指定します。 これは、共有キーの承認を使用する場合に必要です。
|
応答
| 名前 |
型 |
説明 |
|
200 OK
|
|
ファイルが削除された。
Headers
- Date: string
- x-ms-request-id: string
- x-ms-version: string
- x-ms-continuation: string
|
|
202 Accepted
|
|
削除要求は受け入れられます。アカウントに対して階層型名前空間が有効になっている場合にのみ適用されます。
Headers
- Date: string
- x-ms-request-id: string
- x-ms-version: string
- x-ms-continuation: string
|
|
Other Status Codes
|
DataLakeStorageError
|
エラーが発生しました。 使用可能な HTTP 状態、コード、およびメッセージ文字列を次に示します。
- 400 Bad Request、ContentLengthMustBeZero、"Content-Length 要求ヘッダーは 0 である必要があります。
- 400 無効な要求、InvalidAuthenticationInfo、"認証情報が正しい形式で指定されていません。 Authorization ヘッダーの値を確認してください。"
- 400 無効な要求、InvalidFlushPosition、"アップロードされたデータが連続していないか、位置クエリ パラメーターの値が、アップロードされたデータを追加した後のファイルの長さと等しくありません。"
- 400 無効な要求、InvalidHeaderValue、"HTTP ヘッダーの 1 つの値が正しい形式ではありません。"
- 400 無効な要求、InvalidHttpVerb、"指定された HTTP 動詞は無効です。サーバーによって認識されません。"
- 400 無効な要求、InvalidInput、"要求入力の 1 つが無効です。
- 400 無効な要求、InvalidPropertyName、"プロパティ名を空にすることはできません。"
- 400 Bad Request、InvalidPropertyName、"プロパティ名に無効な文字が含まれています。"
- 400 無効な要求、InvalidQueryParameterValue、"要求 URI で指定されたクエリ パラメーターの 1 つの値が無効です。
- 400 無効な要求、InvalidResourceName、"指定されたリソース名に無効な文字が含まれています。
- 400 無効な要求、InvalidSourceUri、"ソース URI が無効です。
- 400 無効な要求、InvalidUri、"要求 URI が無効です。
- 400 Bad Request、MissingRequiredHeader、"この要求に必須の HTTP ヘッダーが指定されていません。"
- 400 Bad Request、MissingRequiredQueryParameter、"この要求に必須のクエリ パラメーターが指定されていません。
- 400 無効な要求、MultipleConditionHeadersNotSupported、"複数の条件ヘッダーはサポートされていません"。
- 400 Bad Request、OutOfRangeInput、"要求入力の 1 つが範囲外です。
- 400 Bad Request、OutOfRangeQueryParameterValue、"要求 URI で指定されたクエリ パラメーターの 1 つが許容範囲外です。
- 400 無効な要求、UnsupportedHeader、"要求で指定されたヘッダーの 1 つがサポートされていません。"
- 400 無効な要求、UnsupportedQueryParameter、"要求 URI で指定されたクエリ パラメーターの 1 つがサポートされていません。"
- 400 無効な要求、UnsupportedRestVersion、"指定された Rest バージョンはサポートされていません。
- 403 Forbidden、AccountIsDisabled、"指定されたアカウントが無効になっています。"
- 403 Forbidden、AuthorizationFailure、"この要求は、この操作を実行する権限がありません。
- 403 Forbidden、InsufficientAccountPermissions、"アクセスされているアカウントには、この操作を実行するための十分なアクセス許可がありません。"
- 404 Not Found, FilesystemNotFound, "指定されたファイルシステムは存在しません。"
- 404 Not Found, PathNotFound, "指定されたパスが存在しません。"
- 404 Not Found、RenameDestinationParentPathNotFound、"宛先パスの親ディレクトリが存在しません。"
- 404 Not Found、ResourceNotFound、"指定されたリソースが存在しません。"
- 404 Not Found、SourcePathNotFound、"名前変更操作のソース パスが存在しません。"
- 405 メソッド Not Allowed、UnsupportedHttpVerb、"リソースは指定された HTTP 動詞をサポートしていません。"
- 409 Conflict、DestinationPathIsBeingDeleted、"指定された宛先パスは削除済みとしてマークされています。"
- 409 Conflict, DirectoryNotEmpty, "再帰的なクエリ パラメーター値は、空でないディレクトリを削除するには true である必要があります。"
- 409 競合、FilesystemAlreadyExists、"指定されたファイルシステムは既に存在します。
- 409 競合、FilesystemBeingDeleted、"指定されたファイルシステムが削除されています。"
- 409 Conflict、InvalidDestinationPath、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。* 409 Conflict, InvalidFlushOperation, "リソースは Blob Service API によって作成または変更され、Data Lake Storage サービス API によって書き込むことができません。"
- 409 Conflict, InvalidRenameSourcePath, "source directory cannot be same as the destination directory, or can be a サブディレクトリ of the source directory."
- 409 Conflict、InvalidSourceOrDestinationResourceType、"ソースとターゲットのリソースの種類は同じである必要があります。"
- 409 競合、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 競合、LeaseNotPresentWithLeaseOperation、"リース ID が指定されたリース操作に存在しません。
- 409 Conflict、PathAlreadyExists、"指定されたパスは既に存在します。
- 409 Conflict、PathConflict、"指定されたパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。
- 409 Conflict、SourcePathIsBeingDeleted、"指定されたソース パスは削除済みとしてマークされています。"
- 409 Conflict、ResourceTypeMismatch、"要求で指定されたリソースの種類がリソースの種類と一致しません。"
- 412 前提条件失敗、ConditionNotMet、"HTTP 条件付きヘッダーを使用して指定された条件が満たされていません。"
- 412 前提条件に失敗しました。LeaseIdMismatch、"指定されたリース ID がリソースのリース ID と一致しませんでした。"
- 412 前提条件に失敗しました。LeaseIdMissing、「現在、リソースにリースがあり、要求でリース ID が指定されていませんでした。」
- 412 前提条件に失敗しました。LeaseNotPresent、「現在、リソースにリースはありません。」
- 412 前提条件に失敗しました。LeaseLost、"リース ID が指定されましたが、リソースのリースの有効期限が切れています。
- 412 前提条件失敗、SourceConditionNotMet、"HTTP 条件付きヘッダーを使用して指定されたソース条件が満たされていません。"
- 413 要求エンティティが大きすぎる、RequestBodyTooLarge、"要求本文が大きすぎて、許容される上限を超えています。"
- 416 要求された範囲が満たされない、InvalidRange、"指定された範囲は、リソースの現在のサイズに対して無効です。
- 500 内部サーバー エラー、InternalError、"サーバーで内部エラーが発生しました。 要求を再試行してください。"
- 500 内部サーバー エラー、OperationTimedOut、"許可された時間内に操作を完了できませんでした。"
- 503 サービス利用不可、ServerBusy、"エグレスはアカウントの制限を超えています。"
- 503 サービス利用不可、ServerBusy、"イングレスはアカウントの制限を超えています。"
- 503 サービス利用不可、ServerBusy、"1 秒あたりの操作数がアカウントの制限を超えています。"
- 503 サービス利用不可、ServerBusy、"サーバーは現在、要求を受信できません。 要求を再試行してください。"
Headers
- x-ms-request-id: string
- x-ms-version: string
|
定義
DataLakeStorageError
| 名前 |
型 |
説明 |
|
error
|
Error
|
サービス エラー応答オブジェクト。
|
Error
サービス エラー応答オブジェクト。
| 名前 |
型 |
説明 |
|
code
|
string
|
サービス エラー コード。
|
|
message
|
string
|
サービス エラー メッセージ。
|