PutObject
    • PDF

    PutObject

    • PDF

    記事の要約

    Classic/VPC環境で利用できます。

    オブジェクトをアップロードしてメタデータを作成します。
    既に保存されているオブジェクトを再度アップロードすると上書きされ、既存のメタデータを再度作成すると新たに入力した値に更新されます。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    PUT/v1/AUTH_{project_id}/{container}/{object}

    リクエストヘッダ

    ヘッダの説明は次の通りです。

    フィールドタイプ必須の有無説明
    X-Auth-TokenStringOptional発行したトークンの値
    X-Object-Meta-{name}StringOptional設定するメタデータ
    • {name}部分にメタデータのキーを入力
    • ヘッダの値にメタデータの値を入力
    X-Object-ManifestStringConditional大容量オブジェクトをアップロードする場合、オブジェクト(SLO)のマニフェスト
    • 入力形式: {container}/{prefix}
    X-Delete-AtIntegerOptionalオブジェクトの自動削除予定時刻(Unix Timestamp)
    • データを一時的に保存する場合に使用
    • 入力された日時にオブジェクトを削除
    X-Delete-AfterIntegerOptionalオブジェクトの自動削除予定時点(秒単位で入力)
    • データを一時的に保存する時に使用
    • アップロード時点から入力された時間の経過後にオブジェクトを削除
    X-Detect-Content-TypeBooleanOptionalファイル拡張子に基づいてオブジェクトの MIMEタイプを自動設定
    • true | false
      • true: MIMEタイプを検出し、自動決定
      • false: 自動検出なしでContent-Typeに入力された MIMEタイプに設定
    X-Copy-FromStringOptionalオブジェクトをコピー
    • 入力形式: {container}/{object}
    • Rangeヘッダと組み合わせ可能
    X-Copy-From-AccountStringOptional他アカウントでオブジェクトをコピー
    Content-DispositionStringOptionalブラウザのレスポンス処理方式
    Content-EncodingStringOptionalオブジェクトのエンコード方式
    Content-TypeStringOptionalオブジェクトの MIMEタイプ
    Content-LengthIntegerOptionalオブジェクトの容量
    • chunked transfer encodingを使用する場合、設定は不要
    Transfer-EncodingStringOptionalchunked transfer encoding使用設定
    • chunked
    • 設定時、Content-Lengthヘッダの除外が必要
    ETagStringOptionalETagヘッダの値
    If-None-MatchStringOptionalETag条件ヘッダ

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    project_idStringRequiredプロジェクト ID
    containerStringRequired対象のオブジェクトが保存されるコンテナの名前
    objectStringRequired保存するオブジェクトの名前

    リクエストクエリパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    temp_url_sigStringOptioanl保存するリソースにアクセス可能な仮 URLの署名
    • 承認されたリクエストであることを検証
    temp_url_expiresIntegerOptioanl保存するリソースにアクセス可能な仮 URLの有効期限(Unix Timestamp)
    multipart-manifestStringConditional大容量オブジェクトのマルチパートアップロードを宣言
    • 値としてputを入力するとマルチパートアップロードとして認識され、パートを1つのファイルに結合するようににサーバに指示
    • リクエストボディにパートを結合するためのマニフェストを必ず作成

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    curl -L -X PUT 'https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}' \
    -H 'X-Auth-Token: {token}' \
    -H 'X-Object-Meta-collection: C1' \
    -H 'X-Detect-Content-Type: true' \
    -T '@{/FILE_PATH/OBJECT}'
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスヘッダ

    ヘッダの説明は次の通りです。

    フィールドタイプ必須の有無説明
    Content-TypeString-レスポンス結果の MIMEタイプ
    Content-LengthString-レスポンス結果の長さ(Byte)
    ETagString-ETagヘッダの値
    Last-ModifiedString-オブジェクトの最終更新時間(UTC)
    X-Trans-IdString-リクエストのトランザクション ID
    X-Openstack-Request-IdString-リクエストのトランザクション ID
    • X-Trans-Idと同じ
    DateString-リクエストのレスポンスタイム(UTC)

    レスポンスステータスコード

    レスポンスステータスコードの説明は次の通りです。

    HTTPステータスコードコードメッセージ説明
    201-Createdリクエスト成功
    408-Request Timeoutリクエストタイムアウト

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 201 Created
    Last-Modified: Mon, 17 Sep 2018 07:36:47 GMT
    Content-Length: 0
    Etag: 95444a08aec383972a52eaaac43e6dce
    Content-Type: text/html; charset=UTF-8
    X-Trans-Id: txe5ad93db05334b1cb44d2-005b9f598e
    X-Openstack-Request-Id: txe5ad93db05334b1cb44d2-005b9f598e
    Date: Mon, 17 Sep 2018 07:36:46 GMT
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.