CreateApplication - Amazon CloudWatch Application Insights

CreateApplication

Adds an application that is created from a resource group.

Request Syntax

{ "AttachMissingPermission": boolean, "AutoConfigEnabled": boolean, "AutoCreate": boolean, "CWEMonitorEnabled": boolean, "GroupingType": "string", "OpsCenterEnabled": boolean, "OpsItemSNSTopicArn": "string", "ResourceGroupName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

AttachMissingPermission

If set to true, the managed policies for SSM and CW will be attached to the instance roles if they are missing.

Type: Boolean

Required: No

AutoConfigEnabled

Indicates whether Application Insights automatically configures unmonitored resources in the resource group.

Type: Boolean

Required: No

AutoCreate

Configures all of the resources in the resource group by applying the recommended configurations.

Type: Boolean

Required: No

CWEMonitorEnabled

Indicates whether Application Insights can listen to CloudWatch events for the application resources, such as instance terminated, failed deployment, and others.

Type: Boolean

Required: No

GroupingType

Application Insights can create applications based on a resource group or on an account. To create an account-based application using all of the resources in the account, set this parameter to ACCOUNT_BASED.

Type: String

Valid Values: ACCOUNT_BASED

Required: No

OpsCenterEnabled

When set to true, creates opsItems for any problems detected on an application.

Type: Boolean

Required: No

OpsItemSNSTopicArn

The SNS topic provided to Application Insights that is associated to the created opsItem. Allows you to receive notifications for updates to the opsItem.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 300.

Pattern: ^arn:aws(-\w+)*:[\w\d-]+:([\w\d-]*)?:[\w\d_-]*([:/].+)*$

Required: No

ResourceGroupName

The name of the resource group.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: [a-zA-Z0-9\.\-_]*

Required: No

Tags

List of tags to add to the application. tag key (Key) and an associated tag value (Value). The maximum length of a tag key is 128 characters. The maximum length of a tag value is 256 characters.

Type: Array of Tag objects

Array Members: Minimum number of 0 items. Maximum number of 200 items.

Required: No

Response Syntax

{ "ApplicationInfo": { "AccountId": "string", "AttachMissingPermission": boolean, "AutoConfigEnabled": boolean, "CWEMonitorEnabled": boolean, "DiscoveryType": "string", "LifeCycle": "string", "OpsCenterEnabled": boolean, "OpsItemSNSTopicArn": "string", "Remarks": "string", "ResourceGroupName": "string" } }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

ApplicationInfo

Information about the application.

Type: ApplicationInfo object

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

User does not have permissions to perform this action.

HTTP Status Code: 400

InternalServerException

The server encountered an internal error and is unable to complete the request.

HTTP Status Code: 400

ResourceInUseException

The resource is already created or in use.

HTTP Status Code: 400

ResourceNotFoundException

The resource does not exist in the customer account.

HTTP Status Code: 400

TagsAlreadyExistException

Tags are already registered for the specified application ARN.

HTTP Status Code: 400

ValidationException

The parameter is not valid.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: