1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. cloudwatch
  6. getIntegration

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi

    Resource Type definition for AWS::CloudWatch::Integration. Manages a CloudWatch (Amazon CloudWatch Observability / Omni) account-scoped integration. V1 supports AWS_CONFIG_SLREC, AWS_INTEGRATION, and EXTERNAL_AGENT.

    Using getIntegration

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getIntegration(args: GetIntegrationArgs, opts?: InvokeOptions): Promise<GetIntegrationResult>
    function getIntegrationOutput(args: GetIntegrationOutputArgs, opts?: InvokeOutputOptions): Output<GetIntegrationResult>
    def get_integration(integration_arn: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetIntegrationResult
    def get_integration_output(integration_arn: pulumi.Input[Optional[str]] = None,
                        opts: Optional[InvokeOutputOptions] = None) -> Output[GetIntegrationResult]
    func LookupIntegration(ctx *Context, args *LookupIntegrationArgs, opts ...InvokeOption) (*LookupIntegrationResult, error)
    func LookupIntegrationOutput(ctx *Context, args *LookupIntegrationOutputArgs, opts ...InvokeOption) LookupIntegrationResultOutput

    > Note: This function is named LookupIntegration in the Go SDK.

    public static class GetIntegration 
    {
        public static Task<GetIntegrationResult> InvokeAsync(GetIntegrationArgs args, InvokeOptions? opts = null)
        public static Output<GetIntegrationResult> Invoke(GetIntegrationInvokeArgs args, InvokeOptions? opts = null)
        public static Output<GetIntegrationResult> Invoke(GetIntegrationInvokeArgs args, InvokeOutputOptions opts)
    }
    public static CompletableFuture<GetIntegrationResult> getIntegration(GetIntegrationArgs args, InvokeOptions options)
    public static Output<GetIntegrationResult> getIntegration(GetIntegrationArgs args, InvokeOptions options)
    public static Output<GetIntegrationResult> getIntegration(GetIntegrationArgs args, InvokeOutputOptions options)
    
    fn::invoke:
      function: aws-native:cloudwatch:getIntegration
      arguments:
        # arguments dictionary
    data "aws-native_cloudwatch_get_integration" "name" {
        # arguments
    }

    The following arguments are supported:

    IntegrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    IntegrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integration_arn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationArn String
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integration_arn str
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationArn String
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.

    getIntegration Result

    The following output properties are available:

    CreatedAt string
    The time at which the integration was created.
    IntegrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    IntegrationAttributes Dictionary<string, string>
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    IntegrationId string
    The service-generated unique identifier (UUID) of the integration.
    RoleArn string
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    Status Pulumi.AwsNative.CloudWatch.IntegrationStatus
    Lifecycle status of the integration.
    Tags List<Pulumi.AwsNative.Outputs.Tag>
    Tags associated with the integration.
    UpdatedAt string
    The time at which the integration was last updated.
    CreatedAt string
    The time at which the integration was created.
    IntegrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    IntegrationAttributes map[string]string
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    IntegrationId string
    The service-generated unique identifier (UUID) of the integration.
    RoleArn string
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    Status IntegrationStatus
    Lifecycle status of the integration.
    Tags Tag
    Tags associated with the integration.
    UpdatedAt string
    The time at which the integration was last updated.
    created_at string
    The time at which the integration was created.
    integration_arn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integration_attributes map(string)
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    integration_id string
    The service-generated unique identifier (UUID) of the integration.
    role_arn string
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    status "PENDING" | "PENDING_OAUTH" | "ACTIVE" | "ERROR" | "FAILED" | "DELETED"
    Lifecycle status of the integration.
    tags list(object)
    Tags associated with the integration.
    updated_at string
    The time at which the integration was last updated.
    createdAt String
    The time at which the integration was created.
    integrationArn String
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationAttributes Map<String,String>
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    integrationId String
    The service-generated unique identifier (UUID) of the integration.
    roleArn String
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    status IntegrationStatus
    Lifecycle status of the integration.
    tags List<Tag>
    Tags associated with the integration.
    updatedAt String
    The time at which the integration was last updated.
    createdAt string
    The time at which the integration was created.
    integrationArn string
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationAttributes {[key: string]: string}
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    integrationId string
    The service-generated unique identifier (UUID) of the integration.
    roleArn string
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    status IntegrationStatus
    Lifecycle status of the integration.
    tags Tag[]
    Tags associated with the integration.
    updatedAt string
    The time at which the integration was last updated.
    created_at str
    The time at which the integration was created.
    integration_arn str
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integration_attributes Mapping[str, str]
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    integration_id str
    The service-generated unique identifier (UUID) of the integration.
    role_arn str
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    status IntegrationStatus
    Lifecycle status of the integration.
    tags Sequence[root_Tag]
    Tags associated with the integration.
    updated_at str
    The time at which the integration was last updated.
    createdAt String
    The time at which the integration was created.
    integrationArn String
    The ARN of the integration. arn:aws:cloudwatch:{region}:{account}:integration/{integrationId}.
    integrationAttributes Map<String>
    Type-specific configuration attributes (max 50 entries). EXTERNAL_AGENT requires 'catalogId'. On update, supplied attributes merge into the existing map; omitting a key does not remove it.
    integrationId String
    The service-generated unique identifier (UUID) of the integration.
    roleArn String
    IAM role ARN the integration assumes. Required for AWS_INTEGRATION (a valid, service-assumable IAM role ARN). Not used by AWS_CONFIG_SLREC or EXTERNAL_AGENT.
    status "PENDING" | "PENDING_OAUTH" | "ACTIVE" | "ERROR" | "FAILED" | "DELETED"
    Lifecycle status of the integration.
    tags List<Property Map>
    Tags associated with the integration.
    updatedAt String
    The time at which the integration was last updated.

    Supporting Types

    IntegrationStatus

    NameValue
    PendingPENDING
    PendingOauthPENDING_OAUTH
    ActiveACTIVE
    ErrorERROR
    FailedFAILED
    DeletedDELETED
    NameValue
    IntegrationStatusPendingPENDING
    IntegrationStatusPendingOauthPENDING_OAUTH
    IntegrationStatusActiveACTIVE
    IntegrationStatusErrorERROR
    IntegrationStatusFailedFAILED
    IntegrationStatusDeletedDELETED
    Value
    PENDING
    PENDING_OAUTH
    ACTIVE
    ERROR
    FAILED
    DELETED
    NameValue
    PendingPENDING
    PendingOauthPENDING_OAUTH
    ActiveACTIVE
    ErrorERROR
    FailedFAILED
    DeletedDELETED
    NameValue
    PendingPENDING
    PendingOauthPENDING_OAUTH
    ActiveACTIVE
    ErrorERROR
    FailedFAILED
    DeletedDELETED
    NameValue
    PENDINGPENDING
    PENDING_OAUTHPENDING_OAUTH
    ACTIVEACTIVE
    ERRORERROR
    FAILEDFAILED
    DELETEDDELETED
    Value
    PENDING
    PENDING_OAUTH
    ACTIVE
    ERROR
    FAILED
    DELETED

    Tag

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.86.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial