1. Packages
  2. Packages
  3. Newrelic Provider
  4. API Docs
  5. FleetDeployment
Viewing docs for New Relic v5.66.2
published on Tuesday, May 12, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-newrelic

newrelic.FleetDeployment

newrelic logo
Viewing docs for New Relic v5.66.2
published on Tuesday, May 12, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-newrelic

    Use this resource to create and manage New Relic fleet deployments.

    A fleet deployment defines the agent versions and optional configuration versions to roll out to a fleet. Each deployment belongs to a fleet and contains one or more agent blocks describing which agent type and version to deploy, and optionally which configuration version (from newrelic.FleetConfiguration) to apply.

    Note: Deployments can only be updated while in the CREATED phase. Once the fleet backend begins executing the deployment (phase advances to IN_PROGRESS, FAILED, or COMPLETED), any attempt to change name, description, agent, or tags will be blocked at plan time with an error. Run terraform destroy to remove the deployment from state and then re-create it with the desired configuration. If terraform destroy itself fails because the deployment is actively executing, the resource will be removed from Terraform state with a warning — once the deployment reaches a terminal phase (COMPLETED or FAILED) you can clean it up manually in the New Relic UI.

    Example Usage

    Basic Deployment

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

const infra = new newrelic.FleetDeployment("infra", {
    fleetId: prod.id,
    name: "Production Infra Deployment",
    description: "Deploys NRInfra v1.58.0 to the production fleet",
    agents: [{
        agentType: "NRInfra",
        version: "1.58.0",
    }],
});

    import pulumi
import pulumi_newrelic as newrelic

infra = newrelic.FleetDeployment("infra",
    fleet_id=prod["id"],
    name="Production Infra Deployment",
    description="Deploys NRInfra v1.58.0 to the production fleet",
    agents=[{
        "agent_type": "NRInfra",
        "version": "1.58.0",
    }])

    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.NewFleetDeployment(ctx, "infra", &newrelic.FleetDeploymentArgs{
			FleetId:     pulumi.Any(prod.Id),
			Name:        pulumi.String("Production Infra Deployment"),
			Description: pulumi.String("Deploys NRInfra v1.58.0 to the production fleet"),
			Agents: newrelic.FleetDeploymentAgentArray{
				&newrelic.FleetDeploymentAgentArgs{
					AgentType: pulumi.String("NRInfra"),
					Version:   pulumi.String("1.58.0"),
				},
			},
		})
		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 infra = new NewRelic.FleetDeployment("infra", new()
    {
        FleetId = prod.Id,
        Name = "Production Infra Deployment",
        Description = "Deploys NRInfra v1.58.0 to the production fleet",
        Agents = new[]
        {
            new NewRelic.Inputs.FleetDeploymentAgentArgs
            {
                AgentType = "NRInfra",
                Version = "1.58.0",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.newrelic.FleetDeployment;
import com.pulumi.newrelic.FleetDeploymentArgs;
import com.pulumi.newrelic.inputs.FleetDeploymentAgentArgs;
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 infra = new FleetDeployment("infra", FleetDeploymentArgs.builder()
            .fleetId(prod.id())
            .name("Production Infra Deployment")
            .description("Deploys NRInfra v1.58.0 to the production fleet")
            .agents(FleetDeploymentAgentArgs.builder()
                .agentType("NRInfra")
                .version("1.58.0")
                .build())
            .build());

    }
}

    resources:
  infra:
    type: newrelic:FleetDeployment
    properties:
      fleetId: ${prod.id}
      name: Production Infra Deployment
      description: Deploys NRInfra v1.58.0 to the production fleet
      agents:
        - agentType: NRInfra
          version: 1.58.0

    Example coming soon!

    Deployment Linked to a Configuration Version

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

const infraCfg = new newrelic.FleetConfiguration("infra_cfg", {
    name: "Production Infra Config",
    agentType: "NRInfra",
    managedEntityType: "HOST",
    versions: [{
        configurationContent: `log:
  level: info
`,
    }],
});
const infra = new newrelic.FleetDeployment("infra", {
    fleetId: prod.id,
    name: "Production Infra Deployment",
    description: "Deploys NRInfra v1.58.0 with the production config",
    agents: [{
        agentType: "NRInfra",
        version: "1.58.0",
        configurationVersionId: infraCfg.latestVersionEntityId,
    }],
});

    import pulumi
import pulumi_newrelic as newrelic

infra_cfg = newrelic.FleetConfiguration("infra_cfg",
    name="Production Infra Config",
    agent_type="NRInfra",
    managed_entity_type="HOST",
    versions=[{
        "configuration_content": """log:
  level: info
""",
    }])
infra = newrelic.FleetDeployment("infra",
    fleet_id=prod["id"],
    name="Production Infra Deployment",
    description="Deploys NRInfra v1.58.0 with the production config",
    agents=[{
        "agent_type": "NRInfra",
        "version": "1.58.0",
        "configuration_version_id": infra_cfg.latest_version_entity_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 {
		infraCfg, err := newrelic.NewFleetConfiguration(ctx, "infra_cfg", &newrelic.FleetConfigurationArgs{
			Name:              pulumi.String("Production Infra Config"),
			AgentType:         pulumi.String("NRInfra"),
			ManagedEntityType: pulumi.String("HOST"),
			Versions: newrelic.FleetConfigurationVersionArray{
				&newrelic.FleetConfigurationVersionArgs{
					ConfigurationContent: pulumi.String("log:\n  level: info\n"),
				},
			},
		})
		if err != nil {
			return err
		}
		_, err = newrelic.NewFleetDeployment(ctx, "infra", &newrelic.FleetDeploymentArgs{
			FleetId:     pulumi.Any(prod.Id),
			Name:        pulumi.String("Production Infra Deployment"),
			Description: pulumi.String("Deploys NRInfra v1.58.0 with the production config"),
			Agents: newrelic.FleetDeploymentAgentArray{
				&newrelic.FleetDeploymentAgentArgs{
					AgentType:              pulumi.String("NRInfra"),
					Version:                pulumi.String("1.58.0"),
					ConfigurationVersionId: infraCfg.LatestVersionEntityId,
				},
			},
		})
		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 infraCfg = new NewRelic.FleetConfiguration("infra_cfg", new()
    {
        Name = "Production Infra Config",
        AgentType = "NRInfra",
        ManagedEntityType = "HOST",
        Versions = new[]
        {
            new NewRelic.Inputs.FleetConfigurationVersionArgs
            {
                ConfigurationContent = @"log:
  level: info
",
            },
        },
    });

    var infra = new NewRelic.FleetDeployment("infra", new()
    {
        FleetId = prod.Id,
        Name = "Production Infra Deployment",
        Description = "Deploys NRInfra v1.58.0 with the production config",
        Agents = new[]
        {
            new NewRelic.Inputs.FleetDeploymentAgentArgs
            {
                AgentType = "NRInfra",
                Version = "1.58.0",
                ConfigurationVersionId = infraCfg.LatestVersionEntityId,
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.newrelic.FleetConfiguration;
import com.pulumi.newrelic.FleetConfigurationArgs;
import com.pulumi.newrelic.inputs.FleetConfigurationVersionArgs;
import com.pulumi.newrelic.FleetDeployment;
import com.pulumi.newrelic.FleetDeploymentArgs;
import com.pulumi.newrelic.inputs.FleetDeploymentAgentArgs;
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 infraCfg = new FleetConfiguration("infraCfg", FleetConfigurationArgs.builder()
            .name("Production Infra Config")
            .agentType("NRInfra")
            .managedEntityType("HOST")
            .versions(FleetConfigurationVersionArgs.builder()
                .configurationContent("""
log:
  level: info
                """)
                .build())
            .build());

        var infra = new FleetDeployment("infra", FleetDeploymentArgs.builder()
            .fleetId(prod.id())
            .name("Production Infra Deployment")
            .description("Deploys NRInfra v1.58.0 with the production config")
            .agents(FleetDeploymentAgentArgs.builder()
                .agentType("NRInfra")
                .version("1.58.0")
                .configurationVersionId(infraCfg.latestVersionEntityId())
                .build())
            .build());

    }
}

    resources:
  infraCfg:
    type: newrelic:FleetConfiguration
    name: infra_cfg
    properties:
      name: Production Infra Config
      agentType: NRInfra
      managedEntityType: HOST
      versions:
        - configurationContent: |
            log:
              level: info
  infra:
    type: newrelic:FleetDeployment
    properties:
      fleetId: ${prod.id}
      name: Production Infra Deployment
      description: Deploys NRInfra v1.58.0 with the production config
      agents:
        - agentType: NRInfra
          version: 1.58.0
          configurationVersionId: ${infraCfg.latestVersionEntityId}

    Example coming soon!

    Multiple Agents

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

const fullStack = new newrelic.FleetDeployment("full_stack", {
    fleetId: prod.id,
    name: "Full Stack Deployment",
    agents: [
        {
            agentType: "NRInfra",
            version: "1.58.0",
            configurationVersionId: infraCfg.latestVersionEntityId,
        },
        {
            agentType: "FluentBit",
            version: "3.2.0",
        },
    ],
});

    import pulumi
import pulumi_newrelic as newrelic

full_stack = newrelic.FleetDeployment("full_stack",
    fleet_id=prod["id"],
    name="Full Stack Deployment",
    agents=[
        {
            "agent_type": "NRInfra",
            "version": "1.58.0",
            "configuration_version_id": infra_cfg["latestVersionEntityId"],
        },
        {
            "agent_type": "FluentBit",
            "version": "3.2.0",
        },
    ])

    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.NewFleetDeployment(ctx, "full_stack", &newrelic.FleetDeploymentArgs{
			FleetId: pulumi.Any(prod.Id),
			Name:    pulumi.String("Full Stack Deployment"),
			Agents: newrelic.FleetDeploymentAgentArray{
				&newrelic.FleetDeploymentAgentArgs{
					AgentType:              pulumi.String("NRInfra"),
					Version:                pulumi.String("1.58.0"),
					ConfigurationVersionId: pulumi.Any(infraCfg.LatestVersionEntityId),
				},
				&newrelic.FleetDeploymentAgentArgs{
					AgentType: pulumi.String("FluentBit"),
					Version:   pulumi.String("3.2.0"),
				},
			},
		})
		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 fullStack = new NewRelic.FleetDeployment("full_stack", new()
    {
        FleetId = prod.Id,
        Name = "Full Stack Deployment",
        Agents = new[]
        {
            new NewRelic.Inputs.FleetDeploymentAgentArgs
            {
                AgentType = "NRInfra",
                Version = "1.58.0",
                ConfigurationVersionId = infraCfg.LatestVersionEntityId,
            },
            new NewRelic.Inputs.FleetDeploymentAgentArgs
            {
                AgentType = "FluentBit",
                Version = "3.2.0",
            },
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.newrelic.FleetDeployment;
import com.pulumi.newrelic.FleetDeploymentArgs;
import com.pulumi.newrelic.inputs.FleetDeploymentAgentArgs;
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 fullStack = new FleetDeployment("fullStack", FleetDeploymentArgs.builder()
            .fleetId(prod.id())
            .name("Full Stack Deployment")
            .agents(            
                FleetDeploymentAgentArgs.builder()
                    .agentType("NRInfra")
                    .version("1.58.0")
                    .configurationVersionId(infraCfg.latestVersionEntityId())
                    .build(),
                FleetDeploymentAgentArgs.builder()
                    .agentType("FluentBit")
                    .version("3.2.0")
                    .build())
            .build());

    }
}

    resources:
  fullStack:
    type: newrelic:FleetDeployment
    name: full_stack
    properties:
      fleetId: ${prod.id}
      name: Full Stack Deployment
      agents:
        - agentType: NRInfra
          version: 1.58.0
          configurationVersionId: ${infraCfg.latestVersionEntityId}
        - agentType: FluentBit
          version: 3.2.0

    Example coming soon!

    With Tags

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

const infra = new newrelic.FleetDeployment("infra", {
    fleetId: prod.id,
    name: "Production Deployment",
    agents: [{
        agentType: "NRInfra",
        version: "1.58.0",
    }],
    tags: [
        "environment:production",
        "team:platform",
    ],
});

    import pulumi
import pulumi_newrelic as newrelic

infra = newrelic.FleetDeployment("infra",
    fleet_id=prod["id"],
    name="Production Deployment",
    agents=[{
        "agent_type": "NRInfra",
        "version": "1.58.0",
    }],
    tags=[
        "environment:production",
        "team:platform",
    ])

    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.NewFleetDeployment(ctx, "infra", &newrelic.FleetDeploymentArgs{
			FleetId: pulumi.Any(prod.Id),
			Name:    pulumi.String("Production Deployment"),
			Agents: newrelic.FleetDeploymentAgentArray{
				&newrelic.FleetDeploymentAgentArgs{
					AgentType: pulumi.String("NRInfra"),
					Version:   pulumi.String("1.58.0"),
				},
			},
			Tags: pulumi.StringArray{
				pulumi.String("environment:production"),
				pulumi.String("team:platform"),
			},
		})
		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 infra = new NewRelic.FleetDeployment("infra", new()
    {
        FleetId = prod.Id,
        Name = "Production Deployment",
        Agents = new[]
        {
            new NewRelic.Inputs.FleetDeploymentAgentArgs
            {
                AgentType = "NRInfra",
                Version = "1.58.0",
            },
        },
        Tags = new[]
        {
            "environment:production",
            "team:platform",
        },
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.newrelic.FleetDeployment;
import com.pulumi.newrelic.FleetDeploymentArgs;
import com.pulumi.newrelic.inputs.FleetDeploymentAgentArgs;
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 infra = new FleetDeployment("infra", FleetDeploymentArgs.builder()
            .fleetId(prod.id())
            .name("Production Deployment")
            .agents(FleetDeploymentAgentArgs.builder()
                .agentType("NRInfra")
                .version("1.58.0")
                .build())
            .tags(            
                "environment:production",
                "team:platform")
            .build());

    }
}

    resources:
  infra:
    type: newrelic:FleetDeployment
    properties:
      fleetId: ${prod.id}
      name: Production Deployment
      agents:
        - agentType: NRInfra
          version: 1.58.0
      tags:
        - environment:production
        - team:platform

    Example coming soon!

    Create FleetDeployment Resource

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

    Constructor syntax

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

@overload
def FleetDeployment(resource_name: str,
                    opts: Optional[ResourceOptions] = None,
                    fleet_id: Optional[str] = None,
                    agents: Optional[Sequence[FleetDeploymentAgentArgs]] = None,
                    description: Optional[str] = None,
                    name: Optional[str] = None,
                    organization_id: Optional[str] = None,
                    tags: Optional[Sequence[str]] = None)
    func NewFleetDeployment(ctx *Context, name string, args FleetDeploymentArgs, opts ...ResourceOption) (*FleetDeployment, error)
    public FleetDeployment(string name, FleetDeploymentArgs args, CustomResourceOptions? opts = null)
    public FleetDeployment(String name, FleetDeploymentArgs args)
public FleetDeployment(String name, FleetDeploymentArgs args, CustomResourceOptions options)

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


    resource "newrelic_fleetdeployment" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args FleetDeploymentArgs
    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 FleetDeploymentArgs
    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 FleetDeploymentArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args FleetDeploymentArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args FleetDeploymentArgs
    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 fleetDeploymentResource = new NewRelic.FleetDeployment("fleetDeploymentResource", new()
{
    FleetId = "string",
    Agents = new[]
    {
        new NewRelic.Inputs.FleetDeploymentAgentArgs
        {
            AgentType = "string",
            ConfigurationVersionId = "string",
            Version = "string",
        },
    },
    Description = "string",
    Name = "string",
    OrganizationId = "string",
    Tags = new[]
    {
        "string",
    },
});

    example, err := newrelic.NewFleetDeployment(ctx, "fleetDeploymentResource", &newrelic.FleetDeploymentArgs{
	FleetId: pulumi.String("string"),
	Agents: newrelic.FleetDeploymentAgentArray{
		&newrelic.FleetDeploymentAgentArgs{
			AgentType:              pulumi.String("string"),
			ConfigurationVersionId: pulumi.String("string"),
			Version:                pulumi.String("string"),
		},
	},
	Description:    pulumi.String("string"),
	Name:           pulumi.String("string"),
	OrganizationId: pulumi.String("string"),
	Tags: pulumi.StringArray{
		pulumi.String("string"),
	},
})

    resource "newrelic_fleetdeployment" "fleetDeploymentResource" {
  fleet_id = "string"
  agents {
    agent_type               = "string"
    configuration_version_id = "string"
    version                  = "string"
  }
  description     = "string"
  name            = "string"
  organization_id = "string"
  tags            = ["string"]
}

    var fleetDeploymentResource = new FleetDeployment("fleetDeploymentResource", FleetDeploymentArgs.builder()
    .fleetId("string")
    .agents(FleetDeploymentAgentArgs.builder()
        .agentType("string")
        .configurationVersionId("string")
        .version("string")
        .build())
    .description("string")
    .name("string")
    .organizationId("string")
    .tags("string")
    .build());

    fleet_deployment_resource = newrelic.FleetDeployment("fleetDeploymentResource",
    fleet_id="string",
    agents=[{
        "agent_type": "string",
        "configuration_version_id": "string",
        "version": "string",
    }],
    description="string",
    name="string",
    organization_id="string",
    tags=["string"])

    const fleetDeploymentResource = new newrelic.FleetDeployment("fleetDeploymentResource", {
    fleetId: "string",
    agents: [{
        agentType: "string",
        configurationVersionId: "string",
        version: "string",
    }],
    description: "string",
    name: "string",
    organizationId: "string",
    tags: ["string"],
});

    type: newrelic:FleetDeployment
properties:
    agents:
        - agentType: string
          configurationVersionId: string
          version: string
    description: string
    fleetId: string
    name: string
    organizationId: string
    tags:
        - string

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

    FleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    Agents List<Pulumi.NewRelic.Inputs.FleetDeploymentAgent>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    Description string
    A description of the deployment.
    Name string
    The name of the deployment.
    OrganizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    Tags List<string>
    A list of tags in key:value1,value2 format.
    FleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    Agents []FleetDeploymentAgentArgs
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    Description string
    A description of the deployment.
    Name string
    The name of the deployment.
    OrganizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    Tags []string
    A list of tags in key:value1,value2 format.
    fleet_id string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    agents list(object)
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    description string
    A description of the deployment.
    name string
    The name of the deployment.
    organization_id string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    tags list(string)
    A list of tags in key:value1,value2 format.
    fleetId String
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    agents List<FleetDeploymentAgent>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    description String
    A description of the deployment.
    name String
    The name of the deployment.
    organizationId String
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    tags List<String>
    A list of tags in key:value1,value2 format.
    fleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    agents FleetDeploymentAgent[]
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    description string
    A description of the deployment.
    name string
    The name of the deployment.
    organizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    tags string[]
    A list of tags in key:value1,value2 format.
    fleet_id str
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    agents Sequence[FleetDeploymentAgentArgs]
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    description str
    A description of the deployment.
    name str
    The name of the deployment.
    organization_id str
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    tags Sequence[str]
    A list of tags in key:value1,value2 format.
    fleetId String
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    agents List<Property Map>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    description String
    A description of the deployment.
    name String
    The name of the deployment.
    organizationId String
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    tags List<String>
    A list of tags in key:value1,value2 format.

    Outputs

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

    DeploymentId string
    The entity GUID of the deployment.
    Id string
    The provider-assigned unique ID for this managed resource.
    Phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    DeploymentId string
    The entity GUID of the deployment.
    Id string
    The provider-assigned unique ID for this managed resource.
    Phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    deployment_id string
    The entity GUID of the deployment.
    id string
    The provider-assigned unique ID for this managed resource.
    phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    deploymentId String
    The entity GUID of the deployment.
    id String
    The provider-assigned unique ID for this managed resource.
    phase String
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    deploymentId string
    The entity GUID of the deployment.
    id string
    The provider-assigned unique ID for this managed resource.
    phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    deployment_id str
    The entity GUID of the deployment.
    id str
    The provider-assigned unique ID for this managed resource.
    phase str
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    deploymentId String
    The entity GUID of the deployment.
    id String
    The provider-assigned unique ID for this managed resource.
    phase String
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.

    Look up Existing FleetDeployment Resource

    Get an existing FleetDeployment 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?: FleetDeploymentState, opts?: CustomResourceOptions): FleetDeployment
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        agents: Optional[Sequence[FleetDeploymentAgentArgs]] = None,
        deployment_id: Optional[str] = None,
        description: Optional[str] = None,
        fleet_id: Optional[str] = None,
        name: Optional[str] = None,
        organization_id: Optional[str] = None,
        phase: Optional[str] = None,
        tags: Optional[Sequence[str]] = None) -> FleetDeployment
    func GetFleetDeployment(ctx *Context, name string, id IDInput, state *FleetDeploymentState, opts ...ResourceOption) (*FleetDeployment, error)
    public static FleetDeployment Get(string name, Input<string> id, FleetDeploymentState? state, CustomResourceOptions? opts = null)
    public static FleetDeployment get(String name, Output<String> id, FleetDeploymentState state, CustomResourceOptions options)
    resources:  _:    type: newrelic:FleetDeployment    get:      id: ${id}
    import {
  to = newrelic_fleetdeployment.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:
    Agents List<Pulumi.NewRelic.Inputs.FleetDeploymentAgent>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    DeploymentId string
    The entity GUID of the deployment.
    Description string
    A description of the deployment.
    FleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    Name string
    The name of the deployment.
    OrganizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    Phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    Tags List<string>
    A list of tags in key:value1,value2 format.
    Agents []FleetDeploymentAgentArgs
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    DeploymentId string
    The entity GUID of the deployment.
    Description string
    A description of the deployment.
    FleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    Name string
    The name of the deployment.
    OrganizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    Phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    Tags []string
    A list of tags in key:value1,value2 format.
    agents list(object)
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    deployment_id string
    The entity GUID of the deployment.
    description string
    A description of the deployment.
    fleet_id string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    name string
    The name of the deployment.
    organization_id string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    tags list(string)
    A list of tags in key:value1,value2 format.
    agents List<FleetDeploymentAgent>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    deploymentId String
    The entity GUID of the deployment.
    description String
    A description of the deployment.
    fleetId String
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    name String
    The name of the deployment.
    organizationId String
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    phase String
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    tags List<String>
    A list of tags in key:value1,value2 format.
    agents FleetDeploymentAgent[]
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    deploymentId string
    The entity GUID of the deployment.
    description string
    A description of the deployment.
    fleetId string
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    name string
    The name of the deployment.
    organizationId string
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    phase string
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    tags string[]
    A list of tags in key:value1,value2 format.
    agents Sequence[FleetDeploymentAgentArgs]
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    deployment_id str
    The entity GUID of the deployment.
    description str
    A description of the deployment.
    fleet_id str
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    name str
    The name of the deployment.
    organization_id str
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    phase str
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    tags Sequence[str]
    A list of tags in key:value1,value2 format.
    agents List<Property Map>
    One or more agent blocks. At least one is required when creating a deployment. On update, the list may be set to empty (agent = []) to uninstall all agent assignments from the deployment. Each agentType may appear at most once per deployment. See Nested agent blocks below.
    deploymentId String
    The entity GUID of the deployment.
    description String
    A description of the deployment.
    fleetId String
    The entity GUID of the fleet this deployment belongs to. Cannot be changed after creation.
    name String
    The name of the deployment.
    organizationId String
    The organization ID. Auto-fetched from the account when not provided. Cannot be changed after creation.
    phase String
    The current phase of the deployment. Possible values: CREATED, IN_PROGRESS, FAILED, COMPLETED.
    tags List<String>
    A list of tags in key:value1,value2 format.

    Supporting Types

    FleetDeploymentAgent, FleetDeploymentAgentArgs

    AgentType string
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    ConfigurationVersionId string
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    Version string
    The agent version string to deploy (e.g. "1.58.0").
    AgentType string
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    ConfigurationVersionId string
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    Version string
    The agent version string to deploy (e.g. "1.58.0").
    agent_type string
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    configuration_version_id string
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    version string
    The agent version string to deploy (e.g. "1.58.0").
    agentType String
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    configurationVersionId String
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    version String
    The agent version string to deploy (e.g. "1.58.0").
    agentType string
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    configurationVersionId string
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    version string
    The agent version string to deploy (e.g. "1.58.0").
    agent_type str
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    configuration_version_id str
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    version str
    The agent version string to deploy (e.g. "1.58.0").
    agentType String
    The agent type. Valid values: NRInfra, NRDOT, FluentBit, NRPrometheusAgent.
    configurationVersionId String
    A configuration version entity GUID (from newrelic.FleetConfiguration) to associate with this agent in the deployment.
    version String
    The agent version string to deploy (e.g. "1.58.0").

    Import

    Fleet deployments can be imported using the deployment entity GUID:

    $ pulumi import newrelic:index/fleetDeployment:FleetDeployment infra <deployment_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.66.2
    published on Tuesday, May 12, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-newrelic
      Try Pulumi Cloud free. Your team will thank you.