DeleteBackupPlan
バックアッププランを削除します。バックアッププランは、関連付けられた選択リソースがすべて削除された後に削除できます。バックアッププランを削除すると、バックアッププランの現在のバージョンが削除されます。以前のバージョン (存在する場合) は引き続き存在します。
リクエストの構文
DELETE /backup/plans/backupPlanId
HTTP/1.1
URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- backupPlanId
-
バックアップ計画を一意に識別します。
必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"BackupPlanArn": "string",
"BackupPlanId": "string",
"DeletionDate": number,
"VersionId": "string"
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- BackupPlanArn
-
たとえば、
arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50
などのバックアップ計画を一意に識別する Amazon リソースネーム (ARN) です。型: 文字列
- BackupPlanId
-
バックアップ計画を一意に識別します。
型: 文字列
- DeletionDate
-
Unix 形式および協定世界時 (UTC)でバックアップ計画が削除される日時。
DeletionDate
の値はミリ秒単位の精度です。たとえば、1516925490.087 の値は、2018 年 1 月 26 日 (金) 午前12:11:30.087 を表します。型: タイムスタンプ
- VersionId
-
一意のランダムに生成された UTF-8 エンコード Unicode 文字列 (最大 1,024 バイト長)。バージョン ID を編集することはできません。
型: 文字列
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード:400
- InvalidRequestException
-
リクエストへの入力に何らかの問題が発生していることを示します。たとえば、パラメータのタイプが間違っています。
HTTP ステータスコード:400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード:400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード:400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード:500
その他の参照資料
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。