計算ノードの停止、起動または再起動
post
/paas/service/dbcs/api/v1.1/instances/{identityDomainId}/{serviceId}
Exadata Cloud Machineデータベース・デプロイメントに関連付けられたコンピュート・ノードを停止、開始、または再起動します。 これらの操作は、コンピュート・ノードで実行されているすべてのデータベースに影響を与えます。
リクエスト
サポートされるメディア・タイプ
- application/vnd.com.oracle.oracloud.provisioning.Service+json
パス・パラメータ
- identityDomainId
-
型:
string
必須:true
Exadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。- serviceId
型:string
必須:true
処理するコンピュート・ノードを使用するExadata Cloud Machineデータベース・デプロイメントの名前。
ヘッダー・パラメータ
- Authorization
-
型:
string
必須:true
リクエストをしているユーザーのユーザー名とパスワードのBase64エンコーディング。 詳細は、セキュリティ、認証および認可を参照してください。- X-ID-TENANT-NAME
型:string
必須:true
Exadata Cloud Machine環境を格納するアイデンティティ・ドメインの名前。 詳細は、「セキュリティ、認証、認可」を参照してください。
本文パラメータ
リクエスト本文は、計算ノード・ライフサイクル・リクエストの詳細を定義します。 太字は必須の値を示します。
ルート・スキーマ : stopstart-postrequest
リクエスト本文は、計算ノード・ライフサイクル・リクエストの詳細を定義します。 太字は必須の値を示します。
- lifecycleState
-
型:
string
実行中の操作。stop
- 稼働している計算ノードを停止します。start
- 停止している計算ノードを起動します。restart
- 稼働している計算ノードを再起動します。
- lifecycleTimeout
-
型:
string
リクエストの操作タイムアウト。
有効な値の範囲は、
1
から300
分です。デフォルトは
60
分です。 - vmName
-
型:
string
対象の計算ノードの名前。
レスポンス
202 Response
Accepted. 返される可能性のあるその他のHTTPステータス・コードの詳細は、「ステータス・コード」を参照してください。
Locationヘッダーは、操作のステータスにアクセスする際に使用できるREST URIを返します(操作のステータスの表示を参照)。
例
次の例は、cURLを使用してRESTエンドポイントにPOSTリクエストを送信することによって、Exadata Cloud Machineインスタンスに関連付けられたコンピュート・ノードを停止する方法を示しています。
この例では、アイデンティティ・ドメインはusexampleで、Oracle Cloudユーザー名およびパスワードはserviceadminおよびPa55_wordです。 実行されているExadata Cloud Machineデータベース・インスタンスの名前はdb11gで、停止するコンピュート・ノードの名前はnode02.us2.oraclecloud.comです。
cURLコマンド
次のcURLコマンドでは、リクエスト本文を--dataオプションで直接指定しています。
curl --include --method POST \ --cacert ~/cacert.pem \ --user serviceadmin:Pa55_word \ --header "X-ID-TENANT-NAME:usexample" \ --header "Content-Type:application/json" \ --data '{ "lifecycleState" : "stop", "vmName" : "node02.us2.oraclecloud.com" }' \ https://dbaas.oraclecloud.com/paas/service/dbcs/api/v1.1/instances/usexample/db11g
HTTPステータス・コードおよびレスポンス・ヘッダー
HTTP/1.1 202 Accepted Server: Oracle-Application-Server-11g Location: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/status/control/job/6569711 X-ORACLE-DMS-ECID: id-string X-ORACLE-DMS-ECID: id-string X-Frame-Options: DENY Service-URI: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/db11g Vary: Accept-Encoding,User-Agent Retry-After: 60 Content-Language: en Content-Encoding: gzip Content-Length: 20 Content-Type: application/json Date: date-and-time Connection: keep-alive