For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/fr/api/latest/aws-integration/preview-aws-metric-name-filter.md. A documentation index is available at /llms.txt.
Language
Datadog site

Preview AWS metric name filter

WARNINGNote: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.
POSThttps://api.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.us3.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.us5.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.datadoghq.eu/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.ap1.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.ap2.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.uk1.datadoghq.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.ddog-gov.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_previewhttps://api.us2.ddog-gov.com/api/v2/integration/aws/accounts/{aws_account_config_id}/metric_name_filter_preview

Présentation

Preview which collected CloudWatch metrics would be filtered by the supplied metric name filters. The filters are not persisted.

This endpoint requires the aws_configuration_read permission.

Arguments

Paramètres du chemin

Name
Type
Description
aws_account_config_id [required]
string

Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the List all AWS integrations endpoint and query by AWS Account ID.

Requête

Body Data (required)

The metric name filters to preview.

Champ
Type
Description
data [required]
object

AWS metric name filter preview request data.

Réponse

AWS metric name filter preview result

AWS metric name filter preview response body.

Champ
Type
Description
data [required]
object

AWS metric name filter preview response data.

Exemple de code

Preview AWS metric name filter
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF
# Path parameters
export aws_account_config_id="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/integration/aws/accounts/${aws_account_config_id}/metric_name_filter_preview" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "metric_name_filters": [
        {
          "exclude_only": [
            "aws.ec2.network_in"
          ],
          "namespace": "AWS/EC2"
        }
      ]
    },
    "type": "metric_name_filter_preview"
  }
}
EOF