@aws-sdk/client-ssm 3.848.0 → 3.849.0

package/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>

package/dist-types/SSM.d.ts

@@ -1071,7 +1071,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>

package/dist-types/SSMClient.d.ts

@@ -331,7 +331,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>

package/dist-types/commands/DescribeParametersCommand.d.ts

@@ -35,6 +35,9 @@ declare const DescribeParametersCommand_base: {
  *    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,

package/dist-types/commands/GetParameterCommand.d.ts

@@ -28,6 +28,9 @@ declare const GetParameterCommand_base: {
 };
 /**
  * <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>

package/dist-types/commands/GetParameterHistoryCommand.d.ts

@@ -28,6 +28,9 @@ declare const GetParameterHistoryCommand_base: {
 };
 /**
  * <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,

package/dist-types/commands/GetParametersByPathCommand.d.ts

@@ -34,6 +34,9 @@ declare const GetParametersByPathCommand_base: {
  *    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

package/dist-types/commands/GetParametersCommand.d.ts

@@ -32,6 +32,9 @@ declare const GetParametersCommand_base: {
  *             <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

package/dist-types/commands/LabelParameterVersionCommand.d.ts

@@ -63,6 +63,11 @@ declare const LabelParameterVersionCommand_base: {
  *      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.

package/dist-types/commands/PutComplianceItemsCommand.d.ts

@@ -43,6 +43,13 @@ declare const PutComplianceItemsCommand_base: {
  *             <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>

package/dist-types/commands/UnlabelParameterVersionCommand.d.ts

@@ -28,6 +28,9 @@ declare const UnlabelParameterVersionCommand_base: {
 };
 /**
  * <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

package/dist-types/index.d.ts

@@ -15,7 +15,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>

package/dist-types/models/models_0.d.ts

@@ -3240,7 +3240,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>
@@ -3253,10 +3256,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;

package/dist-types/models/models_1.d.ts

@@ -1653,7 +1653,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;
@@ -2932,6 +2932,50 @@ export declare const InventoryQueryOperatorType: {
 export type InventoryQueryOperatorType = (typeof InventoryQueryOperatorType)[keyof typeof InventoryQueryOperatorType];
 /**
  * <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 {
@@ -2941,9 +2985,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;
@@ -6404,6 +6446,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;
@@ -6499,6 +6547,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;
@@ -8844,7 +8900,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>

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-ssm",
   "description": "AWS SDK for JavaScript Ssm Client for Node.js, Browser and React Native",
-  "version": "3.848.0",
+  "version": "3.849.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "node ../../scripts/compilation/inline client-ssm",