サービス・インスタンスの削除
put
/api/v1.1/instances/{identityId}/{serviceId}
サービス・インスタンスを削除します。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- identityId
-
タイプ:
string
必須:true
Oracle Cloud Serviceアカウントのアイデンティティ・ドメインの名前。- serviceId
タイプ:string
必須:true
サービス・インスタンスのID。
本文のパラメータ
リクエスト本文では、サービス・インスタンス削除リクエストの詳細を定義します。 太字は必須の値を示します。
ルート・スキーマ: InstanceDelete-putrequest
リクエスト本文では、サービス・インスタンス削除リクエストの詳細を定義します。 太字は必須の値を示します。
- dbaName
-
タイプ:
string
必須:true
Oracle Database Cloud - Database as a Serviceインスタンス管理者のユーザー名。 - dbaPassword
-
タイプ:
string
必須:true
Oracle Database Cloud - Database as a Service管理者のパスワード。 - forceDelete
-
タイプ:
boolean
データベース・スキーマを削除するためにデータベース・インスタンスにアクセスできなくても、サービス・インスタンスの削除を強制するかどうかを指定するフラグ。true
に設定されている場合、データベース・インスタンス上の関連するデータベース・スキーマ(サービス・インスタンスの削除操作で削除されていない場合)を手動で削除する必要があります。 この値のデフォルトはfalse
です。 - skipBackupOnTerminate
-
タイプ:
boolean
サービス・インスタンスを削除する前のバックアップの作成をスキップするかどうかを指定するフラグ。 この値のデフォルトはtrueです。
レスポンス
サポートされるメディア・タイプ
- application/json
- text/plain
- text/html
202レスポンス
成功
本文
レスポンス本文には、削除操作に関する情報が含まれます。
ルート・スキーマ: InstanceDelete-response
レスポンス本文には、削除操作に関する情報が含まれます。
- auto-update
-
タイプ:
string
メンテナンス・ウィンドウ中にOracle Cloud Toolsの更新がOracle SOA Cloud Serviceインスタンスに対して自動的に適用されるかどうかを指定するフラグ。 Oracle Cloud Toolsは、サービス・インスタンスのライフサイクルの管理に使用されます。 - compliance_status
-
タイプ:
string
Oracle Cloud Toolsのバージョンがコンプライアンスに準拠していないかどうかを示すステータス。 Oracle Cloud Toolsを使用して、サービス・インスタンスのライフサイクルを管理します。 Oracle Cloud Toolsがコンプライアンスに準拠していない場合、この属性は次のステータス値のいずれかに設定されます。NEW_VERSION
: 新しいバージョンのOracle Cloud Toolsが使用できることを示します。 できるだけすぐにこの更新を適用することをお薦めします。DEPRECATED
: 現行バージョンのOracle Cloud Toolsが非推奨であることを示します。 最新のOracle Cloud Tools更新を適用して、将来的にサービスが中断されないようにしてください。UNSUPPORTED
: 現行バージョンのOracle Cloud Toolsがサポートされていないことを示します。 最新のパッチを適用して通常の操作を再開してください。
Oracle Cloud Toolsが最新の場合、この属性は空白です。
- compliance_status_desc
-
タイプ:
string
Oracle Cloud Toolsのコンプライアンス・ステータスに関する詳細を示す説明で、Oracle SOA Cloud Serviceインスタンスのライフサイクルの管理に使用されます。 サービス・インスタンスがコンプライアンスに準拠していない場合、この属性はステータス値(Oracle Cloud Toolsがコンプライアンスに準拠していない場合、この属性は次のいずれかのステータス値に設定されます)に基づいて、次のいずれかの説明に設定されます。NEW_VERSION
: Oracleツール[latestVersion
]の新しいバージョンを使用できます。 この更新には、Oracle Cloud Toolsの重要な修正が含まれます。 クラウド・ツールを使用して、サービスのライフサイクルを管理します。 お客様はできるだけすぐにこの更新を適用することをお薦めします。DEPRECATED
: Oracleツール・バージョン[deprecatedVersion
]が非推奨であるため、このサービスは現在非推奨の状態です。 このバージョンは今後サポートされない可能性があるため、最新のOracleツール更新を適用してください。UNSUPPORTED
: Oracleツール・バージョン[unsupportedVersion
]が不要であるため、このサービスは現在サポートされていない状態です。 最新のパッチを適用して通常の操作を再開してください。
Oracle Cloud Toolsが最新の場合、この属性は空白です。
- created_by
-
タイプ:
string
Oracle SOA Cloud Serviceインスタンスの作成に使用されるアカウントの名前。 - creation_time
-
タイプ:
string
Oracle SOA Cloud Serviceインスタンスの作成日時。 - description
-
タイプ:
string
サービス・インスタンスに関する追加情報を提供する自由形式のテキスト。 - error_status_desc
-
タイプ:
string
Oracle SOA Cloud Serviceインスタンスがエラー状態にある理由を説明するエラー・ステータス。 次に、説明の例を示します。This service is currently in an erroneous state as the tools are in an inconsistent state. Reason - error details. Apply the latest tools patch to resume normal operations on this service.
- identity_domain
-
タイプ:
string
アイデンティティ・ドメイン名。 - last_modified_time
-
タイプ:
string
Oracle SOA Cloud Serviceインスタンスの最終更新日時。 - service_name
-
タイプ:
string
Oracle SOA Cloud Serviceインスタンスの名前。 - service_url
-
タイプ:
string
Oracle SOA Cloud ServiceインスタンスのリソースURL。 - status
-
タイプ:
string
削除操作がリクエストされたときのOracle SOA Cloud Serviceインスタンスのステータスを示すフラグ。 有効な値:Running
、In Progress
、Terminating
およびFailed
。 - version
-
タイプ:
string
Oracle Fusion Middlewareソフトウェアのバージョン。 有効な値:12cR3
および11g
。 - wlsVersion
-
タイプ:
string
Oracle WebLogic Serverソフトウェアのバージョン。 有効な値は、12.1.3.0.4
および10.3.6.0.9
です。
例
次の例では、cURLを使用してRESTリソースに対するPUTリクエストを発行することによってOracle SOA Cloud Serviceインスタンスを削除する方法を示しています。 詳細は、「cURLの使用」を参照してください。
Oracle SOA Cloud Serviceインスタンスの削除に関する項も参照してください。
cURLコマンド
curl -i -X PUT -u joe@example.com:Welcome1! -d @delete.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance
注意:: この例では、アメリカ合衆国でのURL接頭辞(soacs)を使用しています。 世界の他の地域のURL接頭辞の詳細は、「リクエストの送信」を参照してください。
リクエスト本文の例
JSON形式のリクエスト本文の例を次に示します。
{ "dbaName": "SYS", "dbaPassword": "Weblogic123#", "forceDelete": true }
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
Locationヘッダーは、サービス・インスタンス削除リクエストのステータスにアクセスする際に使用できるRESTリソースを返します。 詳細は、「サービスのプロビジョニング・ステータスの取得」を参照してください。
HTTP/1.1 202 Accepted Date: Wed, 24 Jun 2015 19:52:03 GMT Server: Oracle-Application-Server-11g Location: https://api-host/paas/service/soa/api/v1.1/instances/ExampleInstance/status/delete/job/100900
レスポンス本文の例
JSON形式のレスポンス本文の例を次に示します。
{ "service_name":"ExampleInstance", "version":"12cR3", "wlsVersion":"12.1.3.0.4", "status":"Terminating", "error_status_desc": "", "compliance_status": "", "compliance_status_desc": "", "auto_update" : "true", "description":"An example service instance", "identity_domain":"ExcapleIdentityDomain", "creation_time":"Mon Aug 18 20:22:54 GMT 2014", "last_modified_time":"Mon Aug 18 20:22:54 GMT 2014", "created_by":"joe@example.com", "service_uri":"https:\/\/api-host\/paas\/service\/soa\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance" }