スナップショットの管理

スナップショットは、runningまたはshutdown状態のインスタンスから特定の時間に取得されたマシン・イメージ起動ディスクのコピーです。このコピーをイメージ・リストに追加し、それを使用して新しいインスタンスを作成することができます。

オーケストレーションを停止した結果としてインスタンスが削除される場合、インスタンスの変更は保持されません。また、インスタンスを削除した場合にも、ブート・ディスクの作成後に加えられたすべてのカスタマイズおよび変更は削除されます。カスタマイズした仮想マシン(VM)を維持するには、マシン・イメージを保持するためのスナップショットを作成します。その後、そのスナップショットを使用して、同じカスタマイズで新しいVMを作成します。

注意:

カスタマイズを保持する別の方法は、インスタンスを終了してCPUおよびメモリー・リソースを空にすることです。 VMが再起動すると、カスタマイズの効力が保持されます。終了の詳細は、「インスタンスの終了」を参照してください。

トピック:

スナップショットの追加

このAPIを使用すると、スナップショットを追加できます。

メソッド

POST

RESTリソース

/snapshot/

URI

https://api_endpoint/snapshot/

リクエスト本文のパラメータ

パラメータ	説明
instance	スナップショットを取得する対象のインスタンス
name	(オプション)サーバーにより生成された識別子を置き換えるスナップショットの一意の識別子。オブジェクト名には、英数字、ハイフン、およびピリオドのみを使用できます。オブジェクト名は大文字と小文字が区別されます。
quota	(オプション)このスナップショットの保存に適用される割当て制限
machineimage	(オプション)マシン・イメージの一意の識別子。このオプションを指定しなければ、サーバーによって一意の識別子が生成されます。

URIの例

https://api.oc.example.com/snapshot/

リクエスト本文の例

{
  "instance": "/mytenant/administrator/a6fbb572-a584-486a-9314-56a24499028d",
  "name": null, 
  "quota": null, 
  "machineimage": "/mytenant/administrator/snapshot1"
}

スナップショット・リクエストの削除

このAPIを使用すると、スナップショット作成リクエストを削除できます。これはリクエストのみを削除し、リクエストの結果であるマシン・イメージは削除されません。

スナップショット・リクエストの削除には、次の制約が適用されます。

active状態のリクエストは削除されません。
リクエストを削除できるのは、errorまたはcomplete状態の場合のみです。

メソッド

DELETE

RESTリソース

/snapshot/name

URI

https://api_endpoint/snapshot/name

URIパラメータ

パラメータ	説明
name	スナップショットの一意の識別子

URIの例

https://api.oc.example.com/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec

スナップショットの詳細の取得

スナップショットの詳細を取得するには、REST APIを使用します。

トピック:

スナップショットの検出

このAPIを使用すると、特定のコンテナ内のスナップショットを検出できます。

注意:

検出APIコールは、指定されたコンテナ内のオブジェクトの名前を表示しますが、オブジェクトの詳細は表示しません。オブジェクトの名前をリストするには、Acceptヘッダーをapplication/oracle-compute-v3+directory+jsonに設定します。その他の目的では、Acceptヘッダーをapplication/oracle-compute-v3+jsonに設定する必要があります。

メソッド

GET

RESTリソース

/snapshot/container/

URI

https://api_endpoint/snapshot/container/

URIパラメータ

パラメータ	説明
container	スナップショットの階層的な名前空間

URIの例

https://api.oc.example.com/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/

レスポンス本文の例

{"result": 
        [
                "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec", 
                "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/df8caca5-8a27-4153-9c5f-7440080b40c8"
        ]
}

スナップショットの取得

このAPIを使用すると、特定のスナップショットの詳細を取得できます。

メソッド

GET

RESTリソース

/snapshot/name

URI

https://api_endpoint/snapshot/name

URIパラメータ

パラメータ	説明
name	スナップショットの一意な識別子

URIの例

https://api.oc.example.com/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec

レスポンス本文の例

{
"instance_id": "a6fbb572-a584-486a-9314-56a24499028d",
"account": "/mytenant/default", 
"platform": "linux", 
"name": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec", 
"client_owned": true, 
"sizes": {}, 
"creation_time": "2015-08-20T06:54:58Z", 
"uri": "https://10.32.80.5/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec", 
"quota": null, 
"delay": "", 
"instance": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d", 
"machineimage": "/mytenant/public/snapshot1", 
"state": "complete", 
"quota_reservation": null, 
"user": "/mytenant/public", 
"file": "hdfs:///bimage/a6fbb572-a584-486a-9314-56a24499028d-4dbb2b4c-d315-47ba-b938-696f74826bec-snapshot.tar.gz", 
"request_id": "4dbb2b4c-d315-47ba-b938-696f74826bec", 
"error_reason": "", 
"image_format": "raw"
}

スナップショットのリスト表示

このAPIを使用すると、特定のコンテナ内のスナップショットの情報をリストできます。

メソッド

GET

RESTリソース

/snapshot/{container |name}

URI

https://api_endpoint/snapshot/container | name?quota=quotaValue&instance=instanceValue&machineimage=machineimageValue

URIパラメータ

注意:

このコマンドの出力は、オプション・パラメータに基づいてフィルタリングされます(指定されている場合)。

パラメータ	説明
container	スナップショットの階層的な名前空間
name	(オプション)サーバーにより生成された識別子を置き換えるスナップショットの一意の識別子
quota=quotaValue	(オプション)このスナップショットが格納される割当て制限
instance=instanceValue	(オプション)スナップショットを取得する対象のインスタンス
machineimage=macineimageValue	(オプション)マシン・イメージの一意の識別子。このオプションを指定しない場合、一意の識別子がサーバーにより生成されます。

URIの例

https://api.oc.example.com/snapshot/mytenant/

レスポンス本文の例

{"result":[
 {
  "instance_id": "a6fbb572-a584-486a-9314-56a24499028d",
  "account": "/mytenant/default", 
  "platform": "linux", 
  "name": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec", 
  "client_owned": true, 
  "sizes": {}, 
  "creation_time": "2015-08-20T06:54:58Z", 
  "uri": "https://api.ic.example.com/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/4dbb2b4c-d315-47ba-b938-696f74826bec", 
  "quota": null, 
  "delay": "", 
  "instance": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d", 
  "machineimage": "/mytenant/public/snapshot1", 
  "state": "complete", 
  "quota_reservation": null, 
  "user": "/mytenant/public", 
  "file": "hdfs:///bimage/a6fbb572-a584-486a-9314-56a24499028d-4dbb2b4c-d315-47ba-b938-696f74826bec-snapshot.tar.gz", 
  "request_id": "4dbb2b4c-d315-47ba-b938-696f74826bec", 
  "error_reason": "", 
  "image_format": "raw"
 },
{
  "instance_id": "a6fbb572-a584-486a-9314-56a24499028d",
  "account": "/mytenant/default", 
  "platform": "linux", 
  "name": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/0b0ef87a-a7c8-46b3-8cdc-3315a203a431", 
  "client_owned": true, 
  "sizes": {}, 
  "creation_time": "2015-08-20T06:54:58Z", 
  "uri": "https://api.oc.example.com/snapshot/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d/0b0ef87a-a7c8-46b3-8cdc-3315a203a431", 
  "quota": null, 
  "delay": "shutdown", 
  "instance": "/mytenant/public/a6fbb572-a584-486a-9314-56a24499028d", 
  "machineimage": "/mytenant/public/snapshot2", 
  "state": "active", 
  "quota_reservation": null, 
  "user": "/mytenant/public", 
  "file": "hdfs:///bimage/a6fbb572-a584-486a-9314-56a24499028d-0b0ef87a-a7c8-46b3-8cdc-3315a203a431-snapshot.tar.gz", 
  "request_id": "0b0ef87a-a7c8-46b3-8cdc-3315a203a431", 
  "error_reason": "", 
  "image_format": "raw"
 }
]}