機械翻訳について
  1. Compute Classic Oracle Cloud Infrastructure Compute Classic用REST API(IaaS)REST API
  2. 認証

認証

Compute ClassicへのAPI呼び出しでは、基本認証(ユーザー名とパスワード)が必要です。 ユーザー名とパスワードをすべてのAPIコールに渡すか、有効な認証トークンを渡すことができます。 有効な認証トークンを取得するには、ユーザー資格証明を認証するためのHTTPリクエストを送信します。 認証リクエストに成功した場合、サーバーは30分間有効になる認証トークンを含んだcookieを返します。 APIコールを発行するクライアントは、このcookieをAPIコールに含める必要があります。

認証トークンをリクエストして、その認証トークンを環境変数に格納するには:

  1. Compute Classicインスタンスのユーザー名とパスワード(大文字と小文字が区別されます)を書き留めておいてください。 Oracleからのアカウント作成メールには、この情報が含まれています。 この情報がない場合は、サービス管理者に連絡してください。

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

    注意:

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

    • Compute Classicインスタンスのユーザー名とパスワードは、大文字と小文字が区別されます。

  3. REST APIを呼び出すときは、2つの部分からなるユーザー名を渡す必要があります。 次のいずれかの方法で、2つの部分からなるユーザー名を指定します。

    • 従来のクラウド・アカウントを使用している場合、またはアカウント作成電子メールに次の例に示すアイデンティティ・ドメインに関する情報が含まれている場合、2部構成のユーザー名には次の形式を使用する必要があります:

      /Compute-identityDomainName/username

      Oracleからのアカウント作成電子メールには、アイデンティティ・ドメインの名前、ユーザー名およびパスワードが含まれています。

      たとえば、アイデンティティ・ドメインがacmeで、アカウント作成電子メールのusernameがjack.jones@example.comの場合、REST API呼び出しには次の2つの部分からなるユーザー名を使用します:

      /Compute-acme/jack.jones@example.com

    • Identity Cloud Service(IDCS)でクラウド・アカウントを使用している場合、またはアカウント作成電子メールにアイデンティティ・ドメインに関する情報が含まれていない場合、2部構成のユーザー名には次の形式を使用する必要があります:

      /Compute-serviceInstanceID/username

      Compute Classicインスタンスのサービス・インスタンスIDを取得するには:

      1. Oracle Cloud My Servicesアプリケーションにサインインします。 「Oracle Cloudスタート・ガイド」の「あなたのクラウド・アカウントにサインイン」を参照してください。

        「Oracle Cloud My Services Dashboard」ページが表示されます。 あなたのアカウントに割り当てられているサービスを一覧表示します。

      2. Computeサービスのタイルで、「コンピュート」をクリックします。 Compute Classicの「サービスの詳細」ページが表示されます。

      3. 追加情報の下に、「サービス・インスタンスID」を書き留めます。

      たとえば、サービス・インスタンスIDが575260584で、アカウント作成メールのusernameがjack.jones@example.comの場合、REST API呼び出しには次の2つの部分からなるユーザー名を使用します:

      /Compute-575260584/jack.jones@example.com

    注意:

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

  4. 次の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/

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

    • acmeおよびjack.jones@example.comは値の例です。 acmeをCompute Classicアカウントのアイデンティティ・ドメインIDに置き換え、jack.jones@example.comをユーザー名で置き換えます。

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

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

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

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

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

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

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

認証Cookieを取得した後、Compute Classicオブジェクトに対して操作を実行できます。