published on Thursday, Apr 23, 2026 by Volcengine
published on Thursday, Apr 23, 2026 by Volcengine
A deployment set is a strategy that controls the distribution of instances at the underlying hardware level, enabling physical-level security isolation. By creating deployment sets, you can distribute instances across different underlying hardware to ensure disaster recovery and high availability for your business.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as volcenginecc from "@volcengine/pulumi-volcenginecc";
const ecsDeploymentSetDemo = new volcenginecc.ecs.DeploymentSet("EcsDeploymentSetDemo", {
description: "this is a test DeploymentSet",
deploymentSetName: "test-deployment-set",
granularity: "host",
instanceIds: ["i-yedvixxxxxva4izkjtl"],
deploymentSetGroupNumber: 1,
strategy: "Availability",
});
import pulumi
import pulumi_volcenginecc as volcenginecc
ecs_deployment_set_demo = volcenginecc.ecs.DeploymentSet("EcsDeploymentSetDemo",
description="this is a test DeploymentSet",
deployment_set_name="test-deployment-set",
granularity="host",
instance_ids=["i-yedvixxxxxva4izkjtl"],
deployment_set_group_number=1,
strategy="Availability")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/volcengine/pulumi-volcenginecc/sdk/go/volcenginecc/ecs"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := ecs.NewDeploymentSet(ctx, "EcsDeploymentSetDemo", &ecs.DeploymentSetArgs{
Description: pulumi.String("this is a test DeploymentSet"),
DeploymentSetName: pulumi.String("test-deployment-set"),
Granularity: pulumi.String("host"),
InstanceIds: pulumi.StringArray{
pulumi.String("i-yedvixxxxxva4izkjtl"),
},
DeploymentSetGroupNumber: pulumi.Int(1),
Strategy: pulumi.String("Availability"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Volcenginecc = Volcengine.Pulumi.Volcenginecc;
return await Deployment.RunAsync(() =>
{
var ecsDeploymentSetDemo = new Volcenginecc.Ecs.DeploymentSet("EcsDeploymentSetDemo", new()
{
Description = "this is a test DeploymentSet",
DeploymentSetName = "test-deployment-set",
Granularity = "host",
InstanceIds = new[]
{
"i-yedvixxxxxva4izkjtl",
},
DeploymentSetGroupNumber = 1,
Strategy = "Availability",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.volcengine.volcenginecc.ecs.DeploymentSet;
import com.volcengine.volcenginecc.ecs.DeploymentSetArgs;
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 ecsDeploymentSetDemo = new DeploymentSet("ecsDeploymentSetDemo", DeploymentSetArgs.builder()
.description("this is a test DeploymentSet")
.deploymentSetName("test-deployment-set")
.granularity("host")
.instanceIds("i-yedvixxxxxva4izkjtl")
.deploymentSetGroupNumber(1)
.strategy("Availability")
.build());
}
}
resources:
ecsDeploymentSetDemo:
type: volcenginecc:ecs:DeploymentSet
name: EcsDeploymentSetDemo
properties:
description: this is a test DeploymentSet
deploymentSetName: test-deployment-set
granularity: host
instanceIds:
- i-yedvixxxxxva4izkjtl
deploymentSetGroupNumber: 1
strategy: Availability
Create DeploymentSet Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new DeploymentSet(name: string, args: DeploymentSetArgs, opts?: CustomResourceOptions);@overload
def DeploymentSet(resource_name: str,
args: DeploymentSetArgs,
opts: Optional[ResourceOptions] = None)
@overload
def DeploymentSet(resource_name: str,
opts: Optional[ResourceOptions] = None,
deployment_set_name: Optional[str] = None,
deployment_set_group_number: Optional[int] = None,
description: Optional[str] = None,
granularity: Optional[str] = None,
group_count: Optional[int] = None,
instance_ids: Optional[Sequence[str]] = None,
strategy: Optional[str] = None)func NewDeploymentSet(ctx *Context, name string, args DeploymentSetArgs, opts ...ResourceOption) (*DeploymentSet, error)public DeploymentSet(string name, DeploymentSetArgs args, CustomResourceOptions? opts = null)
public DeploymentSet(String name, DeploymentSetArgs args)
public DeploymentSet(String name, DeploymentSetArgs args, CustomResourceOptions options)
type: volcenginecc:ecs:DeploymentSet
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 DeploymentSetArgs
- 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 DeploymentSetArgs
- 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 DeploymentSetArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DeploymentSetArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DeploymentSetArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
DeploymentSet 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 DeploymentSet resource accepts the following input properties:
- Deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- Deployment
Set intGroup Number - Deployment set group index. Value range: 1–7.
- Description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- Granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- Group
Count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- Instance
Ids List<string> - List of ECS instance IDs in the deployment set.
- Strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- Deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- Deployment
Set intGroup Number - Deployment set group index. Value range: 1–7.
- Description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- Granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- Group
Count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- Instance
Ids []string - List of ECS instance IDs in the deployment set.
- Strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- deployment
Set StringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- deployment
Set IntegerGroup Number - Deployment set group index. Value range: 1–7.
- description String
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity String
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count Integer - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Ids List<String> - List of ECS instance IDs in the deployment set.
- strategy String
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- deployment
Set numberGroup Number - Deployment set group index. Value range: 1–7.
- description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count number - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Ids string[] - List of ECS instance IDs in the deployment set.
- strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- deployment_
set_ strname - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- deployment_
set_ intgroup_ number - Deployment set group index. Value range: 1–7.
- description str
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity str
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group_
count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance_
ids Sequence[str] - List of ECS instance IDs in the deployment set.
- strategy str
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- deployment
Set StringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- deployment
Set NumberGroup Number - Deployment set group index. Value range: 1–7.
- description String
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity String
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count Number - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Ids List<String> - List of ECS instance IDs in the deployment set.
- strategy String
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
Outputs
All input properties are implicitly available as output properties. Additionally, the DeploymentSet resource produces the following output properties:
- Capacities
List<Volcengine.
Deployment Set Capacity> - Created
At string - Deployment set creation time.
- Deployment
Set stringId - Deployment set ID.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Amount int - Number of ECS instances in the deployment set.
- Capacities
[]Deployment
Set Capacity - Created
At string - Deployment set creation time.
- Deployment
Set stringId - Deployment set ID.
- Id string
- The provider-assigned unique ID for this managed resource.
- Instance
Amount int - Number of ECS instances in the deployment set.
- capacities
List<Deployment
Set Capacity> - created
At String - Deployment set creation time.
- deployment
Set StringId - Deployment set ID.
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Amount Integer - Number of ECS instances in the deployment set.
- capacities
Deployment
Set Capacity[] - created
At string - Deployment set creation time.
- deployment
Set stringId - Deployment set ID.
- id string
- The provider-assigned unique ID for this managed resource.
- instance
Amount number - Number of ECS instances in the deployment set.
- capacities
Sequence[Deployment
Set Capacity] - created_
at str - Deployment set creation time.
- deployment_
set_ strid - Deployment set ID.
- id str
- The provider-assigned unique ID for this managed resource.
- instance_
amount int - Number of ECS instances in the deployment set.
- capacities List<Property Map>
- created
At String - Deployment set creation time.
- deployment
Set StringId - Deployment set ID.
- id String
- The provider-assigned unique ID for this managed resource.
- instance
Amount Number - Number of ECS instances in the deployment set.
Look up Existing DeploymentSet Resource
Get an existing DeploymentSet 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?: DeploymentSetState, opts?: CustomResourceOptions): DeploymentSet@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
capacities: Optional[Sequence[DeploymentSetCapacityArgs]] = None,
created_at: Optional[str] = None,
deployment_set_group_number: Optional[int] = None,
deployment_set_id: Optional[str] = None,
deployment_set_name: Optional[str] = None,
description: Optional[str] = None,
granularity: Optional[str] = None,
group_count: Optional[int] = None,
instance_amount: Optional[int] = None,
instance_ids: Optional[Sequence[str]] = None,
strategy: Optional[str] = None) -> DeploymentSetfunc GetDeploymentSet(ctx *Context, name string, id IDInput, state *DeploymentSetState, opts ...ResourceOption) (*DeploymentSet, error)public static DeploymentSet Get(string name, Input<string> id, DeploymentSetState? state, CustomResourceOptions? opts = null)public static DeploymentSet get(String name, Output<String> id, DeploymentSetState state, CustomResourceOptions options)resources: _: type: volcenginecc:ecs:DeploymentSet get: 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.
- Capacities
List<Volcengine.
Deployment Set Capacity> - Created
At string - Deployment set creation time.
- Deployment
Set intGroup Number - Deployment set group index. Value range: 1–7.
- Deployment
Set stringId - Deployment set ID.
- Deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- Description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- Granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- Group
Count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- Instance
Amount int - Number of ECS instances in the deployment set.
- Instance
Ids List<string> - List of ECS instance IDs in the deployment set.
- Strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- Capacities
[]Deployment
Set Capacity Args - Created
At string - Deployment set creation time.
- Deployment
Set intGroup Number - Deployment set group index. Value range: 1–7.
- Deployment
Set stringId - Deployment set ID.
- Deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- Description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- Granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- Group
Count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- Instance
Amount int - Number of ECS instances in the deployment set.
- Instance
Ids []string - List of ECS instance IDs in the deployment set.
- Strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- capacities
List<Deployment
Set Capacity> - created
At String - Deployment set creation time.
- deployment
Set IntegerGroup Number - Deployment set group index. Value range: 1–7.
- deployment
Set StringId - Deployment set ID.
- deployment
Set StringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- description String
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity String
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count Integer - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Amount Integer - Number of ECS instances in the deployment set.
- instance
Ids List<String> - List of ECS instance IDs in the deployment set.
- strategy String
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- capacities
Deployment
Set Capacity[] - created
At string - Deployment set creation time.
- deployment
Set numberGroup Number - Deployment set group index. Value range: 1–7.
- deployment
Set stringId - Deployment set ID.
- deployment
Set stringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- description string
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity string
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count number - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Amount number - Number of ECS instances in the deployment set.
- instance
Ids string[] - List of ECS instance IDs in the deployment set.
- strategy string
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- capacities
Sequence[Deployment
Set Capacity Args] - created_
at str - Deployment set creation time.
- deployment_
set_ intgroup_ number - Deployment set group index. Value range: 1–7.
- deployment_
set_ strid - Deployment set ID.
- deployment_
set_ strname - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- description str
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity str
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group_
count int - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance_
amount int - Number of ECS instances in the deployment set.
- instance_
ids Sequence[str] - List of ECS instance IDs in the deployment set.
- strategy str
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
- capacities List<Property Map>
- created
At String - Deployment set creation time.
- deployment
Set NumberGroup Number - Deployment set group index. Value range: 1–7.
- deployment
Set StringId - Deployment set ID.
- deployment
Set StringName - Deployment set name. Cannot start with a digit, hyphen, or underscore. Can only contain Chinese characters, letters, digits, underscores, and hyphens. Length limit: 1–128 characters.
- description String
- Deployment set description. Must start with a letter or Chinese character. Can only contain Chinese characters, letters, digits, period '.', space, underscore '_', hyphen '-', equals '=', English comma ',', Chinese comma ',', and Chinese period '。'. Length limit: within 255 characters.
- granularity String
- Deployment granularity. Options: host: physical machine. rack: rack. switch: switch.
- group
Count Number - Number of deployment set groups. Set the group count for the deployment set group high availability policy. Value range: 1–7. Default: 7.
- instance
Amount Number - Number of ECS instances in the deployment set.
- instance
Ids List<String> - List of ECS instance IDs in the deployment set.
- strategy String
- Deployment policy. Options: Availability (default): high availability policy. AvailabilityGroup: deployment set group high availability policy.
Supporting Types
DeploymentSetCapacity, DeploymentSetCapacityArgs
- Available
Count int - You can also include the number of ECS instances in the current deployment set within this availability zone.
- Used
Count int - Number of ECS instances in the deployment set that belong to this availability zone.
- Zone
Id string - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
- Available
Count int - You can also include the number of ECS instances in the current deployment set within this availability zone.
- Used
Count int - Number of ECS instances in the deployment set that belong to this availability zone.
- Zone
Id string - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
- available
Count Integer - You can also include the number of ECS instances in the current deployment set within this availability zone.
- used
Count Integer - Number of ECS instances in the deployment set that belong to this availability zone.
- zone
Id String - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
- available
Count number - You can also include the number of ECS instances in the current deployment set within this availability zone.
- used
Count number - Number of ECS instances in the deployment set that belong to this availability zone.
- zone
Id string - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
- available_
count int - You can also include the number of ECS instances in the current deployment set within this availability zone.
- used_
count int - Number of ECS instances in the deployment set that belong to this availability zone.
- zone_
id str - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
- available
Count Number - You can also include the number of ECS instances in the current deployment set within this availability zone.
- used
Count Number - Number of ECS instances in the deployment set that belong to this availability zone.
- zone
Id String - Availability zone ID. Only returns the availability zone ID for ECS instances in the deployment set.
Import
$ pulumi import volcenginecc:ecs/deploymentSet:DeploymentSet example "deployment_set_id"
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- volcenginecc volcengine/pulumi-volcenginecc
- License
- MPL-2.0
- Notes
- This Pulumi package is based on the
volcengineccTerraform Provider.
published on Thursday, Apr 23, 2026 by Volcengine
