機械翻訳について
  1. Compute Classic Oracle Cloud Infrastructure Compute Classic用REST API(IaaS)REST API
  2. クイック・スタート

クイック・スタート

以下のタスクを実行して、REST APIを使用して環境を設定し、最初のCompute Classicオブジェクトを作成します。 Oracle CloudおよびOracle Cloud Machine上のREST APIの使用には、特に明記しない限り、すべての文書が適用されます。

前提条件

前提条件 詳細情報
Oracle Cloudにアカウントを作成および構成します。 『Oracle Cloudスタート・ガイド』のOracle.comアカウントの取得に関する項を参照してください。
Compute Classicへの試用版または有料サブスクリプションを取得します。 「Oracle Cloud Infrastructure Compute Classicの使用」の「Compute Classicサブスクリプションの開始方法」を参照してください。

ステップ1: アカウント情報の取得

Oracleからのアカウント作成メールには、Compute Classicインスタンスのユーザー名とパスワードが含まれています。

この情報がない場合は、サービス管理者に連絡してください。

使用しているクラウド・アカウントのタイプを特定: 「従来のクラウド・アカウント」(Cloud Serviceアカウントとも呼ばれます)またはIdentity Cloud Service(IDCS)を使用したクラウド・アカウント。 「Oracle Cloudの管理とモニタリング」の「Oracle Cloudアカウントのタイプ」を参照してください。

注意:

Oracle Cloud MachineはIdentity Cloud Service(IDCS)でクラウド・アカウントのみをサポートしています。

ステップ2: REST API呼び出しの2部構成のユーザー名を識別

「認証」を参照してください。

注意:

このドキュメントのすべての例では、2つの部分からなるユーザー名として/Compute-acme/jack.jones@example.comを使用しています。 IDCSのクラウド・アカウントを使用している場合は、2部構成のユーザー名のacmeをサービス・インスタンスIDに置き換えます。

ステップ3: 割り当てられている必要なロールを取得

アカウント管理者に連絡して、Oracle Cloud My Servicesのユーザー名に対して必要なロールの割当を受けてください。

  • Compute Classicオブジェクトを作成、更新、および削除するには、Compute_Operationsロールが必要です。

  • オブジェクトの詳細を表示または取得するには、Compute_MonitorまたはCompute_Operationsのロールが必要です。

詳細については、「Oracle Cloud Infrastructure Compute Classicの使用」の「Compute Classicのロールについて」を参照してください。

必要なロールが割り当てられていない、または割当てが不明な場合は、システム管理者に連絡してロールがユーザーにOracle Cloud My Servicesで割り当てられるようにしてください。 「Oracle Cloudの管理とモニタリング」の「ユーザー・ロールの変更」を参照してください。

ステップ4: cURLのインストール

REST APIは、ハイパーテキスト転送プロトコル(HTTP)を正しく完全に理解し、インターネットに接続している任意のアプリケーションまたはプログラミング・プラットフォームからアクセスできます。 REST APIでは、HTTPSを介したセキュアな通信、HTTPヘッダー、特殊なHTTP動詞(PUTやDELETE)などのHTTPの高度なファセットを使用します。

cURLは、HTTPリクエストの送信によってREST APIコールの起動に使用できるコマンドライン・ツールです。 このドキュメントの例では、cURLコマンドライン・ツールを使用してCompute Classic REST APIにアクセスする方法を示します。

通常、cURLは多くのUNIX系ホストでデフォルトで使用可能です。 WindowsへのcURLのインストールの詳細は、チュートリアルWindowsでのCygwinへのcURLのインストールを参照してください。

注意:

特定のWebブラウザを使用してREST API呼び出しを送信することもできます。 サポートはベンダーにより異なります。 完全サポートするにはブラウザ・プラグインが必要な場合があります。

多くのプログラミング・プラットフォーム(Java、Ruby、Perl、PHP、.NETなど)もこれらの要件を満たしますが、完全サポートするにはサード・パーティのライブラリの使用が必要な場合もあります。 ガイダンスは、プログラミング・プラットフォームのドキュメントを参照してください。

詳細は、次を参照してください。

ステップ5: リソースURLの形式を理解し、REST APIエンドポイントを特定

リクエストの送信を参照してください。

これで、Compute ClassicのREST APIとの対話を開始する準備が整いました。

ステップ6: 認証Cookieの取得

  1. 次のcURLコマンドの例に示すように、Compute Classicから認証Cookieを取得します:

    curl -i -X POST
     -H "Content-Type: application/oracle-compute-v3+json"
     -d '{"user":"/Compute-acme/jack.jones@example.com","password":"ft7)Dvjo"}'
        https://api-z999.compute.us0.oraclecloud.com/authenticate/

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

  2. 次の例に示すように、POSTリクエストに対するレスポンスで、Set-Cookieヘッダーを探します。 

    Set-Cookie: nimbula=eyJpZGVudGl0eSI6ICJ7XCJyZWFsbVwiOiBcImNvbXB1dGUtdXM2LXoyOFwiLCBcInZhbHVlXCI6IFwie1xcXCJjdXN0b21lclxcXCI6IFxcXCJDb21wdXRlLWFjbWVjY3NcXFwiLCBcXFwicmVhbG1cXFwiOiBcXFwiY29tcHV0ZS11czYtejI4XFxcIiwgXFxcImVudGl0eV90eXBlXFxcIjogXFxcInVzZXJcXFwiLCBcXFwic2Vzc2lvbl9leHBpcmVzXFxcIjogMTQ2MDQ4NjA5Mi44MDM1NiwgXFxcImV4cGlyZXNcXFwiOiAxNDYwNDc3MDkyLjgwMzU5MiwgXFxcInVzZXJcXFwiOiBcXFwiL0NvbXB1dGUtYWNtZWNjcy9zeWxhamEua2FubmFuQG9yYWNsZS5jb21cXFwiLCBcXFwiZ3JvdXBzXFxcIjogW1xcXCIvQ29tcHV0ZS1hY21lY2NzL0NvbXB1dGUuQ29tcHV0ZV9PcGVyYXRpb25zXFxcIiwgXFxcIi9Db21wdXRlLWFjbWVjY3MvQ29tcHV0ZS5Db21wdXRlX01vbml0b3JcXFwiXX1cIiwgXCJzaWduYXR1cmVcIjogXCJRT0xaeUZZdU54SmdjL3FuSk16MDRnNmRWVng2blY5S0JpYm5zeFNCWXJXcVVJVGZmMkZtdjhoTytaVnZwQVdURGpwczRNMHZTc2RocWw3QmM0VGJpSmhFTWVyNFBjVVgvb05qd2VpaUcyaStBeDBPWmc3SDJFSjRITWQ0S1V3eTl6NlYzRHd4eUhwTjdqM0w0eEFUTDUyeVpVQWVQK1diMkdzU1pjMmpTaHZyNi9ibU1CZ1Nyd2M4MUdxdURBMFN6d044V2VneUF1YVk5QTUxZmxaanJBMGVvVUJudmZ6NGxCUVVIZXloYyt0SXZVaDdUcGU2RGwxd3RSeFNGVVlQR0FEQk9xMExGaVd1QlpaU0FTZVcwOHBZcEZ2a2lOZXdPdU9LaU93dFc3VkFtZ3VHT0E1Yk1ibzYvMm5oZEhTWHJhYmtsY000UVE1LzZUMDJlZUpTYVE9PVwifSJ9; Path=/; Max-Age=1800

    Set-Cookieヘッダーおよび値は、単一の行になる点に注意してください。 この例では読みやすくするために改行が使用されています。

  3. 次のLinuxホストの場合の例に示すように、認証cookieを環境変数に格納します。

    コマンド全体は、単一の行になる点に注意してください。 この例では読みやすくするために改行が使用されています。 

    export COMPUTE_COOKIE='nimbula=eyJpZGVudGl0eSI6ICJ7XCJyZWFsbVwiOiBcImNvbXB1dGUtdXM2LXoyOFwiLCBcInZhbHVlXCI6IFwie1xcXCJjdXN0b21lclxcXCI6IFxcXCJDb21wdXRlLWFjbWVjY3NcXFwiLCBcXFwicmVhbG1cXFwiOiBcXFwiY29tcHV0ZS11czYtejI4XFxcIiwgXFxcImVudGl0eV90eXBlXFxcIjogXFxcInVzZXJcXFwiLCBcXFwic2Vzc2lvbl9leHBpcmVzXFxcIjogMTQ2MDQ4NjA5Mi44MDM1NiwgXFxcImV4cGlyZXNcXFwiOiAxNDYwNDc3MDkyLjgwMzU5MiwgXFxcInVzZXJcXFwiOiBcXFwiL0NvbXB1dGUtYWNtZWNjcy9zeWxhamEua2FubmFuQG9yYWNsZS5jb21cXFwiLCBcXFwiZ3JvdXBzXFxcIjogW1xcXCIvQ29tcHV0ZS1hY21lY2NzL0NvbXB1dGUuQ29tcHV0ZV9PcGVyYXRpb25zXFxcIiwgXFxcIi9Db21wdXRlLWFjbWVjY3MvQ29tcHV0ZS5Db21wdXRlX01vbml0b3JcXFwiXX1cIiwgXCJzaWduYXR1cmVcIjogXCJRT0xaeUZZdU54SmdjL3FuSk16MDRnNmRWVng2blY5S0JpYm5zeFNCWXJXcVVJVGZmMkZtdjhoTytaVnZwQVdURGpwczRNMHZTc2RocWw3QmM0VGJpSmhFTWVyNFBjVVgvb05qd2VpaUcyaStBeDBPWmc3SDJFSjRITWQ0S1V3eTl6NlYzRHd4eUhwTjdqM0w0eEFUTDUyeVpVQWVQK1diMkdzU1pjMmpTaHZyNi9ibU1CZ1Nyd2M4MUdxdURBMFN6d044V2VneUF1YVk5QTUxZmxaanJBMGVvVUJudmZ6NGxCUVVIZXloYyt0SXZVaDdUcGU2RGwxd3RSeFNGVVlQR0FEQk9xMExGaVd1QlpaU0FTZVcwOHBZcEZ2a2lOZXdPdU9LaU93dFc3VkFtZ3VHT0E1Yk1ibzYvMm5oZEhTWHJhYmtsY000UVE1LzZUMDJlZUpTYVE9PVwifSJ9; Path=/; Max-Age=1800'

ステップ7: (オプション) 最初のストレージ・ボリュームの作成

認証Cookieを取得した後、Compute Classicオブジェクトに対して操作を実行できます。 次の例では、次のcURLコマンド例で示すように、POST /storage/volume/リクエストを送信することでストレージ・ボリュームを作成する方法を示します。

コマンド全体は、単一の行になる点に注意してください。 この例では読みやすくするために改行が使用されています。 

curl -X POST 
     -H "Cookie: $COMPUTE_COOKIE" 
     -H "Content-Type: application/oracle-compute-v3+json" 
     -d '{"size": "10G", 
          "properties": ["/oracle/public/storage/default"], 
          "name": "/Compute-acme/jack.jones@example.com/myVolume"}' 
     https://api-z999.compute.us0.oraclecloud.com/storage/volume/

COMPUTE_COOKIEは、前の手順で認証cookieを格納した変数の名前です。

レスポンス内の「status」フィールドに「initializing」が表示されます。

ステップ8: 最初のストレージ・ボリュームの詳細の確認

次のcURLコマンド例に示すように、GET /storage/volume/{name}リクエストを送信して、ボリュームが作成されたかどうか確認します。

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

curl -X GET 
     -H "Cookie: $COMPUTE_COOKIE" 
     https://api-z999.compute.us0.oraclecloud.com/storage/volume/Compute-acme/jack.jones@example.com/myVolume

ボリュームが作成されると、レスポンス内の「status」フィールドに「online」が表示されます。