tempurl

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

オブジェクトにアクセスできる一時的な URLを作成します。

構文

tempurl構文は次の通りです。

swift tempurl \
    <method> \
    <time> \
    <path> \
    <key> \
    [--absolute] \
    [--prefix-based] \
    [--iso8601] \
    [--ip-range <ip-range>] \
    [--digest <sha1|sha256|sha512>]

オプション

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

必須オプション

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

オプション	タイプ	必須の有無	説明
`<method>`	String	Required	一時 URLで許可する HTTPメソッド `GET` \| `HEAD` \| `PUT` \| `POST` \| `DELETE`
`<time>`	String	Required	一時 URLの有効期間秒単位の整数 (例: `3600`) `s`、`m`、`h`、`d`の接尾辞を付けた数字 (例: `24h`) ISO 8601形式のタイムスタンプ (例: `2026-08-19T19:20:30Z`) `--absolute`入力時、整数は有効期限の Unixタイムスタンプとして解釈
`<path>`	String	Required	オブジェクトのフルパスまたはストレージ URL 例: `/v1/AUTH_{project_id}/{container}/{object}`
`<key>`	String	Required	クラスタに設定された一時 URLのシークレットキー `post`コマンドで設定 (例: `swift post -m "Temp-URL-Key:{key}"`) postを参照

任意オプション

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

オプション	タイプ	必須の有無	説明
`--absolute`	Boolean	Optional	`<time>`を Unixタイムスタンプとして解釈 `<time>`が ISO 8601形式の場合は無視
`--prefix-based`	Boolean	Optional	接頭辞ベースの一時 URLを作成
`--iso8601`	Boolean	Optional	一時 URLに Unixタイムスタンプではなく、ISO 8601形式の UTCタイムスタンプを含める
`--ip-range`	String	Optional	一時 URLの使用を許可する IPアドレスまたは IPアドレス範囲
`--digest`	String	Optional	使用するダイジェストアルゴリズム `sha1` \| `sha256` \| `sha512`

共通オプション

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

例

一時 URLを作成すると、署名と有効期限が含まれたパスが出力されます。出力されたパスの先頭に、authコマンドで確認したストレージ URLを追加して使用します。

コマンド

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

swift tempurl GET 3600 \
    /v1/AUTH_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d/test-container-01/sample.txt \
    {key}

出力

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

/v1/AUTH_a1b2c3d4e5f64a7b8c9d0e1f2a3b4c5d/test-container-01/sample.txt?temp_url_sig=<signature-redacted>&temp_url_expires=1787108031