copy

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

オブジェクトを新しい場所にコピーします。対象の保存先を指定しなければ、オブジェクトのメタデータのみが変更されます。

構文

copy構文は次の通りです。

swift copy \
    <container> \
    <object> \
    [--destination <destination-path>] \
    [--fresh-metadata] \
    [--meta <name:value>] \
    [--header <header:value>]

オプション

copyの実行時に指定できるオプションについて説明します。

必須オプション

copyの必須オプションです。

オプション	タイプ	必須の有無	説明
`<container>`	String	Required	コンテナ名
`<object>`	List	Required	オブジェクト名スペースで区切って複数入力可能

任意オプション

copyの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--destination`	String	Optional	コピー先のコンテナとオブジェクト名 `/container/object`形式で入力オブジェクト名を省略すると、コピー元の名前と同じ名前を使用複数のオブジェクトをコピーする際、オブジェクト名まで指定するとエラー
`--fresh-metadata`	Boolean	Optional	既存のメタデータを除外してコピー未入力の場合、既存のメタデータは保持または追加
`--meta`	String	Optional	メタデータ項目 `name:value`形式で入力
`--header`	String	Optional	リクエストで使用するユーザー定義ヘッダ `header:value`形式で入力

共通オプション

swiftコマンドで共通して使用するオプションについては、Archive Storageのオプションをご参照ください。

例

コマンドを実行すると、コピー元のオブジェクトとコピー先が出力されます。

コマンド

コマンドの例は次の通りです。

swift copy test-container-01 sample.txt \
    --destination /test-container-01/copied.txt

出力

出力の例は次の通りです。

created container test-container-01
test-container-01/sample.txt copied to /test-container-01/copied.txt