feat(client-lightsail): Add support for tagging of Alarm resource type

awstools · awstools · commit ad9e0d7195bf · 2026-04-03T18:14:17.000Z
diff --git a/clients/client-lightsail/src/commands/CreateContactMethodCommand.ts b/clients/client-lightsail/src/commands/CreateContactMethodCommand.ts
@@ -32,6 +32,8 @@ export interface CreateContactMethodCommandOutput extends CreateContactMethodRes
  *       You can add one email address and one mobile phone number contact method in each Amazon Web Services Region. However, SMS text messaging is not supported in some Amazon Web Services
  *       Regions, and SMS text messages cannot be sent to some countries/regions. For more information,
  *       see <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-notifications">Notifications in Amazon Lightsail</a>.</p>
+ *          <p>The <code>create contact method</code> operation supports tag-based access control via request
+ *       tags. For more information, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-controlling-access-using-tags">Lightsail Developer Guide</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-lightsail/src/commands/GetAlarmsCommand.ts b/clients/client-lightsail/src/commands/GetAlarmsCommand.ts
@@ -83,6 +83,12 @@ export interface GetAlarmsCommandOutput extends GetAlarmsResult, __MetadataBeare
  * //         "OK" || "ALARM" || "INSUFFICIENT_DATA",
  * //       ],
  * //       notificationEnabled: true || false,
+ * //       tags: [ // TagList
+ * //         { // Tag
+ * //           key: "STRING_VALUE",
+ * //           value: "STRING_VALUE",
+ * //         },
+ * //       ],
  * //     },
  * //   ],
  * //   nextPageToken: "STRING_VALUE",
diff --git a/clients/client-lightsail/src/commands/PutAlarmCommand.ts b/clients/client-lightsail/src/commands/PutAlarmCommand.ts
@@ -38,6 +38,8 @@ export interface PutAlarmCommandOutput extends PutAlarmResult, __MetadataBearer
  *          <p>When you update an existing alarm, its state is left unchanged, but the update completely
  *       overwrites the previous configuration of the alarm. The alarm is then evaluated with the
  *       updated configuration.</p>
+ *          <p>The <code>put alarm</code> operation supports tag-based access control via request
+ *       tags. For more information, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-controlling-access-using-tags">Lightsail Developer Guide</a>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -62,6 +64,12 @@ export interface PutAlarmCommandOutput extends PutAlarmResult, __MetadataBearer
  *     "OK" || "ALARM" || "INSUFFICIENT_DATA",
  *   ],
  *   notificationEnabled: true || false,
+ *   tags: [ // TagList
+ *     { // Tag
+ *       key: "STRING_VALUE",
+ *       value: "STRING_VALUE",
+ *     },
+ *   ],
  * };
  * const command = new PutAlarmCommand(input);
  * const response = await client.send(command);
diff --git a/clients/client-lightsail/src/models/models_0.ts b/clients/client-lightsail/src/models/models_0.ts
@@ -540,6 +540,29 @@ export interface MonitoredResourceInfo {
   resourceType?: ResourceType | undefined;
 }
 
+/**
+ * <p>Describes a tag key and optional value assigned to an Amazon Lightsail resource.</p>
+ *          <p>For more information about tags in Lightsail, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags">Amazon Lightsail Developer Guide</a>.</p>
+ * @public
+ */
+export interface Tag {
+  /**
+   * <p>The key of the tag.</p>
+   *          <p>Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the
+   *       following characters: + - = . _ : / @</p>
+   * @public
+   */
+  key?: string | undefined;
+
+  /**
+   * <p>The value of the tag.</p>
+   *          <p>Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the
+   *       following characters: + - = . _ : / @</p>
+   * @public
+   */
+  value?: string | undefined;
+}
+
 /**
  * <p>Describes an alarm.</p>
  *          <p>An alarm is a way to monitor your Lightsail resource metrics. For more information, see
@@ -740,6 +763,13 @@ export interface Alarm {
    * @public
    */
   notificationEnabled?: boolean | undefined;
+
+  /**
+   * <p>The tag keys and optional values for the resource. For more information about tags in
+   *       Lightsail, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags">Amazon Lightsail Developer Guide</a>.</p>
+   * @public
+   */
+  tags?: Tag[] | undefined;
 }
 
 /**
@@ -1361,29 +1391,6 @@ export interface BucketState {
   message?: string | undefined;
 }
 
-/**
- * <p>Describes a tag key and optional value assigned to an Amazon Lightsail resource.</p>
- *          <p>For more information about tags in Lightsail, see the <a href="https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags">Amazon Lightsail Developer Guide</a>.</p>
- * @public
- */
-export interface Tag {
-  /**
-   * <p>The key of the tag.</p>
-   *          <p>Constraints: Tag keys accept a maximum of 128 letters, numbers, spaces in UTF-8, or the
-   *       following characters: + - = . _ : / @</p>
-   * @public
-   */
-  key?: string | undefined;
-
-  /**
-   * <p>The value of the tag.</p>
-   *          <p>Constraints: Tag values accept a maximum of 256 letters, numbers, spaces in UTF-8, or the
-   *       following characters: + - = . _ : / @</p>
-   * @public
-   */
-  value?: string | undefined;
-}
-
 /**
  * <p>Describes an Amazon Lightsail bucket.</p>
  * @public
diff --git a/clients/client-lightsail/src/models/models_1.ts b/clients/client-lightsail/src/models/models_1.ts
@@ -3247,6 +3247,13 @@ export interface PutAlarmRequest {
    * @public
    */
   notificationEnabled?: boolean | undefined;
+
+  /**
+   * <p>The tag keys and optional values to add to the alarm during create.</p>
+   *          <p>Use the <code>TagResource</code> action to tag a resource after it's created.</p>
+   * @public
+   */
+  tags?: Tag[] | undefined;
 }
 
 /**
diff --git a/clients/client-lightsail/src/schemas/schemas_0.ts b/clients/client-lightsail/src/schemas/schemas_0.ts
@@ -1301,8 +1301,8 @@ export var AddOnRequest$: StaticStructureSchema = [3, n0, _AOR,
 ];
 export var Alarm$: StaticStructureSchema = [3, n0, _A,
   0,
-  [_n, _a, _cA, _l, _rT, _sC, _mRI, _cO, _eP, _p, _th, _dTA, _tMD, _sta, _mN, _stat, _u, _cP, _nT, _nE],
-  [0, 0, 4, () => ResourceLocation$, 0, 0, () => MonitoredResourceInfo$, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 64 | 0, 64 | 0, 2]
+  [_n, _a, _cA, _l, _rT, _sC, _mRI, _cO, _eP, _p, _th, _dTA, _tMD, _sta, _mN, _stat, _u, _cP, _nT, _nE, _ta],
+  [0, 0, 4, () => ResourceLocation$, 0, 0, () => MonitoredResourceInfo$, 0, 1, 1, 1, 1, 0, 0, 0, 0, 0, 64 | 0, 64 | 0, 2, () => TagList]
 ];
 export var AllocateStaticIpRequest$: StaticStructureSchema = [3, n0, _ASIR,
   0,
@@ -3046,8 +3046,8 @@ export var PrivateRegistryAccessRequest$: StaticStructureSchema = [3, n0, _PRAR,
 ];
 export var PutAlarmRequest$: StaticStructureSchema = [3, n0, _PAR,
   0,
-  [_aN, _mN, _mRN, _cO, _th, _eP, _dTA, _tMD, _cP, _nT, _nE],
-  [0, 0, 0, 0, 1, 1, 1, 0, 64 | 0, 64 | 0, 2], 6
+  [_aN, _mN, _mRN, _cO, _th, _eP, _dTA, _tMD, _cP, _nT, _nE, _ta],
+  [0, 0, 0, 0, 1, 1, 1, 0, 64 | 0, 64 | 0, 2, () => TagList], 6
 ];
 export var PutAlarmResult$: StaticStructureSchema = [3, n0, _PARu,
   0,
diff --git a/codegen/sdk-codegen/aws-models/lightsail.json b/codegen/sdk-codegen/aws-models/lightsail.json
@@ -486,6 +486,12 @@
           "traits": {
             "smithy.api#documentation": "<p>Indicates whether the alarm is enabled.</p>"
           }
+        },
+        "tags": {
+          "target": "com.amazonaws.lightsail#TagList",
+          "traits": {
+            "smithy.api#documentation": "<p>The tag keys and optional values for the resource. For more information about tags in\n      Lightsail, see the <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-tags\">Amazon Lightsail Developer Guide</a>.</p>"
+          }
         }
       },
       "traits": {
@@ -3815,7 +3821,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Creates an email or SMS text message contact method.</p>\n         <p>A contact method is used to send you notifications about your Amazon Lightsail resources.\n      You can add one email address and one mobile phone number contact method in each Amazon Web Services Region. However, SMS text messaging is not supported in some Amazon Web Services\n      Regions, and SMS text messages cannot be sent to some countries/regions. For more information,\n      see <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-notifications\">Notifications in Amazon Lightsail</a>.</p>",
+        "smithy.api#documentation": "<p>Creates an email or SMS text message contact method.</p>\n         <p>A contact method is used to send you notifications about your Amazon Lightsail resources.\n      You can add one email address and one mobile phone number contact method in each Amazon Web Services Region. However, SMS text messaging is not supported in some Amazon Web Services\n      Regions, and SMS text messages cannot be sent to some countries/regions. For more information,\n      see <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-notifications\">Notifications in Amazon Lightsail</a>.</p>\n         <p>The <code>create contact method</code> operation supports tag-based access control via request\n      tags. For more information, see the <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-controlling-access-using-tags\">Lightsail Developer Guide</a>.</p>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/ls/api/2016-11-28/CreateContactMethod",
@@ -19664,7 +19670,7 @@
         }
       ],
       "traits": {
-        "smithy.api#documentation": "<p>Creates or updates an alarm, and associates it with the specified metric.</p>\n         <p>An alarm is used to monitor a single metric for one of your resources. When a metric\n      condition is met, the alarm can notify you by email, SMS text message, and a banner displayed\n      on the Amazon Lightsail console. For more information, see <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-alarms\">Alarms\n        in Amazon Lightsail</a>.</p>\n         <p>When this action creates an alarm, the alarm state is immediately set to\n        <code>INSUFFICIENT_DATA</code>. The alarm is then evaluated and its state is set\n      appropriately. Any actions associated with the new state are then executed.</p>\n         <p>When you update an existing alarm, its state is left unchanged, but the update completely\n      overwrites the previous configuration of the alarm. The alarm is then evaluated with the\n      updated configuration.</p>",
+        "smithy.api#documentation": "<p>Creates or updates an alarm, and associates it with the specified metric.</p>\n         <p>An alarm is used to monitor a single metric for one of your resources. When a metric\n      condition is met, the alarm can notify you by email, SMS text message, and a banner displayed\n      on the Amazon Lightsail console. For more information, see <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-alarms\">Alarms\n        in Amazon Lightsail</a>.</p>\n         <p>When this action creates an alarm, the alarm state is immediately set to\n        <code>INSUFFICIENT_DATA</code>. The alarm is then evaluated and its state is set\n      appropriately. Any actions associated with the new state are then executed.</p>\n         <p>When you update an existing alarm, its state is left unchanged, but the update completely\n      overwrites the previous configuration of the alarm. The alarm is then evaluated with the\n      updated configuration.</p>\n         <p>The <code>put alarm</code> operation supports tag-based access control via request\n      tags. For more information, see the <a href=\"https://docs.aws.amazon.com/lightsail/latest/userguide/amazon-lightsail-controlling-access-using-tags\">Lightsail Developer Guide</a>.</p>",
         "smithy.api#http": {
           "method": "POST",
           "uri": "/ls/api/2016-11-28/PutAlarm",
@@ -19746,6 +19752,12 @@
           "traits": {
             "smithy.api#documentation": "<p>Indicates whether the alarm is enabled.</p>\n         <p>Notifications are enabled by default if you don't specify this parameter.</p>"
           }
+        },
+        "tags": {
+          "target": "com.amazonaws.lightsail#TagList",
+          "traits": {
+            "smithy.api#documentation": "<p>The tag keys and optional values to add to the alarm during create.</p>\n         <p>Use the <code>TagResource</code> action to tag a resource after it's created.</p>"
+          }
         }
       },
       "traits": {
