次の方法で共有


Filesystem - Create

ファイルシステムの作成
指定した場所にルート化されたファイルシステムを作成します。 ファイルシステムが既に存在する場合、操作は失敗します。 この操作では、条件付き HTTP 要求はサポートされていません。

PUT https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem
PUT https://{accountName}.{dnsSuffix}/{filesystem}?resource=filesystem&timeout={timeout}

URI パラメーター

名前 / 必須 説明
accountName
path True

string

Azure Storage のアカウント名。

dnsSuffix
path True

string

Azure Data Lake Storage エンドポイントの DNS サフィックス。

filesystem
path True

string

ファイルシステム識別子。 値の先頭と末尾は文字または数字で、文字、数字、ダッシュ (-) 文字のみを含める必要があります。 連続するダッシュは使用できません。 すべての文字は小文字にする必要があります。 値は 3 ~ 63 文字である必要があります。

正規表現パターン: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$

resource
query True

FilesystemResourceType

値は、すべてのファイルシステム操作に対して "filesystem" である必要があります。

timeout
query

integer

int32

オプションの操作タイムアウト値 (秒単位)。 期間は、サービスが要求を受信したときに開始されます。 操作が完了する前にタイムアウト値が経過すると、操作は失敗します。

要求ヘッダー

名前 必須 説明
x-ms-properties

string

ファイル システムと共に格納されるユーザー定義プロパティは、名前と値のペアのコンマ区切りのリスト "n1=v1, n2=v2, ..." の形式で格納されます。各値は base64 でエンコードされた文字列です。 文字列には、ISO-8859-1 文字セット内の ASCII 文字のみを含める場合があることに注意してください。

x-ms-default-encryption-scope

string

暗号化スコープは、ファイル システムで既定として設定されます。

x-ms-client-request-id

string

トラブルシューティングと関連付けのために分析ログに記録された UUID。

正規表現パターン: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$

x-ms-date

string

要求に対して協定世界時 (UTC) を指定します。 これは、共有キーの承認を使用する場合に必要です。

x-ms-version

string

要求の処理に使用される REST プロトコルのバージョンを指定します。 これは、共有キーの承認を使用する場合に必要です。

応答

名前 説明
201 Created

作成済み

ヘッダー

  • Date: string
  • ETag: string
  • Last-Modified: string
  • x-ms-request-id: string
  • x-ms-version: string
  • x-ms-namespace-enabled: string
  • x-ms-default-encryption-scope: string
Other Status Codes

DataLakeStorageError

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

  • 400 Bad Request、ContentLengthMustBeZero、"Content-Length 要求ヘッダーは 0 である必要があります。
  • 400 Bad Request、InvalidAuthenticationInfo、"認証情報が正しい形式で指定されていません。 Authorization ヘッダーの値を確認してください。
  • 400 Bad Request、InvalidFlushPosition、"アップロードされたデータが連続していないか、位置クエリ パラメーターの値が、アップロードされたデータを追加した後のファイルの長さと等しくありません。"
  • 400 Bad Request、InvalidHeaderValue、"HTTP ヘッダーの 1 つの値が正しい形式ではありません。"
  • 400 Bad Request、InvalidHttpVerb、"指定された HTTP 動詞は無効です。サーバーによって認識されません。
  • 400 Bad Request、InvalidInput、"要求入力の 1 つが無効です。
  • 400 Bad Request、InvalidPropertyName、"プロパティ名を空にすることはできません"。
  • 400 Bad Request、InvalidPropertyName、"プロパティ名に無効な文字が含まれています。
  • 400 Bad Request、InvalidQueryParameterValue、"要求 URI で指定されたクエリ パラメーターの 1 つの値が無効です。
  • 400 Bad Request、InvalidResourceName、"指定されたリソース名に無効な文字が含まれています。
  • 400 無効な要求、InvalidSourceUri、"ソース URI が無効です。
  • 400 Bad Request、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 Bad Request、UnsupportedQueryParameter、"要求 URI で指定されたクエリ パラメーターの 1 つがサポートされていません。
  • 400 Bad Request、UnsupportedRestVersion、"指定された Rest バージョンはサポートされていません。
  • 403 Forbidden、AccountIsDisabled、"指定されたアカウントが無効になっています。
  • 403 Forbidden、AuthorizationFailure、"この要求は、この操作を実行する権限がありません。
  • 403 Forbidden、InsufficientAccountPermissions、"アクセスされているアカウントには、この操作を実行するための十分なアクセス許可がありません。"
  • 404 見つかりません。FilesystemNotFound、"指定されたファイルシステムが存在しません。
  • 404 見つかりません。PathNotFound、"指定したパスが存在しません。
  • 404 Not Found, RenameDestinationParentPathNotFound, "宛先パスの親ディレクトリが存在しません。"
  • 404 見つかりません。ResourceNotFound、"指定されたリソースが存在しません。
  • 404 Not Found, SourcePathNotFound, "名前変更操作のソース パスが存在しません。"
  • 405 メソッド Not Allowed、UnsupportedHttpVerb、"リソースは指定された HTTP 動詞をサポートしていません。"
  • 409 競合、DestinationPathIsBeingDeleted、"指定した宛先パスは削除対象としてマークされています。
  • 409 Conflict,DirectoryNotEmpty, "空でないディレクトリを削除するには、再帰的なクエリ パラメーター値が true である必要があります。
  • 409 競合、FilesystemAlreadyExists、"指定されたファイルシステムは既に存在します。
  • 409 競合、FilesystemBeingDeleted、"指定されたファイルシステムが削除されています。
  • 409 Conflict、InvalidDestinationPath、"指定したパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。* 409 Conflict, InvalidFlushOperation, "リソースは Blob Service API によって作成または変更され、Data Lake Storage Service API によって書き込むことができません。"
  • 409 Conflict, InvalidRenameSourcePath, "ソース ディレクトリをコピー先ディレクトリと同じにすることも、コピー先をソース ディレクトリのサブディレクトリにすることもできません。"
  • 409 Conflict、InvalidSourceOrDestinationResourceType、"ソースとターゲットのリソースの種類は同じである必要があります。
  • 409 競合、LeaseAlreadyPresent、"既にリースが存在します。
  • 409 Conflict, LeaseIdMismatchWithLeaseOperation, "指定されたリース ID は、指定されたリース操作を持つリソースのリース ID と一致しませんでした。"
  • 409 Conflict, LeaseIsAlreadyBroken, "リースは既に破損しており、再び壊すことはできません。"
  • 409 競合、LeaseIsBreakingAndCannotBeAcquired、"リース ID は一致しましたが、リースは現在中断状態であり、破損するまで取得できません"。
  • 409 競合、LeaseIsBreakingAndCannotBeChanged、"リース ID は一致しましたが、リースは現在中断状態であり、変更できません"。
  • 409 競合、LeaseIsBrokenAndCannotBeRenewed、"リース ID は一致しましたが、リースは明示的に破損しており、更新できません"。
  • 409 Conflict, LeaseNameMismatch, "指定されたリース名が既存のリース名と一致しませんでした。
  • 409 競合、LeaseNotPresentWithLeaseOperation、"リース ID が指定されたリース操作と一緒に存在しません。
  • 409 Conflict,PathAlreadyExists, "指定されたパスは既に存在します。
  • 409 Conflict、PathConflict、"指定したパス、またはパスの要素が存在し、そのリソースの種類がこの操作に対して無効です。
  • 409 競合、SourcePathIsBeingDeleted、"指定したソース パスは削除対象としてマークされています。
  • 409 競合、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

定義

名前 説明
DataLakeStorageError
Error

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

FilesystemResourceType

値は、すべてのファイルシステム操作に対して "filesystem" である必要があります。

DataLakeStorageError

名前 説明
error

Error

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

Error

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

名前 説明
code

string

サービス エラー コード。

message

string

サービス エラー メッセージ。

FilesystemResourceType

値は、すべてのファイルシステム操作に対して "filesystem" である必要があります。

名前 説明
filesystem

string