機械翻訳について
  1. Oracle Java Cloud ServiceのREST API
  2. タスク
  3. バックアップとリストア

すべてのバックアップの表示

get

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/backups

Oracle Java Cloud Serviceインスタンスのすべてのバックアップに関する情報を返します。 デフォルトは次のとおりです。
  • 全体バックアップと増分バックアップが含まれています。 全体バックアップのみを含める場合は、?fullBackupsOnly問合せパラメータをtrueに設定します。
  • 成功したバックアップと進行中のバックアップが返されます。 失敗したバックアップと削除されたバックアップを含める場合は、?includeAll問合せパラメータをtrueに設定します。
  • 長さが32文字を超えるメモは切り捨てられます。 完了したメモの内容を含める場合は、?includeCompleteNotes問合せパラメータをtrueに設定します。

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}/backupsは推奨されていませんが、近いうちに引き続きサポートされます。 ただし、今後非推奨のURL構造がサポートされなくなった場合に、中断を最小限に抑えるために、新しいパスを使用するようにアプリケーションを移行することをお勧めします。

リクエスト

パス・パラメータ
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インスタンスの名前。
問合せパラメータ
fullBackupsOnly
型: boolean
全体バックアップのみを表示する(true)か、全体バックアップと増分バックアップの両方を表示する(false)かを指定するフラグ。 デフォルトはfalseです。
includeAll
型: boolean
成功したもの、進行中のもの、失敗したものおよび削除されたものを含め、すべてのバックアップを表示する(true)か、成功したか、または進行中のバックアップのみを表示する(false)かを指定するフラグ。 デフォルトはfalseです。
includeCompleteNotes
型: boolean
各バックアップの完全な一連のノートを表示する(true)か、32文字を超えるメモを切り捨てる(false)かを指定するフラグ。 デフォルトはfalseです。
ヘッダー・パラメータ
X-ID-TENANT-NAME
型: string
必須: true
Oracle Java Cloud Serviceアカウントのアイデンティティ・ドメインID (Oracle Public Cloudの場合)。

Oracle Java Cloud Serviceインスタンスのテナント名(Oracle Cloud Machineの場合)。

レスポンス

サポートされているメディア・タイプ
  • application/json
200レスポンス
OK 返される可能性のあるその他のHTTPステータス・コードの詳細は、ステータス・コードを参照してください。
本文
レスポンス本文には、すべてのバックアップに関する情報が含まれます。
ルート・スキーマ: viewallbackups-response
レスポンス本文には、すべてのバックアップに関する情報が含まれます。
ネストされたスキーマ: backupInProgress
型: array
現在処理中のバックアップがあれば、その詳細をグループ化します。
ネストされたスキーマ: backups
型: array
完了したバックアップをすべてグループ化します。
ネストされたスキーマ: backups
ネストされたスキーマ: serviceComponents
型: array
サービス・コンポーネントの詳細をグループ化します。
ネストされたスキーマ: servicecomponents

例

次の例では、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 "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/backups

レスポンス・ヘッダーの例

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

HTTP/1.1 200 OK
Date: Tue, 07 Mar 2017 19:13:31 GMT
Content-Type: application/json

レスポンス本文の例(Oracle Public Cloud)

次の例では、進行中の1つのバックアップを含むJSON形式のレスポンス本文のコンテンツを示しています。

{
    "backups":[
    {
        "backupId":"1449332100032",
        "jobId":"8191",
        "backupStartDate":"Sat Dec 05 16:15:00 GMT 2016",
        "backupCompleteDate":"Sat Dec 05 17:36:18 GMT 2016",
        "expirationDate":"Mon Jan 04 16:15:00 GMT 2017",
        "initiatedBy":"scheduled",
        "full":true,
        "local":false,
        "localCopy":true,
        "databaseIncluded":true,
        "size":"15.8MB",
        "sizeInBytes":16557866,
        "dbTag":"TAG20151205T163004",
        "status":"Completed",
        "storageContainer":"Storage-ExampleIdentityDomain\/JCSBackups"
        "href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomain\/services\/jaas\/instances\/ExampleInstance\/backups\/1449332100032",
        "serviceComponents":[
        {
            "type":"OTD_JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"WLS",
            "version":"12.1.3.0.5"
        },
        {
            "type":"OTD",
            "version":"11.1.1.9.1"
        }],
        "notes":"Automated backup"
    },
    {
        "backupId":"1449340039298",
        "jobId":"8213",
        "backupStartDate":"Sat Dec 05 18:27:19 GMT 2016",
        "backupCompleteDate":"Sat Dec 05 18:29:53 GMT 2016",
        "expirationDate":"Mon Jan 04 18:27:19 GMT 2017",
        "initiatedBy":"username",
        "full":true,
        "local":false,
        "localCopy":true,
        "databaseIncluded":false,
        "size":"16MB",
        "sizeInBytes":16792928,
        "status":"Completed",
        "storageContainer":"Storage-ExampleIdentityDomain\/JCSBackups"
        "href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomain\/services\/jaas\/instances\/ExampleInstance\/backups\/1449340039298",
        "serviceComponents":[
        {
            "type":"OTD_JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"WLS",
            "version":"12.1.3.0.5"
        },
        {
            "type":"OTD",
            "version":"11.1.1.9.1"
        }]
    },
    {...}
    ],
    "backupInProgress":{
        "backupId":"1449346810790",
        "jobId":"8221",
        "backupStartDate":"Sat Dec 05 20:20:10 GMT 2016",
        "expirationDate":"Mon Jan 04 20:20:10 GMT 2017",
        "initiatedBy":"username",
        "full":true,
        "local":true,
        "localCopy":false,
        "databaseIncluded":true,
        "size":"Unknown",
        "sizeInBytes":0,
        "dbTag":"unavailable",
        "status":"Backup In Progress",
        "storageContainer":"Storage-ExampleIdentityDomain\/JCSBackups"
        "href":"https:\/\/rest_server_url\/paas\/api\/v1.1\/instancemgmt\/ExampleIdentityDomain\/services\/jaas\/instances\/ExampleInstance\/backups\/144934681079
0",
        "notes":"On-demand full with database..."
    }
}

レスポンス本文の例(Oracle Cloud Machine)

次の例では、進行中の1つのバックアップを含むJSON形式のレスポンス本文のコンテンツを示しています。

{
    "backups":[
    {
        "backupId":"1449223500059",
        "jobId":"6270",
        "backupStartDate":"Fri Dec 04 10:05:00 GMT 2015",
        "backupCompleteDate":"Fri Dec 04 10:10:06 GMT 2015",
        "expirationDate":"Sat Jan 09 10:05:00 GMT 2016",
        "initiatedBy":"scheduled",
        "full":true,
        "local":false,
        "localCopy":true,
        "databaseIncluded":false,
        "size":"1697.4MB",
        "sizeInBytes":1779870512,
        "status":"Completed",
        "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance\/backups\/1449223500059",
        "serviceComponents":[
        {
            "type":"OTD",
            "version":"11.1.1.9.1"
        },
        {
            "type":"OTD_JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"WLS",
            "version":"12.1.3.0.5"
        }
        ],
        "notes":"Automated backup"
    },
    {...},
    {
        "backupId":"1450995000073",
        "jobId":"7027",
        "backupStartDate":"Thu Dec 24 22:10:00 GMT 2015",
        "backupCompleteDate":"Thu Dec 24 22:12:40 GMT 2015",
        "expirationDate":"Sat Jan 23 22:10:00 GMT 2016",
        "initiatedBy":"scheduled",
        "full":false,
        "local":false,
        "localCopy":true,
        "databaseIncluded":false,
        "size":"149.7MB",
        "sizeInBytes":156982572,
        "status":"Completed",
        "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance\/backups\/1450995000073",
        "serviceComponents":[
        {
            "type":"OTD",
            "version":"11.1.1.9.1"
        },
        {
            "type":"OTD_JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"JDK",
            "version":"1.7.0_91"
        },
        {
            "type":"WLS",
            "version":"12.1.3.0.5"
        }
        ],
        "notes":"Automated backup"
    }],
    "backupInProgress":
    {
        "backupId":"1450996752252",
        "jobId":"10029",
        "backupStartDate":"Thu Dec 24 22:39:12 GMT 2015",
        "expirationDate":"Sat Jan 23 22:39:12 GMT 2016",
        "initiatedBy":"username",
        "full":true,
        "local":true,
        "localCopy":false,
        "databaseIncluded":false,
        "size":"149.7MB",
        "sizeInBytes":156979772,
        "status":"Backup In Progress",
        "href":"https:\/\/rest_server_url\/paas\/service\/jcs\/api\/v1.1\/instances\/myTenantName\/ExampleInstance\/backups\/1450996752252",
        "notes":"On-demand full backup..."
    }
}