すべてのプロダクト
Search
ドキュメントセンター

:CreateFile

最終更新日:Jul 24, 2026

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

操作説明

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

ファイルのアップロードプロシージャ中、アップロードされたファイルパートにはストレージ料金が発生します。パートは、ファイルのアップロードが完了するか、10 日後に有効期限切れとなってクリーンアップされるまで、10 日間保持されます。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

POST /v2/file/create HTTP/1.1

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

domain_id

string

必須

body

object

任意

リクエストボディのパラメーター。

name

string

必須

ファイル名。名前は UTF-8 エンコーディングで最大 1024 バイトまで指定でき、スラッシュ (/) を含めることはできません。

a.txt。

type

string

必須

ファイルタイプ。有効な値:

  • file: ファイル。

  • folder: フォルダ。

file。

parent_file_id

string

必須

親フォルダの ID。ルートディレクトリにアップロードするには、このパラメーターを root に設定します。

fileid1

drive_id

string

任意

ドライブの ID。共有リンク経由でアップロードを実行する場合を除き、このパラメーターは必須です。フォームによるアップロードの場合も必須です。

1

share_id

string

任意

共有の ID。共有リンク経由でアップロードする場合、このパラメーターは必須です。

7JQX1FswpQ8

size

integer

任意

ファイルサイズ (バイト単位)。

1024

content_type

string

任意

ファイルのコンテンツタイプ。デフォルト値: application/octet-stream。

application/json

part_info_list

array<object>

任意

パート情報のリスト。最大値は 10000 パートです。このパラメーターが指定されていない場合、デフォルトで 1 つのパートが返されます。フォームに従って指定してください。

array<object>

任意

パート情報。フォームに従って指定してください。

part_number

integer

任意

パートのシーケンス番号 (1 から始まります)。

1

parallel_sha1_ctx

object

任意

このパート以前の全データの SHA1 コンテキスト。このフィールドは同時マルチパートアップロードモードでのみ有効です。

h

array

任意

このパートより前のすべてのデータのコンテキスト SHA1 の 1 番目から 5 番目の 32 ビット変数。このフィールドは同時マルチパートアップロードパターンでのみ有効です。

integer

任意

このパートより前のすべてのデータのコンテキスト SHA1 の 1 番目から 5 番目の 32 ビット変数。

1

part_offset

integer

任意

直前のデータブロックまでの合計長 (バイト単位)。値は 64 の倍数である必要があります。このフィールドは同時マルチパートアップロードモードでのみ有効です。

10240

content_md5

string

任意

パートの MD5 値。アップロード中にパートの MD5 を検証する必要がある場合に、このパラメーターを指定します。

ASKJDJSKDJJSJDJS。

content_type

string

任意

クライアントが PUT を使用してパートをアップロードする際に設定する必要がある Content-Type 値。アップロード時にクライアントが指定した Content-Type がこの値と一致しない場合、署名エラーが発生します。デフォルト値: 空。クライアントは PUT 時に Content-Type を指定する必要はありません。

application/json

user_tags

array

任意

カスタムユーザータグ。最大値は 1000 タグです。

UserTag

任意

カスタムユーザータグ。

hidden

boolean

任意

ファイルを非表示にするかどうかを指定します。デフォルト値: 非表示ではありません。

false。

description

string

任意

ファイルの説明。説明は最大 1024 文字まで指定できます。デフォルト値: 空。

Team file.

content_hash

string

任意

ファイルコンテンツのハッシュ値。値は content_hash_name で指定されたアルゴリズムに基づいて計算されます。

7C4A8D09CA3762AF61E59520943DC26494F8941B

content_hash_name

string

任意

ファイルコンテンツのハッシュアルゴリズム名。現在、sha1 のみがサポートされています。

sha1

pre_hash

string

任意

ファイルの最初の 1 KB の SHA1 値。事前秒速アップロード特徴を使用する場合に、このパラメーターを指定します。サーバー上で一致が見つからない場合、クライアントは秒速アップロードのためにファイル全体の SHA1 を計算する必要はありません。

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。上書き操作の場合、このパラメーターは必須です。

9520943DC264

local_created_at

string

任意

ファイルのローカル作成時間。デフォルト値: 空。フォーマット: yyyy-MM-ddTHH:mm:ssZ (UTC+0 タイムゾーン)。

2023-10-04T14:30:00Z

local_modified_at

string

任意

ファイルのローカル変更時間。デフォルト値: 空。フォーマット: yyyy-MM-ddTHH:mm:ssZ (UTC+0 タイムゾーン)。

2023-10-04T14:30:00Z

parallel_upload

boolean

任意

並列パートアップロード特徴を有効にするかどうかを指定します。

true。

upload_type

string

任意

アップロードタイプ。有効な値: multipart および form。デフォルト値: multipart。

multipart。

レスポンスフィールド

フィールド

型

説明

例

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
      },
      "upload_form_info": {
        "endpoint": "",
        "form_data": {
          "key": ""
        }
      },
      "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
}

エラーコード

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

変更履歴

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