翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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、以下を参照してください。