AWS::CodeGuruProfiler::ProfilingGroup - AWS CloudFormation

AWS::CodeGuruProfiler::ProfilingGroup

Creates a profiling group.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::CodeGuruProfiler::ProfilingGroup", "Properties" : { "AgentPermissions" : Json, "AnomalyDetectionNotificationConfiguration" : [ Channel, ... ], "ComputePlatform" : String, "ProfilingGroupName" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::CodeGuruProfiler::ProfilingGroup Properties: AgentPermissions: Json AnomalyDetectionNotificationConfiguration: - Channel ComputePlatform: String ProfilingGroupName: String Tags: - Tag

Properties

AgentPermissions

The agent permissions attached to this profiling group.

Required: No

Type: Json

Update requires: No interruption

AnomalyDetectionNotificationConfiguration

Add anomaly notifications for a profiling group.

Required: No

Type: List of Channel

Update requires: No interruption

ComputePlatform

The compute platform of the profiling group. Use AWSLambda if your application runs on AWS Lambda. Use Default if your application runs on a compute platform that is not AWS Lambda, such an Amazon EC2 instance, an on-premises server, or a different platform. If not specified, Default is used. This property is immutable.

Required: No

Type: String

Update requires: Replacement

ProfilingGroupName

The name of the profiling group.

Required: Yes

Type: String

Update requires: Replacement

Tags

A list of tags to add to the created profiling group.

Required: No

Type: List of Tag

Update requires: No interruption

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the name of the profiling group.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

Arn

The full Amazon Resource Name (ARN) for that profiling group.

Examples

CodeGuru Profiler profiling group resource configuration

The following is an example of the profiling group resource with the profiling group name and agent permissions properties.

JSON

"MyProfilingGroupWithAgentPermissions": { "Type": "AWS::CodeGuruProfiler::ProfilingGroup", "Properties": { "ProfilingGroupName": "MyProfilingGroup", "AgentPermissions": { "Principals": [ "arn:aws:iam::1233456789012:role/agent-permissions-role-1", "arn:aws:iam::1233456789012:role/agent-permissions-role-2" ] } } }

YAML

MyProfilingGroupWithAgentPermissions: Type: AWS::CodeGuruProfiler::ProfilingGroup Properties: ProfilingGroupName: "MyProfilingGroup" AgentPermissions: Principals: - "arn:aws:iam::1233456789012:role/agent-permissions-role-1" - "arn:aws:iam::1233456789012:role/agent-permissions-role-2"

CodeGuru Profiler profiling group resource with compute platform

The following is an example of the profiling group resource that runs on AWS Lambda.

JSON

"MyProfilingGroupWithComputePlatform": { "Type": "AWS::CodeGuruProfiler::ProfilingGroup", "Properties": { "ProfilingGroupName": "MyProfilingGroup", "ComputePlatform": "AWSLambda" } }

YAML

MyProfilingGroupWithComputePlatform: Type: AWS::CodeGuruProfiler::ProfilingGroup Properties: ProfilingGroupName: "MyProfilingGroup" ComputePlatform: "AWSLambda"

CodeGuru Profiler profiling group resource with notifications

The following is an example of the a notification configuration for a profiling group.

JSON

"MyProfilingGroupWithNotificationChannelConfiguration": { "Type": "AWS::CodeGuruProfiler::ProfilingGroup", "Properties": { "ProfilingGroupName": "MyProfilingGroup", "AnomalyDetectionNotificationConfiguration": [ { "channelUri": "SOME_SNS_TOPIC_ARN", "channelId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee" } ] } }

YAML

MyProfilingGroupWithNotificationChannelConfiguration: Type: AWS::CodeGuruProfiler::ProfilingGroup Properties: ProfilingGroupName: MyProfilingGroup AnomalyDetectionNotificationConfiguration: - channelUri: SOME_SNS_TOPIC_ARN channelId: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee