Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. Newrelic Provider
  4. API Docs
  5. AwsConnection
Viewing docs for New Relic v5.72.0
published on Thursday, Jun 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-newrelic

newrelic.AwsConnection

newrelic logo
Viewing docs for New Relic v5.72.0
published on Thursday, Jun 11, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-newrelic

    Use this resource to create and manage an AWS Connection entity in New Relic.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as newrelic from "@pulumi/newrelic";

const foo = new newrelic.AwsConnection("foo", {
    name: "test-aws-connection",
    description: "AWS Connection wrapping the role",
    region: "us-east-1",
    enabled: true,
    scopeType: "ORGANIZATION",
    scopeId: "YOUR_ORG_ID_HERE",
    credential: {
        assumeRole: {
            roleArn: "arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest",
            externalId: "external id",
        },
    },
});

    import pulumi
import pulumi_newrelic as newrelic

foo = newrelic.AwsConnection("foo",
    name="test-aws-connection",
    description="AWS Connection wrapping the role",
    region="us-east-1",
    enabled=True,
    scope_type="ORGANIZATION",
    scope_id="YOUR_ORG_ID_HERE",
    credential={
        "assume_role": {
            "role_arn": "arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest",
            "external_id": "external id",
        },
    })

    package main

import (
	"github.com/pulumi/pulumi-newrelic/sdk/v5/go/newrelic"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := newrelic.NewAwsConnection(ctx, "foo", &newrelic.AwsConnectionArgs{
			Name:        pulumi.String("test-aws-connection"),
			Description: pulumi.String("AWS Connection wrapping the role"),
			Region:      pulumi.String("us-east-1"),
			Enabled:     pulumi.Bool(true),
			ScopeType:   pulumi.String("ORGANIZATION"),
			ScopeId:     pulumi.String("YOUR_ORG_ID_HERE"),
			Credential: &newrelic.AwsConnectionCredentialArgs{
				AssumeRole: &newrelic.AwsConnectionCredentialAssumeRoleArgs{
					RoleArn:    pulumi.String("arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest"),
					ExternalId: pulumi.String("external id"),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using NewRelic = Pulumi.NewRelic;

return await Deployment.RunAsync(() => 
{
    var foo = new NewRelic.AwsConnection("foo", new()
    {
        Name = "test-aws-connection",
        Description = "AWS Connection wrapping the role",
        Region = "us-east-1",
        Enabled = true,
        ScopeType = "ORGANIZATION",
        ScopeId = "YOUR_ORG_ID_HERE",
        Credential = new NewRelic.Inputs.AwsConnectionCredentialArgs
        {
            AssumeRole = new NewRelic.Inputs.AwsConnectionCredentialAssumeRoleArgs
            {
                RoleArn = "arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest",
                ExternalId = "external id",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.newrelic.AwsConnection;
import com.pulumi.newrelic.AwsConnectionArgs;
import com.pulumi.newrelic.inputs.AwsConnectionCredentialArgs;
import com.pulumi.newrelic.inputs.AwsConnectionCredentialAssumeRoleArgs;
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) {
        var foo = new AwsConnection("foo", AwsConnectionArgs.builder()
            .name("test-aws-connection")
            .description("AWS Connection wrapping the role")
            .region("us-east-1")
            .enabled(true)
            .scopeType("ORGANIZATION")
            .scopeId("YOUR_ORG_ID_HERE")
            .credential(AwsConnectionCredentialArgs.builder()
                .assumeRole(AwsConnectionCredentialAssumeRoleArgs.builder()
                    .roleArn("arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest")
                    .externalId("external id")
                    .build())
                .build())
            .build());

    }
}

    resources:
  foo:
    type: newrelic:AwsConnection
    properties:
      name: test-aws-connection
      description: AWS Connection wrapping the role
      region: us-east-1
      enabled: true
      scopeType: ORGANIZATION
      scopeId: YOUR_ORG_ID_HERE
      credential:
        assumeRole:
          roleArn: arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest
          externalId: external id

    pulumi {
  required_providers {
    newrelic = {
      source = "pulumi/newrelic"
    }
  }
}

resource "newrelic_awsconnection" "foo" {
  name        = "test-aws-connection"
  description = "AWS Connection wrapping the role"
  region      = "us-east-1"
  enabled     = true
  scope_type  = "ORGANIZATION"
  scope_id    = "YOUR_ORG_ID_HERE"
  credential = {
    assume_role = {
      role_arn    = "arn:aws:iam::123456789012:role/newrelic-fed-logs-ingest"
      external_id = "external id"
    }
  }
}

    Create AwsConnection Resource

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

    Constructor syntax

    new AwsConnection(name: string, args: AwsConnectionArgs, opts?: CustomResourceOptions);
    @overload
def AwsConnection(resource_name: str,
                  args: AwsConnectionArgs,
                  opts: Optional[ResourceOptions] = None)

@overload
def AwsConnection(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  credential: Optional[AwsConnectionCredentialArgs] = None,
                  account_id: Optional[str] = None,
                  description: Optional[str] = None,
                  enabled: Optional[bool] = None,
                  external_id: Optional[str] = None,
                  name: Optional[str] = None,
                  region: Optional[str] = None,
                  scope_id: Optional[str] = None,
                  scope_type: Optional[str] = None,
                  settings: Optional[Sequence[AwsConnectionSettingArgs]] = None,
                  tags: Optional[Sequence[AwsConnectionTagArgs]] = None)
    func NewAwsConnection(ctx *Context, name string, args AwsConnectionArgs, opts ...ResourceOption) (*AwsConnection, error)
    public AwsConnection(string name, AwsConnectionArgs args, CustomResourceOptions? opts = null)
    public AwsConnection(String name, AwsConnectionArgs args)
public AwsConnection(String name, AwsConnectionArgs args, CustomResourceOptions options)

    type: newrelic:AwsConnection
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "newrelic_awsconnection" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args AwsConnectionArgs
    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 AwsConnectionArgs
    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 AwsConnectionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AwsConnectionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AwsConnectionArgs
    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 awsConnectionResource = new NewRelic.AwsConnection("awsConnectionResource", new()
{
    Credential = new NewRelic.Inputs.AwsConnectionCredentialArgs
    {
        AssumeRole = new NewRelic.Inputs.AwsConnectionCredentialAssumeRoleArgs
        {
            RoleArn = "string",
            ExternalId = "string",
        },
    },
    AccountId = "string",
    Description = "string",
    Enabled = false,
    ExternalId = "string",
    Name = "string",
    Region = "string",
    ScopeId = "string",
    ScopeType = "string",
    Settings = new[]
    {
        new NewRelic.Inputs.AwsConnectionSettingArgs
        {
            Key = "string",
            Value = "string",
        },
    },
    Tags = new[]
    {
        new NewRelic.Inputs.AwsConnectionTagArgs
        {
            Key = "string",
            Values = new[]
            {
                "string",
            },
        },
    },
});

    example, err := newrelic.NewAwsConnection(ctx, "awsConnectionResource", &newrelic.AwsConnectionArgs{
	Credential: &newrelic.AwsConnectionCredentialArgs{
		AssumeRole: &newrelic.AwsConnectionCredentialAssumeRoleArgs{
			RoleArn:    pulumi.String("string"),
			ExternalId: pulumi.String("string"),
		},
	},
	AccountId:   pulumi.String("string"),
	Description: pulumi.String("string"),
	Enabled:     pulumi.Bool(false),
	ExternalId:  pulumi.String("string"),
	Name:        pulumi.String("string"),
	Region:      pulumi.String("string"),
	ScopeId:     pulumi.String("string"),
	ScopeType:   pulumi.String("string"),
	Settings: newrelic.AwsConnectionSettingArray{
		&newrelic.AwsConnectionSettingArgs{
			Key:   pulumi.String("string"),
			Value: pulumi.String("string"),
		},
	},
	Tags: newrelic.AwsConnectionTagArray{
		&newrelic.AwsConnectionTagArgs{
			Key: pulumi.String("string"),
			Values: pulumi.StringArray{
				pulumi.String("string"),
			},
		},
	},
})

    resource "newrelic_awsconnection" "awsConnectionResource" {
  credential = {
    assume_role = {
      role_arn    = "string"
      external_id = "string"
    }
  }
  account_id  = "string"
  description = "string"
  enabled     = false
  external_id = "string"
  name        = "string"
  region      = "string"
  scope_id    = "string"
  scope_type  = "string"
  settings {
    key   = "string"
    value = "string"
  }
  tags {
    key    = "string"
    values = ["string"]
  }
}

    var awsConnectionResource = new AwsConnection("awsConnectionResource", AwsConnectionArgs.builder()
    .credential(AwsConnectionCredentialArgs.builder()
        .assumeRole(AwsConnectionCredentialAssumeRoleArgs.builder()
            .roleArn("string")
            .externalId("string")
            .build())
        .build())
    .accountId("string")
    .description("string")
    .enabled(false)
    .externalId("string")
    .name("string")
    .region("string")
    .scopeId("string")
    .scopeType("string")
    .settings(AwsConnectionSettingArgs.builder()
        .key("string")
        .value("string")
        .build())
    .tags(AwsConnectionTagArgs.builder()
        .key("string")
        .values("string")
        .build())
    .build());

    aws_connection_resource = newrelic.AwsConnection("awsConnectionResource",
    credential={
        "assume_role": {
            "role_arn": "string",
            "external_id": "string",
        },
    },
    account_id="string",
    description="string",
    enabled=False,
    external_id="string",
    name="string",
    region="string",
    scope_id="string",
    scope_type="string",
    settings=[{
        "key": "string",
        "value": "string",
    }],
    tags=[{
        "key": "string",
        "values": ["string"],
    }])

    const awsConnectionResource = new newrelic.AwsConnection("awsConnectionResource", {
    credential: {
        assumeRole: {
            roleArn: "string",
            externalId: "string",
        },
    },
    accountId: "string",
    description: "string",
    enabled: false,
    externalId: "string",
    name: "string",
    region: "string",
    scopeId: "string",
    scopeType: "string",
    settings: [{
        key: "string",
        value: "string",
    }],
    tags: [{
        key: "string",
        values: ["string"],
    }],
});

    type: newrelic:AwsConnection
properties:
    accountId: string
    credential:
        assumeRole:
            externalId: string
            roleArn: string
    description: string
    enabled: false
    externalId: string
    name: string
    region: string
    scopeId: string
    scopeType: string
    settings:
        - key: string
          value: string
    tags:
        - key: string
          values:
            - string

    AwsConnection 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 AwsConnection resource accepts the following input properties:

    Credential Pulumi.NewRelic.Inputs.AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    AccountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    Description string
    A description of the AWS Connection.
    Enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    ExternalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    Name string
    The name of the AWS connection.
    Region string
    AWS region for this connection (e.g. us-east-1).
    ScopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    ScopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    Settings List<Pulumi.NewRelic.Inputs.AwsConnectionSetting>
    Optional list of connection settings. Each entry takes:
    Tags List<Pulumi.NewRelic.Inputs.AwsConnectionTag>
    Tags applied to the AWS Connection entity. Each entry takes:
    Credential AwsConnectionCredentialArgs
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    AccountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    Description string
    A description of the AWS Connection.
    Enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    ExternalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    Name string
    The name of the AWS connection.
    Region string
    AWS region for this connection (e.g. us-east-1).
    ScopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    ScopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    Settings []AwsConnectionSettingArgs
    Optional list of connection settings. Each entry takes:
    Tags []AwsConnectionTagArgs
    Tags applied to the AWS Connection entity. Each entry takes:
    credential object
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    account_id string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    description string
    A description of the AWS Connection.
    enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    external_id string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name string
    The name of the AWS connection.
    region string
    AWS region for this connection (e.g. us-east-1).
    scope_id string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scope_type string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings list(object)
    Optional list of connection settings. Each entry takes:
    tags list(object)
    Tags applied to the AWS Connection entity. Each entry takes:
    credential AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    accountId String
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    description String
    A description of the AWS Connection.
    enabled Boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId String
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name String
    The name of the AWS connection.
    region String
    AWS region for this connection (e.g. us-east-1).
    scopeId String
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType String
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings List<AwsConnectionSetting>
    Optional list of connection settings. Each entry takes:
    tags List<AwsConnectionTag>
    Tags applied to the AWS Connection entity. Each entry takes:
    credential AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    accountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    description string
    A description of the AWS Connection.
    enabled boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name string
    The name of the AWS connection.
    region string
    AWS region for this connection (e.g. us-east-1).
    scopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings AwsConnectionSetting[]
    Optional list of connection settings. Each entry takes:
    tags AwsConnectionTag[]
    Tags applied to the AWS Connection entity. Each entry takes:
    credential AwsConnectionCredentialArgs
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    account_id str
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    description str
    A description of the AWS Connection.
    enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    external_id str
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name str
    The name of the AWS connection.
    region str
    AWS region for this connection (e.g. us-east-1).
    scope_id str
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scope_type str
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings Sequence[AwsConnectionSettingArgs]
    Optional list of connection settings. Each entry takes:
    tags Sequence[AwsConnectionTagArgs]
    Tags applied to the AWS Connection entity. Each entry takes:
    credential Property Map
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    accountId String
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    description String
    A description of the AWS Connection.
    enabled Boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId String
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name String
    The name of the AWS connection.
    region String
    AWS region for this connection (e.g. us-east-1).
    scopeId String
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType String
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings List<Property Map>
    Optional list of connection settings. Each entry takes:
    tags List<Property Map>
    Tags applied to the AWS Connection entity. Each entry takes:

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing AwsConnection Resource

    Get an existing AwsConnection 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?: AwsConnectionState, opts?: CustomResourceOptions): AwsConnection
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[str] = None,
        credential: Optional[AwsConnectionCredentialArgs] = None,
        description: Optional[str] = None,
        enabled: Optional[bool] = None,
        external_id: Optional[str] = None,
        name: Optional[str] = None,
        region: Optional[str] = None,
        scope_id: Optional[str] = None,
        scope_type: Optional[str] = None,
        settings: Optional[Sequence[AwsConnectionSettingArgs]] = None,
        tags: Optional[Sequence[AwsConnectionTagArgs]] = None) -> AwsConnection
    func GetAwsConnection(ctx *Context, name string, id IDInput, state *AwsConnectionState, opts ...ResourceOption) (*AwsConnection, error)
    public static AwsConnection Get(string name, Input<string> id, AwsConnectionState? state, CustomResourceOptions? opts = null)
    public static AwsConnection get(String name, Output<String> id, AwsConnectionState state, CustomResourceOptions options)
    resources:  _:    type: newrelic:AwsConnection    get:      id: ${id}
    import {
  to = newrelic_awsconnection.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    Credential Pulumi.NewRelic.Inputs.AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    Description string
    A description of the AWS Connection.
    Enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    ExternalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    Name string
    The name of the AWS connection.
    Region string
    AWS region for this connection (e.g. us-east-1).
    ScopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    ScopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    Settings List<Pulumi.NewRelic.Inputs.AwsConnectionSetting>
    Optional list of connection settings. Each entry takes:
    Tags List<Pulumi.NewRelic.Inputs.AwsConnectionTag>
    Tags applied to the AWS Connection entity. Each entry takes:
    AccountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    Credential AwsConnectionCredentialArgs
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    Description string
    A description of the AWS Connection.
    Enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    ExternalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    Name string
    The name of the AWS connection.
    Region string
    AWS region for this connection (e.g. us-east-1).
    ScopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    ScopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    Settings []AwsConnectionSettingArgs
    Optional list of connection settings. Each entry takes:
    Tags []AwsConnectionTagArgs
    Tags applied to the AWS Connection entity. Each entry takes:
    account_id string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    credential object
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    description string
    A description of the AWS Connection.
    enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    external_id string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name string
    The name of the AWS connection.
    region string
    AWS region for this connection (e.g. us-east-1).
    scope_id string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scope_type string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings list(object)
    Optional list of connection settings. Each entry takes:
    tags list(object)
    Tags applied to the AWS Connection entity. Each entry takes:
    accountId String
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    credential AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    description String
    A description of the AWS Connection.
    enabled Boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId String
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name String
    The name of the AWS connection.
    region String
    AWS region for this connection (e.g. us-east-1).
    scopeId String
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType String
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings List<AwsConnectionSetting>
    Optional list of connection settings. Each entry takes:
    tags List<AwsConnectionTag>
    Tags applied to the AWS Connection entity. Each entry takes:
    accountId string
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    credential AwsConnectionCredential
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    description string
    A description of the AWS Connection.
    enabled boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId string
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name string
    The name of the AWS connection.
    region string
    AWS region for this connection (e.g. us-east-1).
    scopeId string
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType string
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings AwsConnectionSetting[]
    Optional list of connection settings. Each entry takes:
    tags AwsConnectionTag[]
    Tags applied to the AWS Connection entity. Each entry takes:
    account_id str
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    credential AwsConnectionCredentialArgs
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    description str
    A description of the AWS Connection.
    enabled bool
    Flag to indicate whether the connection is enabled. Defaults to true.
    external_id str
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name str
    The name of the AWS connection.
    region str
    AWS region for this connection (e.g. us-east-1).
    scope_id str
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scope_type str
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings Sequence[AwsConnectionSettingArgs]
    Optional list of connection settings. Each entry takes:
    tags Sequence[AwsConnectionTagArgs]
    Tags applied to the AWS Connection entity. Each entry takes:
    accountId String
    New Relic account ID where the connection will be created. Used when scopeType = ACCOUNT.
    credential Property Map
    Credentials block describing how New Relic should authenticate into the AWS account. See Nested credential block below.
    description String
    A description of the AWS Connection.
    enabled Boolean
    Flag to indicate whether the connection is enabled. Defaults to true.
    externalId String
    Consumer-managed identifier — useful for caller-side idempotent tracking. Distinct from credential.assume_role.external_id (the IAM cross-account External ID).
    name String
    The name of the AWS connection.
    region String
    AWS region for this connection (e.g. us-east-1).
    scopeId String
    Scope ID matching scopeType — a New Relic account ID for ACCOUNT scope, or an organization ID for ORGANIZATION scope.
    scopeType String
    Scope type for the connection. Valid values: ACCOUNT, ORGANIZATION.
    settings List<Property Map>
    Optional list of connection settings. Each entry takes:
    tags List<Property Map>
    Tags applied to the AWS Connection entity. Each entry takes:

    Supporting Types

    AwsConnectionCredential, AwsConnectionCredentialArgs

    AssumeRole AwsConnectionCredentialAssumeRole
    STS:AssumeRole configuration. See below.
    assume_role object
    STS:AssumeRole configuration. See below.
    assumeRole AwsConnectionCredentialAssumeRole
    STS:AssumeRole configuration. See below.
    assumeRole AwsConnectionCredentialAssumeRole
    STS:AssumeRole configuration. See below.
    assume_role AwsConnectionCredentialAssumeRole
    STS:AssumeRole configuration. See below.
    assumeRole Property Map
    STS:AssumeRole configuration. See below.

    AwsConnectionCredentialAssumeRole, AwsConnectionCredentialAssumeRoleArgs

    RoleArn string
    ARN of the IAM role New Relic should assume.
    ExternalId string
    External ID supplied by New Relic during STS:AssumeRole.
    RoleArn string
    ARN of the IAM role New Relic should assume.
    ExternalId string
    External ID supplied by New Relic during STS:AssumeRole.
    role_arn string
    ARN of the IAM role New Relic should assume.
    external_id string
    External ID supplied by New Relic during STS:AssumeRole.
    roleArn String
    ARN of the IAM role New Relic should assume.
    externalId String
    External ID supplied by New Relic during STS:AssumeRole.
    roleArn string
    ARN of the IAM role New Relic should assume.
    externalId string
    External ID supplied by New Relic during STS:AssumeRole.
    role_arn str
    ARN of the IAM role New Relic should assume.
    external_id str
    External ID supplied by New Relic during STS:AssumeRole.
    roleArn String
    ARN of the IAM role New Relic should assume.
    externalId String
    External ID supplied by New Relic during STS:AssumeRole.

    AwsConnectionSetting, AwsConnectionSettingArgs

    Key string
    The setting key.
    Value string
    The setting value.
    Key string
    The setting key.
    Value string
    The setting value.
    key string
    The setting key.
    value string
    The setting value.
    key String
    The setting key.
    value String
    The setting value.
    key string
    The setting key.
    value string
    The setting value.
    key str
    The setting key.
    value str
    The setting value.
    key String
    The setting key.
    value String
    The setting value.

    AwsConnectionTag, AwsConnectionTagArgs

    Key string
    The tag key.
    Values List<string>
    Set of tag values.
    Key string
    The tag key.
    Values []string
    Set of tag values.
    key string
    The tag key.
    values list(string)
    Set of tag values.
    key String
    The tag key.
    values List<String>
    Set of tag values.
    key string
    The tag key.
    values string[]
    Set of tag values.
    key str
    The tag key.
    values Sequence[str]
    Set of tag values.
    key String
    The tag key.
    values List<String>
    Set of tag values.

    Import

    AWS Connections can be imported using the entity GUID:

    $ pulumi import newrelic:index/awsConnection:AwsConnection foo <entity-guid>

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

    Package Details

    Repository
    New Relic pulumi/pulumi-newrelic
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the newrelic Terraform Provider.
    newrelic logo
    Viewing docs for New Relic v5.72.0
    published on Thursday, Jun 11, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-newrelic

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial