Skip to content

Creates a resource metrics configuration for an Amazon Web Services resource

Description

Creates a resource metrics configuration for an Amazon Web Services resource. After you create a configuration, Amazon CloudWatch collects detailed metrics for that resource.

Each Amazon Web Services resource can have only one resource metrics configuration. If a configuration already exists for the specified resource ARN, this operation returns a ConflictException. To modify an existing configuration, use update_resource_metrics_configuration.

If the Amazon Web Services resource that you specify in ResourceArn does not exist, this operation returns a ResourceNotFoundException. Verify that the resource ARN is correct and that the resource exists before you retry the request.

To create a resource metrics configuration, you must have the cloudwatch:CreateResourceMetricsConfiguration permission. For information about scoping this permission to specific resources, see Condition keys for resource metrics configuration access in the Amazon CloudWatch User Guide.

Usage

cloudwatch_create_resource_metrics_configuration(ResourceArn,
  MetricSelections)

Arguments

  • ResourceArn

    [required] The Amazon Resource Name (ARN) of the Amazon Web Services resource to enable detailed monitoring for.

  • MetricSelections

    Specifies which metrics Amazon CloudWatch collects for the resource. If you omit this parameter, Amazon CloudWatch collects all available detailed metrics for the resource.

Value

A list with the following syntax:

list(
  ResourceMetricsConfiguration = list(
    ResourceArn = "string",
    CreatedAt = as.POSIXct(
      "2015-01-01"
    ),
    UpdatedAt = as.POSIXct(
      "2015-01-01"
    ),
    MetricSelections = list(
      list(
        IncludeMetrics = list(
          "string"
        )
      )
    )
  )
)

Request syntax

svc$create_resource_metrics_configuration(
  ResourceArn = "string",
  MetricSelections = list(
    list(
      IncludeMetrics = list(
        "string"
      )
    )
  )
)