feat(client-appconfig): Enabling boto3 paginators for list APIs and adding documentation around ServiceQuotaExceededException errors

awstools · awstools · commit 78ddf33a50ba · 2023-09-20T19:23:46.000Z
diff --git a/clients/client-appconfig/src/commands/CreateApplicationCommand.ts b/clients/client-appconfig/src/commands/CreateApplicationCommand.ts
@@ -76,6 +76,17 @@ export interface CreateApplicationCommandOutput extends Application, __MetadataB
  * @throws {@link InternalServerException} (server fault)
  *  <p>There was an internal failure in the AppConfig service.</p>
  *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
+ *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
  *
diff --git a/clients/client-appconfig/src/commands/CreateConfigurationProfileCommand.ts b/clients/client-appconfig/src/commands/CreateConfigurationProfileCommand.ts
@@ -139,6 +139,17 @@ export interface CreateConfigurationProfileCommandOutput extends ConfigurationPr
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>The requested resource could not be found.</p>
  *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
+ *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
  *
diff --git a/clients/client-appconfig/src/commands/CreateDeploymentStrategyCommand.ts b/clients/client-appconfig/src/commands/CreateDeploymentStrategyCommand.ts
@@ -85,6 +85,17 @@ export interface CreateDeploymentStrategyCommandOutput extends DeploymentStrateg
  * @throws {@link InternalServerException} (server fault)
  *  <p>There was an internal failure in the AppConfig service.</p>
  *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
+ *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
  *
diff --git a/clients/client-appconfig/src/commands/CreateEnvironmentCommand.ts b/clients/client-appconfig/src/commands/CreateEnvironmentCommand.ts
@@ -97,6 +97,17 @@ export interface CreateEnvironmentCommandOutput extends Environment, __MetadataB
  * @throws {@link ResourceNotFoundException} (client fault)
  *  <p>The requested resource could not be found.</p>
  *
+ * @throws {@link ServiceQuotaExceededException} (client fault)
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
+ *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
  *
diff --git a/clients/client-appconfig/src/commands/CreateExtensionAssociationCommand.ts b/clients/client-appconfig/src/commands/CreateExtensionAssociationCommand.ts
@@ -97,7 +97,15 @@ export interface CreateExtensionAssociationCommandOutput extends ExtensionAssoci
  *  <p>The requested resource could not be found.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  <p>The number of hosted configuration versions exceeds the limit for the AppConfig hosted configuration store. Delete one or more versions and try again.</p>
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
  *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
diff --git a/clients/client-appconfig/src/commands/CreateExtensionCommand.ts b/clients/client-appconfig/src/commands/CreateExtensionCommand.ts
@@ -40,9 +40,25 @@ export interface CreateExtensionCommandOutput extends Extension, __MetadataBeare
  *          logic or behavior at different points during the AppConfig workflow of creating
  *          or deploying a configuration.</p>
  *          <p>You can create your own extensions or use the Amazon Web Services authored extensions provided by
- *             AppConfig. For most use cases, to create your own extension, you must create
- *          an Lambda function to perform any computation and processing defined in the
- *          extension. For more information about extensions, see <a href="https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html">Working with
+ *             AppConfig. For an AppConfig extension that uses Lambda, you must create a Lambda function to perform any computation and processing
+ *          defined in the extension. If you plan to create custom versions of the Amazon Web Services
+ *          authored notification extensions, you only need to specify an Amazon Resource Name (ARN) in
+ *          the <code>Uri</code> field for the new extension version.</p>
+ *          <ul>
+ *             <li>
+ *                <p>For a custom EventBridge notification extension, enter the ARN of the EventBridge
+ *                default events in the <code>Uri</code> field.</p>
+ *             </li>
+ *             <li>
+ *                <p>For a custom Amazon SNS notification extension, enter the ARN of an Amazon SNS
+ *                topic in the <code>Uri</code> field.</p>
+ *             </li>
+ *             <li>
+ *                <p>For a custom Amazon SQS notification extension, enter the ARN of an Amazon SQS
+ *                message queue in the <code>Uri</code> field. </p>
+ *             </li>
+ *          </ul>
+ *          <p>For more information about extensions, see <a href="https://docs.aws.amazon.com/appconfig/latest/userguide/working-with-appconfig-extensions.html">Working with
  *                AppConfig extensions</a> in the
  *          <i>AppConfig User Guide</i>.</p>
  * @example
@@ -120,7 +136,15 @@ export interface CreateExtensionCommandOutput extends Extension, __MetadataBeare
  *  <p>There was an internal failure in the AppConfig service.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  <p>The number of hosted configuration versions exceeds the limit for the AppConfig hosted configuration store. Delete one or more versions and try again.</p>
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
  *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
diff --git a/clients/client-appconfig/src/commands/CreateHostedConfigurationVersionCommand.ts b/clients/client-appconfig/src/commands/CreateHostedConfigurationVersionCommand.ts
@@ -120,7 +120,15 @@ export interface CreateHostedConfigurationVersionCommandOutput
  *  <p>The requested resource could not be found.</p>
  *
  * @throws {@link ServiceQuotaExceededException} (client fault)
- *  <p>The number of hosted configuration versions exceeds the limit for the AppConfig hosted configuration store. Delete one or more versions and try again.</p>
+ *  <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
  *
  * @throws {@link AppConfigServiceException}
  * <p>Base exception class for all service exceptions from AppConfig service.</p>
diff --git a/clients/client-appconfig/src/commands/GetDeploymentCommand.ts b/clients/client-appconfig/src/commands/GetDeploymentCommand.ts
@@ -99,6 +99,7 @@ export interface GetDeploymentCommandOutput extends Deployment, __MetadataBearer
  * //   ],
  * //   KmsKeyArn: "STRING_VALUE",
  * //   KmsKeyIdentifier: "STRING_VALUE",
+ * //   VersionLabel: "STRING_VALUE",
  * // };
  *
  * ```
diff --git a/clients/client-appconfig/src/commands/ListDeploymentsCommand.ts b/clients/client-appconfig/src/commands/ListDeploymentsCommand.ts
@@ -65,6 +65,7 @@ export interface ListDeploymentsCommandOutput extends Deployments, __MetadataBea
  * //       PercentageComplete: Number("float"),
  * //       StartedAt: new Date("TIMESTAMP"),
  * //       CompletedAt: new Date("TIMESTAMP"),
+ * //       VersionLabel: "STRING_VALUE",
  * //     },
  * //   ],
  * //   NextToken: "STRING_VALUE",
diff --git a/clients/client-appconfig/src/commands/StartDeploymentCommand.ts b/clients/client-appconfig/src/commands/StartDeploymentCommand.ts
@@ -106,6 +106,7 @@ export interface StartDeploymentCommandOutput extends Deployment, __MetadataBear
  * //   ],
  * //   KmsKeyArn: "STRING_VALUE",
  * //   KmsKeyIdentifier: "STRING_VALUE",
+ * //   VersionLabel: "STRING_VALUE",
  * // };
  *
  * ```
diff --git a/clients/client-appconfig/src/commands/StopDeploymentCommand.ts b/clients/client-appconfig/src/commands/StopDeploymentCommand.ts
@@ -101,6 +101,7 @@ export interface StopDeploymentCommandOutput extends Deployment, __MetadataBeare
  * //   ],
  * //   KmsKeyArn: "STRING_VALUE",
  * //   KmsKeyIdentifier: "STRING_VALUE",
+ * //   VersionLabel: "STRING_VALUE",
  * // };
  *
  * ```
diff --git a/clients/client-appconfig/src/models/models_0.ts b/clients/client-appconfig/src/models/models_0.ts
@@ -339,6 +339,36 @@ export class InternalServerException extends __BaseException {
   }
 }
 
+/**
+ * @public
+ * <p>The number of one more AppConfig resources exceeds the maximum allowed. Verify that your
+ *          environment doesn't exceed the following service quotas:</p>
+ *          <p>Applications: 100 max</p>
+ *          <p>Deployment strategies: 20 max</p>
+ *          <p>Configuration profiles: 100 max per application</p>
+ *          <p>Environments: 20 max per application</p>
+ *          <p>To resolve this issue, you can delete one or more resources and try again. Or, you
+ *          can request a quota increase. For more information about quotas and to request an increase,
+ *          see <a href="https://docs.aws.amazon.com/general/latest/gr/appconfig.html#limits_appconfig">Service quotas for AppConfig</a> in the Amazon Web Services General Reference.</p>
+ */
+export class ServiceQuotaExceededException extends __BaseException {
+  readonly name: "ServiceQuotaExceededException" = "ServiceQuotaExceededException";
+  readonly $fault: "client" = "client";
+  Message?: string;
+  /**
+   * @internal
+   */
+  constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>) {
+    super({
+      name: "ServiceQuotaExceededException",
+      $fault: "client",
+      ...opts,
+    });
+    Object.setPrototypeOf(this, ServiceQuotaExceededException.prototype);
+    this.Message = opts.Message;
+  }
+}
+
 /**
  * @public
  * @enum
@@ -477,8 +507,13 @@ export interface CreateConfigurationProfileRequest {
    *                the format <code>ssm-parameter://<parameter name></code> or the ARN.</p>
    *             </li>
    *             <li>
+   *                <p>For an Amazon Web Services
+   *                CodePipeline pipeline, specify the URI in the following format:
+   *                   <code>codepipeline</code>://<pipeline name>.</p>
+   *             </li>
+   *             <li>
    *                <p>For an Secrets Manager secret, specify the URI in the following format:
-   *                   <code>secrets-manager</code>://<secret name>.</p>
+   *                   <code>secretsmanager</code>://<secret name>.</p>
    *             </li>
    *             <li>
    *                <p>For an Amazon S3 object, specify the URI in the following format:
@@ -992,28 +1027,6 @@ export interface Extension {
   Parameters?: Record<string, Parameter>;
 }
 
-/**
- * @public
- * <p>The number of hosted configuration versions exceeds the limit for the AppConfig hosted configuration store. Delete one or more versions and try again.</p>
- */
-export class ServiceQuotaExceededException extends __BaseException {
-  readonly name: "ServiceQuotaExceededException" = "ServiceQuotaExceededException";
-  readonly $fault: "client" = "client";
-  Message?: string;
-  /**
-   * @internal
-   */
-  constructor(opts: __ExceptionOptionType<ServiceQuotaExceededException, __BaseException>) {
-    super({
-      name: "ServiceQuotaExceededException",
-      $fault: "client",
-      ...opts,
-    });
-    Object.setPrototypeOf(this, ServiceQuotaExceededException.prototype);
-    this.Message = opts.Message;
-  }
-}
-
 /**
  * @public
  */
@@ -1142,7 +1155,9 @@ export interface CreateHostedConfigurationVersionRequest {
 
   /**
    * @public
-   * <p>An optional, user-defined label for the AppConfig hosted configuration version. This value must contain at least one non-numeric character. For example, "v2.2.0".</p>
+   * <p>An optional, user-defined label for the AppConfig hosted configuration
+   *          version. This value must contain at least one non-numeric character. For example,
+   *          "v2.2.0".</p>
    */
   VersionLabel?: string;
 }
@@ -1549,9 +1564,19 @@ export interface DeploymentEvent {
   /**
    * @public
    * <p>A description of the deployment event. Descriptions include, but are not limited to, the
-   *          user account or the Amazon CloudWatch alarm ARN that initiated a rollback, the percentage of hosts
-   *          that received the deployment, or in the case of an internal error, a recommendation to
-   *          attempt a new deployment.</p>
+   *          following:</p>
+   *          <ul>
+   *             <li>
+   *                <p>The Amazon Web Services account or the Amazon CloudWatch alarm ARN that initiated a rollback.</p>
+   *             </li>
+   *             <li>
+   *                <p>The percentage of hosts that received the deployment.</p>
+   *             </li>
+   *             <li>
+   *                <p>A recommendation to attempt a new deployment (in the case of an internal
+   *                error).</p>
+   *             </li>
+   *          </ul>
    */
   Description?: string;
 
@@ -1723,6 +1748,12 @@ export interface Deployment {
    * <p>The KMS key identifier (key ID, key alias, or key ARN). AppConfig uses this ID to encrypt the configuration data using a customer managed key. </p>
    */
   KmsKeyIdentifier?: string;
+
+  /**
+   * @public
+   * <p>A user-defined label for an AppConfig hosted configuration version.</p>
+   */
+  VersionLabel?: string;
 }
 
 /**
@@ -2040,6 +2071,12 @@ export interface DeploymentSummary {
    * <p>Time the deployment completed.</p>
    */
   CompletedAt?: Date;
+
+  /**
+   * @public
+   * <p>A user-defined label for an AppConfig hosted configuration version.</p>
+   */
+  VersionLabel?: string;
 }
 
 /**
@@ -2429,7 +2466,9 @@ export interface ListHostedConfigurationVersionsRequest {
 
   /**
    * @public
-   * <p>An optional filter that can be used to specify the version label of an AppConfig hosted configuration version. This parameter supports filtering by prefix using a wildcard, for example "v2*". If you don't specify an asterisk at the end of the value, only an exact match is returned.</p>
+   * <p>An optional filter that can be used to specify the version label of an AppConfig hosted configuration version. This parameter supports filtering by prefix using a
+   *          wildcard, for example "v2*". If you don't specify an asterisk at the end of the value, only
+   *          an exact match is returned.</p>
    */
   VersionLabel?: string;
 }
@@ -2488,7 +2527,9 @@ export interface StartDeploymentRequest {
 
   /**
    * @public
-   * <p>The configuration version to deploy. If deploying an AppConfig hosted configuration version, you can specify either the version number or version label.</p>
+   * <p>The configuration version to deploy. If deploying an AppConfig hosted
+   *          configuration version, you can specify either the version number or version label. For all
+   *          other configurations, you must specify the version number.</p>
    */
   ConfigurationVersion: string | undefined;
 
diff --git a/clients/client-appconfig/src/protocols/Aws_restJson1.ts b/clients/client-appconfig/src/protocols/Aws_restJson1.ts
diff --git a/codegen/sdk-codegen/aws-models/appconfig.json b/codegen/sdk-codegen/aws-models/appconfig.json

Original file line number	Diff line number	Diff line change
`@@ -99,6 +99,7 @@ export interface GetDeploymentCommandOutput extends Deployment, __MetadataBearer`
`99`	`99`	`* // ],`
`100`	`100`	`* // KmsKeyArn: "STRING_VALUE",`
`101`	`101`	`* // KmsKeyIdentifier: "STRING_VALUE",`
	`102`	`+ * // VersionLabel: "STRING_VALUE",`
`102`	`103`	`* // };`
`103`	`104`	`*`
`104`	`105`	* ```
Original file line number	Diff line number	Diff line change
`@@ -106,6 +106,7 @@ export interface StartDeploymentCommandOutput extends Deployment, __MetadataBear`
`106`	`106`	`* // ],`
`107`	`107`	`* // KmsKeyArn: "STRING_VALUE",`
`108`	`108`	`* // KmsKeyIdentifier: "STRING_VALUE",`
	`109`	`+ * // VersionLabel: "STRING_VALUE",`
`109`	`110`	`* // };`
`110`	`111`	`*`
`111`	`112`	* ```