バックアップ構成の更新
post
/api/v1.1/instances/{identityId}/{serviceId}/backupconfig
サービス・インスタンスのバックアップ構成を更新します。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- identityId
-
タイプ:
string
必須:true
Oracle Cloud Serviceアカウントのアイデンティティ・ドメインの名前。- serviceId
タイプ:string
必須:true
サービス・インスタンスのID。
本文のパラメータ
ルート・スキーマ: UpdateBackupConfigurationPayload
タイプ:
object
- cloudStorageContainer
-
タイプ:
string
Oracle Cloud Storage Serviceのコンテナ名。 - defaultRetention
-
タイプ:
string
増分バックアップの保存日数。
全体バックアップは関連する最新の増分バックアップが使用可能になるまで保存されます。
NULLに設定されている場合、バックアップは無期限に、または手動で削除されるまで保存されます。 - fullBackupSchedule
-
タイプ:
object
fullBackupSchedule次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。 - incrementalBackupSchedule
-
タイプ:
object
incrementalBackupSchedule次回の増分バックアップのスケジュール。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。
ネスト・スキーマ: fullBackupSchedule
タイプ:
object
次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。
- dayOfMonth
-
タイプ:
string
構成できない項目。'*' (すべての日) - dayOfWeek
-
タイプ:
string
構成可能な項目 - hour
-
タイプ:
string
構成可能な項目 - minute
-
タイプ:
string
構成可能な項目 - month
-
タイプ:
string
構成できない項目。'*' (すべての月) - second
-
タイプ:
string
構成できない項目。 デフォルトは0です - year
-
タイプ:
string
構成できない項目。'*' (すべての年)
ネスト・スキーマ: incrementalBackupSchedule
タイプ:
object
次回の増分バックアップのスケジュール。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。
- dayOfMonth
-
タイプ:
string
日 - dayOfWeek
-
タイプ:
string
曜日 - hour
-
タイプ:
string
時間 - minute
-
タイプ:
string
分 - month
-
タイプ:
string
月 - second
-
タイプ:
string
秒 - year
-
タイプ:
string
年
レスポンス
サポートされるメディア・タイプ
- application/json
200レスポンス
成功
本文
ルート・スキーマ: ViewBackupConfigurationResponse
タイプ:
object
- cloudStorageContainer
-
タイプ:
string
必須:true
Oracle Cloud Storage Serviceのコンテナ名。 - defaultRetention
-
タイプ:
string
必須:true
増分バックアップの保存日数。
全体バックアップは関連する最新の増分バックアップが使用可能になるまで保存されます。
NULLに設定されている場合、バックアップは無期限に、または手動で削除されるまで保存されます。 - fullBackupSchedule
-
タイプ:
object
fullBackupSchedule必須:true
次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。 - incrementalBackupSchedule
-
タイプ:
object
incrementalBackupSchedule必須:true
次回の増分バックアップのスケジュール。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。 - lastBackupDate
-
タイプ:
string
必須:true
前回のバックアップが完了した日時。
注意: バックアップがない場合、この属性は省略されます。 - nextFullBackupDate
-
タイプ:
string
必須:true
次回の全体バックアップがスケジュールされている日時。 - nextIncrementalBackupDate
-
タイプ:
string
必須:true
次回の増分バックアップがスケジュールされている日時。 - percentBackupVolumeUsed
-
タイプ:
integer
必須:true
現在使用中のバックアップ・ボリュームの合計パーセント。 - totalBackupVolumeUsed
-
タイプ:
string
必須:true
現在使用中のバックアップ・ボリュームの合計量(MB単位)。 - totalCloudStorageContainerUsed
-
タイプ:
string
必須:true
現在使用中のCloud Storage Container領域の合計量(MB単位)。
ネスト・スキーマ: fullBackupSchedule
タイプ:
object
次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。
- dayOfMonth
-
タイプ:
string
構成できない項目。'*' (すべての日) - dayOfWeek
-
タイプ:
string
構成可能な項目 - hour
-
タイプ:
string
構成可能な項目 - minute
-
タイプ:
string
構成可能な項目 - month
-
タイプ:
string
構成できない項目。'*' (すべての月) - second
-
タイプ:
string
構成できない項目。 デフォルトは0です - year
-
タイプ:
string
構成できない項目。'*' (すべての年)
ネスト・スキーマ: incrementalBackupSchedule
タイプ:
object
次回の増分バックアップのスケジュール。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'fullBackupSchedule'と同じです。
- dayOfMonth
-
タイプ:
string
日 - dayOfWeek
-
タイプ:
string
曜日 - hour
-
タイプ:
string
時間 - minute
-
タイプ:
string
分 - month
-
タイプ:
string
月 - second
-
タイプ:
string
秒 - year
-
タイプ:
string
年
例
次の例では、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによってOracle SOA Cloud Serviceインスタンスのバックアップ構成を更新する方法を示しています。 詳細は、「cURLの使用」を参照してください。
Oracle SOA Cloud Serviceインスタンスの自動バックアップの構成に関する項も参照してください。
cURLコマンド
curl -i -X POST -u joe@example.com:Welcome1! -d @backup.json -H "Content-type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://api-host/paas/service/soa/api/v1.1/instances/ExampleIdentityDomain/ExampleInstance/backupconfig
注意:: この例では、アメリカ合衆国でのURL接頭辞(soacs)を使用しています。 世界の他の地域のURL接頭辞の詳細は、「リクエストの送信」を参照してください。
リクエスト本文の例
JSON形式のリクエスト・ドキュメントの例を次に示します。
{ "fullBackupSchedule": { "hour":"5", "dayOfWeek":"Sun" }, "incrementalBackupSchedule": { "hour":"3" } }
レスポンス本文の例
次の例では、新しい値が有効になった(太字で示した部分)、JSON形式で返されるレスポンスを示しています。
{ "defaultRetention":"30 days", "fullBackupSchedule": { "second":"0", "minute":"0", "hour":"5", "dayOfMonth":"*", "month":"*", "dayOfWeek":"Sun", "year":"*" }, "incrementalBackupSchedule": { "second":"0", "minute":"0", "hour":"3", "dayOfMonth":"*", "month":"*", "dayOfWeek":"Mon,Tue,Wed,Thu,Fri,Sat", "year":"*" }, "lastBackupDate":"Thu Dec 11 07:25:00 GMT 2014", "nextFullBackupDate":"Sun Dec 14 05:00:00 GMT 2014", "nextIncrementalBackupDate":"Fri Dec 12 03:00:00 GMT 2014", "cloudStorageContainer":"develop-soa/JCSBackup", "totalCloudStorageContainerUsed":"0.0MB", "totalBackupVolumeUsed":"853.5MB", "percentBackupVolumeUsed":0 }