翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateFramework
JSON 形式の入力ドキュメントを使用して FrameworkName によって識別される既存のフレームワークを更新します。
リクエストの構文
PUT /audit/frameworks/frameworkName 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",
"IdempotencyToken": "string"
}URI リクエストパラメータ
リクエストでは、次の URI パラメータを使用します。
- frameworkName
-
フレームワークの一意の名前。この名前は、文字で始まり、文字 (a~z、A~Z)、数字 (0~9)、およびアンダースコア (_) を含む 1 から 256 文字で構成されます。
長さの制限：最小長は 1 です。最大長は 256 です。
パターン：
[a-zA-Z][_a-zA-Z0-9]*必須: はい
リクエストボディ
リクエストは以下の JSON 形式のデータを受け入れます。
- FrameworkControls
-
フレームワークを構成するコントロールのリスト。リスト内の各コントロールには、名前、入力パラメータ、およびスコープがあります。
型: FrameworkControl オブジェクトの配列
必須: いいえ
- FrameworkDescription
-
最大 1,024 文字のフレームワークの説明 (オプション)。
型: 文字列
長さの制限: 最小長は 0 です。最大長は 1,024 です。
パターン:
.*\S.*必須: いいえ
- IdempotencyToken
-
別の
UpdateFrameworkInputへの同じコール間を区別するために使用できる顧客が選択した文字列。同じ冪等性トークンで成功したリクエストを再試行すると、アクションは実行されず、成功メッセージが表示されます。タイプ: 文字列
必須: いいえ
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"FrameworkArn": "string",
"FrameworkName": "string"
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- CreationTime
-
フレームワークが作成された日付と時刻を ISO 8601 で表したものです。
CreationTimeの値は、ミリ秒単位の精度です。例えば、2020-07-10T15:00:00.000-08:00 は 2020 年 7 月 10 日午後 3 時 (UTC から 8 時間遅れ) を表します。型: タイムスタンプ
- FrameworkArn
-
リソースを一意に識別する Amazon リソースネーム (ARN)。ARN の形式は、リソースタイプによって異なります。
型: 文字列
- FrameworkName
-
フレームワークの一意の名前。この名前は、文字で始まり、文字 (a~z、A~Z)、数字 (0~9)、およびアンダースコア (_) を含む 1 から 256 文字で構成されます。
型: 文字列
長さの制限：最小長は 1 です。最大長は 256 です。
パターン：
[a-zA-Z][_a-zA-Z0-9]*
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AlreadyExistsException
-
必要なリソースは既に存在します。
HTTP ステータスコード：400
- ConflictException
-
AWS Backup 前のアクションの実行が終了するまで、要求したアクションを実行できません。後ほどもう一度試してください。」
HTTP ステータスコード：400
- InvalidParameterValueException
-
パラメータの値に問題があることを示します。たとえば、値が範囲外であることです。
HTTP ステータスコード：400
- LimitExceededException
-
たとえば、リクエストで許可されるアイテムの最大数などのリクエストの制限を超えました。
HTTP ステータスコード：400
- MissingParameterValueException
-
必須パラメータがないことを示します。
HTTP ステータスコード：400
- ResourceNotFoundException
-
アクションに必要なリソースは存在しません。
HTTP ステータスコード：400
- ServiceUnavailableException
-
サーバーの一時的障害のため、リクエストは失敗しました。
HTTP ステータスコード：500
その他の参照資料
この API を言語固有の AWS SDK で使用する方法について詳しくは、以下を参照してください。
