すべてのプロダクト
Search

このプロダクト

    Object Storage Service:initiate-multipart-upload

    ドキュメントセンター

    Object Storage Service:initiate-multipart-upload

    最終更新日:Dec 07, 2025

    initiate-multipart-upload コマンドは、マルチパートアップロードタスクを開始します。

    注意事項

    • initiate-multipart-upload コマンドを実行すると、Object Storage Service (OSS) は、マルチパートアップロードタスクを識別するための一意のアップロード ID を作成して返します。この ID を使用して、マルチパートアップロードの中止やクエリなどの関連操作を実行できます。

    • マルチパートアップロードリクエストを開始しても、同じ名前の既存のオブジェクトには影響しません。

    権限

    デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。 Alibaba Cloud アカウント下の RAM ユーザーまたは RAM ロールは、デフォルトでは何の権限も持っていません。 Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたはバケットポリシーを通じて操作権限を付与する必要があります。

    API

    アクション

    定義

    InitiateMultipartUpload

    oss:PutObject

    マルチパートアップロードタスクを初期化します。

    oss:PutObjectTagging

    マルチパートアップロードタスクを初期化する際に、x-oss-tagging を通じてオブジェクトタグを指定する場合、この権限が必要です。

    kms:GenerateDataKey

    オブジェクトをアップロードする際に、オブジェクトのメタデータに X-Oss-Server-Side-Encryption: KMS が含まれている場合、これら 2 つの権限が必要です。

    kms:Decrypt

    コマンド構文

    ossutil api initiate-multipart-upload --bucket value --key value [flags]

    パラメーター

    タイプ

    説明

    --bucket

    string

    バケットの名前。

    --key

    string

    オブジェクトの完全なパス。

    --encoding-type

    string

    返されるコンテンツのエンコーディングを指定します。

    --content-encoding

    string

    オブジェクトがダウンロードされる際のオブジェクトのコンテンツエンコーディング形式。

    --content-type

    string

    オブジェクトのコンテンツタイプ。

    --content-disposition

    string

    オブジェクトがダウンロードされる際のオブジェクトの名前。

    --cache-control

    string

    オブジェクトがダウンロードされる際の Web ページのキャッシュ動作。

    --metadata

    stringArray

    key=value 形式のオブジェクトのユーザーメタデータ。カスタムメタデータを指定するには、x-oss-meta-* というプレフィックスが付いたパラメーターを設定する必要があります。

    --server-side-data-encryption

    string

    オブジェクトの暗号化アルゴリズム。

    --server-side-encryption

    string

    アップロードするオブジェクトの各パートを暗号化するために使用されるサーバ側暗号化メソッド。

    --server-side-encryption-key-id

    string

    Key Management Service (KMS) によって管理されるカスタマーマスターキー (CMK) の ID。

    --storage-class

    string

    オブジェクトのストレージクラス。

    --tagging

    string

    オブジェクトのタグ。

    --expires

    string

    有効期限 (ミリ秒単位)。

    --forbid-overwrite

    string

    CompleteMultipartUpload 操作を呼び出すときに、同じ名前のオブジェクトを上書きするかどうかを指定します。

    説明

    使用例

    • マルチパートアップロードタスクを開始します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject

    • マルチパートアップロードタスクを開始し、結果を JSON フォーマットで表示します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format json

    • マルチパートアップロードタスクを開始し、結果を YAML フォーマットで表示します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --output-format yaml

    • マルチパートアップロードタスクを開始し、カスタムメタデータを指定します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --metadata user=aliyun --metadata email=ali***@aliyuncs.com

    • マルチパートアップロードタスクを開始し、オブジェクトタグを指定します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --tagging "TagA=A&TagB=B"

    • マルチパートアップロードタスクを開始し、オブジェクトのサーバ側暗号化メソッドを指定します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****

    • マルチパートアップロードタスクを開始し、同じ名前のオブジェクトの上書きを禁止します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --forbid-overwrite true

    • マルチパートアップロードタスクを開始し、オブジェクトがダウンロードされる際の Web ページのキャッシュ動作を指定します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --cache-control no-cach

    • マルチパートアップロードタスクを開始し、オブジェクトがダウンロードされる際のオブジェクトの名前を指定します。

      ossutil api initiate-multipart-upload --bucket examplebucket --key exampleobject --content-disposition "attachment;filename=oss_download.jpg"