CreateFile API によるファイル・フォルダ作成 - PDS - Alibaba Cloud -

ファイルまたはフォルダを作成します。

操作説明

ファイルの作成に関するベストプラクティスについては、「ファイルアップロード」をご参照ください。

ファイルアップロード中、ファイルチャンクにはストレージコストが発生します。チャンクは最大 10 日間保持され、アップロードが完了するか、この期間が経過すると自動的に削除されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/file/create HTTP/1.1

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
body	object	任意	リクエストボディ。
name	string	必須	ファイル名。名前は UTF-8 で最大 1,024 バイトまでで、スラッシュ (/) を含めることはできません。	a.txt
type	string	必須	アイテムタイプ。有効な値：`file` および `folder`。	file
parent_file_id	string	必須	親ディレクトリの ID。ルートディレクトリにアイテムを作成するには、このパラメーターを `root` に設定します。	fileid1
drive_id	string	任意	ドライブの ID。共有 URL を使用してファイルを作成しない場合は、このパラメーターは必須です。	1
share_id	string	任意	共有 ID。共有 URL を使用してファイルを作成する場合は、このパラメーターは必須です。	7JQX1FswpQ8
size	integer	任意	ファイルサイズ (バイト単位)。	1024
content_type	string	任意	ファイルコンテンツの MIME タイプ。デフォルト値：`application/octet-stream`。	application/json
part_info_list	array<object>	任意	マルチパートアップロード用のファイルパートのリスト。最大 10,000 パートまで指定できます。省略した場合、システムはシングルパートアップロードを実行します。
	array<object>	任意	ファイルパート。
part_number	integer	任意	ファイルパートのシーケンス番号。パート番号は 1 から始まります。	1
parallel_sha1_ctx	object	任意	先行するすべてのパートのコンテンツの SHA-1 ハッシュコンテキスト。このパラメーターは、並列アップロード機能が有効な場合にのみ必須です。
h	array	任意	先行するファイルパートからの SHA-1 ハッシュ状態の 5 つの 32 ビット変数。このパラメーターは、並列アップロード機能が有効な場合にのみ必須です。
	integer	任意	SHA-1 ハッシュ状態の 5 つの 32 ビット変数のうちの 1 つ。	1
part_offset	integer	任意	先行するすべてのファイルパートの合計サイズ (バイト単位)。値は 64 の倍数である必要があります。このパラメーターは、並列アップロード機能が有効な場合にのみ必須です。	10240
content_md5	string	任意	ファイルパートの MD5 ハッシュ値。アップロードされたパートの整合性を検証するために使用されます。	ASKJDJSKDJJSJDJS
content_type	string	任意	ファイルパートの MIME タイプ。	application/json
user_tags	array	任意	ファイルのカスタムタグのリスト。最大 1,000 個のタグを指定できます。
	UserTag	任意	カスタムタグ。
hidden	boolean	任意	ファイルまたはフォルダを非表示にするかどうかを指定します。デフォルト値：`false`。	false
description	string	任意	ファイルの説明。最大 1,024 文字。デフォルトでは空です。	团队文件
content_hash	string	任意	`content_hash_name` で指定されたアルゴリズムを使用して計算された、ファイルコンテンツ全体のハッシュ値。	7C4A8D09CA3762AF61E59520943DC26494F8941B
content_hash_name	string	任意	`content_hash` の計算に使用されるアルゴリズム。サポートされている値は `sha1` のみです。	sha1
pre_hash	string	任意	ファイルの最初の 1 KB の SHA-1 ハッシュ値。これは、即時ファイルアップロード (プリハッシュ) 機能に必要です。この機能により、サービスは一致するファイルを迅速に見つけることができるため、クライアントは事前にファイル全体のハッシュを計算する必要がありません。	7C4A8D09CA3762AF61E59520943DC26494F89411
check_name_mode	string	任意	ファイル名の競合を処理するためのポリシー。有効な値： `ignore`：既存のファイルと同じ名前で新しいファイルを作成することを許可します。 `auto_rename`：名前の競合が発生した場合、新しいファイルの名前を自動的に変更します。デフォルトでは、現在のタイムスタンプが名前に付加されます。例：`xxx_20060102_150405`。 `refuse`：同じ名前のファイルが存在する場合、リクエストを拒否し、競合するファイルに関する情報を返します。デフォルト値：`ignore`。列挙値: refuse : refuse auto_rename : auto_rename ignore : ignore	ignore
file_id	string	任意	クライアントが指定するファイルの ID。`check_name_mode` が `ignore` に設定されている場合に必須です。	9520943DC264
local_created_at	string	任意	ローカルファイルの作成時刻。協定世界時 (UTC) および ISO 8601 フォーマット (`yyyy-MM-ddTHH:mm:ssZ`) で指定します。省略した場合、この値は記録されません。	2023-10-04T14:30:00Z
local_modified_at	string	任意	ローカルファイルの変更時刻。協定世界時 (UTC) および ISO 8601 フォーマット (`yyyy-MM-ddTHH:mm:ssZ`) で指定します。省略した場合、この値は記録されません。	2023-10-04T14:30:00Z
image_media_metadata	ImageMediaMetadata	任意	クライアントが提供するイメージのメタデータ。
video_media_metadata	VideoMediaMetadata	任意	クライアントが提供するビデオのメタデータ。
parallel_upload	boolean	任意	並列アップロード機能を有効にするには `true` に設定します。	true
custom_updated_at	string	任意
custom_created_at	string	任意

レスポンスフィールド

フィールド	型	説明	例
	object	応答ペイロード。
parent_file_id	string	親ディレクトリの ID。	fileid5
part_info_list	array	パート情報リスト。
	UploadPartInfo	パート情報。
upload_id	string	アップロード ID。	uploadid1
rapid_upload	boolean	高速アップロードが使用されたかどうか。	true
type	string	ファイルタイプ。	file
file_id	string	ファイル ID。	fileid1
domain_id	string	ドメイン ID。	bj1
drive_id	string	ドライブ ID。	1
file_name	string	ファイル名。	a.txt
status	string	ファイルステータス。	uploading
exist	boolean	ファイルが存在するかどうか。	false

例

成功レスポンス

JSONJSON

{
  "parent_file_id": "fileid5",
  "part_info_list": [
    {
      "part_number": 1,
      "part_size": 1024,
      "upload_url": "https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661",
      "internal_upload_url": "https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\n",
      "etag": "\"0CC175B9C0F1B6A831C399E269772661\"",
      "parallel_sha1_ctx": {
        "h": [
          0
        ],
        "part_offset": 10240
      },
      "parallel_sha256_ctx": {
        "h": [
          0
        ],
        "part_offset": 0
      }
    }
  ],
  "upload_id": "uploadid1",
  "rapid_upload": true,
  "type": "file",
  "file_id": "fileid1",
  "domain_id": "bj1",
  "drive_id": "1",
  "file_name": "a.txt",
  "status": "uploading",
  "exist": false
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。