すべての削除されたバックアップの表示
/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/deletedbackups
Oracle Public Cloudでのバックアップの内容、バックアップが格納される場所、およびバックアップとバックアップのローカル・コピーがどのように自動的に削除されるかの詳細は、『Oracle Java Cloud Serviceの使用』のOracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください。 Oracle Cloud Machineの場合、OPCMでのOracle Java Cloud Serviceの使用のOracle Java Cloud Serviceインスタンスのバックアップおよびリストアに関する項を参照してください。
注意: 従来のパス/paas/service/jcs/api/v1.1/instances/{identityDomainId}/{serviceId}/deletedbackupsは推奨されていませんが、近いうちに引き続きサポートされます。 ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。
リクエスト
- identityDomainId
-
型:
string必須:trueOracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
- serviceId
型:string必須:trueOracle Java Cloud Serviceインスタンスの名前。
- X-ID-TENANT-NAME
-
型:
string必須:trueOracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。
レスポンス
- deletedbackups
-
型:
arraydeletedbackups削除されたバックアップをすべてグループ化します。
- backupId
-
型:
stringバックアップID。 - backupStartDate
-
型:
stringバックアップを開始した日時。 - databaseIncluded
-
型:
booleanOracle Java Cloud Serviceインスタンスのバックアップ操作の一部としてデータベース・バックアップが開始されたかどうかを指定するフラグ。 この属性は、Oracle Public Cloudにのみ適用されます。falseの場合、データベース・バックアップは実行されていません。trueの場合、データベース・バックアップが実行されています。Oracle Cloud Machineでは、この値は常に
falseです。 - dbTag
-
型:
stringRMANタグまたはタイムスタンプ。 この属性は、Oracle Public Cloudにのみ適用されます。この属性は、Oracle Java Cloud Serviceインスタンスのバックアップの一部としてデータベース・バックアップが開始された場合のみ含まれます。 関連するDatabase Cloud Serviceデータベース・デプロイメントが単一インスタンス・データベースをホスティングしている場合、この属性値は特定のデータベース・ファイルがバックアップされていることを示すRMANタグになります。 関連するDatabase Cloud Serviceデータベース・デプロイメントがOracle Real Application Clusters (RAC)データベースをホスティングしている場合、この属性値はデータベース・バックアップのタイムスタンプになります。
- deletedOnDate
-
型:
stringバックアップの削除が完了した日時。 - expirationDate
-
型:
stringバックアップがストレージから自動的に削除される日時。 値がnullの場合、バックアップは無期限に保存されるか、手動で削除するまで保存されます。 (オンデマンド・バックアップのkeepForeverがtrueに設定されている場合、値はnullです。) - full
-
型:
booleanこれが全体(true)バックアップか増分(false)バックアップかを指定するフラグ。 - href
-
型:
stringバックアップ・リソースのURI。 - initiatedBy
-
型:
stringこの操作を開始したユーザー・アカウント。 スケジュール済の自動操作の場合、値はscheduledです。 - jobId
-
型:
stringバックアップ削除操作のジョブID。 - ローカル
-
型:
booleanバックアップが、ダウンロードされて管理サーバーのブロック・ストレージにローカルに格納される(true)か、アーカイブされてリモートに格納される(false)かを示すフラグ。Oracle Public Cloudでは、リモート・ストレージは指定されたOracle Storage Cloud Serviceコンテナです。
Oracle Cloud Machineでは、リモート・ストレージは指定されたNFSストレージ・ディスクです。
- localCopy
-
型:
booleanリモート・ストレージにアップロードされたバックアップ用にバックアップのローカル・コピーが保持されるかどうかを示すフラグ。Oracle Public Cloudでは、リモート・ストレージは指定されたOracle Storage Cloud Serviceコンテナです。
Oracle Cloud Machineでは、リモート・ストレージは指定されたNFSストレージ・ディスクです。
- notes
-
型:
stringバックアップに関する追加情報を提供する、自由形式のテキスト。 - size
-
型:
stringバックアップのサイズ(MB)。 - sizeInBytes
-
型:
integerバックアップのバイト単位のサイズ。 - status
-
型:
stringバックアップの状態。 有効な値はDeletedです。 - storageContainer
-
型:
stringこの属性はOracle Public Cloudでのみ使用できます。サービス・インスタンスのバックアップが格納される場所。
例
次の例では、cURLを使用してRESTリソースに対するGETリクエストを発行することによって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 GET -u username:userPassword1! -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
レスポンス・ヘッダーの例
レスポンス・ヘッダーの例を次に示します。
HTTP/1.1 200 OK Date: Sat, 12 Dec 2015 01:50:11 GMT Transfer-Encoding: chunked Content-Type: application/json
レスポンス本文の例(Oracle Public Cloud)
次の例では、JSON形式で返されるレスポンスを示しています。
{
"deletedbackups":[
{
"backupId":"1444395600241",
"jobId":"300748",
"backupStartDate":"Fri Oct 09 13:00:00 GMT 2015",
"expirationDate":"Sat Nov 14 13:00:00 GMT 2015",
"deletedOnDate":"Mon Nov 16 13:21:23 GMT 2015",
"initiatedBy":"scheduled",
"full":true,
"local":false,
"localCopy":false,
"databaseIncluded":true,
"size":"1712.8MB",
"sizeInBytes":1795953008,
"dbTag":"TAG20151009T131630",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1444395600241",
"notes":"Automated backup"
},
{
"backupId":"1444482000267",
"jobId":"300746",
"backupStartDate":"Sat Oct 10 13:00:00 GMT 2015",
"expirationDate":"Mon Nov 09 13:00:00 GMT 2015",
"deletedOnDate":"Mon Nov 16 13:20:20 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":false,
"databaseIncluded":true,
"size":"52.1MB",
"sizeInBytes":54682556,
"dbTag":"TAG20151010T130457",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1444482000267",
"notes":"Automated backup"
},
...
{
"backupId":"1447938000367",
"jobId":"325323",
"backupStartDate":"Thu Nov 19 13:00:00 GMT 2015",
"expirationDate":"Sat Dec 19 13:00:00 GMT 2015",
"deletedOnDate":"Wed Nov 25 19:30:07 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":true,
"databaseIncluded":true,
"size":"388.8MB",
"sizeInBytes":407662990,
"dbTag":"TAG20151119T131258",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1447938000367",
"notes":"Automated backup"
},
{
"backupId":"1448110800502",
"jobId":"325320",
"backupStartDate":"Sat Nov 21 13:00:00 GMT 2015",
"expirationDate":"Mon Dec 21 13:00:00 GMT 2015",
"deletedOnDate":"Wed Nov 25 19:27:02 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":true,
"databaseIncluded":true,
"size":"387.3MB",
"sizeInBytes":406099518,
"dbTag":"TAG20151121T131441",
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/ExampleIdentityDomain\/ExampleInstance\/backups\/1448110800502",
"notes":"Automated backup"
}
]
}
レスポンス本文の例(Oracle Cloud Machine)
次の例では、JSON形式で返されるレスポンスを示しています。
{
"deletedbackups":[
{
"backupId":"1450996752252",
"jobId":"unknown",
"backupStartDate":"Thu Dec 24 22:39:12 GMT 2015",
"expirationDate":"Sat Jan 23 22:39:12 GMT 2016",
"deletedOnDate":"Thu Dec 24 22:54:56 GMT 2015",
"initiatedBy":"scheduled",
"full":true,
"local":false,
"localCopy":false,
"databaseIncluded":false,
"size":"149.7MB",
"sizeInBytes":156979772,
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance\/backups\/1450996752252",
"notes":"Automated backup"
},
{
"backupId":"1450998251233",
"jobId":"10033",
"backupStartDate":"Thu Dec 24 23:04:11 GMT 2015",
"expirationDate":"Sat Jan 23 23:04:11 GMT 2016",
"deletedOnDate":"Thu Dec 24 23:17:57 GMT 2015",
"initiatedBy":"scheduled",
"full":false,
"local":false,
"localCopy":false,
"databaseIncluded":false,
"size":"149.7MB",
"sizeInBytes":156989404,
"status":"Deleted",
"href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance\/backups\/1450998251233",
"notes":"Automated backup"
}]
}