Skip to content

Commit 616e118

Browse files
author
awstools
committed
docs(client-config-service): Documentation updates for the AWS Config CLI
1 parent 20675fd commit 616e118

File tree

6 files changed

+75
-13
lines changed

6 files changed

+75
-13
lines changed

clients/client-config-service/src/commands/DescribeOrganizationConfigRulesCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ export interface DescribeOrganizationConfigRulesCommandOutput
3939
* <p>Limit and next token are not applicable if you specify organization Config rule names.
4040
* It is only applicable, when you request all the organization Config rules.</p>
4141
* <p>
42-
* <i>For accounts within an organzation</i>
42+
* <i>For accounts within an organization</i>
4343
* </p>
4444
* <p>If you deploy an organizational rule or conformance pack in an organization
4545
* administrator account, and then establish a delegated administrator and deploy an

clients/client-config-service/src/commands/DescribeOrganizationConformancePacksCommand.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ export interface DescribeOrganizationConformancePacksCommandOutput
4242
* <p>Limit and next token are not applicable if you specify organization conformance packs names. They are only applicable,
4343
* when you request all the organization conformance packs. </p>
4444
* <p>
45-
* <i>For accounts within an organzation</i>
45+
* <i>For accounts within an organization</i>
4646
* </p>
4747
* <p>If you deploy an organizational rule or conformance pack in an organization
4848
* administrator account, and then establish a delegated administrator and deploy an

clients/client-config-service/src/commands/PutRemediationConfigurationsCommand.ts

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,15 +39,31 @@ export interface PutRemediationConfigurationsCommandOutput
3939
* The Config rule must already exist for you to add a remediation configuration.
4040
* The target (SSM document) must exist and have permissions to use the target. </p>
4141
* <note>
42+
* <p>
43+
* <b>Be aware of backward incompatible changes</b>
44+
* </p>
4245
* <p>If you make backward incompatible changes to the SSM document,
4346
* you must call this again to ensure the remediations can run.</p>
4447
* <p>This API does not support adding remediation configurations for service-linked Config Rules such as Organization Config rules,
4548
* the rules deployed by conformance packs, and rules deployed by Amazon Web Services Security Hub.</p>
4649
* </note>
4750
* <note>
51+
* <p>
52+
* <b>Required fields</b>
53+
* </p>
4854
* <p>For manual remediation configuration, you need to provide a value for <code>automationAssumeRole</code> or use a value in the <code>assumeRole</code>field to remediate your resources. The SSM automation document can use either as long as it maps to a valid parameter.</p>
4955
* <p>However, for automatic remediation configuration, the only valid <code>assumeRole</code> field value is <code>AutomationAssumeRole</code> and you need to provide a value for <code>AutomationAssumeRole</code> to remediate your resources.</p>
5056
* </note>
57+
* <note>
58+
* <p>
59+
* <b>Auto remediation can be initiated even for compliant resources</b>
60+
* </p>
61+
* <p>If you enable auto remediation for a specific Config rule using the <a href="https://docs.aws.amazon.com/config/latest/APIReference/emAPI_PutRemediationConfigurations.html">PutRemediationConfigurations</a> API or the Config console,
62+
* it initiates the remediation process for all non-compliant resources for that specific rule.
63+
* The auto remediation process relies on the compliance data snapshot which is captured on a periodic basis.
64+
* Any non-compliant resource that is updated between the snapshot schedule will continue to be remediated based on the last known compliance data snapshot.</p>
65+
* <p>This means that in some cases auto remediation can be initiated even for compliant resources, since the bootstrap processor uses a database that can have stale evaluation results based on the last known compliance data snapshot.</p>
66+
* </note>
5167
* @example
5268
* Use a bare-bones client and the command you need to make an API call.
5369
* ```javascript

clients/client-config-service/src/commands/PutRemediationExceptionsCommand.ts

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,21 +31,40 @@ export interface PutRemediationExceptionsCommandOutput extends PutRemediationExc
3131
* <p>A remediation exception is when a specified resource is no longer considered for auto-remediation.
3232
* This API adds a new exception or updates an existing exception for a specified resource with a specified Config rule. </p>
3333
* <note>
34+
* <p>
35+
* <b>Exceptions block auto remediation</b>
36+
* </p>
3437
* <p>Config generates a remediation exception when a problem occurs running a remediation action for a specified resource.
3538
* Remediation exceptions blocks auto-remediation until the exception is cleared.</p>
3639
* </note>
3740
* <note>
41+
* <p>
42+
* <b>Manual remediation is recommended when placing an exception</b>
43+
* </p>
3844
* <p>When placing an exception on an Amazon Web Services resource, it is recommended that remediation is set as manual remediation until
3945
* the given Config rule for the specified resource evaluates the resource as <code>NON_COMPLIANT</code>.
4046
* Once the resource has been evaluated as <code>NON_COMPLIANT</code>, you can add remediation exceptions and change the remediation type back from Manual to Auto if you want to use auto-remediation.
4147
* Otherwise, using auto-remediation before a <code>NON_COMPLIANT</code> evaluation result can delete resources before the exception is applied.</p>
4248
* </note>
4349
* <note>
50+
* <p>
51+
* <b>Exceptions can only be performed on non-compliant resources</b>
52+
* </p>
4453
* <p>Placing an exception can only be performed on resources that are <code>NON_COMPLIANT</code>.
4554
* If you use this API for <code>COMPLIANT</code> resources or resources that are <code>NOT_APPLICABLE</code>, a remediation exception will not be generated.
4655
* For more information on the conditions that initiate the possible Config evaluation results,
4756
* see <a href="https://docs.aws.amazon.com/config/latest/developerguide/config-concepts.html#aws-config-rules">Concepts | Config Rules</a> in the <i>Config Developer Guide</i>.</p>
4857
* </note>
58+
* <note>
59+
* <p>
60+
* <b>Auto remediation can be initiated even for compliant resources</b>
61+
* </p>
62+
* <p>If you enable auto remediation for a specific Config rule using the <a href="https://docs.aws.amazon.com/config/latest/APIReference/emAPI_PutRemediationConfigurations.html">PutRemediationConfigurations</a> API or the Config console,
63+
* it initiates the remediation process for all non-compliant resources for that specific rule.
64+
* The auto remediation process relies on the compliance data snapshot which is captured on a periodic basis.
65+
* Any non-compliant resource that is updated between the snapshot schedule will continue to be remediated based on the last known compliance data snapshot.</p>
66+
* <p>This means that in some cases auto remediation can be initiated even for compliant resources, since the bootstrap processor uses a database that can have stale evaluation results based on the last known compliance data snapshot.</p>
67+
* </note>
4968
* @example
5069
* Use a bare-bones client and the command you need to make an API call.
5170
* ```javascript

clients/client-config-service/src/models/models_0.ts

Lines changed: 29 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2563,6 +2563,9 @@ export interface ConfigurationItem {
25632563
* <p>Asia Pacific (Melbourne)</p>
25642564
* </li>
25652565
* <li>
2566+
* <p>Canada West (Calgary)</p>
2567+
* </li>
2568+
* <li>
25662569
* <p>Europe (Spain)</p>
25672570
* </li>
25682571
* <li>
@@ -2665,6 +2668,9 @@ export interface RecordingStrategy {
26652668
* <p>Asia Pacific (Melbourne)</p>
26662669
* </li>
26672670
* <li>
2671+
* <p>Canada West (Calgary)</p>
2672+
* </li>
2673+
* <li>
26682674
* <p>Europe (Spain)</p>
26692675
* </li>
26702676
* <li>
@@ -2744,6 +2750,9 @@ export interface RecordingGroup {
27442750
* <p>Asia Pacific (Melbourne)</p>
27452751
* </li>
27462752
* <li>
2753+
* <p>Canada West (Calgary)</p>
2754+
* </li>
2755+
* <li>
27472756
* <p>Europe (Spain)</p>
27482757
* </li>
27492758
* <li>
@@ -2760,7 +2769,7 @@ export interface RecordingGroup {
27602769
* <p>
27612770
* <b>Aurora global clusters are recorded in all enabled Regions</b>
27622771
* </p>
2763-
* <p>The <code>AWS::RDS::GlobalCluster</code> resource type will be recorded in all supported Config Regions where the configuration recorder is enabled, even if <code>includeGlobalResourceTypes</code> is not set to <code>true</code>.
2772+
* <p>The <code>AWS::RDS::GlobalCluster</code> resource type will be recorded in all supported Config Regions where the configuration recorder is enabled, even if <code>includeGlobalResourceTypes</code> is set<code>false</code>.
27642773
* The <code>includeGlobalResourceTypes</code> option is a bundle which only applies to IAM users, groups, roles, and customer managed policies.
27652774
* </p>
27662775
* <p>If you do not want to record <code>AWS::RDS::GlobalCluster</code> in all enabled Regions, use one of the following recording strategies:</p>
@@ -2776,7 +2785,22 @@ export interface RecordingGroup {
27762785
* </ol>
27772786
* <p>For more information, see <a href="https://docs.aws.amazon.com/config/latest/developerguide/select-resources.html#select-resources-all">Selecting Which Resources are Recorded</a> in the <i>Config developer guide</i>.</p>
27782787
* </important>
2788+
* <important>
2789+
* <p>
2790+
* <b>includeGlobalResourceTypes and the exclusion recording strategy</b>
2791+
* </p>
2792+
* <p>The <code>includeGlobalResourceTypes</code> field has no impact on the <code>EXCLUSION_BY_RESOURCE_TYPES</code> recording strategy.
2793+
* This means that the global IAM resource types (IAM users, groups, roles, and customer managed policies) will
2794+
* not be automatically added as exclusions for <code>exclusionByResourceTypes</code> when <code>includeGlobalResourceTypes</code> is set to <code>false</code>.</p>
2795+
* <p>The <code>includeGlobalResourceTypes</code> field should only be used to modify the <code>AllSupported</code> field, as the default for
2796+
* the <code>AllSupported</code> field is to record configuration changes for all supported resource types excluding the global
2797+
* IAM resource types. To include the global IAM resource types when <code>AllSupported</code> is set to <code>true</code>, make sure to set <code>includeGlobalResourceTypes</code> to <code>true</code>.</p>
2798+
* <p>To exclude the global IAM resource types for the <code>EXCLUSION_BY_RESOURCE_TYPES</code> recording strategy, you need to manually add them to the <code>resourceTypes</code> field of <code>exclusionByResourceTypes</code>.</p>
2799+
* </important>
27792800
* <note>
2801+
* <p>
2802+
* <b>Required and optional fields</b>
2803+
* </p>
27802804
* <p>Before you set this field to <code>true</code>,
27812805
* set the <code>allSupported</code> field of <a href="https://docs.aws.amazon.com/config/latest/APIReference/API_RecordingGroup.html">RecordingGroup</a> to
27822806
* <code>true</code>. Optionally, you can set the <code>useOnly</code> field of <a href="https://docs.aws.amazon.com/config/latest/APIReference/API_RecordingStrategy.html">RecordingStrategy</a> to <code>ALL_SUPPORTED_RESOURCE_TYPES</code>.</p>
@@ -2889,6 +2913,9 @@ export interface RecordingGroup {
28892913
* <p>Asia Pacific (Melbourne)</p>
28902914
* </li>
28912915
* <li>
2916+
* <p>Canada West (Calgary)</p>
2917+
* </li>
2918+
* <li>
28922919
* <p>Europe (Spain)</p>
28932920
* </li>
28942921
* <li>
@@ -3289,7 +3316,7 @@ export interface TemplateSSMDocumentDetails {
32893316
/**
32903317
* @public
32913318
* <p>The name or Amazon Resource Name (ARN) of the SSM document to use to create a conformance pack.
3292-
* If you use the document name, Config checks only your account and Amazon Web Services Region for the SSM document. If you want to use an SSM document from another Region or account, you must provide the ARN.</p>
3319+
* If you use the document name, Config checks only your account and Amazon Web Services Region for the SSM document.</p>
32933320
*/
32943321
DocumentName: string | undefined;
32953322

0 commit comments

Comments
 (0)