バックアップ構成の更新
post
/api/v1.1/instances/{identityId}/{serviceId}/backupconfig
サービス・インスタンスのバックアップ構成を更新します。
リクエスト
サポートされるメディア・タイプ
- application/json
パス・パラメータ
- identityId
-
タイプ:
string必須:trueOracle Cloud Serviceアカウントのアイデンティティ・ドメインの名前。- serviceId
タイプ:string必須:trueサービス・インスタンスのID。
本文のパラメータ
ルート・スキーマ: UpdateBackupConfigurationPayload
タイプ:
object- cloudStorageContainer
-
タイプ:
stringOracle Cloud Storage Serviceのコンテナ名。 - defaultRetention
-
タイプ:
string増分バックアップの保存日数。
全体バックアップは関連する最新の増分バックアップが使用可能になるまで保存されます。
NULLに設定されている場合、バックアップは無期限に、または手動で削除されるまで保存されます。 - fullBackupSchedule
-
タイプ:
objectfullBackupSchedule次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。 - incrementalBackupSchedule
-
タイプ:
objectincrementalBackupSchedule次回の増分バックアップのスケジュール。
デフォルトで、増分バックアップは、全体バックアップの曜日以外の毎日、全体バックアップの開始と同じ時刻に開始します。
単位は'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必須:trueOracle Cloud Storage Serviceのコンテナ名。 - defaultRetention
-
タイプ:
string必須:true増分バックアップの保存日数。
全体バックアップは関連する最新の増分バックアップが使用可能になるまで保存されます。
NULLに設定されている場合、バックアップは無期限に、または手動で削除されるまで保存されます。 - fullBackupSchedule
-
タイプ:
objectfullBackupSchedule必須:true次回の全体バックアップのスケジュール。
デフォルトで、全体バックアップは毎週開始され、サービス・インスタンスが作成されてから12時間後、直近の5分間隔に丸められて始まります。 - incrementalBackupSchedule
-
タイプ:
objectincrementalBackupSchedule必須: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
}