1. Packages
  2. Wavefront Provider
  3. API Docs
  4. CloudIntegrationEc2
Wavefront v3.1.6 published on Thursday, Oct 31, 2024 by Pulumi

wavefront.CloudIntegrationEc2

Explore with Pulumi AI

wavefront logo
Wavefront v3.1.6 published on Thursday, Oct 31, 2024 by Pulumi

    Provides a Wavefront Cloud Integration for EC2. This allows EC2 cloud integrations to be created, updated, and deleted.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as wavefront from "@pulumi/wavefront";
    
    const extId = new wavefront.CloudIntegrationAwsExternalId("ext_id", {});
    const ec2 = new wavefront.CloudIntegrationEc2("ec2", {
        name: "Test Integration",
        roleArn: "arn:aws::1234567:role/example-arn",
        externalId: extId.id,
    });
    
    import pulumi
    import pulumi_wavefront as wavefront
    
    ext_id = wavefront.CloudIntegrationAwsExternalId("ext_id")
    ec2 = wavefront.CloudIntegrationEc2("ec2",
        name="Test Integration",
        role_arn="arn:aws::1234567:role/example-arn",
        external_id=ext_id.id)
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-wavefront/sdk/v3/go/wavefront"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		extId, err := wavefront.NewCloudIntegrationAwsExternalId(ctx, "ext_id", nil)
    		if err != nil {
    			return err
    		}
    		_, err = wavefront.NewCloudIntegrationEc2(ctx, "ec2", &wavefront.CloudIntegrationEc2Args{
    			Name:       pulumi.String("Test Integration"),
    			RoleArn:    pulumi.String("arn:aws::1234567:role/example-arn"),
    			ExternalId: extId.ID(),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Wavefront = Pulumi.Wavefront;
    
    return await Deployment.RunAsync(() => 
    {
        var extId = new Wavefront.CloudIntegrationAwsExternalId("ext_id");
    
        var ec2 = new Wavefront.CloudIntegrationEc2("ec2", new()
        {
            Name = "Test Integration",
            RoleArn = "arn:aws::1234567:role/example-arn",
            ExternalId = extId.Id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.wavefront.CloudIntegrationAwsExternalId;
    import com.pulumi.wavefront.CloudIntegrationEc2;
    import com.pulumi.wavefront.CloudIntegrationEc2Args;
    import java.util.List;
    import java.util.ArrayList;
    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 extId = new CloudIntegrationAwsExternalId("extId");
    
            var ec2 = new CloudIntegrationEc2("ec2", CloudIntegrationEc2Args.builder()
                .name("Test Integration")
                .roleArn("arn:aws::1234567:role/example-arn")
                .externalId(extId.id())
                .build());
    
        }
    }
    
    resources:
      extId:
        type: wavefront:CloudIntegrationAwsExternalId
        name: ext_id
      ec2:
        type: wavefront:CloudIntegrationEc2
        properties:
          name: Test Integration
          roleArn: arn:aws::1234567:role/example-arn
          externalId: ${extId.id}
    

    Create CloudIntegrationEc2 Resource

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

    Constructor syntax

    new CloudIntegrationEc2(name: string, args: CloudIntegrationEc2Args, opts?: CustomResourceOptions);
    @overload
    def CloudIntegrationEc2(resource_name: str,
                            args: CloudIntegrationEc2Args,
                            opts: Optional[ResourceOptions] = None)
    
    @overload
    def CloudIntegrationEc2(resource_name: str,
                            opts: Optional[ResourceOptions] = None,
                            external_id: Optional[str] = None,
                            role_arn: Optional[str] = None,
                            service: Optional[str] = None,
                            additional_tags: Optional[Mapping[str, str]] = None,
                            force_save: Optional[bool] = None,
                            hostname_tags: Optional[Sequence[str]] = None,
                            name: Optional[str] = None,
                            service_refresh_rate_in_minutes: Optional[int] = None)
    func NewCloudIntegrationEc2(ctx *Context, name string, args CloudIntegrationEc2Args, opts ...ResourceOption) (*CloudIntegrationEc2, error)
    public CloudIntegrationEc2(string name, CloudIntegrationEc2Args args, CustomResourceOptions? opts = null)
    public CloudIntegrationEc2(String name, CloudIntegrationEc2Args args)
    public CloudIntegrationEc2(String name, CloudIntegrationEc2Args args, CustomResourceOptions options)
    
    type: wavefront:CloudIntegrationEc2
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args CloudIntegrationEc2Args
    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 CloudIntegrationEc2Args
    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 CloudIntegrationEc2Args
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args CloudIntegrationEc2Args
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args CloudIntegrationEc2Args
    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 cloudIntegrationEc2Resource = new Wavefront.CloudIntegrationEc2("cloudIntegrationEc2Resource", new()
    {
        ExternalId = "string",
        RoleArn = "string",
        Service = "string",
        AdditionalTags = 
        {
            { "string", "string" },
        },
        ForceSave = false,
        HostnameTags = new[]
        {
            "string",
        },
        Name = "string",
        ServiceRefreshRateInMinutes = 0,
    });
    
    example, err := wavefront.NewCloudIntegrationEc2(ctx, "cloudIntegrationEc2Resource", &wavefront.CloudIntegrationEc2Args{
    	ExternalId: pulumi.String("string"),
    	RoleArn:    pulumi.String("string"),
    	Service:    pulumi.String("string"),
    	AdditionalTags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	ForceSave: pulumi.Bool(false),
    	HostnameTags: pulumi.StringArray{
    		pulumi.String("string"),
    	},
    	Name:                        pulumi.String("string"),
    	ServiceRefreshRateInMinutes: pulumi.Int(0),
    })
    
    var cloudIntegrationEc2Resource = new CloudIntegrationEc2("cloudIntegrationEc2Resource", CloudIntegrationEc2Args.builder()
        .externalId("string")
        .roleArn("string")
        .service("string")
        .additionalTags(Map.of("string", "string"))
        .forceSave(false)
        .hostnameTags("string")
        .name("string")
        .serviceRefreshRateInMinutes(0)
        .build());
    
    cloud_integration_ec2_resource = wavefront.CloudIntegrationEc2("cloudIntegrationEc2Resource",
        external_id="string",
        role_arn="string",
        service="string",
        additional_tags={
            "string": "string",
        },
        force_save=False,
        hostname_tags=["string"],
        name="string",
        service_refresh_rate_in_minutes=0)
    
    const cloudIntegrationEc2Resource = new wavefront.CloudIntegrationEc2("cloudIntegrationEc2Resource", {
        externalId: "string",
        roleArn: "string",
        service: "string",
        additionalTags: {
            string: "string",
        },
        forceSave: false,
        hostnameTags: ["string"],
        name: "string",
        serviceRefreshRateInMinutes: 0,
    });
    
    type: wavefront:CloudIntegrationEc2
    properties:
        additionalTags:
            string: string
        externalId: string
        forceSave: false
        hostnameTags:
            - string
        name: string
        roleArn: string
        service: string
        serviceRefreshRateInMinutes: 0
    

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

    ExternalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    RoleArn string
    The external ID corresponding to the Role ARN.
    Service string
    A value denoting which cloud service this service integrates with.
    AdditionalTags Dictionary<string, string>
    A list of point tag key-values to add to every point ingested using this integration.
    ForceSave bool
    Forces this resource to save, even if errors are present.
    HostnameTags List<string>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    Name string
    The human-readable name of this integration.
    ServiceRefreshRateInMinutes int
    How often, in minutes, to refresh the service.
    ExternalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    RoleArn string
    The external ID corresponding to the Role ARN.
    Service string
    A value denoting which cloud service this service integrates with.
    AdditionalTags map[string]string
    A list of point tag key-values to add to every point ingested using this integration.
    ForceSave bool
    Forces this resource to save, even if errors are present.
    HostnameTags []string
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    Name string
    The human-readable name of this integration.
    ServiceRefreshRateInMinutes int
    How often, in minutes, to refresh the service.
    externalId String
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    roleArn String
    The external ID corresponding to the Role ARN.
    service String
    A value denoting which cloud service this service integrates with.
    additionalTags Map<String,String>
    A list of point tag key-values to add to every point ingested using this integration.
    forceSave Boolean
    Forces this resource to save, even if errors are present.
    hostnameTags List<String>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name String
    The human-readable name of this integration.
    serviceRefreshRateInMinutes Integer
    How often, in minutes, to refresh the service.
    externalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    roleArn string
    The external ID corresponding to the Role ARN.
    service string
    A value denoting which cloud service this service integrates with.
    additionalTags {[key: string]: string}
    A list of point tag key-values to add to every point ingested using this integration.
    forceSave boolean
    Forces this resource to save, even if errors are present.
    hostnameTags string[]
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name string
    The human-readable name of this integration.
    serviceRefreshRateInMinutes number
    How often, in minutes, to refresh the service.
    external_id str
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    role_arn str
    The external ID corresponding to the Role ARN.
    service str
    A value denoting which cloud service this service integrates with.
    additional_tags Mapping[str, str]
    A list of point tag key-values to add to every point ingested using this integration.
    force_save bool
    Forces this resource to save, even if errors are present.
    hostname_tags Sequence[str]
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name str
    The human-readable name of this integration.
    service_refresh_rate_in_minutes int
    How often, in minutes, to refresh the service.
    externalId String
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    roleArn String
    The external ID corresponding to the Role ARN.
    service String
    A value denoting which cloud service this service integrates with.
    additionalTags Map<String>
    A list of point tag key-values to add to every point ingested using this integration.
    forceSave Boolean
    Forces this resource to save, even if errors are present.
    hostnameTags List<String>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name String
    The human-readable name of this integration.
    serviceRefreshRateInMinutes Number
    How often, in minutes, to refresh the service.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the CloudIntegrationEc2 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 str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing CloudIntegrationEc2 Resource

    Get an existing CloudIntegrationEc2 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?: CloudIntegrationEc2State, opts?: CustomResourceOptions): CloudIntegrationEc2
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            additional_tags: Optional[Mapping[str, str]] = None,
            external_id: Optional[str] = None,
            force_save: Optional[bool] = None,
            hostname_tags: Optional[Sequence[str]] = None,
            name: Optional[str] = None,
            role_arn: Optional[str] = None,
            service: Optional[str] = None,
            service_refresh_rate_in_minutes: Optional[int] = None) -> CloudIntegrationEc2
    func GetCloudIntegrationEc2(ctx *Context, name string, id IDInput, state *CloudIntegrationEc2State, opts ...ResourceOption) (*CloudIntegrationEc2, error)
    public static CloudIntegrationEc2 Get(string name, Input<string> id, CloudIntegrationEc2State? state, CustomResourceOptions? opts = null)
    public static CloudIntegrationEc2 get(String name, Output<String> id, CloudIntegrationEc2State state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    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:
    AdditionalTags Dictionary<string, string>
    A list of point tag key-values to add to every point ingested using this integration.
    ExternalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    ForceSave bool
    Forces this resource to save, even if errors are present.
    HostnameTags List<string>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    Name string
    The human-readable name of this integration.
    RoleArn string
    The external ID corresponding to the Role ARN.
    Service string
    A value denoting which cloud service this service integrates with.
    ServiceRefreshRateInMinutes int
    How often, in minutes, to refresh the service.
    AdditionalTags map[string]string
    A list of point tag key-values to add to every point ingested using this integration.
    ExternalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    ForceSave bool
    Forces this resource to save, even if errors are present.
    HostnameTags []string
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    Name string
    The human-readable name of this integration.
    RoleArn string
    The external ID corresponding to the Role ARN.
    Service string
    A value denoting which cloud service this service integrates with.
    ServiceRefreshRateInMinutes int
    How often, in minutes, to refresh the service.
    additionalTags Map<String,String>
    A list of point tag key-values to add to every point ingested using this integration.
    externalId String
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    forceSave Boolean
    Forces this resource to save, even if errors are present.
    hostnameTags List<String>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name String
    The human-readable name of this integration.
    roleArn String
    The external ID corresponding to the Role ARN.
    service String
    A value denoting which cloud service this service integrates with.
    serviceRefreshRateInMinutes Integer
    How often, in minutes, to refresh the service.
    additionalTags {[key: string]: string}
    A list of point tag key-values to add to every point ingested using this integration.
    externalId string
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    forceSave boolean
    Forces this resource to save, even if errors are present.
    hostnameTags string[]
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name string
    The human-readable name of this integration.
    roleArn string
    The external ID corresponding to the Role ARN.
    service string
    A value denoting which cloud service this service integrates with.
    serviceRefreshRateInMinutes number
    How often, in minutes, to refresh the service.
    additional_tags Mapping[str, str]
    A list of point tag key-values to add to every point ingested using this integration.
    external_id str
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    force_save bool
    Forces this resource to save, even if errors are present.
    hostname_tags Sequence[str]
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name str
    The human-readable name of this integration.
    role_arn str
    The external ID corresponding to the Role ARN.
    service str
    A value denoting which cloud service this service integrates with.
    service_refresh_rate_in_minutes int
    How often, in minutes, to refresh the service.
    additionalTags Map<String>
    A list of point tag key-values to add to every point ingested using this integration.
    externalId String
    The Role ARN that the customer has created in AWS IAM to allow access to Wavefront.
    forceSave Boolean
    Forces this resource to save, even if errors are present.
    hostnameTags List<String>
    A list of AWS instance tags to use as the source name in a series. Default is ["hostname", "host", "name"]. If no tag in the list is found, the series source is set to the instance id.
    name String
    The human-readable name of this integration.
    roleArn String
    The external ID corresponding to the Role ARN.
    service String
    A value denoting which cloud service this service integrates with.
    serviceRefreshRateInMinutes Number
    How often, in minutes, to refresh the service.

    Import

    EC2 Cloud Integrations can be imported by using the id, e.g.:

    $ pulumi import wavefront:index/cloudIntegrationEc2:CloudIntegrationEc2 ec2 a411c16b-3cf7-4f03-bf11-8ca05aab898d
    

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

    Package Details

    Repository
    Wavefront pulumi/pulumi-wavefront
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the wavefront Terraform Provider.
    wavefront logo
    Wavefront v3.1.6 published on Thursday, Oct 31, 2024 by Pulumi