Oracle Cloud Infrastructure Compute ClassicのREST API

すべてのRESTエンドポイント

ACL

アクセス制御リスト(ACL)は、セキュリティ・ルールの集合です。 ACLを使用して、インスタンス間のトラフィックを制御できます。 Compute Classicインスタンスとの間のトラフィックを制御するために、ACLを次の場所に適用することができます:

同じIPネットワーク上のCompute Classicインスタンスの仮想NIC

VPNゲートウェイやインターネット・ゲートウェイ・ノードなどの中継ノードの仮想NIC

デフォルトのACLでは、IPネットワーク内のすべての仮想NICへのトラフィックが許可されます。

ACLの作成: メソッド: post
パス: /network/v1/acl/
ACLの削除: メソッド: delete
パス: /network/v1/acl/{name}
コンテナ内のすべてのACLに関する詳細の取得: メソッド: get
パス: /network/v1/acl/{container}/
ACLに関する詳細の取得: メソッド: get
パス: /network/v1/acl/{name}
ACLの更新: メソッド: put
パス: /network/v1/acl/{name}

アカウント

Compute Classicでは、別のサービスにアクセスするために使用する必要がある資格証明を格納するためにアカウントが使用されます。たとえば、アカウントを使用して、マシン・イメージを格納するOracle Cloud Infrastructure Object Storage Classicインスタンスの資格証明およびその他の詳細を定義します。

次のHTTPリクエストを使用して、アカウントを表示できます。

コンテナ内のすべてのアカウントに関する詳細の取得: メソッド: get
パス: /account/{container}/
アカウントに関する詳細の取得: メソッド: get
パス: /account/{name}
コンテナ内のすべてのアカウントとサブコンテナの名前を取得: メソッド: get
パス: /account/{container}
コンテナの名前の取得: メソッド: get
パス: /account/

AuditEvents

(これはこのAPIの一般的な説明であり、追加する必要があります。)

コンテナ内のすべての監査イベントの詳細の取得: メソッド: get
パス: /auditevent/{container}/
監査イベントの詳細の取得: メソッド: get
パス: /auditevent/{name}

認証

このリソースへのPOSTリクエストは、指定されたユーザーを認証し、Compute Classicへの後続のAPI呼び出しで指定できる認証Cookieを戻します。

ユーザーの認証: メソッド: post
パス: /authenticate/

AvailabilityDomains

(これはこのAPIの一般的な説明であり、追加する必要があります。)

可用性ドメインの詳細の取得: メソッド: get
パス: /compute/availabilitydomain/{name}
コンテナ内のすべてのアベイラビリティ・ドメインおよびサブ・コンテナの名前の取得: メソッド: get
パス: /compute/availabilitydomain/

バックアップ構成

バックアップは定義した間隔で自動的に取得されるようにスケジュールできます。バックアップをスケジュールすると、指定されたストレージ・ボリュームのスナップショットが作成され、スナップショットは関連付けられたOracle Cloud Infrastructure Object Storage Classicインスタンスに格納されます。

バックアップ構成を追加、削除、更新および取得するには、次にリストされているHTTPリクエストを使用します。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

バックアップ構成の作成: メソッド: post
パス: /backupservice/v1/configuration
バックアップ構成の削除: メソッド: delete
パス: /backupservice/v1/configuration/{name}
バックアップ構成に関する詳細の取得: メソッド: get
パス: /backupservice/v1/configuration/{name}
すべてのバックアップ構成に関する詳細の取得: メソッド: get
パス: /backupservice/v1/configuration
バックアップ構成の更新: メソッド: put
パス: /backupservice/v1/configuration/{name}

バックアップ

指定したバックアップ構成を使用して、バックアップをすぐに作成できます。スケジュールされているバックアップおよびそのステータスの表示、または指定されたバックアップおよび対応するスナップショットの削除を行うこともできます。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

バックアップの作成: メソッド: post
パス: /backupservice/v1/backup
バックアップの削除: メソッド: delete
パス: /backupservice/v1/backup/{name}
すべてのバックアップに関する詳細の取得: メソッド: get
パス: /backupservice/v1/backup
指定されたバックアップに関する詳細の取得: メソッド: get
パス: /backupservice/v1/backup/{name}

IPAddressAssociation

単一の仮想NIC上のすべてのIPアドレスの関連付けとIPアドレスの予約との間の関連付けは、すべての到達可能なIPアドレスのプレフィクスが重複しないようにする必要があります(デフォルト・プレフィクスを除く)。到達可能なデフォルトのIPアドレス・プレフィクスを持っています。

IPネットワークのIPアドレスの関連付けの作成: メソッド: post
パス: /network/v1/ipassociation/
IPネットワークで使用されるIPアドレスの関連付けの削除: メソッド: delete
パス: /network/v1/ipassociation/{name}
コンテナ内のすべてのIPアドレスの関連付けに関する詳細の取得: メソッド: get
パス: /network/v1/ipassociation/{container}/
IPネットワークで使用されるIPアドレスの関連付けに関する詳細の取得: メソッド: get
パス: /network/v1/ipassociation/{name}
IPネットワークで使用されるIPアドレスの関連付けの更新: メソッド: put
パス: /network/v1/ipassociation/{name}

IPAddressPrefixSet

IPアドレス・プレフィックス・セットは、IPv4アドレスをCIDRアドレス・プレフィックス形式でリストします。

IPアドレス・プレフィックス・セットの作成: メソッド: post
パス: /network/v1/ipaddressprefixset/
IPアドレス・プレフィックス・セットの削除: メソッド: delete
パス: /network/v1/ipaddressprefixset/{name}
コンテナ内のすべてのIPアドレス・プレフィックス・セットに関する詳細の取得: メソッド: get
パス: /network/v1/ipaddressprefixset/{container}/
IPアドレス・プレフィックス・セットに関する詳細の取得: メソッド: get
パス: /network/v1/ipaddressprefixset/{name}
IPアドレス・プレフィックス・セットの更新: メソッド: put
パス: /network/v1/ipaddressprefixset/{name}

IPAddressReservation

NATを使用してIPネットワーク / IPネットワーク交換外にルーティングするための1つ以上の仮想NICに関連付けることができるNAT IPv4アドレスの予約。

IPネットワークのIPアドレス予約の作成: メソッド: post
パス: /network/v1/ipreservation/
IPネットワークで使用されるIPアドレス予約の削除: メソッド: delete
パス: /network/v1/ipreservation/{name}
コンテナ内のすべてのIPアドレス予約に関する詳細の取得: メソッド: get
パス: /network/v1/ipreservation/{container}/
IPネットワークで使用されるIPアドレス予約に関する詳細の取得: メソッド: get
パス: /network/v1/ipreservation/{name}
IPネットワークで使用されるIPアドレス予約の更新: メソッド: put
パス: /network/v1/ipreservation/{name}

IPAssociation

IPの関連付けとは、IP予約とインスタンスのvcableとの間のリンクのことです。 vcableは、インスタンス上の特定のネットワーク・インタフェースへのアタッチ・ポイントです。 vcableは、インスタンスを作成すると自動的に作成され、インスタンスを削除すると削除されます。

次のHTTPリクエストを使用して、IPの関連付けを作成、削除および表示できます。

IPの関連付けの作成: メソッド: post
パス: /ip/association/
IPの関連付けの削除: メソッド: delete
パス: /ip/association/{name}
コンテナ内のすべてのIPの関連付けに関する詳細の取得: メソッド: get
パス: /ip/association/{container}/
IPの関連付けに関する詳細の取得: メソッド: get
パス: /ip/association/{name}
コンテナ内のすべてのIP関連付けおよびサブコンテナの名前を取得: メソッド: get
パス: /ip/association/{container}
コンテナの名前の取得: メソッド: get
パス: /ip/association/

IPNetworkExchange

IPネットワーク交換には複数のIPネットワークを含めることができますが、IPネットワークは1つのIPネットワーク交換にのみ追加できます。詳細は、「Oracle Cloud Infrastructure Compute Classicの使用」の「IPネットワークの管理」を参照してください。

IPネットワーク交換を作成、表示および削除するには、次にリストされているHTTPリクエストを使用します。

IPネットワーク交換の作成: メソッド: post
パス: /network/v1/ipnetworkexchange/
IPネットワーク交換の削除: メソッド: delete
パス: /network/v1/ipnetworkexchange/{name}
コンテナ内のすべてのIPネットワーク交換に関する詳細の取得: メソッド: get
パス: /network/v1/ipnetworkexchange/{container}/
IPネットワーク交換に関する詳細の取得: メソッド: get
パス: /network/v1/ipnetworkexchange/{name}

IPNetwork

IPネットワークを使用すると、アカウントにIPサブネットを定義できます。 IPサブネットのサイズおよびサブネットに設定されるIPアドレスは、IPネットワークの作成時に指定したIPアドレス・プレフィックスによって決定されます。これらのIPアドレスは、共有ネットワークによって使用されるオラクル社提供のIPアドレスの共通プールの一部ではありません。 IPネットワークにインスタンスを追加すると、そのインスタンスにはそのサブネットのIPアドレスが割り当てられます。 IPアドレスは、ビジネスのニーズに応じて、静的または動的にインスタンスに割り当てることができます。このため、インスタンスに割り当てられるIPアドレスを完全に制御できます。詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「IPネットワークの管理」を参照してください。

IPネットワークの作成: メソッド: post
パス: /network/v1/ipnetwork/
IPネットワークの削除: メソッド: delete
パス: /network/v1/ipnetwork/{name}
コンテナ内のすべてのIPネットワークに関する詳細の取得: メソッド: get
パス: /network/v1/ipnetwork/{container}/
IPネットワークに関する詳細の取得: メソッド: get
パス: /network/v1/ipnetwork/{name}
IPネットワークの更新: メソッド: put
パス: /network/v1/ipnetwork/{name}

IPReservation

IP予約は、IPアドレス・プールからのパブリックIPアドレスの割当てです。 IP予約を作成した後、IPの関連付けを使用してそれをインスタンスに関連付け、インターネットとインスタンス間のアクセスを可能にすることができます。

次のHTTPリクエストを使用して、IP予約を追加、削除、更新および表示できます。

IP予約を作成: メソッド: post
パス: /ip/reservation/
IP予約を削除: メソッド: delete
パス: /ip/reservation/{name}
コンテナ内のすべてのIP予約に関する詳細の取得: メソッド: get
パス: /ip/reservation/{container}/
IP予約に関する詳細の取得: メソッド: get
パス: /ip/reservation/{name}
コンテナ内のすべてのIP予約とサブコンテナの名前を取得: メソッド: get
パス: /ip/reservation/{container}
コンテナの名前の取得: メソッド: get
パス: /ip/reservation/
IP予約の更新: メソッド: put
パス: /ip/reservation/{name}

ImageListEntry

イメージ・リスト内の各マシン・イメージは、イメージ・リスト・エントリで識別されます。

次のHTTPリクエストを使用して、イメージ・リスト・エントリを作成および削除できます。

イメージ・リスト・エントリの作成: メソッド: post
パス: /imagelist/{name}/entry/
イメージ・リスト・エントリの削除: メソッド: delete
パス: /imagelist/{name}/entry/{version}
イメージ・リスト・エントリの詳細の取得: メソッド: get
パス: /imagelist/{name}/entry/{version}

ImageList

イメージ・リストは、Compute Classicのマシン・イメージのコレクションです。イメージ・リスト内の各マシンは、一意のエントリ番号で識別されます。

たとえば、起動プランを使用してインスタンスを作成する際、使用するマシン・イメージが含まれているイメージ・リストを指定する必要があります。

次のHTTPリクエストを使用して、イメージ・リストを作成、削除、更新および表示できます。

イメージ・リストの作成: メソッド: post
パス: /imagelist/
イメージ・リストの削除: メソッド: delete
パス: /imagelist/{name}
コンテナ内のすべてのイメージ・リストに関する詳細の取得: メソッド: get
パス: /imagelist/{container}/
イメージ・リストに関する詳細の取得: メソッド: get
パス: /imagelist/{name}
コンテナ内のすべてのイメージ・リストとサブコンテナの名前を取得: メソッド: get
パス: /imagelist/{container}
コンテナの名前の取得: メソッド: get
パス: /imagelist/
イメージ・リストの更新: メソッド: put
パス: /imagelist/{name}

InstanceConsole

インスタンスのブート中に発生したエラーの診断にインスタンスのコンソール出力を使用できます。 instanceconsoleオブジェクトは、インスタンスの起動時に作成され、インスタンスの削除時に破棄されます。

インスタンス・コンソールの詳細の取得: メソッド: get
パス: /instanceconsole/{name}

インスタンス

Compute Classicインスタンスは、特定のオペレーティング・システムと、指定したCPUリソースとメモリー・リソースを実行している仮想マシンです。 「Oracle Cloud Infrastructure Compute Classicの使用」の「インスタンスについて」を参照してください。

次のHTTPリクエストを使用して、インスタンスを表示および削除できます。

インスタンスの削除: メソッド: delete
パス: /instance/{name}
コンテナ内のすべてのインスタンスに関する詳細の取得: メソッド: get
パス: /instance/{container}/
インスタンスに関する詳細の取得: メソッド: get
パス: /instance/{name}
コンテナ内のすべてのインスタンスとサブコンテナの名前を取得: メソッド: get
パス: /instance/{container}
コンテナの名前の取得: メソッド: get
パス: /instance/
インスタンスを更新: メソッド: put
パス: /instance/{name}

LaunchPlan

起動プランは1つ以上のインスタンスのプロパティを定義するJSON形式のファイルです。起動プランを使用して、複数の非永続インスタンスをCompute Classicにすばやく作成して開始することができます。起動プランJSONファイルを再利用してインスタンスを何回も作成することはできますが、起動プラン自体はCompute Classicでは維持されません。

インスタンスを作成するとき、初期状態はpreparingです。Compute Classicはリソースを割り当て、インスタンスの作成を準備します。次に、状態は「initializing」に変わり、指定したイメージがインストール中であることを示します。初期化が完了すると、状態は「running」に変わり、OSが起動したことを示します。インスタンスが「running」状態のときは、それに接続できます。

起動プランを使用したインスタンスの作成: メソッド: post
パス: /launchplan/

MachineImage

マシン・イメージは、オペレーティング・システムがインストールされた、特定のサイズの仮想ハード・ディスクのテンプレートです。 Compute Classicでは、マシン・イメージを使用して仮想マシン・インスタンスを作成します。

次のHTTPリクエストを使用して、マシン・イメージを作成、表示および削除できます。

マシン・イメージの作成: メソッド: post
パス: /machineimage/
マシン・イメージの削除: メソッド: delete
パス: /machineimage/{name}
マシン・イメージの詳細の取得: メソッド: get
パス: /machineimage/{name}
コンテナ内のマシン・イメージの詳細の取得: メソッド: get
パス: /machineimage/{container}/
コンテナ内のすべてのマシン・イメージとサブコンテナの名前を取得: メソッド: get
パス: /machineimage/{container}
コンテナの名前の取得: メソッド: get
パス: /machineimage/

OSSContainer

OSSContainerはOracle Cloud Infrastructure Object Storage Classicのコンテナです。 Compute Classic APIを使用してOracle Cloud Infrastructure Object Storage Classicコンテナを作成できます。

Oracle Cloud Infrastructure Object Storage Classicコンテナを作成: メソッド: post
パス: /integrations/osscontainer/
Oracle Cloud Infrastructure Object Storage Classicコンテナを削除: メソッド: delete
パス: /integrations/osscontainer/{name}
コンテナ内のすべてのOracle Cloud Infrastructure Object Storage Classicコンテナの詳細を取得: メソッド: get
パス: /integrations/osscontainer/{container}/
Oracle Cloud Infrastructure Object Storage Classicコンテナの詳細を取得: メソッド: get
パス: /integrations/osscontainer/{name}
コンテナ内のすべてのOracle Cloud Infrastructure Object Storage Classicコンテナとサブコンテナの名前を取得: メソッド: get
パス: /integrations/osscontainer/{container}
コンテナの名前の取得: メソッド: get
パス: /integrations/osscontainer/
Oracle Cloud Infrastructure Object Storage Classicコンテナを更新: メソッド: put
パス: /integrations/osscontainer/{name}

OrchestrationObjects

オーケストレーション・オブジェクトは、オーケストレーションv2によって管理されるCompute Classicのオブジェクトです。これは、オーケストレーションの主要な構成要素です。各オブジェクトには、作成するコンピューティング、ネットワーキング、またはストレージ・リソースのすべての属性が含まれています。オーケストレーションでオブジェクトを定義するときは、参照を使用して他のオブジェクトとの依存関係を作成できます。 「Oracle Cloud Infrastructure Compute Classicの使用」の「オブジェクト参照と関係」を参照してください。

オーケストレーションは、最大100の相互依存オブジェクトを処理するように設計されています。他のAPIを使用してオブジェクトを作成すると、オーケストレーションが損なわれる可能性があります。

注意: オーケストレーションを使用して調整したリソースを管理するには、常にオーケストレーションを使用する必要があります。たとえば、OrchestrationObject APIを使用して、セキュリティ・リストを実行中のインスタンスに追加するか、SecListsまたはStorageSnapshots APIを使用せずに、アタッチされたストレージ・ボリュームのストレージ・スナップショットを作成します。たとえば、WebコンソールまたはREST APIを使用して、オーケストレーションを使用して作成したオブジェクトを削除しないでください。これにより、オーケストレーションがオブジェクトと関連するリソースを再作成しようとするか、エラー状態になる可能性があります。

また、Orchestrations v1を使用して作成したリソースをOrchestrations v2で参照したり、その逆に使用したり、管理したりしないでください。

以下に示すHTTPリクエストを使用して、オーケストレーション内のオブジェクトにオブジェクトを追加したり、オブジェクトを削除したり、オブジェクトを更新したりすることができます。

オーケストレーション・オブジェクトを作成: メソッド: post
パス: /platform/v1/object/
オーケストレーション・オブジェクトを削除: メソッド: delete
パス: /platform/v1/object/{name}
コンテナ内のすべてのオーケストレーション・オブジェクトの詳細を取得: メソッド: get
パス: /platform/v1/object/{container}/
オーケストレーション・オブジェクトの詳細を取得: メソッド: get
パス: /platform/v1/object/{name}
コンテナ内のすべてのオーケストレーション・オブジェクトとサブコンテナの名前を取得: メソッド: get
パス: /platform/v1/object/{container}
コンテナの名前の取得: メソッド: get
パス: /platform/v1/object/
オーケストレーション・オブジェクトを更新: メソッド: put
パス: /platform/v1/object/{name}

OrchestrationV2s

オーケストレーションは、Compute Classicのコンピューティング、ネットワーク、およびストレージ・リソースのコレクションの属性と相互依存関係を定義します。オーケストレーションを使用して、仮想コンピュート・トボロジ全体のプロビジョニングおよびライフサイクル操作を自動化することができます。

以前のバージョンのCompute Classicでは、オーケストレーションv1を使用してリソースを作成および管理できました。リリース17.1.2以降、Orchestrations v2を使用してリソースを作成およびプロビジョニングすることもできます。

注意: オーケストレーションを使用して作成したリソースを管理するには、常にオーケストレーションを使用する必要があります。たとえば、WebコンソールまたはREST APIを使用して、オーケストレーションを使用して作成したオブジェクトを削除しないでください。これにより、オーケストレーションがオブジェクトと関連するリソースを再作成しようとするか、エラー状態になる可能性があります。

また、Orchestrations v1を使用して作成したリソースをOrchestrations v2で参照したり、その逆に使用したり、管理したりしないでください。

詳細は、「Orchestrations v2について」を参照してください。

OrchestrationV2を作成: メソッド: post
パス: /platform/v1/orchestration/
OrchestrationV2を削除: メソッド: delete
パス: /platform/v1/orchestration/{name}
コンテナ内のすべてのOrchestrationV2の詳細を取得: メソッド: get
パス: /platform/v1/orchestration/{container}/
OrchestrationV2の詳細を取得: メソッド: get
パス: /platform/v1/orchestration/{name}
コンテナ内のすべてのOrchestrationV2およびサブコンテナの名前を取得: メソッド: get
パス: /platform/v1/orchestration/{container}
コンテナの名前の取得: メソッド: get
パス: /platform/v1/orchestration/
OrchestrationV2を更新: メソッド: put
パス: /platform/v1/orchestration/{name}

オーケストレーション

オーケストレーション(JSON形式のファイル)を作成してCompute Classicに追加したら、オーケストレーションで定義されているすべてのリソースの作成と削除を1つのステップでトリガーできます。

オーケストレーションには1つ以上のオブジェクト・プラン(oplans)が含まれています。 oplanで指定可能な属性は、オブジェクト型(obj_type)によって異なります。オーケストレーションと各オブジェクト・タイプの属性を使用して作成できるオブジェクト・タイプの詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「オーケストレーションの属性」を参照してください。

次のHTTPリクエストを使用して、オーケストレーションを追加、開始、停止、取得、更新および削除できます。

オーケストレーションの追加: メソッド: post
パス: /orchestration/
オーケストレーションの削除: メソッド: delete
パス: /orchestration/{name}
コンテナ内のすべてのオーケストレーションに関する詳細の取得: メソッド: get
パス: /orchestration/{container}/
オーケストレーションに関する詳細の取得: メソッド: get
パス: /orchestration/{name}
コンテナ内のすべてのオーケストレーションとサブコンテナの名前を取得: メソッド: get
パス: /orchestration/{container}
コンテナの名前の取得: メソッド: get
パス: /orchestration/
オーケストレーションの更新: メソッド: put
パス: /orchestration/{name}

PrivateGateways

Compute Classicアカウント内の構内ネットワークとIPネットワーク内のサブネット間のプライベート・データ接続をOracle Cloud Infrastructure FastConnect Classicエッジルーター経由で設定する場合は、プライベート・ゲートウェイを作成します。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

プライベート・ゲートウェイを作成: メソッド: post
パス: /network/v1/privategateway/
プライベート・ゲートウェイを削除: メソッド: delete
パス: /network/v1/privategateway/{name}
プライベート・ゲートウェイの詳細を取得: メソッド: get
パス: /network/v1/privategateway/{name}
コンテナ内のすべてのプライベート・ゲートウェイの詳細を取得: メソッド: get
パス: /network/v1/privategateway/{container}/
コンテナ内のすべてのプライベート・ゲートウェイとサブコンテナの名前を取得: メソッド: get
パス: /network/v1/privategateway/{container}
プライベート・ゲートウェイを更新: メソッド: put
パス: /network/v1/privategateway/{name}

RebootInstanceRequest

rebootinstancerequestオブジェクトを作成することで、実行中のインスタンスを再起動できます。

インスタンス再起動リクエストの作成: メソッド: post
パス: /rebootinstancerequest/
インスタンス再起動リクエストの削除: メソッド: delete
パス: /rebootinstancerequest/{name}
インスタンス再起動リクエストの詳細の取得: メソッド: get
パス: /rebootinstancerequest/{name}
コンテナ内のすべてのインスタンス再起動リクエストの詳細の取得: メソッド: get
パス: /rebootinstancerequest/{container}/
コンテナ内のすべてのリブート・インスタンス・リクエストおよびサブコンテナの名前の取得: メソッド: get
パス: /rebootinstancerequest/{container}
コンテナの名前の取得: メソッド: get
パス: /rebootinstancerequest/

RefreshToken

認証トークンは30分後に失効します。このリクエストによって、認証トークンの有効期限が、コマンドを実行した時間から30分延長されます。これにより、現在の認証トークンの有効期限が延長されますが、セッションの有効期限の3時間を超えることはありません。

認証トークンのリフレッシュ: メソッド: get
パス: /refresh/

リストア

バックアップがボリュームにリストアされるようにスケジュールできます。リストアは、完全なバックアップからのみ行うことができます。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

リストアの作成: メソッド: post
パス: /backupservice/v1/restore
リストアの削除: メソッド: delete
パス: /backupservice/v1/restore/{name}
リストアに関する詳細の取得: メソッド: get
パス: /backupservice/v1/restore/{name}
すべてのリストアに関する詳細の取得: メソッド: get
パス: /backupservice/v1/restore

ルート

IPネットワークを作成してそのネットワークにインスタンスを追加したら、ルートおよびIPネットワーク交換を作成することによって、それぞれのネットワーク間の接続を指定できます。

ルートには、宛先のIPアドレス、およびルーティング・パケットの次のホップを提供するvNICsetを指定します。ルートを使用してサブネット間のトラフィックを有効にすると、各IPネットワークへの複数のルートを指定できます。また、ルートにvNICsetを使用すると、エグレス負荷分散および高可用性が実現されます。

詳細は、「Oracle Cloud Infrastructure Compute Classicの使用」の「IPネットワークの管理」を参照してください。

ルートの作成: メソッド: post
パス: /network/v1/route/
ルートの削除: メソッド: delete
パス: /network/v1/route/{name}
ルートに関する詳細の取得: メソッド: get
パス: /network/v1/route/{name}
コンテナ内のすべてのルートに関する詳細の取得: メソッド: get
パス: /network/v1/route/{container}/
ルートの更新: メソッド: put
パス: /network/v1/route/{name}

SSHKey

SSHを使用してインスタンスに接続するには、それを1つ以上のSSH公開キーと関連付ける必要があります。まず、ssh-keygenなどのツールを使用して、必要なSSHキーペアを生成してから、公開キーをCompute Classicにアップロードする必要があります。

次のHTTPリクエストを使用して、SSH公開キーを追加、削除、更新および表示できます。 SSHキーペアを生成する方法については、「Oracle Cloud Infrastructure Compute Classicの使用」の「SSHキーペアの生成」を参照してください。

SSHキーの追加: メソッド: post
パス: /sshkey/
SSHキーの削除: メソッド: delete
パス: /sshkey/{name}
コンテナ内のすべてのSSHキーの詳細の取得: メソッド: get
パス: /sshkey/{container}/
SSHキーの詳細の取得: メソッド: get
パス: /sshkey/{name}
コンテナ内のすべてのSSHキーとサブコンテナの名前を取得: メソッド: get
パス: /sshkey/{container}
コンテナの名前の取得: メソッド: get
パス: /sshkey/
SSHキーの更新: メソッド: put
パス: /sshkey/{name}

SecApplication

セキュリティ・アプリケーションは、セキュリティ・ルールで使用可能なIPプロトコルとポート間のマッピングです。 Web UIでは、セキュリティ・アプリケーションはプロトコルと呼ばれます。 Compute Classicにはいくつかの定義済みセキュリティ・アプリケーションが用意されています。ユーザー独自のセキュリティ・アプリケーションを定義することもできます。

次のHTTPリクエストを使用して、セキュリティ・アプリケーションを作成、削除および表示できます。

セキュリティ・アプリケーションの作成: メソッド: post
パス: /secapplication/
セキュリティ・アプリケーションの削除: メソッド: delete
パス: /secapplication/{name}
セキュリティ・アプリケーションに関する詳細の取得: メソッド: get
パス: /secapplication/{name}
コンテナ内のすべてのセキュリティ・アプリケーションに関する詳細の取得: メソッド: get
パス: /secapplication/{container}/
コンテナ内のすべてのセキュリティ・アプリケーションとサブコンテナの名前を取得: メソッド: get
パス: /secapplication/{container}
コンテナの名前の取得: メソッド: get
パス: /secapplication/

SecAssociation

セキュリティ・アソシエーションとは、セキュリティ・リストとインスタンスのvcableとの間のリンクのことです。 vcableは、インスタンス上の特定のネットワーク・インタフェースへのアタッチ・ポイントです。 vcableによって、セキュリティ・リストとのインスタンスの動的な関連付けまたは関連付けの解除が可能になります。 1つのvcableに対して、最大8つのセキュリティ・リストを関連付けることができます。この制限には、インスタンス構成(起動プランなど)で指定されるセキュリティ・リスト、およびインスタンスの作成後に追加される新規のセキュリティ・アソシエーションが含まれます。

セキュリティ・リストを削除すると、そのセキュリティ・リストに関係するすべてのセキュリティ・アソシエーションも削除される点に注意してください。

次のHTTPリクエストを使用して、セキュリティ・アソシエーションを作成、削除および表示できます。

セキュリティ・アソシエーションの作成: メソッド: post
パス: /secassociation/
セキュリティ・アソシエーションの削除: メソッド: delete
パス: /secassociation/{name}
セキュリティ・アソシエーションに関する詳細の取得: メソッド: get
パス: /secassociation/{name}
コンテナ内のすべてのセキュリティ・アソシエーションに関する詳細の取得: メソッド: get
パス: /secassociation/{container}/
コンテナ内のすべてのセキュリティ関連付けとサブコンテナの名前を取得: メソッド: get
パス: /secassociation/{container}
コンテナの名前の取得: メソッド: get
パス: /secassociation/

SecIPList

セキュリティIPリストは、Compute Classicで作成したインスタンスの外部にあるIPアドレスまたはサブネットのセットです。これらのリストは、セキュリティ・ルールを定義する際にソースとして使用できます。

/oracle/public/public-internetという名前のセキュリティIPリストは、Compute Classicにあらかじめ定義されています。このセキュリティIPリストをセキュリティ・ルールでソースとして使用して、インターネット上の任意のホストからのトラフィックを許可することができます。

次のHTTPリクエストを使用して、セキュリティIPリストを作成、削除、更新および表示できます。

セキュリティIPリストの作成: メソッド: post
パス: /seciplist/
セキュリティIPリストの削除: メソッド: delete
パス: /seciplist/{name}
セキュリティIPリストに関する詳細の取得: メソッド: get
パス: /seciplist/{name}
コンテナ内のすべてのセキュリティIPリストに関する詳細の取得: メソッド: get
パス: /seciplist/{container}/
コンテナ内のすべてのセキュリティIPリストとサブコンテナの名前を取得: メソッド: get
パス: /seciplist/{container}
コンテナの名前の取得: メソッド: get
パス: /seciplist/
セキュリティIPリストの更新: メソッド: put
パス: /seciplist/{name}

SecList

セキュリティ・リストは、セキュリティ・ルールで宛先またはソースとして指定できる1つ以上のインスタンスのグループです。セキュリティ・リスト内のインスタンスは、すべてのポートで相互に完全に通信できます。セキュリティ・リストにインスタンスをアタッチする際、セキュリティ・リストで定義されているインバウンドおよびアウトバウンド・ポリシーをそのインスタンスに適用できます。セキュリティ・リスト内のすべてのインスタンスは、すべてのプロトコルとポートで相互に完全に通信できます。

インスタンスの作成中にセキュリティ・リストにアタッチしない場合、インスタンスは、インバウンド・ポリシーがDENYに、アウトバウンド・ポリシーがPERMITに設定されている、事前定義済の/Compute-identity_domain/default/defaultというセキュリティ・リストに自動的にアタッチされます。

次のHTTPリクエストを使用して、セキュリティ・リストを作成、削除、更新および表示できます。セキュリティ・リストの詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「セキュリティ・リストについて」を参照してください。

セキュリティ・リストの作成: メソッド: post
パス: /seclist/
セキュリティ・リストの削除: メソッド: delete
パス: /seclist/{name}
セキュリティ・リストに関する詳細の取得: メソッド: get
パス: /seclist/{name}
コンテナ内のすべてのセキュリティ・リストに関する詳細の取得: メソッド: get
パス: /seclist/{container}/
コンテナ内のすべてのセキュリティ・リストとサブコンテナの名前を取得: メソッド: get
パス: /seclist/{container}
コンテナの名前の取得: メソッド: get
パス: /seclist/
セキュリティ・リストの更新: メソッド: put
パス: /seclist/{name}

SecRule

セキュリティ・ルールは、指定したプロトコルでの2つのセキュリティ・リスト内のインスタンス間、または1つのセキュリティ・リスト内の一連の外部ホスト(IPリスト)とインスタンス間のネットワーク・アクセスを定義します。

セキュリティ・ルールは、セキュリティ・リスト、セキュリティIPリストおよびセキュリティ・アプリケーション・エンティティの関連付けを行います。

次のHTTPリクエストを使用して、セキュリティ・ルールを作成、削除、更新および表示できます。セキュリティ・ルールの詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「セキュリティ・ルールについて」を参照してください。

セキュリティ・ルールの作成: メソッド: post
パス: /secrule/
セキュリティ・ルールの削除: メソッド: delete
パス: /secrule/{name}
セキュリティ・ルールに関する詳細の取得: メソッド: get
パス: /secrule/{name}
コンテナ内のすべてのセキュリティ・ルールに関する詳細の取得: メソッド: get
パス: /secrule/{container}/
コンテナ内のすべてのセキュリティ・ルールとサブコンテナの名前を取得: メソッド: get
パス: /secrule/{container}
コンテナの名前の取得: メソッド: get
パス: /secrule/
セキュリティ・ルールの更新: メソッド: put
パス: /secrule/{name}

SecurityProtocol

セキュリティ・プロトコルを使用すると、トランスポート・プロトコルを指定でき、その指定したプロトコルで使用するソース・ポートおよび宛先ポートを指定できます。

これはセキュリティ・ルール内の一致するパケットに使用されます。

セキュリティ・ルールを作成する際、プロトコルおよび指定したセキュリティ・プロトコルのポートを使用して、そのセキュリティ・ルールによって許可されるトラフィックのタイプが決定されます。セキュリティ・プロトコルでプロトコルおよびポートを指定しない場合、すべてのプロトコルおよびポートのトラフィックが許可されます。

複数のセキュリティ・ルールに1つのセキュリティ・プロトコルを指定できます。そのため、1つのプロトコルを多数のセキュリティ・ルールで使用する場合、そのプロトコルを何度も作成する必要がありません。

IPネットワークのセキュリティ・プロトコルの作成: メソッド: post
パス: /network/v1/secprotocol/
IPネットワークで使用されるセキュリティ・プロトコルの削除: メソッド: delete
パス: /network/v1/secprotocol/{name}
IPネットワークで使用されるセキュリティ・プロトコルに関する詳細の取得: メソッド: get
パス: /network/v1/secprotocol/{name}
コンテナ内のすべてのセキュリティ・プロトコルに関する詳細の取得: メソッド: get
パス: /network/v1/secprotocol/{container}/
IPネットワークで使用されるセキュリティ・プロトコルの更新: メソッド: put
パス: /network/v1/secprotocol/{name}

SecurityRule

セキュリティ・ルールは指定されたソースからのトラフィック、または指定された宛先へのトラフィックを許可します。セキュリティ・ルールの方向(イングレスまたはエグレス)を指定する必要があります。さらに、許可されたトラフィックのソースまたは宛先と、パケットの送信または受信に使用するセキュリティ・プロトコルおよびポートを指定できます。セキュリティ・ルールで指定する各パラメータは、そのルールによって許可されるトラフィックのタイプが一致する必要がある基準を指定します。指定されたすべての基準に一致するパケットのみが許可されます。セキュリティ・ルールで一致基準を指定しない場合、指定された方向のすべてのトラフィックが許可されます。セキュリティ・ルールの主な機能は、IPネットワークで許可されるトラフィック・タイプの識別を補助することです。

IPネットワークのセキュリティ・ルールの作成: メソッド: post
パス: /network/v1/secrule/
IPネットワークで使用されるセキュリティ・ルールの削除: メソッド: delete
パス: /network/v1/secrule/{name}
IPネットワークで使用されるセキュリティ・ルールに関する詳細の取得: メソッド: get
パス: /network/v1/secrule/{name}
コンテナ内のすべてのセキュリティ・ルールに関する詳細の取得: メソッド: get
パス: /network/v1/secrule/{container}/
IPネットワークで使用されるセキュリティ・ルールの更新: メソッド: put
パス: /network/v1/secrule/{name}

シェイプ

シェイプは、Compute ClassicでOCPUの数とインスタンスに割り当てられるメモリーの量を指定するリソース・プロファイルです。シェイプにより、インスタンスが使用するディスク・ドライブのタイプが決まります。汎用または高メモリーのシェイプを選択した場合、ハードディスク・ドライブが使用されます。高I/Oシェイプを選択した場合、NVM Expressソリッドステート・ドライブが使用されます。高I/Oシェイプによって、ルート・ディスクのサイズも決まります。

注意: 高I/Oシェイプは一部のサイトでは使用できません。

シェイプの詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「マシン・イメージとシェイプについて」を参照してください。

シェイプに関する詳細の取得: メソッド: get
パス: /shape/{name}
すべてのシェイプに関する詳細の取得: メソッド: get
パス: /shape/

スナップショット

インスタンス・スナップショットは、既存のインスタンスをテンプレートとして使用してカスタマイズされたマシン・イメージを簡単に作成するための手段です。このカスタマイズされたマシン・イメージを使用して、まったく同じ構成のインスタンスを複数作成できます。インスタンス・スナップショットを使用してインスタンスをクローニングするには、まず、適切なマシン・イメージを使用してインスタンスを作成します。このインスタンスでは、非永続ブート・ボリュームを使用する必要があります。インスタンスを削除すると、仮想マシン(VM)は停止および削除され、起動以降に実施したすべてのカスタマイズは破棄されます。起動後に実施したVMに対する変更を保持するには、インスタンスのスナップショットを作成し、変更したVMの新しいマシン・イメージを作成します。この新しいマシン・イメージをイメージ・リストに追加し、これを使用して新規インスタンスを作成します。

次にリストするHTTPリクエストを使用して、インスタンスのスナップショットを作成、削除および表示できます。

インスタンス・スナップショットの作成: メソッド: post
パス: /snapshot/
インスタンス・スナップショットの削除: メソッド: delete
パス: /snapshot/{name}
コンテナ内のすべてのインスタンス・スナップショットに関する詳細の取得: メソッド: get
パス: /snapshot/{container}/
インスタンス・スナップショットに関する詳細の取得: メソッド: get
パス: /snapshot/{name}
コンテナ内のすべてのインスタンス・スナップショットとサブコンテナの名前を取得: メソッド: get
パス: /snapshot/{container}
コンテナの名前の取得: メソッド: get
パス: /snapshot/

StorageAttachment

ストレージ・アタッチメントは、ストレージ・ボリュームとインスタンス間の関連付けです。ボリュームの関連付けは一度に1インスタンスずつです。ボリュームは、関連するストレージ・アタッチメントを削除することによってインスタンスからデタッチできます。

次のHTTPリクエストを使用して、ストレージ・アタッチメントを作成、削除および表示できます。

ストレージ・アタッチメントの作成: メソッド: post
パス: /storage/attachment/
ストレージ・アタッチメントの削除: メソッド: delete
パス: /storage/attachment/{name}
ストレージ・アタッチメントに関する詳細の取得: メソッド: get
パス: /storage/attachment/{name}
コンテナ内のすべてのストレージ・アタッチメントに関する詳細の取得: メソッド: get
パス: /storage/attachment/{container}/
コンテナ内のすべてのストレージ添付ファイルとサブコンテナの名前を取得: メソッド: get
パス: /storage/attachment/{container}
コンテナの名前の取得: メソッド: get
パス: /storage/attachment/

StorageProperty

ストレージ・プロパティは、ストレージ・プールの特性を説明し、ボリューム作成時にプール内のボリュームの配置を決定するために使用されます。

ストレージ・ボリュームを作成する際、ストレージ・プロパティを指定する必要があります。データベース・ファイルの格納など、低遅延と高IOPSを必要とするストレージ・ボリュームの場合は、/oracle/public/storage/latencyストレージ・プロパティを指定します。それ以外のストレージ・ボリュームの場合は、/oracle/public/storage/defaultを選択します。

次のHTTPリクエストを使用して、ストレージ・プロパティを表示できます。

ストレージ・プロパティに関する詳細の取得: メソッド: get
パス: /property/storage/{name}
コンテナ内のすべてのストレージ・プロパティに関する詳細の取得: メソッド: get
パス: /property/storage/{container}/
コンテナ内のすべてのストレージ・プロパティとサブコンテナの名前を取得: メソッド: get
パス: /property/storage/{container}
コンテナの名前の取得: メソッド: get
パス: /property/storage/

StorageSnapshot

ストレージ・ボリュームのスナップショットを作成すると、ストレージ・ボリュームに格納されているデータをすべて取得できます。スナップショットをバックアップとして保持したり、新しく同じストレージ・ボリュームを作成するために使用したりできます。

ストレージ・ボリュームの複数のスナップショットを取得する場合、各スナップショットで、ストレージ・ボリュームに格納されているすべてのデータが取得されます。コロケートまたはリモートのストレージ・ボリューム・スナップショットのどちらかを作成できます。

コロケート・スナップショット: スナップショットは、元のストレージ・ボリュームと同じ物理的な場所に格納され、各スナップショットで、元のボリュームと同じ量のストレージが使用されます。コロケート・スナップショット、およびコロケート・スナップショットからのボリュームは、非常に迅速に作成できます。コロケートされたスナップショットは、サイト内のストレージ・ボリュームを迅速にリストアする場合に便利です。ただし、コロケート・スナップショットを使用して複数サイトにわたりボリュームをリストアすることはできません。
リモート・スナップショット: スナップショットは、元のストレージ・ボリュームと同じ場所には格納されません。代わりに、それらは縮小され、関連するOracle Cloud Infrastructure Object Storage Classicインスタンスに格納されます。リモート・スナップショットは、ドメインが複数サイトにわたる場合に役立ちます。リモート・スナップショットでは、あるサイトでスナップショットを作成してから、別のサイトに切り替えてそのサイト上でストレージ・ボリュームのコピーを作成できます。ただし、リモート・スナップショットの作成とリモート・スナップショットからのストレージ・ボリュームのリストアには、データがOracle Cloud Infrastructure Object Storage Classicインスタンスとの間で書き込まれるため、ストレージ・ボリュームのサイズによってかなりの時間がかかります。

ストレージ・ボリューム・スナップショットの作成: メソッド: post
パス: /storage/snapshot/
ストレージ・ボリューム・スナップショットの削除: メソッド: delete
パス: /storage/snapshot/{name}
ストレージ・ボリューム・スナップショットの詳細の取得: メソッド: get
パス: /storage/snapshot/{name}
コンテナ内のすべてのストレージ・ボリューム・スナップショットの詳細の取得: メソッド: get
パス: /storage/snapshot/{container}/
コンテナ内のすべてのストレージ・ボリューム・スナップショットとサブコンテナの名前を取得: メソッド: get
パス: /storage/snapshot/{container}
コンテナの名前の取得: メソッド: get
パス: /storage/snapshot/

StorageVolume

ストレージ・ボリュームは、Compute Classicインスタンスのブロック・ストレージを提供する仮想ディスク・ドライブです。詳細は、「Oracle Cloud Infrastructure Compute Classicの使用」の「ストレージ・ボリュームについて」を参照してください。

次のHTTPリクエストを使用して、ストレージ・ボリュームを作成、削除、更新および表示できます。

ストレージ・ボリュームの作成: メソッド: post
パス: /storage/volume/
ストレージ・ボリュームの削除: メソッド: delete
パス: /storage/volume/{name}
ストレージ・ボリュームに関する詳細の取得: メソッド: get
パス: /storage/volume/{name}
コンテナ内のすべてのストレージ・ボリュームに関する詳細の取得: メソッド: get
パス: /storage/volume/{container}/
コンテナ内のすべてのストレージ・ボリュームとサブコンテナの名前を取得: メソッド: get
パス: /storage/volume/{container}
コンテナの名前の取得: メソッド: get
パス: /storage/volume/
ストレージ・ボリュームの更新: メソッド: put
パス: /storage/volume/{name}

VPNEndpointV2s

このAPIを使用して、Compute Classicサイトのデータ・センターとIPネットワーク間のVPN接続を設定します。これにより、データセンターとIPネットワークに追加されたインスタンス間の安全な通信チャネルが提供されます。 VPN接続を設定するには、「Oracle Cloud Infrastructure Compute Classicの使用」の「VPN接続を設定するためのワークフロー」を参照してください。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

VPNエンドポイントV2を作成: メソッド: post
パス: /vpnendpoint/v2/
VPNエンドポイントV2を削除: メソッド: delete
パス: /vpnendpoint/v2/{name}
VPNエンドポイントV2の詳細を取得: メソッド: get
パス: /vpnendpoint/v2/{name}
コンテナ内のすべてのVPNエンドポイントV2の詳細を取得: メソッド: get
パス: /vpnendpoint/v2/{container}/
VPNエンドポイントV2を更新: メソッド: put
パス: /vpnendpoint/v2/{name}

VPNEndpoint

データ・センターとCompute Classicサイト内のインスタンス間に安全なIPSecベースのトンネルを作成して、インスタンスに安全にアクセスできます。 vpnendpointオブジェクトは、Compute ClassicサイトへのVPNトンネルを表します。 Compute Classicサイトに最大20個のVPNトンネルを作成できます。 IPSec VPNトンネルを終了するVPNデバイスがあれば、任意のインターネット・サービス・プロバイダを使用してCompute Classicサイトにアクセスできます。

次のHTTPリクエストを使用して、VPNエンドポイントを作成、削除、更新および表示できます。

これらのエンドポイントは、Oracle Cloud Machineでは使用できません。

VPNエンドポイントの作成: メソッド: post
パス: /vpnendpoint/
VPNエンドポイントの削除: メソッド: delete
パス: /vpnendpoint/{name}
VPNエンドポイントに関する詳細の取得: メソッド: get
パス: /vpnendpoint/{name}
コンテナ内のすべてのVPNエンドポイントに関する詳細の取得: メソッド: get
パス: /vpnendpoint/{container}/
VPNエンドポイントの更新: メソッド: put
パス: /vpnendpoint/{name}

VirtualNICSet

仮想NICセットまたはvNICsetは1つ以上のvNICのコレクションです。 vNICsetは、ルートを作成するときに指定する必要があります。複数のvNICが含まれているvNICsetをルートに使用すると、ECMP (Equal Cost Multipath)のエニーキャスト・ルーティングが実装されます。そのルートによってルーティングされるトラフィックは、vNICsetのすべてのvNIC間で負荷分散されます。また、複数のvNICを持つvNICsetを使用すると、指定されたvNIC間のトラフィックで高可用性が実現されます。

仮想NICセットの作成: メソッド: post
パス: /network/v1/vnicset/
仮想NICセットの削除: メソッド: delete
パス: /network/v1/vnicset/{name}
仮想NICセットに関する詳細の取得: メソッド: get
パス: /network/v1/vnicset/{name}
コンテナ内のすべての仮想NICセットに関する詳細の取得: メソッド: get
パス: /network/v1/vnicset/{container}/
仮想NICセットの更新: メソッド: put
パス: /network/v1/vnicset/{name}

VirtualNIC

仮想NICまたはvNICは、インスタンスをネットワークに関連付けることができる仮想ネットワーク・インタフェース・カードです。オラクル社提供のイメージを使用して2016年9月中旬以降に作成されたインスタンスでは、8個のvNICがサポートされるため、各インスタンスを最大8個のネットワークに関連付けることができます。仮想NICは、オーケストレーションを使用してインスタンスを起動するときに作成され、インスタンスの各vNICが関連付けられるIPネットワークまたは共有ネットワークを指定するネットワーク属性に作成されます。詳細は、「Oracle Cloud Infrastructure Compute Classicの使用」の「インスタンス属性」を参照してください。

仮想NICに関する詳細の取得: メソッド: get
パス: /network/v1/vnic/{name}
コンテナ内のすべての仮想NICに関する詳細の取得: メソッド: get
パス: /network/v1/vnic/{container}/