すべてのプロダクト
Search

このプロダクト

    Object Storage Service:put-object

    ドキュメントセンター

    Object Storage Service:put-object

    最終更新日:Dec 07, 2025

    オブジェクトをバケットにアップロードします。

    注意事項

    • アップロードするオブジェクトは 5 GB を超えることはできません。

    • デフォルトでは、同じ名前のオブジェクトがすでに存在し、そのオブジェクトへのアクセス権限がある場合、新しいオブジェクトは既存のオブジェクトを上書きします。

    権限

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

    API

    アクション

    定義

    PutObject

    oss:PutObject

    オブジェクトをアップロードします。

    oss:PutObjectTagging

    オブジェクトのアップロード時に x-oss-tagging を通じてオブジェクトタグを指定する場合、この権限が必要です。

    kms:GenerateDataKey

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

    kms:Decrypt

    コマンド構文

    ossutil api put-object --bucket value --key value [flags]

    パラメーター

    タイプ

    説明

    --body

    string

    リクエストボディ。

    --bucket

    string

    バケットの名前。

    --cache-control

    string

    オブジェクトのウェブページのキャッシュ動作。

    --content-disposition

    string

    アップロードするオブジェクトの名前を指定します。

    --content-encoding

    string

    オブジェクトコンテンツのエンコード形式。

    --expires

    string

    有効期限。

    --forbid-overwrite

    boolean

    同じ名前の既存のオブジェクトを上書きするかどうかを指定します。

    --key

    string

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

    --metadata

    stringArray

    オブジェクトのメタデータ。 カスタムメタデータを指定するには、x-oss-meta-* というプレフィックスが付いたパラメーターを設定します。

    --object-acl

    string

    オブジェクトのアクセス制御リスト (ACL)。

    --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

    オブジェクトのタグ。 複数のタグを指定できます。 例： TagA=A&TagB=B

    説明

    • put-object コマンドは PutObject API 操作に対応します。 PutObject 操作のパラメーターの詳細については、「PutObject」をご参照ください。

    • サポートされているグローバルコマンドラインオプションの詳細については、「グローバルコマンドラインオプション」をご参照ください。

    例

    • 文字列からオブジェクトをアップロードします。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss"

    • ローカルファイルからオブジェクトをアップロードします。

      ossutil api put-object --bucket examplebucket --key exampleobject --body file://uploadFile

    • 文字列からオブジェクトをアップロードし、カスタムメタデータを追加します。

      ossutil api put-object --bucket examplebucket --key exampleobject  --metadata user=aliyun --metadata email=ali***@aliyuncs.com --body "hi oss"

    • 文字列からオブジェクトをアップロードし、オブジェクトのタグを指定します。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --tagging "TagA=A&TagB=B"

    • 文字列からオブジェクトをアップロードし、オブジェクトの ACL とストレージクラスを指定します。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --object-acl private --storage-class IA

    • 文字列からオブジェクトをアップロードし、オブジェクトのサーバー側の暗号化方式を指定します。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --server-side-encryption KMS --server-side-data-encryption SM4 --server-side-encryption-key-id 9468da86-3509-4f8d-a61e-6eab1eac****

    • 文字列からオブジェクトをアップロードし、同じ名前の既存のオブジェクトが上書きされないようにします。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --forbid-overwrite true

    • 文字列からオブジェクトをアップロードし、オブジェクトがダウンロードされる際のウェブページのキャッシュ動作を指定します。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --cache-control no-cache

    • 文字列からオブジェクトをアップロードし、オブジェクトがダウンロードされるときの名前を指定します。

      ossutil api put-object --bucket examplebucket --key exampleobject --body "hi oss" --content-disposition "attachment;filename=oss_download.jpg"