機械翻訳について

移動

• リクエスト
• レスポンス
• 例

起動プランを使用したインスタンスの作成

post

/launchplan/

起動プランは1つ以上のインスタンスのプロパティを定義するJSON形式のファイルです。 起動プランを使用して、複数の非永続インスタンスをCompute Classicですばやく作成および開始することができます。

起動プランは、作成するインスタンスのプロビジョニング順序と属性を指定します。 起動プランJSONファイルを再利用して、JSONファイルで指定された属性とプロビジョニング順序に基づいて新しいインスタンスを作成することはできますが、起動プラン自体はCompute Classicでは維持されません。

起動プランJSONファイルで指定できる属性については、「Oracle Cloud Infrastructure Compute Classicの使用」の「起動プランを使用したインスタンスの作成」を参照してください。

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

リクエスト

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

• application/oracle-compute-v3+json

ヘッダー・パラメータ

• Cookie: string
  Cookie:ヘッダーは、サービスに対するすべてのリクエストに含まれる必要があります。 それをPOST /authenticate/コールに対して受信されたレスポンス内のset-cookieヘッダーの値に設定してください。

本文 ()

リクエスト本文には、作成する起動プランの詳細が含まれます。

ルート・スキーマ : LaunchPlan-post-request

型: object

リクエスト本文には、作成する起動プランの詳細が含まれます。

ソースの表示

• instances: array instances

  インスタンスのリスト。

  各インスタンスは、インスタンス属性を使用して定義されます。

• relationships(optional): array relationships

  様々なインスタンス間の関係。

  有効な値:

  • same_node: 指定したインスタンスは同じ物理サーバー上に作成されます。 これはインスタンス間の低遅延を確保する場合に便利です。
  • different_node: 指定したインスタンスは同じ物理サーバー上には作成されません。 これはセキュリティまたは冗長性のためにインスタンスを分離する場合に便利です。

{
    "required":[
        "instances"
    ],
    "description":"The request body contains details of the launch plan that you want to create. ",
    "properties":{
        "instances":{
            "items":{
                "$ref":"#/definitions/Instance-post-request"
            },
            "type":"array",
            "description":"<p>A list of instances.<p>Each instance is defined using the instance attributes."
        },
        "relationships":{
            "items":{
                "additionalProperties":{
                    "type":"object"
                },
                "type":"object"
            },
            "type":"array",
            "description":"<p>The relationships between various instances.<p>Valid values:<ul><li>same_node: The specified instances are created on the same physical server. This is useful if you want to ensure low latency across instances.</li><li>different_node: The specified instances aren't created on the same physical server. This is useful if you want to isolate instances for security or redundancy.</li></ul>"
        }
    }
}

ネストされるスキーマ: instances

型: array

インスタンスのリスト。

各インスタンスは、インスタンス属性を使用して定義されます。

ソースの表示

• Array of: object Instance-post-request
  リクエスト本文には、作成するインスタンスの詳細が含まれます。

{
    "items":{
        "$ref":"#/definitions/Instance-post-request"
    },
    "type":"array",
    "description":"<p>A list of instances.<p>Each instance is defined using the instance attributes."
}

ネストされたスキーマ : relationships

型: array

様々なインスタンス間の関係。

有効な値:

• same_node: 指定したインスタンスは同じ物理サーバー上に作成されます。 これはインスタンス間の低遅延を確保する場合に便利です。
• different_node: 指定したインスタンスは同じ物理サーバー上には作成されません。 これはセキュリティまたは冗長性のためにインスタンスを分離する場合に便利です。

ソースの表示

• Array of: object items
  許可される追加プロパティ: additionalProperties

{
    "items":{
        "additionalProperties":{
            "type":"object"
        },
        "type":"object"
    },
    "type":"array",
    "description":"<p>The relationships between various instances.<p>Valid values:<ul><li>same_node: The specified instances are created on the same physical server. This is useful if you want to ensure low latency across instances.</li><li>different_node: The specified instances aren't created on the same physical server. This is useful if you want to isolate instances for security or redundancy.</li></ul>"
}

ネストされたスキーマ : Instance-post-request

型: object

リクエスト本文には、作成するインスタンスの詳細が含まれます。

ソースの表示

• attributes(optional): object attributes
  許可される追加プロパティ: additionalProperties

  インスタンスに対して使用可能にするJSONオブジェクトまたはユーザー定義属性。
• boot_order(optional): array boot_order
  インスタンスを起動するために使用する必要があるブート可能なストレージ・ボリュームのインデックス番号。 唯一の有効な値は1です。 この属性を設定する場合は、storage_attachmentsのvolumeサブパラメータにインデックス番号1のブート可能なストレージ・ボリュームを指定する必要もあります。 boot_orderを指定する場合、インスタンスは指定したブート可能なストレージ・ボリューム上のイメージを使用して起動されるため、imagelist属性を指定する必要はありません。 boot_orderとimagelistの両方を指定する場合、imagelist属性は無視されます。
• desired_state(optional): string
  望ましいインスタンスの状態

  * desired_stateパラメータの値をshutdownに設定して、インスタンスをシャットダウンします。

  * desired_stateパラメータの値をrunningに設定して、以前にシャットダウンしたインスタンスを再起動します。 インスタンスは、インスタンス・データまたは構成のいずれも失うことなく再開されます。

• entry(optional): integer
  オプションのイメージ・リスト・エントリ番号(指定しない場合はデフォルトが使用されます)。
• hostname(optional): string
  インスタンスに割り当てられたホスト名。 Oracle Linuxインスタンスでは、このホスト名はhostnameコマンドへのレスポンスとして表示されます。 相対DNSのみがサポートされます。 ドメイン名が、指定するホスト名に接尾辞として付けられます。 ホスト名の末尾にはピリオドが必要です。 ホスト名を指定しない場合、名前は自動的に生成されます。
• imagelist(optional): string
  使用するイメージが含まれているイメージ・リストの3つの部分からなる名前(/Compute-identity_domain/user/object)。 boot_order属性を使用してブート可能なストレージ・ボリュームを指定しない場合は、これを使用する必要があります。 imagelist属性およびboot_order属性を指定する場合、imagelist属性は無視されます。
• label(optional): string
  ユーザーによって割り当てられたラベル。特に、インスタンス間関係を定義する場合。
• name(optional): string
  インスタンスの3つの部分からなる名前(/Compute-identity_domain/user/object)。 このパラメータを指定しない場合、自動生成されます。
• networking(optional): object networking
  許可される追加プロパティ: additionalProperties

  このインスタンスにアタッチする仮想NICのデバイス名とネットワーク指定子のマッピング。
• reverse_dns(optional): boolean
  true (デフォルト)に設定されている場合、リバースDNSレコードが作成されます。 false (デフォルト)に設定されている場合、いずれのリバースDNSレコードも作成されません。
• shape: string
  インスタンスに必要なCPUの数とRAMを定義するシェイプの名前。
• sshkeys(optional): array sshkeys
  インスタンスに関連付けるSSH公開キーのリスト。
• storage_attachments(optional): array storage_attachments
  storage_attachmentsパラメータを指定する場合は、アタッチメントごとに次のサブパラメータを指定します。

  volume: インスタンスにアタッチするストレージ・ボリュームの3つの部分からなる名前(/Compute-identity_domain/user/object)。 起動時にインスタンスにアタッチされたボリュームはデタッチできない点に注意してください。

  index: ボリュームのインデックス番号。 指定できる範囲は1から10までです。 ストレージ・ボリュームをブート・ディスクとしてインスタンスに使用する場合は、そのボリュームのインデックス番号を1と指定する必要があります。 インデックスにより、ボリュームに公開するインスタンスに応じてデバイス名が決定されます。

• tags(optional): array tags
  JSON配列またはインスタンスのタグ付けに使用される文字列のリスト。 人間にとってわかりやすいタグをインスタンスに割り当てることにより、インスタンスのリストを実行する際に簡単にインスタンスを特定できます。 これらのタグはインスタンス内からは使用できません。

{
    "required":[
        "shape"
    ],
    "description":"The request body contains details of the instance that you want to create. ",
    "properties":{
        "attributes":{
            "additionalProperties":{
                "type":"object"
            },
            "type":"object",
            "description":"A JSON object or dictionary of user-defined attributes to be made available to the instance."
        },
        "boot_order":{
            "items":{
                "type":"integer"
            },
            "type":"array",
            "description":"The index number of the bootable storage volume that should be used to boot the instance. The only valid value is 1. If you set this attribute, you must also specify a bootable storage volume with index number 1 in the volume sub-parameter of storage_attachments. When you specify boot_order, you don't need to specify the imagelist attribute, because the instance is booted using the image on the specified bootable storage volume. If you specify both boot_order and imagelist, the imagelist attribute is ignored."
        },
        "desired_state":{
            "type":"string",
            "description":"Desired state for the instance.<p>* Set the value of the <code>desired_state</code> parameter as <code>shutdown</code> to shut down the instance.<p>* Set the value of the <code>desired_state</code> parameter as <code>running</code> to restart an instance that you had previously shutdown. The instance is restarted without losing any of the instance data or configuration."
        },
        "entry":{
            "type":"integer",
            "description":"Optional imagelistentry number (default will be used if not specified)."
        },
        "hostname":{
            "type":"string",
            "description":"The host name assigned to the instance. On an Oracle Linux instance, this host name is displayed in response to the hostname command. Only relative DNS is supported. The domain name is suffixed to the host name that you specify. The host name must not end with a period. If you don't specify a host name, then a name is generated automatically."
        },
        "imagelist":{
            "type":"string",
            "description":"The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>) of the image list containing the image to be used. You must use this attribute if you don't specify a bootable storage volume by using the boot_order attribute. If you specify the imagelist attribute as well as the boot_order attribute, then the imagelist attribute is ignored."
        },
        "label":{
            "type":"string",
            "description":"A label assigned by the user, specifically for defining inter-instance relationships."
        },
        "name":{
            "type":"string",
            "description":"The three-part name of the instance(<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>). If you don't specify this parameter, it will be autogenerated."
        },
        "networking":{
            "additionalProperties":{
                "type":"object"
            },
            "type":"object",
            "description":"Mapping of device name to network specifiers for virtual NICs to be attached to this instance."
        },
        "reverse_dns":{
            "type":"boolean",
            "description":"If set to true (default), then reverse DNS records are created. If set to false, no reverse DNS records are created."
        },
        "shape":{
            "type":"string",
            "description":"The name of the shape that defines the number of CPUs and the RAM that you require for the instance."
        },
        "sshkeys":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"A list of the SSH public keys that you want to associate with the instance."
        },
        "storage_attachments":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"If you specify the storage_attachments parameter, then specify the following subparameters for each attachment:<p>volume: The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>) of the storage volume that you want to attach to the instance. Note that volumes attached to an instance at launch time can't be detached.<p>index:  The index number for the volume. The allowed range is 1 to 10. If you want to use a storage volume as the boot disk for an instance, you must specify the index number for that volume as 1. The index determines the device name by which the volume is exposed to the instance."
        },
        "tags":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"A JSON array or list of strings used to tag the instance. By assigning a human-friendly tag to an instance, you can identify the instance easily when you perform an instance listing. These tags aren't available from within the instance."
        }
    }
}

ネストされたスキーマ : attributes

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object",
    "description":"A JSON object or dictionary of user-defined attributes to be made available to the instance."
}

インスタンスに対して使用可能にするJSONオブジェクトまたはユーザー定義属性。

ネストされたスキーマ : boot_order

型: array

インスタンスを起動するために使用する必要があるブート可能なストレージ・ボリュームのインデックス番号。 唯一の有効な値は1です。 この属性を設定する場合は、storage_attachmentsのvolumeサブパラメータにインデックス番号1のブート可能なストレージ・ボリュームを指定する必要もあります。 boot_orderを指定する場合、インスタンスは指定したブート可能なストレージ・ボリューム上のイメージを使用して起動されるため、imagelist属性を指定する必要はありません。 boot_orderとimagelistの両方を指定する場合、imagelist属性は無視されます。

ソースの表示

• Array of: integer

{
    "items":{
        "type":"integer"
    },
    "type":"array",
    "description":"The index number of the bootable storage volume that should be used to boot the instance. The only valid value is 1. If you set this attribute, you must also specify a bootable storage volume with index number 1 in the volume sub-parameter of storage_attachments. When you specify boot_order, you don't need to specify the imagelist attribute, because the instance is booted using the image on the specified bootable storage volume. If you specify both boot_order and imagelist, the imagelist attribute is ignored."
}

ネストされたスキーマ : networking

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object",
    "description":"Mapping of device name to network specifiers for virtual NICs to be attached to this instance."
}

このインスタンスにアタッチする仮想NICのデバイス名とネットワーク指定子のマッピング。

ネストされたスキーマ : sshkeys

型: array

インスタンスに関連付けるSSH公開キーのリスト。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"A list of the SSH public keys that you want to associate with the instance."
}

ネストされたスキーマ : storage_attachments

型: array

storage_attachmentsパラメータを指定する場合は、アタッチメントごとに次のサブパラメータを指定します。

volume: インスタンスにアタッチするストレージ・ボリュームの3つの部分からなる名前(/Compute-identity_domain/user/object)。 起動時にインスタンスにアタッチされたボリュームはデタッチできない点に注意してください。

index: ボリュームのインデックス番号。 指定できる範囲は1から10までです。 ストレージ・ボリュームをブート・ディスクとしてインスタンスに使用する場合は、そのボリュームのインデックス番号を1と指定する必要があります。 インデックスにより、ボリュームに公開するインスタンスに応じてデバイス名が決定されます。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"If you specify the storage_attachments parameter, then specify the following subparameters for each attachment:<p>volume: The three-part name (<code>/Compute-<em>identity_domain</em>/<em>user</em>/<em>object</em></code>) of the storage volume that you want to attach to the instance. Note that volumes attached to an instance at launch time can't be detached.<p>index:  The index number for the volume. The allowed range is 1 to 10. If you want to use a storage volume as the boot disk for an instance, you must specify the index number for that volume as 1. The index determines the device name by which the volume is exposed to the instance."
}

ネストされたスキーマ : tags

型: array

JSON配列またはインスタンスのタグ付けに使用される文字列のリスト。 人間にとってわかりやすいタグをインスタンスに割り当てることにより、インスタンスのリストを実行する際に簡単にインスタンスを特定できます。 これらのタグはインスタンス内からは使用できません。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"A JSON array or list of strings used to tag the instance. By assigning a human-friendly tag to an instance, you can identify the instance easily when you perform an instance listing. These tags aren't available from within the instance."
}

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ: items

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object"
}

ネストされたスキーマ : additionalProperties

型: object

トップに戻る

レスポンス

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

• application/oracle-compute-v3+json

201レスポンス

作成されました。 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。

ヘッダー

• set-cookie: string
  セッションが拡張された場合、Cookie値が返されます。

本文 ()

ルート・スキーマ : LaunchPlan-response

型: object

ソースの表示

• instances(optional): array instances

  インスタンスのリスト。

  各インスタンスは、インスタンス属性を使用して定義されます。

• relationships(optional): array relationships

  様々なインスタンス間の関係。

  有効な値:

  • same_node: 指定したインスタンスは同じ物理サーバー上に作成されます。 これはインスタンス間の低遅延を確保する場合に便利です。
  • different_node: 指定したインスタンスは同じ物理サーバー上には作成されません。 これはセキュリティまたは冗長性のためにインスタンスを分離する場合に便利です。

{
    "properties":{
        "instances":{
            "items":{
                "$ref":"#/definitions/Instance-response"
            },
            "type":"array",
            "description":"<p>A list of instances.<p>Each instance is defined using the instance attributes."
        },
        "relationships":{
            "items":{
                "additionalProperties":{
                    "type":"object"
                },
                "type":"object"
            },
            "type":"array",
            "description":"<p>The relationships between various instances.<p>Valid values:<ul><li>same_node: The specified instances are created on the same physical server. This is useful if you want to ensure low latency across instances.</li><li>different_node: The specified instances aren't created on the same physical server. This is useful if you want to isolate instances for security or redundancy.</li></ul>"
        }
    }
}

ネストされるスキーマ: instances

型: array

インスタンスのリスト。

各インスタンスは、インスタンス属性を使用して定義されます。

ソースの表示

• Array of: object Instance-response

{
    "items":{
        "$ref":"#/definitions/Instance-response"
    },
    "type":"array",
    "description":"<p>A list of instances.<p>Each instance is defined using the instance attributes."
}

ネストされたスキーマ : relationships

型: array

様々なインスタンス間の関係。

有効な値:

• same_node: 指定したインスタンスは同じ物理サーバー上に作成されます。 これはインスタンス間の低遅延を確保する場合に便利です。
• different_node: 指定したインスタンスは同じ物理サーバー上には作成されません。 これはセキュリティまたは冗長性のためにインスタンスを分離する場合に便利です。

ソースの表示

• Array of: object items
  許可される追加プロパティ: additionalProperties

{
    "items":{
        "additionalProperties":{
            "type":"object"
        },
        "type":"object"
    },
    "type":"array",
    "description":"<p>The relationships between various instances.<p>Valid values:<ul><li>same_node: The specified instances are created on the same physical server. This is useful if you want to ensure low latency across instances.</li><li>different_node: The specified instances aren't created on the same physical server. This is useful if you want to isolate instances for security or redundancy.</li></ul>"
}

ネストされたスキーマ : Instance-response

型: object

ソースの表示

• account(optional): string
  アイデンティティ・ドメインのデフォルトのアカウントを示します。
• attributes(optional): object attributes
  許可される追加プロパティ: additionalProperties

  インスタンスに対して使用可能にする属性のディクショナリ。 キー"userdata"を持つ値はEC2互換の使用方法で使用可能になります。
• availability_domain(optional): string
  インスタンスが入っている可用性ドメイン
• boot_order(optional): array boot_order
  起動順序リスト。
• desired_state(optional): string
  望ましいインスタンスの状態 この値は、インスタンスをシャットダウンするか、以前にシャットダウンしたインスタンスをそれぞれ再起動するために、shutdownまたはrunningにすることができます。
• disk_attach(optional): string
  ディスクを識別するためにユーザーによって割り当てられたラベル。
• domain(optional): string
  ホスト名およびDNSルックアップに使用するデフォルト・ドメイン。
• entry(optional): integer
  オプションのイメージ・リスト・エントリ番号(指定しない場合はデフォルトが使用されます)。
• error_reason(optional): string
  使用可能な場合、インスタンスがエラー状態になる理由。
• fingerprint(optional): string
  インスタンスによって提示されたSSHサーバーのフィンガープリント。
• hostname(optional): string
  このインスタンスのホスト名。
• hypervisor(optional): object hypervisor
  許可される追加プロパティ: additionalProperties

  ハイパーバイザ固有属性のディクショナリ。
• image_format(optional): string
  イメージの形式。
• imagelist(optional): string
  起動するイメージ・リストの名前。
• ip(optional): string
  インスタンスのIPアドレス。
• label(optional): string
  ユーザーによって割り当てられたラベル。特に、インスタンス間関係を定義する場合。
• name(optional): string
  インスタンスのマルチパート名。
• networking(optional): object networking
  許可される追加プロパティ: additionalProperties

  「このインスタンスにアタッチされる仮想NICのネットワーク指定子」のマッピング。
• placement_requirements(optional): array placement_requirements
  配置場所に一致するノードに任意のタグを指定する文字列のリスト。
• platform(optional): string
  インスタンスのOSプラットフォーム。
• priority(optional): string
  このインスタンスが実行される優先度。
• quota(optional): string
  使用されません
• relationships(optional): array relationships
  このインスタンスの配置場所で満たされる必要のある関係指定のリスト
• resolvers(optional): array resolvers
  デフォルト・リゾルバのかわりに使用するリゾルバ。
• reverse_dns(optional): boolean
  ホスト名のPTRレコードを追加します。
• shape(optional): string
  シェイプは、インスタンスに割り当てられるCPUスレッドの数とメモリー容量(MB)を指定するリソース・プロファイルです。
• sshkeys(optional): array sshkeys
  インスタンスに公開されるSSHキー。
• start_time(optional): string
  インスタンスの開始時間
• state(optional): string
  インスタンスの状態。
• storage_attachments(optional): array storage_attachments
  ストレージ・アタッチメント情報が含まれるディクショナリのリスト。
• tags(optional): array tags
  インスタンスのタグ付けに使用される文字列のカンマ区切りリスト。
• uri(optional): string
  Uniform Resource Identifier
• vcable_id(optional): string
  このインスタンスのvCable。
• vnc(optional): string
  インスタンスのVNCコンソールのIPアドレスおよびポート。

{
    "properties":{
        "account":{
            "type":"string",
            "description":"Shows the default account for your identity domain."
        },
        "attributes":{
            "additionalProperties":{
                "type":"object"
            },
            "type":"object",
            "description":"A dictionary of attributes to be made available to the instance. A value with the key \"userdata\" will be made available in an EC2-compatible manner."
        },
        "availability_domain":{
            "type":"string",
            "description":"The availability domain the instance is in"
        },
        "boot_order":{
            "items":{
                "type":"integer"
            },
            "type":"array",
            "description":"Boot order list."
        },
        "desired_state":{
            "type":"string",
            "description":"Desired state for the instance. The value can be <code>shutdown</code> or <code>running</code> to shutdown an instance or to restart a previously shutdown instance respectively."
        },
        "disk_attach":{
            "type":"string",
            "description":"A label assigned by the user to identify disks."
        },
        "domain":{
            "type":"string",
            "description":"The default domain to use for the hostname and for DNS lookups."
        },
        "entry":{
            "type":"integer",
            "description":"Optional imagelistentry number (default will be used if not specified)."
        },
        "error_reason":{
            "type":"string",
            "description":"The reason for the instance going to error state, if available."
        },
        "fingerprint":{
            "type":"string",
            "description":"SSH server fingerprint presented by the instance."
        },
        "hostname":{
            "type":"string",
            "description":"The hostname for this instance."
        },
        "hypervisor":{
            "additionalProperties":{
                "type":"object"
            },
            "type":"object",
            "description":"A dictionary of hypervisor-specific attributes."
        },
        "image_format":{
            "type":"string",
            "description":"The format of the image."
        },
        "imagelist":{
            "type":"string",
            "description":"Name of imagelist to be launched."
        },
        "ip":{
            "type":"string",
            "description":"IP address of the instance."
        },
        "label":{
            "type":"string",
            "description":"A label assigned by the user, specifically for defining inter-instance relationships."
        },
        "name":{
            "type":"string",
            "description":"Multipart name of the instance."
        },
        "networking":{
            "additionalProperties":{
                "type":"object"
            },
            "type":"object",
            "description":"Mapping of <device name> to network specifiers for virtual NICs to be attached to this instance."
        },
        "placement_requirements":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"A list of strings specifying arbitrary tags on nodes to be matched on placement."
        },
        "platform":{
            "type":"string",
            "description":"The OS platform for the instance."
        },
        "priority":{
            "type":"string",
            "description":"The priority at which this instance will be run."
        },
        "quota":{
            "type":"string",
            "description":"Not used"
        },
        "relationships":{
            "items":{
                "additionalProperties":{
                    "type":"object"
                },
                "type":"object"
            },
            "type":"array",
            "description":"A list of relationship specifications to be satisfied on this instance's placement"
        },
        "resolvers":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"Resolvers to use instead of the default resolvers."
        },
        "reverse_dns":{
            "type":"boolean",
            "description":"Add PTR records for the hostname."
        },
        "shape":{
            "type":"string",
            "description":"A shape is a resource profile that specifies the number of CPU threads and the amount of memory (in MB) to be allocated to an instance."
        },
        "sshkeys":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"SSH keys that will be exposed to the instance."
        },
        "start_time":{
            "type":"string",
            "description":"Start time of the instance."
        },
        "state":{
            "type":"string",
            "description":"State of the instance."
        },
        "storage_attachments":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"List of dictionaries containing storage attachment Information."
        },
        "tags":{
            "items":{
                "type":"string"
            },
            "type":"array",
            "description":"Comma-separated list of strings used to tag the instance."
        },
        "uri":{
            "type":"string",
            "description":"Uniform Resource Identifier"
        },
        "vcable_id":{
            "type":"string",
            "description":"vCable for this instance."
        },
        "vnc":{
            "type":"string",
            "description":"IP address and port of the VNC console for the instance."
        }
    }
}

ネストされたスキーマ : attributes

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object",
    "description":"A dictionary of attributes to be made available to the instance. A value with the key \"userdata\" will be made available in an EC2-compatible manner."
}

インスタンスに対して使用可能にする属性のディクショナリ。 キー"userdata"を持つ値はEC2互換の使用方法で使用可能になります。

ネストされたスキーマ : boot_order

型: array

起動順序リスト。

ソースの表示

• Array of: integer

{
    "items":{
        "type":"integer"
    },
    "type":"array",
    "description":"Boot order list."
}

ネストされたスキーマ : hypervisor

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object",
    "description":"A dictionary of hypervisor-specific attributes."
}

ハイパーバイザ固有属性のディクショナリ。

ネストされたスキーマ : networking

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object",
    "description":"Mapping of <device name> to network specifiers for virtual NICs to be attached to this instance."
}

「このインスタンスにアタッチされる仮想NICのネットワーク指定子」のマッピング。

ネストされたスキーマ : placement_requirements

型: array

配置場所に一致するノードに任意のタグを指定する文字列のリスト。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"A list of strings specifying arbitrary tags on nodes to be matched on placement."
}

ネストされたスキーマ : relationships

型: array

このインスタンスの配置場所で満たされる必要のある関係指定のリスト

ソースの表示

• Array of: object items
  許可される追加プロパティ: additionalProperties

{
    "items":{
        "additionalProperties":{
            "type":"object"
        },
        "type":"object"
    },
    "type":"array",
    "description":"A list of relationship specifications to be satisfied on this instance's placement"
}

ネストされたスキーマ : resolvers

型: array

デフォルト・リゾルバのかわりに使用するリゾルバ。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"Resolvers to use instead of the default resolvers."
}

ネストされたスキーマ : sshkeys

型: array

インスタンスに公開されるSSHキー。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"SSH keys that will be exposed to the instance."
}

ネストされたスキーマ : storage_attachments

型: array

ストレージ・アタッチメント情報が含まれるディクショナリのリスト。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"List of dictionaries containing storage attachment Information."
}

ネストされたスキーマ : tags

型: array

インスタンスのタグ付けに使用される文字列のカンマ区切りリスト。

ソースの表示

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array",
    "description":"Comma-separated list of strings used to tag the instance."
}

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ: items

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object"
}

ネストされたスキーマ : additionalProperties

型: object

ネストされたスキーマ: items

型: object

使用可能なその他のプロパティ

ソースの表示

• object additionalProperties

{
    "additionalProperties":{
        "type":"object"
    },
    "type":"object"
}

ネストされたスキーマ : additionalProperties

型: object

トップに戻る

例

cURLコマンド

次の例では、cURLを使用してlaunchplan 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 "@launchplan.json"
        https://api-z999.compute.us0.oraclecloud.com/launchplan/

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

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

リクエスト本文の例

次の例では、指定したインスタンス属性のインスタンスを2つ作成するための、launchplan.jsonファイルのリクエスト本文の内容を示しています。

{
  "instances": [
    {
      "shape": "oc3",
      "imagelist": "/oracle/public/oel_6.4_2GB_v1",
      "name": "/Compute-acme/[e-mail]/dev-vm",
      "label": "dev-vm",
      "sshkeys": [
        "/Compute-acme/[e-mail]/dev-key1"
      ]
    },
    {
      "shape": "oc4",
      "imagelist": "/oracle/public/oel_6.4_2GB_v1",
      "name": "/Compute-acme/[e-mail]/prod-vm",
      "label": "prod-vm",
      "sshkeys": [
        "/Compute-acme/[e-mail]/prod-key1"
      ]
    }
  ]
}

レスポンス本文の例

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

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

{
  "relationships": [
    
  ],
  "instances": [
    {
      "domain": "compute-acme...",
      "placement_requirements": [
        "/system/compute/placement/default",
        "/system/compute/allow_instances"
      ],
      "ip": "0.0.0.0",
      "fingerprint": "",
      "site": "",
      "last_state_change_time": null,
      "cluster": null,
      "shape": "oc3",
      "vethernets": null,
      "imagelist": "/oracle/public/oel_6.4_2GB_v1",
      "image_format": "raw",
      "id": "437b72fd-b870-47b1-9c01-7a2812bbe30c",
      "cluster_uri": null,
      "networking": {
        "eth0": {
          "model": "",
          "seclists": [
            "/Compute-acme/default/default"
          ],
          "dns": [
            "d9dd5d.compute-acme.oraclecloud.internal."
          ],
          "nat": null,
          "vethernet": "/oracle/public/default"
        }
      },
      "seclist_associations": null,
      "hostname": "d9dd5d.compute-acme.oraclecloud.internal.",
      "state": "queued",
      "disk_attach": "",
      "label": "dev-vm",
      "priority": "/oracle/public/default",
      "platform": "linux",
      "quota_reservation": null,
      "suspend_file": null,
      "node": null,
      "resource_requirements": {
        "compressed_size": 727212045,
        "ram": 7680,
        "cpus": 2.0,
        "root_disk_size": 0,
        "io": 200,
        "decompressed_size": 2277507072
      },
      "virtio": null,
      "vnc": "",
      "storage_attachments": [],
      "start_time": "2016-04-06T18:03:12Z",
      "storage_attachment_associations": [],
      "quota": "/Compute-acme",
      "vnc_key": null,
      "numerical_priority": 100,
      "suspend_requested": false,
      "entry": 1,
      "error_reason": "",
      "nat_associations": null,
      "sshkeys": ["/Compute-acme/[e-mail]/dev-key1"],
      "tags": [],
      "resolvers": null,
      "metrics": null,
      "account": "/Compute-acme/default",
      "node_uuid": null,
      "name": "/Compute-acme/[e-mail]/dev-vm/437b72fd-b870-47b1-9c01-7a2812bbe30c",
      "vcable_id": null,
      "hypervisor": {"mode": "hvm"},
      "uri": "https://api-z999.compute.us0.oraclecloud.com/instance/Compute-acme/[e-mail]/dev-vm/437b72fd-b870-47b1-9c01-7a2812bbe30c",
      "console": null,
      "reverse_dns": true,
      "delete_requested": null,
      "hypervisor_type": null,
      "attributes": {
        "sshkeys": ["ssh-rsa AAAAB3..."]
      },
      "boot_order": [],
      "last_seen": null
    },
    {
      "domain": "compute-acme...",
      "placement_requirements": [
        "/system/compute/placement/default",
        "/system/compute/allow_instances"
      ],
      "ip": "0.0.0.0",
      "fingerprint": "",
      "site": "",
      "last_state_change_time": null,
      "cluster": null,
      "shape": "oc4",
      "vethernets": null,
      "imagelist": "/oracle/public/oel_6.4_2GB_v1",
      "image_format": "raw",
      "id": "8e37d700-c63c-46f7-bfc0-eea5d788bd04",
      "cluster_uri": null,
      "networking": {
        "eth0": {
          "model": "",
          "seclists": [
            "/Compute-acme/default/default"
          ],
          "dns": [
            "...compute-acme..."
          ],
          "nat": null,
          "vethernet": "/oracle/public/default"
        }
      },
      "seclist_associations": null,
      "hostname": "...compute-acme...",
      "state": "queued",
      "disk_attach": "",
      "label": "prod-vm",
      "priority": "/oracle/public/default",
      "platform": "linux",
      "quota_reservation": null,
      "suspend_file": null,
      "node": null,
      "resource_requirements": {
        "compressed_size": 727212045,
        "ram": 15360,
        "cpus": 4.0,
        "root_disk_size": 0,
        "io": 400,
        "decompressed_size": 2277507072
      },
      "virtio": null,
      "vnc": "",
      "storage_attachments": [],
      "start_time": "2016-04-06T18:03:12Z",
      "storage_attachment_associations": [],
      "quota": "/Compute-acme",
      "vnc_key": null,
      "numerical_priority": 100,
      "suspend_requested": false,
      "entry": 1,
      "error_reason": "",
      "nat_associations": null,
      "sshkeys": ["/Compute-acme/[e-mail]/prod-key1"],
      "tags": [],
      "resolvers": null,
      "metrics": null,
      "account": "/Compute-acme/default",
      "node_uuid": null,
      "name": "/Compute-acme/[e-mail]/prod-vm/8e37d700-c63c-46f7-bfc0-eea5d788bd04",
      "vcable_id": null,
      "hypervisor": {"mode": "hvm"},
      "uri": "https://api-z999.compute.us0.oraclecloud.com/instance/Compute-acme/[e-mail]/prod-vm/8e37d700-c63c-46f7-bfc0-eea5d788bd04",
      "console": null,
      "reverse_dns": true,
      "delete_requested": null,
      "hypervisor_type": null,
      "attributes": {
        "sshkeys": ["ssh-rsa AAAA..."]
      },
      "boot_order": [],
      "last_seen": null
    }
  ]
}

トップに戻る