CreateFramework - AWS Backup

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateFramework

1 つ以上のコントロールを持つフレームワークを作成します。フレームワークは、バックアッププラクティスを評価するために使用できるコントロールの集まりです。事前に構築されたカスタマイズ可能なコントロールを使用してポリシーを定義することで、バックアッププラクティスがポリシーに準拠しているかどうか、およびまだ準拠していないリソースを評価できます。

リクエストの構文

POST /audit/frameworks HTTP/1.1 Content-type: application/json { "FrameworkControls": [ { "ControlInputParameters": [ { "ParameterName": "string", "ParameterValue": "string" } ], "ControlName": "string", "ControlScope": { "ComplianceResourceIds": [ "string" ], "ComplianceResourceTypes": [ "string" ], "Tags": { "string" : "string" } } } ], "FrameworkDescription": "string", "FrameworkName": "string", "FrameworkTags": { "string" : "string" }, "IdempotencyToken": "string" }

URI リクエストパラメータ

リクエストはURIパラメータを使用しません。

リクエスト本文

リクエストは、次のJSON形式のデータを受け入れます。

FrameworkControls

フレームワークを構成するコントロール。リスト内の各コントロールには、名前、入力パラメータ、およびスコープがあります。

型: FrameworkControl オブジェクトの配列

必須:はい

FrameworkDescription

最大 1,024 文字のフレームワークの任意の記述。

型: 文字列

長さの制限: 最小長は 0 です。最大長は 1,024 です。

パターン: .*\S.*

必須: いいえ

FrameworkName

フレームワークの一意の名前。名前は文字から始まる1~256文字で、文字 (a~z、A~Z)、数字 (0~9)、およびアンダースコア (_)により構成されます。

型: 文字列

長さの制限:最小長は 1 です。最大長は 256 です。

Pattern: [a-zA-Z][_a-zA-Z0-9]*

必須:はい

FrameworkTags

フレームワークに割り当てるタグ。

型: 文字列間のマッピング

必須:いいえ

IdempotencyToken

別の CreateFrameworkInput への同じコール間を区別するために使用できる顧客が選択した文字列。同じ冪等性トークンで成功したリクエストを再試行すると、アクションは実行されず、成功メッセージが表示されます。

型: 文字列

必須: いいえ

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "FrameworkArn": "string", "FrameworkName": "string" }

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。

次のデータは、 サービスによって JSON 形式で返されます。

FrameworkArn

リソースを一意に識別する Amazon リソースネーム (ARN)。の形式は、リソースタイプARNによって異なります。

型: 文字列

FrameworkName

フレームワークの一意の名前。名前は文字から始まる1~256文字で、文字 (a~z、A~Z)、数字 (0~9)、およびアンダースコア (_)により構成されます。

型: 文字列

長さの制限:最小長は 1 です。最大長は 256 です。

Pattern: [a-zA-Z][_a-zA-Z0-9]*

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

AlreadyExistsException

必要なリソースは既に存在します。

HTTP ステータスコード: 400

InvalidParameterValueException

パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。

HTTP ステータスコード: 400

LimitExceededException

たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。

HTTP ステータスコード: 400

MissingParameterValueException

必須パラメータがないことを示します。

HTTP ステータスコード: 400

ServiceUnavailableException

サーバーの一時的障害のため、リクエストは失敗しました。

HTTP ステータスコード: 500

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。