Fork me on GitHub

Module cloudwatch

@pulumi/aws > cloudwatch

Index

cloudwatch/dashboard.ts cloudwatch/eventPermission.ts cloudwatch/eventRule.ts cloudwatch/eventTarget.ts cloudwatch/getLogGroup.ts cloudwatch/logDestination.ts cloudwatch/logDestinationPolicy.ts cloudwatch/logGroup.ts cloudwatch/logMetricFilter.ts cloudwatch/logResourcePolicy.ts cloudwatch/logStream.ts cloudwatch/logSubscriptionFilter.ts cloudwatch/metricAlarm.ts

class Dashboard

Provides a CloudWatch Dashboard resource.

constructor

new Dashboard(name: string, args: DashboardArgs, opts?: pulumi.CustomResourceOptions)

Create a Dashboard resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: DashboardState): Dashboard

Get an existing Dashboard resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property dashboardArn

public dashboardArn: pulumi.Output<string>;

The Amazon Resource Name (ARN) of the dashboard.

property dashboardBody

public dashboardBody: pulumi.Output<string>;

The detailed information about the dashboard, including what widgets are included and their location on the dashboard. You can read more about the body structure in the documentation.

property dashboardName

public dashboardName: pulumi.Output<string>;

The name of the dashboard.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class EventPermission

Provides a resource to create a CloudWatch Events permission to support cross-account events in the current account default event bus.

constructor

new EventPermission(name: string, args: EventPermissionArgs, opts?: pulumi.CustomResourceOptions)

Create a EventPermission resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: EventPermissionState): EventPermission

Get an existing EventPermission resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property action

public action: pulumi.Output<string | undefined>;

The action that you are enabling the other account to perform. Defaults to events:PutEvents.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property principal

public principal: pulumi.Output<string>;

The 12-digit AWS account ID that you are permitting to put events to your default event bus. Specify * to permit any account to put events to your default event bus.

property statementId

public statementId: pulumi.Output<string>;

An identifier string for the external account that you are granting permissions to.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class EventRule

Provides a CloudWatch Event Rule resource.

constructor

new EventRule(name: string, args?: EventRuleArgs, opts?: pulumi.CustomResourceOptions)

Create a EventRule resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: EventRuleState): EventRule

Get an existing EventRule resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The Amazon Resource Name (ARN) of the rule.

property description

public description: pulumi.Output<string | undefined>;

The description of the rule.

property eventPattern

public eventPattern: pulumi.Output<string | undefined>;

Event pattern described a JSON object. See full documentation of CloudWatch Events and Event Patterns for details.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property isEnabled

public isEnabled: pulumi.Output<boolean | undefined>;

Whether the rule should be enabled (defaults to true).

property name

public name: pulumi.Output<string>;

The rule’s name. By default generated by Terraform.

property namePrefix

public namePrefix: pulumi.Output<string | undefined>;

The rule’s name. Conflicts with name.

property roleArn

public roleArn: pulumi.Output<string | undefined>;

The Amazon Resource Name (ARN) associated with the role that is used for target invocation.

property scheduleExpression

public scheduleExpression: pulumi.Output<string | undefined>;

The scheduling expression. For example, cron(0 20 * * ? *) or rate(5 minutes).

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class EventTarget

Provides a CloudWatch Event Target resource.

constructor

new EventTarget(name: string, args: EventTargetArgs, opts?: pulumi.CustomResourceOptions)

Create a EventTarget resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: EventTargetState): EventTarget

Get an existing EventTarget resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The Amazon Resource Name (ARN) associated of the target.

property batchTarget

public batchTarget: pulumi.Output<{ ... } | undefined>;

Parameters used when you are using the rule to invoke an Amazon Batch Job. Documented below. A maximum of 1 are allowed.

property ecsTarget

public ecsTarget: pulumi.Output<{ ... } | undefined>;

Parameters used when you are using the rule to invoke Amazon ECS Task. Documented below. A maximum of 1 are allowed.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property input

public input: pulumi.Output<string | undefined>;

Valid JSON text passed to the target.

property inputPath

public inputPath: pulumi.Output<string | undefined>;

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target.

property inputTransformer

public inputTransformer: pulumi.Output<{ ... } | undefined>;

Parameters used when you are providing a custom input to a target based on certain event data.

property kinesisTarget

public kinesisTarget: pulumi.Output<{ ... } | undefined>;

Parameters used when you are using the rule to invoke an Amazon Kinesis Stream. Documented below. A maximum of 1 are allowed.

property roleArn

public roleArn: pulumi.Output<string | undefined>;

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. Required if ecs_target is used.

property rule

public rule: pulumi.Output<string>;

The name of the rule you want to add targets to.

property runCommandTargets

public runCommandTargets: pulumi.Output<{ ... }[] | undefined>;

Parameters used when you are using the rule to invoke Amazon EC2 Run Command. Documented below. A maximum of 5 are allowed.

property sqsTarget

public sqsTarget: pulumi.Output<{ ... } | undefined>;

Parameters used when you are using the rule to invoke an Amazon SQS Queue. Documented below. A maximum of 1 are allowed.

property targetId

public targetId: pulumi.Output<string>;

The unique target assignment ID. If missing, will generate a random, unique id.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogDestination

Provides a CloudWatch Logs destination resource.

constructor

new LogDestination(name: string, args: LogDestinationArgs, opts?: pulumi.CustomResourceOptions)

Create a LogDestination resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogDestinationState): LogDestination

Get an existing LogDestination resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The Amazon Resource Name (ARN) specifying the log destination.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property name

public name: pulumi.Output<string>;

A name for the log destination

property roleArn

public roleArn: pulumi.Output<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to put data into the target

property targetArn

public targetArn: pulumi.Output<string>;

The ARN of the target Amazon Kinesis stream or Amazon Lambda resource for the destination

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogDestinationPolicy

Provides a CloudWatch Logs destination policy resource.

constructor

new LogDestinationPolicy(name: string, args: LogDestinationPolicyArgs, opts?: pulumi.CustomResourceOptions)

Create a LogDestinationPolicy resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogDestinationPolicyState): LogDestinationPolicy

Get an existing LogDestinationPolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property accessPolicy

public accessPolicy: pulumi.Output<string>;

The policy document. This is a JSON formatted string.

property destinationName

public destinationName: pulumi.Output<string>;

A name for the subscription filter

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogGroup

Provides a CloudWatch Log Group resource.

constructor

new LogGroup(name: string, args?: LogGroupArgs, opts?: pulumi.CustomResourceOptions)

Create a LogGroup resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogGroupState): LogGroup

Get an existing LogGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The Amazon Resource Name (ARN) specifying the log group.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property kmsKeyId

public kmsKeyId: pulumi.Output<string | undefined>;

The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

property name

public name: pulumi.Output<string>;

The name of the log group. If omitted, Terraform will assign a random, unique name.

property namePrefix

public namePrefix: pulumi.Output<string | undefined>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property retentionInDays

public retentionInDays: pulumi.Output<number | undefined>;

Specifies the number of days you want to retain log events in the specified log group.

property tags

public tags: pulumi.Output<Tags | undefined>;

A mapping of tags to assign to the resource.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogMetricFilter

Provides a CloudWatch Log Metric Filter resource.

constructor

new LogMetricFilter(name: string, args: LogMetricFilterArgs, opts?: pulumi.CustomResourceOptions)

Create a LogMetricFilter resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogMetricFilterState): LogMetricFilter

Get an existing LogMetricFilter resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property logGroupName

public logGroupName: pulumi.Output<string>;

The name of the log group to associate the metric filter with.

property metricTransformation

public metricTransformation: pulumi.Output<{ ... }>;

A block defining collection of information needed to define how metric data gets emitted. See below.

property name

public name: pulumi.Output<string>;

The name of the CloudWatch metric to which the monitored log information should be published (e.g. ErrorCount)

property pattern

public pattern: pulumi.Output<string>;

A valid CloudWatch Logs filter pattern for extracting metric data out of ingested log events.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogResourcePolicy

Provides a resource to manage a CloudWatch log resource policy.

constructor

new LogResourcePolicy(name: string, args: LogResourcePolicyArgs, opts?: pulumi.CustomResourceOptions)

Create a LogResourcePolicy resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogResourcePolicyState): LogResourcePolicy

Get an existing LogResourcePolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property policyDocument

public policyDocument: pulumi.Output<string>;

Details of the resource policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string. Maximum length of 5120 characters.

property policyName

public policyName: pulumi.Output<string>;

Name of the resource policy.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogStream

Provides a CloudWatch Log Stream resource.

constructor

new LogStream(name: string, args: LogStreamArgs, opts?: pulumi.CustomResourceOptions)

Create a LogStream resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogStreamState): LogStream

Get an existing LogStream resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property arn

public arn: pulumi.Output<string>;

The Amazon Resource Name (ARN) specifying the log stream.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property logGroupName

public logGroupName: pulumi.Output<string>;

The name of the log group under which the log stream is to be created.

property name

public name: pulumi.Output<string>;

The name of the log stream. Must not be longer than 512 characters and must not contain :

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class LogSubscriptionFilter

Provides a CloudWatch Logs subscription filter resource.

constructor

new LogSubscriptionFilter(name: string, args: LogSubscriptionFilterArgs, opts?: pulumi.CustomResourceOptions)

Create a LogSubscriptionFilter resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: LogSubscriptionFilterState): LogSubscriptionFilter

Get an existing LogSubscriptionFilter resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property destinationArn

public destinationArn: pulumi.Output<string>;

The ARN of the destination to deliver matching log events to. Kinesis stream or Lambda function ARN.

property distribution

public distribution: pulumi.Output<string | undefined>;

The method used to distribute log data to the destination. By default log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream. Valid values are “Random” and “ByLogStream”.

property filterPattern

public filterPattern: pulumi.Output<string>;

A valid CloudWatch Logs filter pattern for subscribing to a filtered stream of log events.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property logGroup

public logGroup: pulumi.Output<LogGroup>;

The name of the log group to associate the subscription filter with

property name

public name: pulumi.Output<string>;

A name for the subscription filter

property roleArn

public roleArn: pulumi.Output<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to deliver ingested log events to the destination. If you use Lambda as a destination, you should skip this argument and use aws_lambda_permission resource for granting access from CloudWatch logs to the destination Lambda function.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

class MetricAlarm

Provides a CloudWatch Metric Alarm resource.

constructor

new MetricAlarm(name: string, args: MetricAlarmArgs, opts?: pulumi.CustomResourceOptions)

Create a MetricAlarm resource with the given unique name, arguments, and options.

  • name The unique name of the resource.
  • args The arguments to use to populate this resource's properties.
  • opts A bag of options that control this resource's behavior.

method get

public static get(name: string, id: pulumi.Input<pulumi.ID>, state?: MetricAlarmState): MetricAlarm

Get an existing MetricAlarm resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

method getProvider

getProvider(moduleMember: string): ProviderResource | undefined

method isInstance

static isInstance(obj: any): boolean

Returns true if the given object is an instance of CustomResource. This is designed to work even when multiple copies of the Pulumi SDK have been loaded into the same process.

property actionsEnabled

public actionsEnabled: pulumi.Output<boolean | undefined>;

Indicates whether or not actions should be executed during any changes to the alarm’s state. Defaults to true.

property alarmActions

public alarmActions: pulumi.Output<string[] | undefined>;

The list of actions to execute when this alarm transitions into an ALARM state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property alarmDescription

public alarmDescription: pulumi.Output<string | undefined>;

The description for the alarm.

property comparisonOperator

public comparisonOperator: pulumi.Output<string>;

The arithmetic operation to use when comparing the specified Statistic and Threshold. The specified Statistic value is used as the first operand. Either of the following is supported: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold.

property datapointsToAlarm

public datapointsToAlarm: pulumi.Output<number | undefined>;

The number of datapoints that must be breaching to trigger the alarm.

property dimensions

public dimensions: pulumi.Output<{ ... } | undefined>;

The dimensions for the alarm’s associated metric. For the list of available dimensions see the AWS documentation here.

property evaluateLowSampleCountPercentiles

public evaluateLowSampleCountPercentiles: pulumi.Output<string>;

Used only for alarms based on percentiles. If you specify ignore, the alarm state will not change during periods with too few data points to be statistically significant. If you specify evaluate or omit this parameter, the alarm will always be evaluated and possibly change state no matter how many data points are available. The following values are supported: ignore, and evaluate.

property evaluationPeriods

public evaluationPeriods: pulumi.Output<number>;

The number of periods over which data is compared to the specified threshold.

property extendedStatistic

public extendedStatistic: pulumi.Output<string | undefined>;

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.

property id

id: Output<ID>;

id is the provider-assigned unique ID for this managed resource. It is set during deployments and may be missing (undefined) during planning phases.

property insufficientDataActions

public insufficientDataActions: pulumi.Output<string[] | undefined>;

The list of actions to execute when this alarm transitions into an INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property metricName

public metricName: pulumi.Output<string>;

The name for the alarm’s associated metric. See docs for supported metrics.

property name

public name: pulumi.Output<string>;

The descriptive name for the alarm. This name must be unique within the user’s AWS account

property namespace

public namespace: pulumi.Output<string>;

The namespace for the alarm’s associated metric. See docs for the list of namespaces. See docs for supported metrics.

property okActions

public okActions: pulumi.Output<string[] | undefined>;

The list of actions to execute when this alarm transitions into an OK state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property period

public period: pulumi.Output<number>;

The period in seconds over which the specified statistic is applied.

property statistic

public statistic: pulumi.Output<string | undefined>;

The statistic to apply to the alarm’s associated metric. Either of the following is supported: SampleCount, Average, Sum, Minimum, Maximum

property threshold

public threshold: pulumi.Output<number>;

The value against which the specified statistic is compared.

property treatMissingData

public treatMissingData: pulumi.Output<string | undefined>;

Sets how this alarm is to handle missing data points. The following values are supported: missing, ignore, breaching and notBreaching. Defaults to missing.

property unit

public unit: pulumi.Output<string | undefined>;

The unit for the alarm’s associated metric.

property urn

urn: Output<URN>;

urn is the stable logical URN used to distinctly address a resource, both before and after deployments.

function getLogGroup

getLogGroup(args: GetLogGroupArgs, opts?: pulumi.InvokeOptions): Promise<GetLogGroupResult>

Use this data source to get information about an AWS Cloudwatch Log Group

interface DashboardArgs

The set of arguments for constructing a Dashboard resource.

property dashboardBody

dashboardBody: pulumi.Input<string>;

The detailed information about the dashboard, including what widgets are included and their location on the dashboard. You can read more about the body structure in the documentation.

property dashboardName

dashboardName: pulumi.Input<string>;

The name of the dashboard.

interface DashboardState

Input properties used for looking up and filtering Dashboard resources.

property dashboardArn

dashboardArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) of the dashboard.

property dashboardBody

dashboardBody?: pulumi.Input<string>;

The detailed information about the dashboard, including what widgets are included and their location on the dashboard. You can read more about the body structure in the documentation.

property dashboardName

dashboardName?: pulumi.Input<string>;

The name of the dashboard.

interface EventPermissionArgs

The set of arguments for constructing a EventPermission resource.

property action

action?: pulumi.Input<string>;

The action that you are enabling the other account to perform. Defaults to events:PutEvents.

property principal

principal: pulumi.Input<string>;

The 12-digit AWS account ID that you are permitting to put events to your default event bus. Specify * to permit any account to put events to your default event bus.

property statementId

statementId: pulumi.Input<string>;

An identifier string for the external account that you are granting permissions to.

interface EventPermissionState

Input properties used for looking up and filtering EventPermission resources.

property action

action?: pulumi.Input<string>;

The action that you are enabling the other account to perform. Defaults to events:PutEvents.

property principal

principal?: pulumi.Input<string>;

The 12-digit AWS account ID that you are permitting to put events to your default event bus. Specify * to permit any account to put events to your default event bus.

property statementId

statementId?: pulumi.Input<string>;

An identifier string for the external account that you are granting permissions to.

interface EventRuleArgs

The set of arguments for constructing a EventRule resource.

property description

description?: pulumi.Input<string>;

The description of the rule.

property eventPattern

eventPattern?: pulumi.Input<string>;

Event pattern described a JSON object. See full documentation of CloudWatch Events and Event Patterns for details.

property isEnabled

isEnabled?: pulumi.Input<boolean>;

Whether the rule should be enabled (defaults to true).

property name

name?: pulumi.Input<string>;

The rule’s name. By default generated by Terraform.

property namePrefix

namePrefix?: pulumi.Input<string>;

The rule’s name. Conflicts with name.

property roleArn

roleArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) associated with the role that is used for target invocation.

property scheduleExpression

scheduleExpression?: pulumi.Input<string>;

The scheduling expression. For example, cron(0 20 * * ? *) or rate(5 minutes).

interface EventRuleState

Input properties used for looking up and filtering EventRule resources.

property arn

arn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) of the rule.

property description

description?: pulumi.Input<string>;

The description of the rule.

property eventPattern

eventPattern?: pulumi.Input<string>;

Event pattern described a JSON object. See full documentation of CloudWatch Events and Event Patterns for details.

property isEnabled

isEnabled?: pulumi.Input<boolean>;

Whether the rule should be enabled (defaults to true).

property name

name?: pulumi.Input<string>;

The rule’s name. By default generated by Terraform.

property namePrefix

namePrefix?: pulumi.Input<string>;

The rule’s name. Conflicts with name.

property roleArn

roleArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) associated with the role that is used for target invocation.

property scheduleExpression

scheduleExpression?: pulumi.Input<string>;

The scheduling expression. For example, cron(0 20 * * ? *) or rate(5 minutes).

interface EventTargetArgs

The set of arguments for constructing a EventTarget resource.

property arn

arn: pulumi.Input<string>;

The Amazon Resource Name (ARN) associated of the target.

property batchTarget

batchTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon Batch Job. Documented below. A maximum of 1 are allowed.

property ecsTarget

ecsTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke Amazon ECS Task. Documented below. A maximum of 1 are allowed.

property input

input?: pulumi.Input<string>;

Valid JSON text passed to the target.

property inputPath

inputPath?: pulumi.Input<string>;

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target.

property inputTransformer

inputTransformer?: pulumi.Input<{ ... }>;

Parameters used when you are providing a custom input to a target based on certain event data.

property kinesisTarget

kinesisTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon Kinesis Stream. Documented below. A maximum of 1 are allowed.

property roleArn

roleArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. Required if ecs_target is used.

property rule

rule: pulumi.Input<string>;

The name of the rule you want to add targets to.

property runCommandTargets

runCommandTargets?: pulumi.Input<pulumi.Input<{ ... }>[]>;

Parameters used when you are using the rule to invoke Amazon EC2 Run Command. Documented below. A maximum of 5 are allowed.

property sqsTarget

sqsTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon SQS Queue. Documented below. A maximum of 1 are allowed.

property targetId

targetId?: pulumi.Input<string>;

The unique target assignment ID. If missing, will generate a random, unique id.

interface EventTargetState

Input properties used for looking up and filtering EventTarget resources.

property arn

arn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) associated of the target.

property batchTarget

batchTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon Batch Job. Documented below. A maximum of 1 are allowed.

property ecsTarget

ecsTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke Amazon ECS Task. Documented below. A maximum of 1 are allowed.

property input

input?: pulumi.Input<string>;

Valid JSON text passed to the target.

property inputPath

inputPath?: pulumi.Input<string>;

The value of the JSONPath that is used for extracting part of the matched event when passing it to the target.

property inputTransformer

inputTransformer?: pulumi.Input<{ ... }>;

Parameters used when you are providing a custom input to a target based on certain event data.

property kinesisTarget

kinesisTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon Kinesis Stream. Documented below. A maximum of 1 are allowed.

property roleArn

roleArn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) of the IAM role to be used for this target when the rule is triggered. Required if ecs_target is used.

property rule

rule?: pulumi.Input<string>;

The name of the rule you want to add targets to.

property runCommandTargets

runCommandTargets?: pulumi.Input<pulumi.Input<{ ... }>[]>;

Parameters used when you are using the rule to invoke Amazon EC2 Run Command. Documented below. A maximum of 5 are allowed.

property sqsTarget

sqsTarget?: pulumi.Input<{ ... }>;

Parameters used when you are using the rule to invoke an Amazon SQS Queue. Documented below. A maximum of 1 are allowed.

property targetId

targetId?: pulumi.Input<string>;

The unique target assignment ID. If missing, will generate a random, unique id.

interface GetLogGroupArgs

A collection of arguments for invoking getLogGroup.

property name

name: string;

The name of the Cloudwatch log group

interface GetLogGroupResult

A collection of values returned by getLogGroup.

property arn

arn: string;

The ARN of the Cloudwatch log group

property creationTime

creationTime: number;

The creation time of the log group, expressed as the number of milliseconds after Jan 1, 1970 00:00:00 UTC.

property id

id: string;

id is the provider-assigned unique ID for this managed resource.

interface LogDestinationArgs

The set of arguments for constructing a LogDestination resource.

property name

name?: pulumi.Input<string>;

A name for the log destination

property roleArn

roleArn: pulumi.Input<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to put data into the target

property targetArn

targetArn: pulumi.Input<string>;

The ARN of the target Amazon Kinesis stream or Amazon Lambda resource for the destination

interface LogDestinationPolicyArgs

The set of arguments for constructing a LogDestinationPolicy resource.

property accessPolicy

accessPolicy: pulumi.Input<string>;

The policy document. This is a JSON formatted string.

property destinationName

destinationName: pulumi.Input<string>;

A name for the subscription filter

interface LogDestinationPolicyState

Input properties used for looking up and filtering LogDestinationPolicy resources.

property accessPolicy

accessPolicy?: pulumi.Input<string>;

The policy document. This is a JSON formatted string.

property destinationName

destinationName?: pulumi.Input<string>;

A name for the subscription filter

interface LogDestinationState

Input properties used for looking up and filtering LogDestination resources.

property arn

arn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) specifying the log destination.

property name

name?: pulumi.Input<string>;

A name for the log destination

property roleArn

roleArn?: pulumi.Input<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to put data into the target

property targetArn

targetArn?: pulumi.Input<string>;

The ARN of the target Amazon Kinesis stream or Amazon Lambda resource for the destination

interface LogGroupArgs

The set of arguments for constructing a LogGroup resource.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

property name

name?: pulumi.Input<string>;

The name of the log group. If omitted, Terraform will assign a random, unique name.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property retentionInDays

retentionInDays?: pulumi.Input<number>;

Specifies the number of days you want to retain log events in the specified log group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface LogGroupState

Input properties used for looking up and filtering LogGroup resources.

property arn

arn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) specifying the log group.

property kmsKeyId

kmsKeyId?: pulumi.Input<string>;

The ARN of the KMS Key to use when encrypting log data. Please note, after the AWS KMS CMK is disassociated from the log group, AWS CloudWatch Logs stops encrypting newly ingested data for the log group. All previously ingested data remains encrypted, and AWS CloudWatch Logs requires permissions for the CMK whenever the encrypted data is requested.

property name

name?: pulumi.Input<string>;

The name of the log group. If omitted, Terraform will assign a random, unique name.

property namePrefix

namePrefix?: pulumi.Input<string>;

Creates a unique name beginning with the specified prefix. Conflicts with name.

property retentionInDays

retentionInDays?: pulumi.Input<number>;

Specifies the number of days you want to retain log events in the specified log group.

property tags

tags?: pulumi.Input<Tags>;

A mapping of tags to assign to the resource.

interface LogMetricFilterArgs

The set of arguments for constructing a LogMetricFilter resource.

property logGroupName

logGroupName: pulumi.Input<string>;

The name of the log group to associate the metric filter with.

property metricTransformation

metricTransformation: pulumi.Input<{ ... }>;

A block defining collection of information needed to define how metric data gets emitted. See below.

property name

name?: pulumi.Input<string>;

The name of the CloudWatch metric to which the monitored log information should be published (e.g. ErrorCount)

property pattern

pattern: pulumi.Input<string>;

A valid CloudWatch Logs filter pattern for extracting metric data out of ingested log events.

interface LogMetricFilterState

Input properties used for looking up and filtering LogMetricFilter resources.

property logGroupName

logGroupName?: pulumi.Input<string>;

The name of the log group to associate the metric filter with.

property metricTransformation

metricTransformation?: pulumi.Input<{ ... }>;

A block defining collection of information needed to define how metric data gets emitted. See below.

property name

name?: pulumi.Input<string>;

The name of the CloudWatch metric to which the monitored log information should be published (e.g. ErrorCount)

property pattern

pattern?: pulumi.Input<string>;

A valid CloudWatch Logs filter pattern for extracting metric data out of ingested log events.

interface LogResourcePolicyArgs

The set of arguments for constructing a LogResourcePolicy resource.

property policyDocument

policyDocument: pulumi.Input<string>;

Details of the resource policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string. Maximum length of 5120 characters.

property policyName

policyName: pulumi.Input<string>;

Name of the resource policy.

interface LogResourcePolicyState

Input properties used for looking up and filtering LogResourcePolicy resources.

property policyDocument

policyDocument?: pulumi.Input<string>;

Details of the resource policy, including the identity of the principal that is enabled to put logs to this account. This is formatted as a JSON string. Maximum length of 5120 characters.

property policyName

policyName?: pulumi.Input<string>;

Name of the resource policy.

interface LogStreamArgs

The set of arguments for constructing a LogStream resource.

property logGroupName

logGroupName: pulumi.Input<string>;

The name of the log group under which the log stream is to be created.

property name

name?: pulumi.Input<string>;

The name of the log stream. Must not be longer than 512 characters and must not contain :

interface LogStreamState

Input properties used for looking up and filtering LogStream resources.

property arn

arn?: pulumi.Input<string>;

The Amazon Resource Name (ARN) specifying the log stream.

property logGroupName

logGroupName?: pulumi.Input<string>;

The name of the log group under which the log stream is to be created.

property name

name?: pulumi.Input<string>;

The name of the log stream. Must not be longer than 512 characters and must not contain :

interface LogSubscriptionFilterArgs

The set of arguments for constructing a LogSubscriptionFilter resource.

property destinationArn

destinationArn: pulumi.Input<string>;

The ARN of the destination to deliver matching log events to. Kinesis stream or Lambda function ARN.

property distribution

distribution?: pulumi.Input<string>;

The method used to distribute log data to the destination. By default log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream. Valid values are “Random” and “ByLogStream”.

property filterPattern

filterPattern: pulumi.Input<string>;

A valid CloudWatch Logs filter pattern for subscribing to a filtered stream of log events.

property logGroup

logGroup: pulumi.Input<LogGroup>;

The name of the log group to associate the subscription filter with

property name

name?: pulumi.Input<string>;

A name for the subscription filter

property roleArn

roleArn?: pulumi.Input<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to deliver ingested log events to the destination. If you use Lambda as a destination, you should skip this argument and use aws_lambda_permission resource for granting access from CloudWatch logs to the destination Lambda function.

interface LogSubscriptionFilterState

Input properties used for looking up and filtering LogSubscriptionFilter resources.

property destinationArn

destinationArn?: pulumi.Input<string>;

The ARN of the destination to deliver matching log events to. Kinesis stream or Lambda function ARN.

property distribution

distribution?: pulumi.Input<string>;

The method used to distribute log data to the destination. By default log data is grouped by log stream, but the grouping can be set to random for a more even distribution. This property is only applicable when the destination is an Amazon Kinesis stream. Valid values are “Random” and “ByLogStream”.

property filterPattern

filterPattern?: pulumi.Input<string>;

A valid CloudWatch Logs filter pattern for subscribing to a filtered stream of log events.

property logGroup

logGroup?: pulumi.Input<LogGroup>;

The name of the log group to associate the subscription filter with

property name

name?: pulumi.Input<string>;

A name for the subscription filter

property roleArn

roleArn?: pulumi.Input<string>;

The ARN of an IAM role that grants Amazon CloudWatch Logs permissions to deliver ingested log events to the destination. If you use Lambda as a destination, you should skip this argument and use aws_lambda_permission resource for granting access from CloudWatch logs to the destination Lambda function.

interface MetricAlarmArgs

The set of arguments for constructing a MetricAlarm resource.

property actionsEnabled

actionsEnabled?: pulumi.Input<boolean>;

Indicates whether or not actions should be executed during any changes to the alarm’s state. Defaults to true.

property alarmActions

alarmActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an ALARM state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property alarmDescription

alarmDescription?: pulumi.Input<string>;

The description for the alarm.

property comparisonOperator

comparisonOperator: pulumi.Input<string>;

The arithmetic operation to use when comparing the specified Statistic and Threshold. The specified Statistic value is used as the first operand. Either of the following is supported: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold.

property datapointsToAlarm

datapointsToAlarm?: pulumi.Input<number>;

The number of datapoints that must be breaching to trigger the alarm.

property dimensions

dimensions?: pulumi.Input<{ ... }>;

The dimensions for the alarm’s associated metric. For the list of available dimensions see the AWS documentation here.

property evaluateLowSampleCountPercentiles

evaluateLowSampleCountPercentiles?: pulumi.Input<string>;

Used only for alarms based on percentiles. If you specify ignore, the alarm state will not change during periods with too few data points to be statistically significant. If you specify evaluate or omit this parameter, the alarm will always be evaluated and possibly change state no matter how many data points are available. The following values are supported: ignore, and evaluate.

property evaluationPeriods

evaluationPeriods: pulumi.Input<number>;

The number of periods over which data is compared to the specified threshold.

property extendedStatistic

extendedStatistic?: pulumi.Input<string>;

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.

property insufficientDataActions

insufficientDataActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property metricName

metricName: pulumi.Input<string>;

The name for the alarm’s associated metric. See docs for supported metrics.

property name

name?: pulumi.Input<string>;

The descriptive name for the alarm. This name must be unique within the user’s AWS account

property namespace

namespace: pulumi.Input<string>;

The namespace for the alarm’s associated metric. See docs for the list of namespaces. See docs for supported metrics.

property okActions

okActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an OK state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property period

period: pulumi.Input<number>;

The period in seconds over which the specified statistic is applied.

property statistic

statistic?: pulumi.Input<string>;

The statistic to apply to the alarm’s associated metric. Either of the following is supported: SampleCount, Average, Sum, Minimum, Maximum

property threshold

threshold: pulumi.Input<number>;

The value against which the specified statistic is compared.

property treatMissingData

treatMissingData?: pulumi.Input<string>;

Sets how this alarm is to handle missing data points. The following values are supported: missing, ignore, breaching and notBreaching. Defaults to missing.

property unit

unit?: pulumi.Input<string>;

The unit for the alarm’s associated metric.

interface MetricAlarmState

Input properties used for looking up and filtering MetricAlarm resources.

property actionsEnabled

actionsEnabled?: pulumi.Input<boolean>;

Indicates whether or not actions should be executed during any changes to the alarm’s state. Defaults to true.

property alarmActions

alarmActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an ALARM state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property alarmDescription

alarmDescription?: pulumi.Input<string>;

The description for the alarm.

property comparisonOperator

comparisonOperator?: pulumi.Input<string>;

The arithmetic operation to use when comparing the specified Statistic and Threshold. The specified Statistic value is used as the first operand. Either of the following is supported: GreaterThanOrEqualToThreshold, GreaterThanThreshold, LessThanThreshold, LessThanOrEqualToThreshold.

property datapointsToAlarm

datapointsToAlarm?: pulumi.Input<number>;

The number of datapoints that must be breaching to trigger the alarm.

property dimensions

dimensions?: pulumi.Input<{ ... }>;

The dimensions for the alarm’s associated metric. For the list of available dimensions see the AWS documentation here.

property evaluateLowSampleCountPercentiles

evaluateLowSampleCountPercentiles?: pulumi.Input<string>;

Used only for alarms based on percentiles. If you specify ignore, the alarm state will not change during periods with too few data points to be statistically significant. If you specify evaluate or omit this parameter, the alarm will always be evaluated and possibly change state no matter how many data points are available. The following values are supported: ignore, and evaluate.

property evaluationPeriods

evaluationPeriods?: pulumi.Input<number>;

The number of periods over which data is compared to the specified threshold.

property extendedStatistic

extendedStatistic?: pulumi.Input<string>;

The percentile statistic for the metric associated with the alarm. Specify a value between p0.0 and p100.

property insufficientDataActions

insufficientDataActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an INSUFFICIENT_DATA state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property metricName

metricName?: pulumi.Input<string>;

The name for the alarm’s associated metric. See docs for supported metrics.

property name

name?: pulumi.Input<string>;

The descriptive name for the alarm. This name must be unique within the user’s AWS account

property namespace

namespace?: pulumi.Input<string>;

The namespace for the alarm’s associated metric. See docs for the list of namespaces. See docs for supported metrics.

property okActions

okActions?: pulumi.Input<pulumi.Input<string | Topic>[]>;

The list of actions to execute when this alarm transitions into an OK state from any other state. Each action is specified as an Amazon Resource Number (ARN).

property period

period?: pulumi.Input<number>;

The period in seconds over which the specified statistic is applied.

property statistic

statistic?: pulumi.Input<string>;

The statistic to apply to the alarm’s associated metric. Either of the following is supported: SampleCount, Average, Sum, Minimum, Maximum

property threshold

threshold?: pulumi.Input<number>;

The value against which the specified statistic is compared.

property treatMissingData

treatMissingData?: pulumi.Input<string>;

Sets how this alarm is to handle missing data points. The following values are supported: missing, ignore, breaching and notBreaching. Defaults to missing.

property unit

unit?: pulumi.Input<string>;

The unit for the alarm’s associated metric.