1. Registry
  2. Packages
  3. AWS
  4. API Docs
  5. observabilityadmin
  6. DatasetIntegration
Viewing docs for AWS v7.55.0
published on Friday, Nov 13, 2026 by Pulumi
aws logo aws logo
Viewing docs for AWS v7.55.0
published on Friday, Nov 13, 2026 by Pulumi

    Manages a CloudWatch Observability Admin Dataset Integration. A dataset integration enables CloudWatch to forward the account’s telemetry to a dataset using an IAM role that you provide.

    NOTE: Only one dataset integration can exist per account and Region. Creating a second one fails with a ConflictException. To manage an existing dataset integration, import it.

    NOTE: A successful apply does not prove that forwarding works. If the execution role’s trust policy names the wrong account in aws:SourceAccount or aws:SourceArn, or the role lacks the permissions below, the integration is still created but nothing is forwarded.

    Before you create the integration:

    • The caller needs iam:PassRole on the execution role to create or update the integration.
    • The execution role must be in the same account as the integration and must trust logs.amazonaws.com. Both trust policy conditions must name that account, as in the example below.
    • The role’s logs:IntegrateWithDataset permissions decide which log groups are forwarded. log-group:* forwards all log groups in the account. Log groups in the Delivery log class are never forwarded.
    • If the destination dataset is encrypted with a customer managed AWS KMS key, the key policy must allow the execution role kms:Encrypt, kms:Decrypt, and kms:GenerateDataKey.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const current = aws.getCallerIdentity({});
    const currentGetPartition = aws.getPartition({});
    const currentGetRegion = aws.getRegion({});
    const example = new aws.iam.Role("example", {
        name: "example-dataset-integration",
        assumeRolePolicy: JSON.stringify({
            Version: "2012-10-17",
            Statement: [{
                Action: "sts:AssumeRole",
                Effect: "Allow",
                Principal: {
                    Service: "logs.amazonaws.com",
                },
                Condition: {
                    StringEquals: {
                        "aws:SourceAccount": current.then(current => current.accountId),
                    },
                    ArnLike: {
                        "aws:SourceArn": Promise.all([currentGetPartition, currentGetRegion, current]).then(([currentGetPartition, currentGetRegion, current]) => `arn:${currentGetPartition.partition}:observabilityadmin:${currentGetRegion.region}:${current.accountId}:dataset-integration/default`),
                    },
                },
            }],
        }),
    });
    const exampleRolePolicy = new aws.iam.RolePolicy("example", {
        role: example.name,
        policy: JSON.stringify({
            Version: "2012-10-17",
            Statement: [
                {
                    Effect: "Allow",
                    Action: "logs:IntegrateWithDataset",
                    Resource: Promise.all([currentGetPartition, currentGetRegion, current]).then(([currentGetPartition, currentGetRegion, current]) => `arn:${currentGetPartition.partition}:logs:${currentGetRegion.region}:${current.accountId}:log-group:*`),
                },
                {
                    Effect: "Allow",
                    Action: "cloudwatch:PutRecords",
                    Resource: "*",
                },
            ],
        }),
    });
    const exampleDatasetIntegration = new aws.observabilityadmin.DatasetIntegration("example", {roleArn: example.arn}, {
        dependsOn: [exampleRolePolicy],
    });
    
    import pulumi
    import json
    import pulumi_aws as aws
    
    current = aws.get_caller_identity()
    current_get_partition = aws.get_partition()
    current_get_region = aws.get_region()
    example = aws.iam.Role("example",
        name="example-dataset-integration",
        assume_role_policy=json.dumps({
            "Version": "2012-10-17",
            "Statement": [{
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "logs.amazonaws.com",
                },
                "Condition": {
                    "StringEquals": {
                        "aws:SourceAccount": current.account_id,
                    },
                    "ArnLike": {
                        "aws:SourceArn": f"arn:{current_get_partition.partition}:observabilityadmin:{current_get_region.region}:{current.account_id}:dataset-integration/default",
                    },
                },
            }],
        }))
    example_role_policy = aws.iam.RolePolicy("example",
        role=example.name,
        policy=json.dumps({
            "Version": "2012-10-17",
            "Statement": [
                {
                    "Effect": "Allow",
                    "Action": "logs:IntegrateWithDataset",
                    "Resource": f"arn:{current_get_partition.partition}:logs:{current_get_region.region}:{current.account_id}:log-group:*",
                },
                {
                    "Effect": "Allow",
                    "Action": "cloudwatch:PutRecords",
                    "Resource": "*",
                },
            ],
        }))
    example_dataset_integration = aws.observabilityadmin.DatasetIntegration("example", role_arn=example.arn,
    opts = pulumi.ResourceOptions(depends_on=[example_role_policy]))
    
    package main
    
    import (
    	"encoding/json"
    	"fmt"
    
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws"
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/iam"
    	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/observabilityadmin"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		current, err := aws.GetCallerIdentity(ctx, &aws.GetCallerIdentityArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		currentGetPartition, err := aws.GetPartition(ctx, &aws.GetPartitionArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		currentGetRegion, err := aws.GetRegion(ctx, &aws.GetRegionArgs{}, nil)
    		if err != nil {
    			return err
    		}
    		tmpJSON0, err := json.Marshal(map[string]interface{}{
    			"Version": "2012-10-17",
    			"Statement": []map[string]interface{}{
    				map[string]interface{}{
    					"Action": "sts:AssumeRole",
    					"Effect": "Allow",
    					"Principal": map[string]string{
    						"Service": "logs.amazonaws.com",
    					},
    					"Condition": map[string]interface{}{
    						"StringEquals": map[string]interface{}{
    							"aws:SourceAccount": current.AccountId,
    						},
    						"ArnLike": map[string]string{
    							"aws:SourceArn": fmt.Sprintf("arn:%v:observabilityadmin:%v:%v:dataset-integration/default", currentGetPartition.Partition, currentGetRegion.Region, current.AccountId),
    						},
    					},
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		json0 := string(tmpJSON0)
    		example, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
    			Name:             pulumi.String("example-dataset-integration"),
    			AssumeRolePolicy: json0,
    		})
    		if err != nil {
    			return err
    		}
    		tmpJSON1, err := json.Marshal(map[string]interface{}{
    			"Version": "2012-10-17",
    			"Statement": []interface{}{
    				map[string]string{
    					"Effect":   "Allow",
    					"Action":   "logs:IntegrateWithDataset",
    					"Resource": fmt.Sprintf("arn:%v:logs:%v:%v:log-group:*", currentGetPartition.Partition, currentGetRegion.Region, current.AccountId),
    				},
    				map[string]string{
    					"Effect":   "Allow",
    					"Action":   "cloudwatch:PutRecords",
    					"Resource": "*",
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		json1 := string(tmpJSON1)
    		exampleRolePolicy, err := iam.NewRolePolicy(ctx, "example", &iam.RolePolicyArgs{
    			Role:   example.Name,
    			Policy: json1,
    		})
    		if err != nil {
    			return err
    		}
    		_, err = observabilityadmin.NewDatasetIntegration(ctx, "example", &observabilityadmin.DatasetIntegrationArgs{
    			RoleArn: example.Arn,
    		}, pulumi.DependsOn([]pulumi.Resource{
    			exampleRolePolicy,
    		}))
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using System.Text.Json;
    using Pulumi;
    using Aws = Pulumi.Aws;
    
    return await Deployment.RunAsync(() => 
    {
        var current = Aws.GetCallerIdentity.Invoke();
    
        var currentGetPartition = Aws.GetPartition.Invoke();
    
        var currentGetRegion = Aws.GetRegion.Invoke();
    
        var example = new Aws.Iam.Role("example", new()
        {
            Name = "example-dataset-integration",
            AssumeRolePolicy = JsonSerializer.Serialize(new Dictionary<string, object?>
            {
                ["Version"] = "2012-10-17",
                ["Statement"] = new[]
                {
                    new Dictionary<string, object?>
                    {
                        ["Action"] = "sts:AssumeRole",
                        ["Effect"] = "Allow",
                        ["Principal"] = new Dictionary<string, object?>
                        {
                            ["Service"] = "logs.amazonaws.com",
                        },
                        ["Condition"] = new Dictionary<string, object?>
                        {
                            ["StringEquals"] = new Dictionary<string, object?>
                            {
                                ["aws:SourceAccount"] = current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId),
                            },
                            ["ArnLike"] = new Dictionary<string, object?>
                            {
                                ["aws:SourceArn"] = Output.Tuple(currentGetPartition, currentGetRegion, current).Apply(values =>
                                {
                                    var currentGetPartition = values.Item1;
                                    var currentGetRegion = values.Item2;
                                    var current = values.Item3;
                                    return $"arn:{currentGetPartition.Apply(getPartitionResult => getPartitionResult.Partition)}:observabilityadmin:{currentGetRegion.Apply(getRegionResult => getRegionResult.Region)}:{current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId)}:dataset-integration/default";
                                }),
                            },
                        },
                    },
                },
            }),
        });
    
        var exampleRolePolicy = new Aws.Iam.RolePolicy("example", new()
        {
            Role = example.Name,
            Policy = JsonSerializer.Serialize(new Dictionary<string, object?>
            {
                ["Version"] = "2012-10-17",
                ["Statement"] = new[]
                {
                    new Dictionary<string, object?>
                    {
                        ["Effect"] = "Allow",
                        ["Action"] = "logs:IntegrateWithDataset",
                        ["Resource"] = Output.Tuple(currentGetPartition, currentGetRegion, current).Apply(values =>
                        {
                            var currentGetPartition = values.Item1;
                            var currentGetRegion = values.Item2;
                            var current = values.Item3;
                            return $"arn:{currentGetPartition.Apply(getPartitionResult => getPartitionResult.Partition)}:logs:{currentGetRegion.Apply(getRegionResult => getRegionResult.Region)}:{current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId)}:log-group:*";
                        }),
                    },
                    new Dictionary<string, object?>
                    {
                        ["Effect"] = "Allow",
                        ["Action"] = "cloudwatch:PutRecords",
                        ["Resource"] = "*",
                    },
                },
            }),
        });
    
        var exampleDatasetIntegration = new Aws.Observabilityadmin.DatasetIntegration("example", new()
        {
            RoleArn = example.Arn,
        }, new CustomResourceOptions
        {
            DependsOn =
            {
                exampleRolePolicy,
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.AwsFunctions;
    import com.pulumi.aws.inputs.GetCallerIdentityArgs;
    import com.pulumi.aws.inputs.GetPartitionArgs;
    import com.pulumi.aws.inputs.GetRegionArgs;
    import com.pulumi.aws.iam.Role;
    import com.pulumi.aws.iam.RoleArgs;
    import com.pulumi.aws.iam.RolePolicy;
    import com.pulumi.aws.iam.RolePolicyArgs;
    import com.pulumi.aws.observabilityadmin.DatasetIntegration;
    import com.pulumi.aws.observabilityadmin.DatasetIntegrationArgs;
    import static com.pulumi.codegen.internal.Serialization.*;
    import com.pulumi.resources.CustomResourceOptions;
    import java.util.ArrayList;
    import java.util.Arrays;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            final var current = AwsFunctions.getCallerIdentity(GetCallerIdentityArgs.builder()
                .build());
    
            final var currentGetPartition = AwsFunctions.getPartition(GetPartitionArgs.builder()
                .build());
    
            final var currentGetRegion = AwsFunctions.getRegion(GetRegionArgs.builder()
                .build());
    
            var example = new Role("example", RoleArgs.builder()
                .name("example-dataset-integration")
                .assumeRolePolicy(serializeJson(
                    jsonObject(
                        jsonProperty("Version", "2012-10-17"),
                        jsonProperty("Statement", jsonArray(jsonObject(
                            jsonProperty("Action", "sts:AssumeRole"),
                            jsonProperty("Effect", "Allow"),
                            jsonProperty("Principal", jsonObject(
                                jsonProperty("Service", "logs.amazonaws.com")
                            )),
                            jsonProperty("Condition", jsonObject(
                                jsonProperty("StringEquals", jsonObject(
                                    jsonProperty("aws:SourceAccount", current.accountId())
                                )),
                                jsonProperty("ArnLike", jsonObject(
                                    jsonProperty("aws:SourceArn", String.format("arn:%s:observabilityadmin:%s:%s:dataset-integration/default", currentGetPartition.partition(),currentGetRegion.region(),current.accountId()))
                                ))
                            ))
                        )))
                    )))
                .build());
    
            var exampleRolePolicy = new RolePolicy("exampleRolePolicy", RolePolicyArgs.builder()
                .role(example.name())
                .policy(serializeJson(
                    jsonObject(
                        jsonProperty("Version", "2012-10-17"),
                        jsonProperty("Statement", jsonArray(
                            jsonObject(
                                jsonProperty("Effect", "Allow"),
                                jsonProperty("Action", "logs:IntegrateWithDataset"),
                                jsonProperty("Resource", String.format("arn:%s:logs:%s:%s:log-group:*", currentGetPartition.partition(),currentGetRegion.region(),current.accountId()))
                            ), 
                            jsonObject(
                                jsonProperty("Effect", "Allow"),
                                jsonProperty("Action", "cloudwatch:PutRecords"),
                                jsonProperty("Resource", "*")
                            )
                        ))
                    )))
                .build());
    
            var exampleDatasetIntegration = new DatasetIntegration("exampleDatasetIntegration", DatasetIntegrationArgs.builder()
                .roleArn(example.arn())
                .build(), CustomResourceOptions.builder()
                    .dependsOn(exampleRolePolicy)
                    .build());
    
        }
    }
    
    resources:
      example:
        type: aws:iam:Role
        properties:
          name: example-dataset-integration
          assumeRolePolicy:
            fn::toJSON:
              Version: 2012-10-17
              Statement:
                - Action: sts:AssumeRole
                  Effect: Allow
                  Principal:
                    Service: logs.amazonaws.com
                  Condition:
                    StringEquals:
                      aws:SourceAccount: ${current.accountId}
                    ArnLike:
                      aws:SourceArn: arn:${currentGetPartition.partition}:observabilityadmin:${currentGetRegion.region}:${current.accountId}:dataset-integration/default
      exampleRolePolicy:
        type: aws:iam:RolePolicy
        name: example
        properties:
          role: ${example.name}
          policy:
            fn::toJSON:
              Version: 2012-10-17
              Statement:
                - Effect: Allow
                  Action: logs:IntegrateWithDataset
                  Resource: arn:${currentGetPartition.partition}:logs:${currentGetRegion.region}:${current.accountId}:log-group:*
                - Effect: Allow
                  Action: cloudwatch:PutRecords
                  Resource: '*'
      exampleDatasetIntegration:
        type: aws:observabilityadmin:DatasetIntegration
        name: example
        properties:
          roleArn: ${example.arn}
        options:
          dependsOn:
            - ${exampleRolePolicy}
    variables:
      current:
        fn::invoke:
          function: aws:getCallerIdentity
          arguments: {}
      currentGetPartition:
        fn::invoke:
          function: aws:getPartition
          arguments: {}
      currentGetRegion:
        fn::invoke:
          function: aws:getRegion
          arguments: {}
    
    terraform {
      required_providers {
        aws = {
          source = "pulumi/aws"
        }
      }
    }
    
    data "aws_caller_identity" "current" {
    }
    data "aws_partition" "currentGetPartition" {
    }
    data "aws_region" "currentGetRegion" {
    }
    
    resource "aws_iam_role" "example" {
      lifecycle {
        create_before_destroy = true
      }
      name = "example-dataset-integration"
      assume_role_policy = jsonencode({
        "Version" = "2012-10-17"
        "Statement" = [{
          "Action" = "sts:AssumeRole"
          "Effect" = "Allow"
          "Principal" = {
            "Service" = "logs.amazonaws.com"
          }
          "Condition" = {
            "StringEquals" = {
              "aws:SourceAccount" = data.aws_caller_identity.current.account_id
            }
            "ArnLike" = {
              "aws:SourceArn" ="arn:${data.aws_partition.currentGetPartition.partition}:observabilityadmin:${data.aws_region.currentGetRegion.region}:${data.aws_caller_identity.current.account_id}:dataset-integration/default"
            }
          }
        }]
      })
    }
    resource "aws_iam_role_policy" "example" {
      lifecycle {
        create_before_destroy = true
      }
      role = aws_iam_role.example.name
      policy = jsonencode({
        "Version" = "2012-10-17"
        "Statement" = [{
          "Effect"   = "Allow"
          "Action"   = "logs:IntegrateWithDataset"
          "Resource" ="arn:${data.aws_partition.currentGetPartition.partition}:logs:${data.aws_region.currentGetRegion.region}:${data.aws_caller_identity.current.account_id}:log-group:*"
          }, {
          "Effect"   = "Allow"
          "Action"   = "cloudwatch:PutRecords"
          "Resource" = "*"
        }]
      })
    }
    resource "aws_observabilityadmin_dataset_integration" "example" {
      depends_on = [aws_iam_role_policy.example]
      lifecycle {
        create_before_destroy = true
      }
      role_arn = aws_iam_role.example.arn
    }
    

    Create DatasetIntegration Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new DatasetIntegration(name: string, args: DatasetIntegrationArgs, opts?: CustomResourceOptions);
    @overload
    def DatasetIntegration(resource_name: str,
                           args: DatasetIntegrationArgs,
                           opts: Optional[ResourceOptions] = None)
    
    @overload
    def DatasetIntegration(resource_name: str,
                           opts: Optional[ResourceOptions] = None,
                           role_arn: Optional[str] = None,
                           region: Optional[str] = None,
                           tags: Optional[Mapping[str, str]] = None)
    func NewDatasetIntegration(ctx *Context, name string, args DatasetIntegrationArgs, opts ...ResourceOption) (*DatasetIntegration, error)
    public DatasetIntegration(string name, DatasetIntegrationArgs args, CustomResourceOptions? opts = null)
    public DatasetIntegration(String name, DatasetIntegrationArgs args)
    public DatasetIntegration(String name, DatasetIntegrationArgs args, CustomResourceOptions options)
    
    type: aws:observabilityadmin:DatasetIntegration
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws_observabilityadmin_dataset_integration" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args DatasetIntegrationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args DatasetIntegrationArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args DatasetIntegrationArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DatasetIntegrationArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DatasetIntegrationArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var datasetIntegrationResource = new Aws.Observabilityadmin.DatasetIntegration("datasetIntegrationResource", new()
    {
        RoleArn = "string",
        Region = "string",
        Tags = 
        {
            { "string", "string" },
        },
    });
    
    example, err := observabilityadmin.NewDatasetIntegration(ctx, "datasetIntegrationResource", &observabilityadmin.DatasetIntegrationArgs{
    	RoleArn: pulumi.String("string"),
    	Region:  pulumi.String("string"),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    })
    
    resource "aws_observabilityadmin_dataset_integration" "datasetIntegrationResource" {
      lifecycle {
        create_before_destroy = true
      }
      role_arn = "string"
      region   = "string"
      tags = {
        "string" = "string"
      }
    }
    
    var datasetIntegrationResource = new DatasetIntegration("datasetIntegrationResource", DatasetIntegrationArgs.builder()
        .roleArn("string")
        .region("string")
        .tags(Map.of("string", "string"))
        .build());
    
    dataset_integration_resource = aws.observabilityadmin.DatasetIntegration("datasetIntegrationResource",
        role_arn="string",
        region="string",
        tags={
            "string": "string",
        })
    
    const datasetIntegrationResource = new aws.observabilityadmin.DatasetIntegration("datasetIntegrationResource", {
        roleArn: "string",
        region: "string",
        tags: {
            string: "string",
        },
    });
    
    type: aws:observabilityadmin:DatasetIntegration
    properties:
        region: string
        roleArn: string
        tags:
            string: string
    

    DatasetIntegration Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The DatasetIntegration resource accepts the following input properties:

    RoleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags Dictionary<string, string>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    RoleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    Tags map[string]string
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    role_arn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags map(string)
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    roleArn String

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String,String>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    roleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags {[key: string]: string}
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    role_arn str

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Mapping[str, str]
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    roleArn String

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    tags Map<String>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the DatasetIntegration resource produces the following output properties:

    Arn string
    ARN of the dataset integration.
    CreatedAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    Arn string
    ARN of the dataset integration.
    CreatedAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn string
    ARN of the dataset integration.
    created_at string
    Timestamp when the dataset integration was created, in RFC3339 format.
    id string
    The provider-assigned unique ID for this managed resource.
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn String
    ARN of the dataset integration.
    createdAt String
    Timestamp when the dataset integration was created, in RFC3339 format.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn string
    ARN of the dataset integration.
    createdAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    id string
    The provider-assigned unique ID for this managed resource.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn str
    ARN of the dataset integration.
    created_at str
    Timestamp when the dataset integration was created, in RFC3339 format.
    id str
    The provider-assigned unique ID for this managed resource.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at str
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn String
    ARN of the dataset integration.
    createdAt String
    Timestamp when the dataset integration was created, in RFC3339 format.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    Timestamp when the dataset integration was last updated, in RFC3339 format.

    Look up Existing DatasetIntegration Resource

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

    public static get(name: string, id: Input<ID>, state?: DatasetIntegrationState, opts?: CustomResourceOptions): DatasetIntegration
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            arn: Optional[str] = None,
            created_at: Optional[str] = None,
            region: Optional[str] = None,
            role_arn: Optional[str] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            updated_at: Optional[str] = None) -> DatasetIntegration
    func GetDatasetIntegration(ctx *Context, name string, id IDInput, state *DatasetIntegrationState, opts ...ResourceOption) (*DatasetIntegration, error)
    public static DatasetIntegration Get(string name, Input<string> id, DatasetIntegrationState? state, CustomResourceOptions? opts = null)
    public static DatasetIntegration get(String name, Output<String> id, DatasetIntegrationState state, CustomResourceOptions options)
    resources:  existingDatasetIntegration:    type: aws:observabilityadmin:DatasetIntegration    get:      id: ${id}
    import {
      to = aws_observabilityadmin_dataset_integration.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    state DatasetIntegrationState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state DatasetIntegrationState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    state DatasetIntegrationState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    state DatasetIntegrationState
    Known property values the provider needs, along with the ID, to find the resource. Usually not required.
    options CustomResourceOptions
    Bag of options to control resource's behavior.
    The following state arguments are supported:
    Arn string
    ARN of the dataset integration.
    CreatedAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RoleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    Tags Dictionary<string, string>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    Arn string
    ARN of the dataset integration.
    CreatedAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    RoleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    Tags map[string]string
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    UpdatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn string
    ARN of the dataset integration.
    created_at string
    Timestamp when the dataset integration was created, in RFC3339 format.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    role_arn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    tags map(string)
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all map(string)
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn String
    ARN of the dataset integration.
    createdAt String
    Timestamp when the dataset integration was created, in RFC3339 format.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    roleArn String

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    tags Map<String,String>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn string
    ARN of the dataset integration.
    createdAt string
    Timestamp when the dataset integration was created, in RFC3339 format.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    roleArn string

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    tags {[key: string]: string}
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt string
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn str
    ARN of the dataset integration.
    created_at str
    Timestamp when the dataset integration was created, in RFC3339 format.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    role_arn str

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    tags Mapping[str, str]
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updated_at str
    Timestamp when the dataset integration was last updated, in RFC3339 format.
    arn String
    ARN of the dataset integration.
    createdAt String
    Timestamp when the dataset integration was created, in RFC3339 format.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    roleArn String

    ARN of the IAM role that grants CloudWatch permission to access the resources needed for the dataset integration.

    The following arguments are optional:

    tags Map<String>
    Key-value map of resource tags. If configured with a provider defaultTags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider defaultTags configuration block.
    updatedAt String
    Timestamp when the dataset integration was last updated, in RFC3339 format.

    Import

    Identity Schema

    Required

    • arn (String) ARN of the dataset integration.

    Using pulumi import, import CloudWatch Observability Admin Dataset Integrations using the arn. For example:

    $ pulumi import aws:observabilityadmin/datasetIntegration:DatasetIntegration example arn:aws:observabilityadmin:us-east-1:123456789012:dataset-integration/default
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo aws logo
    Viewing docs for AWS v7.55.0
    published on Friday, Nov 13, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial