Class CreateExtensionAssociationCommandProtected

When you create an extension or configure an Amazon Web Services authored extension, you associate the extension with an AppConfig application, environment, or configuration profile. For example, you can choose to run the AppConfig deployment events to Amazon SNS Amazon Web Services authored extension and receive notifications on an Amazon SNS topic anytime a configuration deployment is started for a specific application. Defining which extension to associate with an AppConfig resource is called an extension association. An extension association is a specified relationship between an extension and an AppConfig resource, such as an application or a configuration profile. For more information about extensions and associations, see Working with AppConfig extensions in the AppConfig User Guide.

Example

Use a bare-bones client and the command you need to make an API call.

import { AppConfigClient, CreateExtensionAssociationCommand } from "@aws-sdk/client-appconfig"; // ES Modules import
// const { AppConfigClient, CreateExtensionAssociationCommand } = require("@aws-sdk/client-appconfig"); // CommonJS import
const client = new AppConfigClient(config);
const input = { // CreateExtensionAssociationRequest
  ExtensionIdentifier: "STRING_VALUE", // required
  ExtensionVersionNumber: Number("int"),
  ResourceIdentifier: "STRING_VALUE", // required
  Parameters: { // ParameterValueMap
    "<keys>": "STRING_VALUE",
  },
  Tags: { // TagMap
    "<keys>": "STRING_VALUE",
  },
};
const command = new CreateExtensionAssociationCommand(input);
const response = await client.send(command);
// { // ExtensionAssociation
//   Id: "STRING_VALUE",
//   ExtensionArn: "STRING_VALUE",
//   ResourceArn: "STRING_VALUE",
//   Arn: "STRING_VALUE",
//   Parameters: { // ParameterValueMap
//     "<keys>": "STRING_VALUE",
//   },
//   ExtensionVersionNumber: Number("int"),
// };

Param

CreateExtensionAssociationCommandInput

Returns

CreateExtensionAssociationCommandOutput

See

• CreateExtensionAssociationCommandInput for command's input shape.
• CreateExtensionAssociationCommandOutput for command's response shape.
• config for AppConfigClient's config shape.

Throws

BadRequestException (client fault)

The input fails to satisfy the constraints specified by an Amazon Web Services service.

Throws

InternalServerException (server fault)

There was an internal failure in the AppConfig service.

Throws

ResourceNotFoundException (client fault)

The requested resource could not be found.

Throws

ServiceQuotaExceededException (client fault)

The number of one more AppConfig resources exceeds the maximum allowed. Verify that your environment doesn't exceed the following service quotas:

Applications: 100 max

Deployment strategies: 20 max

Configuration profiles: 100 max per application

Environments: 20 max per application

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 Service quotas for AppConfig in the Amazon Web Services General Reference.

Throws

AppConfigServiceException

Base exception class for all service exceptions from AppConfig service.