バックアップの削除(非同期)
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/deletedbackups
注意: 従来のパス/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/deletedbackupsは推奨されていませんが、近いうちに引き続きサポートされます。 ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。
リクエスト
- application/json
- identityDomainId
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- serviceId
型:string
必須:true
Oracle Java Cloud Serviceインスタンスの名前。
- X-ID-TENANT-NAME
-
型:
string
必須:true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- backupId
-
型:
string
削除するバックアップのID。 バックアップIDを取得する方法については、すべてのバックアップの表示を参照してください。 - backupIdList
-
型:
array
backupIdList削除するバックアップIDのリスト。 バックアップIDを取得する方法については、すべてのバックアップの表示を参照してください。 リストに全体バックアップのIDがある場合は、関連する(削除されていない)増分バックアップもそのリストに含まれている必要があります。 バックアップの表示の説明に従って、?includeLinkedDetails
問合せパラメータを使用してそのバックアップの関連バックアップを取得します。
array
?includeLinkedDetails
問合せパラメータを使用してそのバックアップの関連バックアップを取得します。 -
型:
string
レスポンス
- application/json
- job_id
-
型:
string
バックアップ削除(非同期)操作のジョブID。 - operationName
-
型:
string
実行した操作の名前。delete-backup
、またはリストを削除する場合はdelete-backups
に設定します。 - target_uri
-
型:
string
バックアップ削除(非同期)リソースのURI。
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによってOracle Java Cloud Serviceインスタンスのバックアップを非同期的に削除する方法を示しています。
注意: この例のコマンドでは、URL構造https://rest_server_url/resource-pathが使用されています。ここで、rest_server_urlはアイデンティティ・ドメインまたはテナント名を問い合せるためのOracle Public CloudまたはOracle Cloud MachineのRESTサーバーです。 Oracle Public CloudまたはOracle Cloud Machineに使用する適切なURL構造の詳細は、リクエストの送信を参照してください。
cURLコマンド
curl -i -X POST -u username:userPassword1! --data @delete.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/deletedbackups
リクエスト本文の例
backupIdで単一のバックアップIDを使用する、JSON形式のリクエスト・ドキュメントの例を次に示します。
{ "backupId": "1449597929855" }
backupIdListでバックアップIDの配列を使用する、JSON形式のリクエスト・ドキュメントの例を次に示します。
{ "backupIdList":[ "1449418500036", "1449504900028", "1449591300044" ] }
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 202 Accepted Date: Tue, 08 Dec 2015 18:19:52 GMT Transfer-Encoding: chunked Content-Type: application/json
レスポンス本文の例
次の例では、backupIdを使用したリクエストに対して、JSON形式で返されたレスポンスを示しています。
{ "operationName":"delete-backup", "target_uri":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/deletedbackups\/8376", "job_id":"8376" }