機械翻訳について
  1. Oracle Cloud Infrastructure Compute ClassicのREST API
  2. タスク
  3. MachineImage

マシン・イメージの作成

post

/machineimage/

Compute Classicにマシン・イメージを追加します。

マシン・イメージの追加後は、そのマシン・イメージを使用してブート可能ストレージ・ボリュームを作成できます。 「ストレージ・ボリュームの作成」を参照してください。

マシン・イメージをイメージ・リストに追加することもできます。 マシン・イメージの追加を参照してください。

注意: このタスクを実行する前に、マシン・イメージ・ファイルをOracle Cloud Infrastructure Object Storage Classicにアップロードする必要があります。 アップロードした.tar.gzファイルの名前をメモします。 Compute Classicにマシン・イメージを追加する際に、この名前を指定する必要があります。

詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「Oracle Cloud Infrastructure Object Storage Classicへのマシン・イメージ・ファイルのアップロード」を参照してください。

前提条件: Oracle Cloud Infrastructure Object Storage Classicインスタンスのレプリケーション・ポリシーを選択したことを確認してください。 「Oracle Cloud Infrastructure Object Storage Classicの使用」の「サービス・インスタンスの複製ポリシーの選択」を参照してください。

必要なロール: このタスクを実行するには、Compute_Operationsのロールが必要です。 このロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 Oracle Cloudの管理および監視のユーザー・ロールの変更に関する項を参照してください。

リクエスト

サポートされるメディア・タイプ
ヘッダー・パラメータ
本文 ()
リクエスト本文には、作成するマシン・イメージの詳細が含まれます。
ルート・スキーマ : MachineImage-post-request
型: object
リクエスト本文には、作成するマシン・イメージの詳細が含まれます。
ソースの表示
ネストされたスキーマ : attributes
型: object
使用可能なその他のプロパティ
ソースの表示

インスタンスに対して使用可能にする任意の属性のオプションのJSONオブジェクトまたはディクショナリ。 これらは、ユーザー定義のタグです。 定義した属性は、http://192.0.0.192/のインスタンス内から表示できます。 「Oracle Cloud Infrastructure Compute Classicの使用」の「ユーザー定義のインスタンス属性の取得」を参照してください。

ネストされたスキーマ : additionalProperties
型: object
トップに戻る

レスポンス

サポートされるメディア・タイプ

201レスポンス

作成されました。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
ヘッダー
本文 ()
ルート・スキーマ : MachineImage-response
型: object
ソースの表示
ネストされたスキーマ : attributes
型: object
使用可能なその他のプロパティ
ソースの表示

インスタンスに対して使用可能にする任意の属性のオプションのJSONオブジェクトまたはディクショナリ。 これらは、ユーザー定義のタグです。 定義した属性は、http://192.0.0.192/のインスタンス内から表示できます。 「Oracle Cloud Infrastructure Compute Classicの使用」の「ユーザー定義のインスタンス属性の取得」を参照してください。

ネストされたスキーマ : checksums
型: object
使用可能なその他のプロパティ
ソースの表示
使用されません
ネストされたスキーマ : hypervisor
型: object
使用可能なその他のプロパティ
ソースの表示
ハイパーバイザ固有属性のディクショナリ。
ネストされたスキーマ : sizes
型: object
イメージ・ファイルのサイズの値。
ネストされたスキーマ : additionalProperties
型: object
ネストされたスキーマ : additionalProperties
型: object
ネストされたスキーマ : additionalProperties
型: object
トップに戻る

例

cURLコマンド

次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、マシン・イメージを作成する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

コマンドを1行で入力します。 この例では、読みやすくするために改行が使用されています。 

curl -i -X POST
     -H "Cookie: $COMPUTE_COOKIE"
     -H "Content-Type: application/oracle-compute-v3+json"
     -H "Accept: application/oracle-compute-v3+json"
     -d "@requestbody.json"
        https://api-z999.compute.us0.oraclecloud.com/machineimage/

  • COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。 認証クッキーの取得および変数への格納の詳細は、認証を参照してください。

  • api-z999.compute.us0.oraclecloud.comはRESTエンドポイントURLの例です。 この値をCompute ClassicサイトのRESTエンドポイントURLに変更します。 サイトのRESTエンドポイントURLを見つける方法については、「リクエストの送信」を参照してください。

リクエスト本文の例

次は、requestbody.jsonファイルのリクエスト本文のコンテンツの例です。 

{
   "account": "/Compute-acme/cloud_storage", 
   "name": "/Compute-acme/jack.jones@example.com/oraclelinux-x64", 
   "no_upload": true, 
   "file": "oraclelinux-x64.img.tar.gz",
		"sizes": {"total":0}
}

レスポンス本文の例

次の例は、レスポンス本文をJSON形式で示しています。

いくつかの行は、読みやすくするために省略記号(...)で切り捨てられます。

{
   "account": "/Compute-acme/cloud_storage", 
   "name": "/Compute-acme/jack.jones@example.com/oraclelinux-x64", 
   "sizes": {
    "uploaded": 1853334188, 
    "total": 1853334188, 
    "decompressed": 22020096000
   },
   "uri": "http://api-z999.compute.us0.oraclecloud.com/machineimage/Compute-acme/jack.jones@example.com/oraclelinux-x64", 
   "quota": null,
   "platform": "linux", 
   "no_upload": true, 
   "state": "available", 
   "signed_by": null, 
   "file": "http://api-z999.compute.us0.oraclecloud.com:443/machineimage/Compute-acme/jack.jones@example.com/oraclelinux-x64",
   "signature": "", 
   "checksums": {}, 
   "attributes": {}, 
   "error_reason": "",
   "image_format": "raw", 
   "audited": null
}
トップに戻る