MENU
      Login
          Login
          目次 x
          PutObject
            目次

            PutObject

              記事の要約

              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}'
              Curl

              レスポンス

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

              レスポンスヘッダ

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

              フィールドタイプ必須の有無説明
              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
              HTTP
              この記事は役に立ちましたか?
              Change password!
              Changing your password will log you out immediately. Use the new password to log back in.
              Change profile
              Success!
              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.
              Logout