Oracle Java Cloud Service REST API

最初のインスタンスの作成

サービス・インスタンスの詳細を定義するリクエスト・ドキュメントを作成すると、最初のOracle Java Cloud Serviceインスタンスを作成する準備ができます。

最初のインスタンスを作成するには、cURLコマンドラインで次の情報を渡します。

リクエストを定義するには、次の手順を実行します。
- --dataオプションを使用して、前のタスク「リクエスト・ドキュメントの作成」で作成したcreate.jsonファイルを渡します。
- -H cURLオプションを使用して、リクエスト・ドキュメントのコンテンツ・タイプをapplication/vnd.com.oracle.oracloud.provisioning.Service+jsonとして定義するContent-Typeヘッダーを渡します。
認証のために、次に示すように、「アカウント情報の取得」の説明に従って前に取得したアカウント資格証明をcURLコマンドラインで指定する必要があります。
- -u cURLオプションを使用して、Oracle Java Cloud Serviceアカウントのユーザー名とパスワードを渡します
- Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)またはテナント名(Oracle Cloud Machine)を指定するために、-H cURLオプションを使用してX-ID-TENANT-NAMEカスタム・リクエスト・ヘッダーを渡します。

例:

C:> curl -i -X POST -u yourUserName:yourPassword --data @create.json -H Content-Type:application/vnd.com.oracle.oracloud.provisioning.Service+json -H X-ID-TENANT-NAME:yourIdentityDomain https://rest_server_url/paas/service/jcs/api/v1.1/instances/yourIdentityDomain

注意: この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。

返されるレスポンス・ヘッダーの例を次に示します。

HTTP/1.1 100 Continue

HTTP/1.1 202 Accepted
Date: Thu, 14 Jul 2016 23:16:53 GMT
Location: https://rest_server_url/paas/service/jcs/api/v1.1/instances/yourIdentityDomain/status/create/job/8466
Content-Length: 0
Content-Type: application/vnd.com.oracle.oracloud.provisioning.Service+json
Service-URI: https://rest_server_url/paas/service/jcs/api/v1.1/instances/yourIdentityDomain/MyFirstInstance

インスタンス作成プロセスは、完了までに数分かかります。上のLocationヘッダーで返されたエンドポイントを使用して、作成操作のステータスを確認できます。例:

C:> curl -i -X GET -u yourUserName:yourPassword -H X-ID-TENANT-NAME:yourIdentityDomain https://rest_server_url/paas/service/jcs/api/v1.1/instances/yourIdentityDomain/status/create/job/8466

レスポンス出力の例を次に示します。表示されているステータスはIn Progressです。サービス・インスタンスが正常に作成および構成された場合、ステータスはRunningとなります。

{
    "service_name": "MyFirstInstance",
    "version": "12cR3",
    "wlsVersion": "12.1.3.0.xxxxxx",
    "status": "In Progress",
    "error_status_desc": "",
    "compliance_status": "",
    "compliance_status_desc": "",
    "auto_update": "true",
    "description": "My first instance using the REST API.",
    "identity_domain": "yourIdentityDomain",
    "creation_time": "Thu Jul 14 23:16:58 UTC 2016",
    "last_modified_time": "Thu Jul 14 23:16:56 UTC 2016",
    "created_by": "yourUserName",
    "service_uri": "https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/yourIdentityDomain\/MyFirstInstance",
    "message": [
        "Created Compute resources for WebLogic Server...",
        "Created security resources for the service...",
        "Starting Compute resources..."
    ]
}