docs(client-ssm): July 2025 doc-only updates for Systems Manager.

awstools · awstools · commit 4c081fec90e4 · 2025-07-18T18:13:21.000Z
diff --git a/clients/client-ssm/README.md b/clients/client-ssm/README.md
@@ -22,7 +22,7 @@ Systems Manager tools</a> in the <i>Amazon Web Services Systems Manager User Gui
 <li>
 <p>For details about predefined runbooks for Automation, a tool in Amazon Web Services Systems Manager, see the
 <i>
-<a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation runbook reference</a>
+<a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation Runbook Reference</a>
 </i>.</p>
 </li>
 <li>
diff --git a/clients/client-ssm/src/SSM.ts b/clients/client-ssm/src/SSM.ts
@@ -3266,7 +3266,7 @@ export interface SSM {
  *             <li>
  *                <p>For details about predefined runbooks for Automation, a tool in Amazon Web Services Systems Manager, see the
  *        <i>
- *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation runbook reference</a>
+ *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation Runbook Reference</a>
  *                   </i>.</p>
  *             </li>
  *             <li>
diff --git a/clients/client-ssm/src/SSMClient.ts b/clients/client-ssm/src/SSMClient.ts
@@ -1004,7 +1004,7 @@ export interface SSMClientResolvedConfig extends SSMClientResolvedConfigType {}
  *             <li>
  *                <p>For details about predefined runbooks for Automation, a tool in Amazon Web Services Systems Manager, see the
  *        <i>
- *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation runbook reference</a>
+ *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation Runbook Reference</a>
  *                   </i>.</p>
  *             </li>
  *             <li>
diff --git a/clients/client-ssm/src/commands/DescribeParametersCommand.ts b/clients/client-ssm/src/commands/DescribeParametersCommand.ts
@@ -36,6 +36,9 @@ export interface DescribeParametersCommandOutput extends DescribeParametersResul
  *    reaches an internal limit while processing the results, it stops the operation and returns the
  *    matching values up to that point and a <code>NextToken</code>. You can specify the
  *     <code>NextToken</code> in a subsequent call to get the next set of results.</p>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  *          <important>
  *             <p>If you change the KMS key alias for the KMS key used to encrypt a parameter,
  *     then you must also update the key alias the parameter uses to reference KMS. Otherwise,
diff --git a/clients/client-ssm/src/commands/GetParameterCommand.ts b/clients/client-ssm/src/commands/GetParameterCommand.ts
@@ -29,6 +29,9 @@ export interface GetParameterCommandOutput extends GetParameterResult, __Metadat
 
 /**
  * <p>Get information about a single parameter by specifying the parameter name.</p>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  *          <note>
  *             <p>To get information about more than one parameter at a time, use the <a>GetParameters</a> operation.</p>
  *          </note>
diff --git a/clients/client-ssm/src/commands/GetParameterHistoryCommand.ts b/clients/client-ssm/src/commands/GetParameterHistoryCommand.ts
@@ -33,6 +33,9 @@ export interface GetParameterHistoryCommandOutput extends GetParameterHistoryRes
 
 /**
  * <p>Retrieves the history of all changes to a parameter.</p>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  *          <important>
  *             <p>If you change the KMS key alias for the KMS key used to encrypt a parameter,
  *     then you must also update the key alias the parameter uses to reference KMS. Otherwise,
diff --git a/clients/client-ssm/src/commands/GetParametersByPathCommand.ts b/clients/client-ssm/src/commands/GetParametersByPathCommand.ts
@@ -39,6 +39,9 @@ export interface GetParametersByPathCommandOutput extends GetParametersByPathRes
  *    reaches an internal limit while processing the results, it stops the operation and returns the
  *    matching values up to that point and a <code>NextToken</code>. You can specify the
  *     <code>NextToken</code> in a subsequent call to get the next set of results.</p>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ssm/src/commands/GetParametersCommand.ts b/clients/client-ssm/src/commands/GetParametersCommand.ts
@@ -33,6 +33,9 @@ export interface GetParametersCommandOutput extends GetParametersResult, __Metad
  *             <p>To get information about a single parameter, you can use the <a>GetParameter</a>
  *     operation instead.</p>
  *          </note>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ssm/src/commands/LabelParameterVersionCommand.ts b/clients/client-ssm/src/commands/LabelParameterVersionCommand.ts
@@ -64,6 +64,11 @@ export interface LabelParameterVersionCommandOutput extends LabelParameterVersio
  *      sensitive). If a label fails to meet these requirements, then the label isn't associated with a
  *      parameter and the system displays it in the list of InvalidLabels.</p>
  *             </li>
+ *             <li>
+ *                <p>Parameter names can't contain spaces. The service removes any spaces specified for
+ *      the beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *      between characters, the request fails with a <code>ValidationException</code> error.</p>
+ *             </li>
  *          </ul>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-ssm/src/commands/PutComplianceItemsCommand.ts b/clients/client-ssm/src/commands/PutComplianceItemsCommand.ts
@@ -44,6 +44,13 @@ export interface PutComplianceItemsCommandOutput extends PutComplianceItemsResul
  *             <li>
  *                <p>ExecutionTime. The time the patch, association, or custom compliance item was applied to
  *      the managed node.</p>
+ *                <important>
+ *                   <p>For State Manager associations, this represents the time when compliance status was
+ *       captured by the Systems Manager service during its internal compliance aggregation workflow, not
+ *       necessarily when the association was executed on the managed node. State Manager updates
+ *       compliance information for all associations on an instance whenever any association executes,
+ *       which may result in multiple associations showing the same execution time.</p>
+ *                </important>
  *             </li>
  *             <li>
  *                <p>Id: The patch, association, or custom compliance ID.</p>
diff --git a/clients/client-ssm/src/commands/UnlabelParameterVersionCommand.ts b/clients/client-ssm/src/commands/UnlabelParameterVersionCommand.ts
@@ -29,6 +29,9 @@ export interface UnlabelParameterVersionCommandOutput extends UnlabelParameterVe
 
 /**
  * <p>Remove a label or labels from a parameter.</p>
+ *          <p>Parameter names can't contain spaces. The service removes any spaces specified for the
+ *    beginning or end of a parameter name. If the specified name for a parameter contains spaces
+ *    between characters, the request fails with a <code>ValidationException</code> error.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-ssm/src/index.ts b/clients/client-ssm/src/index.ts
@@ -17,7 +17,7 @@
  *             <li>
  *                <p>For details about predefined runbooks for Automation, a tool in Amazon Web Services Systems Manager, see the
  *        <i>
- *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation runbook reference</a>
+ *                      <a href="https://docs.aws.amazon.com/systems-manager-automation-runbooks/latest/userguide/automation-runbook-reference.html">Systems Manager Automation Runbook Reference</a>
  *                   </i>.</p>
  *             </li>
  *             <li>
diff --git a/clients/client-ssm/src/models/models_0.ts b/clients/client-ssm/src/models/models_0.ts
@@ -3893,7 +3893,10 @@ export interface PatchSource {
   Products: string[] | undefined;
 
   /**
-   * <p>The value of the yum repo configuration. For example:</p>
+   * <p>The value of the repo configuration.</p>
+   *          <p>
+   *             <b>Example for yum repositories</b>
+   *          </p>
    *          <p>
    *             <code>[main]</code>
    *          </p>
@@ -3906,10 +3909,22 @@ export interface PatchSource {
    *          <p>
    *             <code>enabled=1</code>
    *          </p>
-   *          <note>
-   *             <p>For information about other options available for your yum repository configuration, see
-   *      <a href="https://man7.org/linux/man-pages/man5/dnf.conf.5.html">dnf.conf(5)</a>.</p>
-   *          </note>
+   *          <p>For information about other options available for your yum repository configuration, see
+   *     <a href="https://man7.org/linux/man-pages/man5/dnf.conf.5.html">dnf.conf(5)</a> on the
+   *     <i>man7.org</i> website.</p>
+   *          <p>
+   *             <b>Examples for Ubuntu Server and Debian Server</b>
+   *          </p>
+   *          <p>
+   *             <code>deb http://security.ubuntu.com/ubuntu jammy main</code>
+   *          </p>
+   *          <p>
+   *             <code>deb https://site.example.com/debian distribution component1 component2 component3</code>
+   *          </p>
+   *          <p>Repo information for Ubuntu Server repositories must be specifed in a single line. For more
+   *    examples and information, see <a href="https://manpages.ubuntu.com/manpages/jammy/man5/sources.list.5.html">jammy (5)
+   *     sources.list.5.gz</a> on the <i>Ubuntu Server Manuals</i> website and <a href="https://wiki.debian.org/SourcesList#sources.list_format">sources.list format</a> on the
+   *     <i>Debian Wiki</i>.</p>
    * @public
    */
   Configuration: string | undefined;
diff --git a/clients/client-ssm/src/models/models_1.ts b/clients/client-ssm/src/models/models_1.ts
@@ -1909,7 +1909,7 @@ export interface Session {
   /**
    * <p>
    *             <code>Standard</code> access type is the default for Session Manager sessions.
-   *     <code>JustInTime</code> is the access type for <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-just-in-time-node-access.html">Just-in-time node access</a>. </p>
+   *     <code>JustInTime</code> is the access type for <a href="https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-just-in-time-node-access.html">Just-in-time node access</a>.</p>
    * @public
    */
   AccessType?: AccessType | undefined;
@@ -3422,6 +3422,50 @@ export type InventoryQueryOperatorType = (typeof InventoryQueryOperatorType)[key
 
 /**
  * <p>One or more filters. Use a filter to return a more specific list of results.</p>
+ *          <p>
+ *             <b>Example formats for the <code>aws ssm get-inventory</code>
+ *     command:</b>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *     Key=AWS:InstanceInformation.AgentType,Values=amazon-ssm-agent,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *    Key=AWS:InstanceInformation.AgentVersion,Values=3.3.2299.0,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *     Key=AWS:InstanceInformation.ComputerName,Values=ip-192.0.2.0.us-east-2.compute.internal,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *     Key=AWS:InstanceInformation.InstanceId,Values=i-0a4cd6ceffEXAMPLE,i-1a2b3c4d5e6EXAMPLE,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *    Key=AWS:InstanceInformation.InstanceStatus,Values=Active,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *    Key=AWS:InstanceInformation.IpAddress,Values=198.51.100.0,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters Key=AWS:InstanceInformation.PlatformName,Values="Amazon
+ *     Linux",Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *    Key=AWS:InstanceInformation.PlatformType,Values=Linux,Type=Equal</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *     Key=AWS:InstanceInformation.PlatformVersion,Values=2023,Type=BeginWith</code>
+ *          </p>
+ *          <p>
+ *             <code>--filters
+ *     Key=AWS:InstanceInformation.ResourceType,Values=EC2Instance,Type=Equal</code>
+ *          </p>
  * @public
  */
 export interface InventoryFilter {
@@ -3432,9 +3476,7 @@ export interface InventoryFilter {
   Key: string | undefined;
 
   /**
-   * <p>Inventory filter values. Example: inventory filter where managed node IDs are specified as
-   *    values <code>Key=AWS:InstanceInformation.InstanceId,Values= i-a12b3c4d5e6g,
-   *     i-1a2b3c4d5e6,Type=Equal</code>. </p>
+   * <p>Inventory filter values.</p>
    * @public
    */
   Values: string[] | undefined;
@@ -7350,6 +7392,12 @@ export interface ComplianceExecutionSummary {
    * <p>The time the execution ran as a datetime object that is saved in the following format:
    *     <code>yyyy-MM-dd'T'HH:mm:ss'Z'</code>
    *          </p>
+   *          <important>
+   *             <p>For State Manager associations, this timestamp represents when the compliance status was
+   *     captured and reported by the Systems Manager service, not when the underlying association was actually
+   *     executed on the managed node. To track actual association execution times, use the <a>DescribeAssociationExecutionTargets</a> command or check the association execution
+   *     history in the Systems Manager console.</p>
+   *          </important>
    * @public
    */
   ExecutionTime: Date | undefined;
@@ -7459,6 +7507,14 @@ export interface ComplianceItem {
   /**
    * <p>A summary for the compliance item. The summary includes an execution ID, the execution type
    *    (for example, command), and the execution time.</p>
+   *          <important>
+   *             <p>For State Manager associations, the <code>ExecutionTime</code> value represents when the
+   *     compliance status was captured and aggregated by the Systems Manager service, not necessarily when the
+   *     underlying association was executed on the managed node. State Manager updates compliance status
+   *     for all associations on an instance whenever any association executes, which means multiple
+   *     associations may show the same execution time even if they were executed at different
+   *     times.</p>
+   *          </important>
    * @public
    */
   ExecutionSummary?: ComplianceExecutionSummary | undefined;
@@ -10273,7 +10329,9 @@ export interface PutParameterRequest {
    *                </p>
    *             </li>
    *             <li>
-   *                <p>A parameter name can't include spaces.</p>
+   *                <p>Parameter names can't contain spaces. The service removes any spaces specified for
+   *      the beginning or end of a parameter name. If the specified name for a parameter contains spaces
+   *      between characters, the request fails with a <code>ValidationException</code> error.</p>
    *             </li>
    *             <li>
    *                <p>Parameter hierarchies are limited to a maximum depth of fifteen levels.</p>
diff --git a/codegen/sdk-codegen/aws-models/ssm.json b/codegen/sdk-codegen/aws-models/ssm.json
