Classic/VPC環境で利用できます。
ご希望オン時間に自動的にオブジェクトが削除されるように設定するオブジェクトの寿命管理方法を説明します。オブジェクト PUT(アップロード)リクエストまたはアップロード後の POSTリクエストの際に X-Delete-Atまたは X-Delete-Afterヘッダを使って寿命を設定できます。X-Delete-Afterヘッダでリクエストして設定しても X-Delete-Atに変換して保存されます。寿命設定を解除するには、X-Remove-Delete-Atあるいは X-Remove-Delete-Afterヘッダを使います。
| 名前 | 適用場所 | タイプ | 説明 |
|---|---|---|---|
| X-Delete-At | header | integer | 当該オブジェクトの削除時間を入力(Unix Epoch timestamp) |
| X-Delete-After | header | integer | 入力した時間後に当該オブジェクトを削除(seconds) |
寿命は単一オブジェクト別に適用できます。寿命を設定するオブジェクトが DLOや SLOでアップロードされた場合、セグメントオブジェクトとマニフェストオブジェクトの寿命をそれぞれ設定します。
寿命設定で削除されたオブジェクトは復旧できません。
オブジェクト寿命設定(PUT)
オブジェクトアップロード(PUT)リクエストに X-Delete-Atあるいは X-Delete-Afterヘッダを含めて寿命を設定する例は次の通りです。
構文
PUT /v1/AUTH_{project_id}/{container}/{object}
リクエスト例
curl -i -X PUT -H "X-Delete-At: 1540520319" -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
または
curl -i -X PUT -H "X-Delete-After: 3600" -H "X-Auth-Token: $token" -T "/FILE_PATH/OBJECT" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
オブジェクト寿命設定(POST)
オブジェクト POSTリクエストに X-Delete-Atあるいは X-Delete-Afterヘッダを含めて寿命を設定する例は次の通りです。
構文
POST /v1/AUTH_{project_id}/{container}/{object}
リクエスト例
curl -i -X POST -H "X-Delete-At: 1540520319" -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
または
curl -i -X POST -H "X-Delete-After: 3600" -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
オブジェクト寿命照会
オブジェクトに設定された寿命を照会する例は次の通りです。
構文
HEAD /v1/AUTH_{project_id}/{container}/{object}
リクエスト例
curl -i -X HEAD -H "X-Auth-Token: $token" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}
レスポンス例
HTTP/1.1 200 OK
Content-Length: 4
X-Delete-At: 1540520319
Accept-Ranges: bytes
Last-Modified: Fri, 26 Oct 2018 02:25:30 GMT
Etag: 098f6bcd4621d373cade4e832627b4f6
X-Timestamp: 1540520729.75505
Content-Type: text/html
X-Trans-Id: txeaa0f1050fcf4cad9ccce-005bd27b8d
X-Openstack-Request-Id: txeaa0f1050fcf4cad9ccce-005bd27b8d
Date: Fri, 26 Oct 2018 02:27:25 GMT
オブジェクト寿命解除
Archive Storageでは寿命ヘッダ(X-Delete-At)を直接解除する機能(X-Remove-Delete-Atヘッダ設定)をサポートしません。
既に寿命ヘッダが設定されたオブジェクトは指定された削除日までは削除できず、削除が必要な場合は同じキーでオブジェクトを再度アップロード(上書き)して寿命設定を削除して後に削除します。