Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. ecs
  5. getDedicatedHosts
Alibaba Cloud v3.81.0 published on Monday, Jun 23, 2025 by Pulumi
pulumi/pulumi-alicloud

alicloud.ecs.getDedicatedHosts

Explore with Pulumi AI

alicloud logo
Alibaba Cloud v3.81.0 published on Monday, Jun 23, 2025 by Pulumi
pulumi/pulumi-alicloud

    This data source provides the ECS Dedicated Hosts of the current Alibaba Cloud user.

    NOTE: Available since v1.91.0.

    Example Usage

    Basic Usage

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

const config = new pulumi.Config();
const name = config.get("name") || "terraform-example";
const _default = new alicloud.ecs.DedicatedHost("default", {
    dedicatedHostType: "ddh.c5",
    description: "From_Terraform",
    dedicatedHostName: name,
    actionOnMaintenance: "Migrate",
    tags: {
        Create: "TF",
        For: "ddh-test",
    },
});
const ids = alicloud.ecs.getDedicatedHostsOutput({
    ids: [_default.id],
});
export const ecsDedicatedHostId0 = ids.apply(ids => ids.hosts?.[0]?.id);

    import pulumi
import pulumi_alicloud as alicloud

config = pulumi.Config()
name = config.get("name")
if name is None:
    name = "terraform-example"
default = alicloud.ecs.DedicatedHost("default",
    dedicated_host_type="ddh.c5",
    description="From_Terraform",
    dedicated_host_name=name,
    action_on_maintenance="Migrate",
    tags={
        "Create": "TF",
        "For": "ddh-test",
    })
ids = alicloud.ecs.get_dedicated_hosts_output(ids=[default.id])
pulumi.export("ecsDedicatedHostId0", ids.hosts[0].id)

    package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		cfg := config.New(ctx, "")
		name := "terraform-example"
		if param := cfg.Get("name"); param != "" {
			name = param
		}
		_default, err := ecs.NewDedicatedHost(ctx, "default", &ecs.DedicatedHostArgs{
			DedicatedHostType:   pulumi.String("ddh.c5"),
			Description:         pulumi.String("From_Terraform"),
			DedicatedHostName:   pulumi.String(name),
			ActionOnMaintenance: pulumi.String("Migrate"),
			Tags: pulumi.StringMap{
				"Create": pulumi.String("TF"),
				"For":    pulumi.String("ddh-test"),
			},
		})
		if err != nil {
			return err
		}
		ids := ecs.GetDedicatedHostsOutput(ctx, ecs.GetDedicatedHostsOutputArgs{
			Ids: pulumi.StringArray{
				_default.ID(),
			},
		}, nil)
		ctx.Export("ecsDedicatedHostId0", ids.ApplyT(func(ids ecs.GetDedicatedHostsResult) (*string, error) {
			return &ids.Hosts[0].Id, nil
		}).(pulumi.StringPtrOutput))
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var config = new Config();
    var name = config.Get("name") ?? "terraform-example";
    var @default = new AliCloud.Ecs.DedicatedHost("default", new()
    {
        DedicatedHostType = "ddh.c5",
        Description = "From_Terraform",
        DedicatedHostName = name,
        ActionOnMaintenance = "Migrate",
        Tags = 
        {
            { "Create", "TF" },
            { "For", "ddh-test" },
        },
    });

    var ids = AliCloud.Ecs.GetDedicatedHosts.Invoke(new()
    {
        Ids = new[]
        {
            @default.Id,
        },
    });

    return new Dictionary<string, object?>
    {
        ["ecsDedicatedHostId0"] = ids.Apply(getDedicatedHostsResult => getDedicatedHostsResult.Hosts[0]?.Id),
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.DedicatedHost;
import com.pulumi.alicloud.ecs.DedicatedHostArgs;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetDedicatedHostsArgs;
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) {
        final var config = ctx.config();
        final var name = config.get("name").orElse("terraform-example");
        var default_ = new DedicatedHost("default", DedicatedHostArgs.builder()
            .dedicatedHostType("ddh.c5")
            .description("From_Terraform")
            .dedicatedHostName(name)
            .actionOnMaintenance("Migrate")
            .tags(Map.ofEntries(
                Map.entry("Create", "TF"),
                Map.entry("For", "ddh-test")
            ))
            .build());

        final var ids = EcsFunctions.getDedicatedHosts(GetDedicatedHostsArgs.builder()
            .ids(default_.id())
            .build());

        ctx.export("ecsDedicatedHostId0", ids.applyValue(_ids -> _ids.hosts()[0].id()));
    }
}

    configuration:
  name:
    type: string
    default: terraform-example
resources:
  default:
    type: alicloud:ecs:DedicatedHost
    properties:
      dedicatedHostType: ddh.c5
      description: From_Terraform
      dedicatedHostName: ${name}
      actionOnMaintenance: Migrate
      tags:
        Create: TF
        For: ddh-test
variables:
  ids:
    fn::invoke:
      function: alicloud:ecs:getDedicatedHosts
      arguments:
        ids:
          - ${default.id}
outputs:
  ecsDedicatedHostId0: ${ids.hosts[0].id}

    Using getDedicatedHosts

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

    function getDedicatedHosts(args: GetDedicatedHostsArgs, opts?: InvokeOptions): Promise<GetDedicatedHostsResult>
function getDedicatedHostsOutput(args: GetDedicatedHostsOutputArgs, opts?: InvokeOptions): Output<GetDedicatedHostsResult>
    def get_dedicated_hosts(dedicated_host_id: Optional[str] = None,
                        dedicated_host_name: Optional[str] = None,
                        dedicated_host_type: Optional[str] = None,
                        ids: Optional[Sequence[str]] = None,
                        name_regex: Optional[str] = None,
                        operation_locks: Optional[Sequence[GetDedicatedHostsOperationLock]] = None,
                        output_file: Optional[str] = None,
                        resource_group_id: Optional[str] = None,
                        status: Optional[str] = None,
                        tags: Optional[Mapping[str, str]] = None,
                        zone_id: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetDedicatedHostsResult
def get_dedicated_hosts_output(dedicated_host_id: Optional[pulumi.Input[str]] = None,
                        dedicated_host_name: Optional[pulumi.Input[str]] = None,
                        dedicated_host_type: Optional[pulumi.Input[str]] = None,
                        ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                        name_regex: Optional[pulumi.Input[str]] = None,
                        operation_locks: Optional[pulumi.Input[Sequence[pulumi.Input[GetDedicatedHostsOperationLockArgs]]]] = None,
                        output_file: Optional[pulumi.Input[str]] = None,
                        resource_group_id: Optional[pulumi.Input[str]] = None,
                        status: Optional[pulumi.Input[str]] = None,
                        tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                        zone_id: Optional[pulumi.Input[str]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedHostsResult]
    func GetDedicatedHosts(ctx *Context, args *GetDedicatedHostsArgs, opts ...InvokeOption) (*GetDedicatedHostsResult, error)
func GetDedicatedHostsOutput(ctx *Context, args *GetDedicatedHostsOutputArgs, opts ...InvokeOption) GetDedicatedHostsResultOutput

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

    public static class GetDedicatedHosts 
{
    public static Task<GetDedicatedHostsResult> InvokeAsync(GetDedicatedHostsArgs args, InvokeOptions? opts = null)
    public static Output<GetDedicatedHostsResult> Invoke(GetDedicatedHostsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetDedicatedHostsResult> getDedicatedHosts(GetDedicatedHostsArgs args, InvokeOptions options)
public static Output<GetDedicatedHostsResult> getDedicatedHosts(GetDedicatedHostsArgs args, InvokeOptions options)

    fn::invoke:
  function: alicloud:ecs/getDedicatedHosts:getDedicatedHosts
  arguments:
    # arguments dictionary

    The following arguments are supported:

    DedicatedHostId string
    The ID of ECS Dedicated Host.
    DedicatedHostName string
    The name of ECS Dedicated Host.
    DedicatedHostType string
    The type of the dedicated host.
    Ids List<string>
    A list of ECS Dedicated Host ids.
    NameRegex string
    A regex string to filter results by the ECS Dedicated Host name.
    OperationLocks List<Pulumi.AliCloud.Ecs.Inputs.GetDedicatedHostsOperationLock>
    The reason why the dedicated host resource is locked. See operation_locks below.
    OutputFile string
    Save the result to the file.
    ResourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    Status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    Tags Dictionary<string, string>
    A mapping of tags to assign to the resource.
    ZoneId string
    The zone ID of the ECS Dedicated Host.
    DedicatedHostId string
    The ID of ECS Dedicated Host.
    DedicatedHostName string
    The name of ECS Dedicated Host.
    DedicatedHostType string
    The type of the dedicated host.
    Ids []string
    A list of ECS Dedicated Host ids.
    NameRegex string
    A regex string to filter results by the ECS Dedicated Host name.
    OperationLocks []GetDedicatedHostsOperationLock
    The reason why the dedicated host resource is locked. See operation_locks below.
    OutputFile string
    Save the result to the file.
    ResourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    Status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    Tags map[string]string
    A mapping of tags to assign to the resource.
    ZoneId string
    The zone ID of the ECS Dedicated Host.
    dedicatedHostId String
    The ID of ECS Dedicated Host.
    dedicatedHostName String
    The name of ECS Dedicated Host.
    dedicatedHostType String
    The type of the dedicated host.
    ids List<String>
    A list of ECS Dedicated Host ids.
    nameRegex String
    A regex string to filter results by the ECS Dedicated Host name.
    operationLocks List<GetDedicatedHostsOperationLock>
    The reason why the dedicated host resource is locked. See operation_locks below.
    outputFile String
    Save the result to the file.
    resourceGroupId String
    The ID of the resource group to which the ECS Dedicated Host belongs.
    status String
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    tags Map<String,String>
    A mapping of tags to assign to the resource.
    zoneId String
    The zone ID of the ECS Dedicated Host.
    dedicatedHostId string
    The ID of ECS Dedicated Host.
    dedicatedHostName string
    The name of ECS Dedicated Host.
    dedicatedHostType string
    The type of the dedicated host.
    ids string[]
    A list of ECS Dedicated Host ids.
    nameRegex string
    A regex string to filter results by the ECS Dedicated Host name.
    operationLocks GetDedicatedHostsOperationLock[]
    The reason why the dedicated host resource is locked. See operation_locks below.
    outputFile string
    Save the result to the file.
    resourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    tags {[key: string]: string}
    A mapping of tags to assign to the resource.
    zoneId string
    The zone ID of the ECS Dedicated Host.
    dedicated_host_id str
    The ID of ECS Dedicated Host.
    dedicated_host_name str
    The name of ECS Dedicated Host.
    dedicated_host_type str
    The type of the dedicated host.
    ids Sequence[str]
    A list of ECS Dedicated Host ids.
    name_regex str
    A regex string to filter results by the ECS Dedicated Host name.
    operation_locks Sequence[GetDedicatedHostsOperationLock]
    The reason why the dedicated host resource is locked. See operation_locks below.
    output_file str
    Save the result to the file.
    resource_group_id str
    The ID of the resource group to which the ECS Dedicated Host belongs.
    status str
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    tags Mapping[str, str]
    A mapping of tags to assign to the resource.
    zone_id str
    The zone ID of the ECS Dedicated Host.
    dedicatedHostId String
    The ID of ECS Dedicated Host.
    dedicatedHostName String
    The name of ECS Dedicated Host.
    dedicatedHostType String
    The type of the dedicated host.
    ids List<String>
    A list of ECS Dedicated Host ids.
    nameRegex String
    A regex string to filter results by the ECS Dedicated Host name.
    operationLocks List<Property Map>
    The reason why the dedicated host resource is locked. See operation_locks below.
    outputFile String
    Save the result to the file.
    resourceGroupId String
    The ID of the resource group to which the ECS Dedicated Host belongs.
    status String
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    tags Map<String>
    A mapping of tags to assign to the resource.
    zoneId String
    The zone ID of the ECS Dedicated Host.

    getDedicatedHosts Result

    The following output properties are available:

    Hosts List<Pulumi.AliCloud.Ecs.Outputs.GetDedicatedHostsHost>
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    Ids List<string>
    Names List<string>
    A list of ECS Dedicated Host names.
    DedicatedHostId string
    ID of the ECS Dedicated Host.
    DedicatedHostName string
    The name of the dedicated host.
    DedicatedHostType string
    The type of the dedicated host.
    NameRegex string
    OperationLocks List<Pulumi.AliCloud.Ecs.Outputs.GetDedicatedHostsOperationLock>
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    OutputFile string
    ResourceGroupId string
    The ID of the resource group to which the dedicated host belongs.
    Status string
    The service status of the dedicated host.
    Tags Dictionary<string, string>
    The tags of the dedicated host.
    ZoneId string
    The zone id of the dedicated host.
    Hosts []GetDedicatedHostsHost
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    Id string
    The provider-assigned unique ID for this managed resource.
    Ids []string
    Names []string
    A list of ECS Dedicated Host names.
    DedicatedHostId string
    ID of the ECS Dedicated Host.
    DedicatedHostName string
    The name of the dedicated host.
    DedicatedHostType string
    The type of the dedicated host.
    NameRegex string
    OperationLocks []GetDedicatedHostsOperationLock
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    OutputFile string
    ResourceGroupId string
    The ID of the resource group to which the dedicated host belongs.
    Status string
    The service status of the dedicated host.
    Tags map[string]string
    The tags of the dedicated host.
    ZoneId string
    The zone id of the dedicated host.
    hosts List<GetDedicatedHostsHost>
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    ids List<String>
    names List<String>
    A list of ECS Dedicated Host names.
    dedicatedHostId String
    ID of the ECS Dedicated Host.
    dedicatedHostName String
    The name of the dedicated host.
    dedicatedHostType String
    The type of the dedicated host.
    nameRegex String
    operationLocks List<GetDedicatedHostsOperationLock>
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    outputFile String
    resourceGroupId String
    The ID of the resource group to which the dedicated host belongs.
    status String
    The service status of the dedicated host.
    tags Map<String,String>
    The tags of the dedicated host.
    zoneId String
    The zone id of the dedicated host.
    hosts GetDedicatedHostsHost[]
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    id string
    The provider-assigned unique ID for this managed resource.
    ids string[]
    names string[]
    A list of ECS Dedicated Host names.
    dedicatedHostId string
    ID of the ECS Dedicated Host.
    dedicatedHostName string
    The name of the dedicated host.
    dedicatedHostType string
    The type of the dedicated host.
    nameRegex string
    operationLocks GetDedicatedHostsOperationLock[]
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    outputFile string
    resourceGroupId string
    The ID of the resource group to which the dedicated host belongs.
    status string
    The service status of the dedicated host.
    tags {[key: string]: string}
    The tags of the dedicated host.
    zoneId string
    The zone id of the dedicated host.
    hosts Sequence[GetDedicatedHostsHost]
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    id str
    The provider-assigned unique ID for this managed resource.
    ids Sequence[str]
    names Sequence[str]
    A list of ECS Dedicated Host names.
    dedicated_host_id str
    ID of the ECS Dedicated Host.
    dedicated_host_name str
    The name of the dedicated host.
    dedicated_host_type str
    The type of the dedicated host.
    name_regex str
    operation_locks Sequence[GetDedicatedHostsOperationLock]
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    output_file str
    resource_group_id str
    The ID of the resource group to which the dedicated host belongs.
    status str
    The service status of the dedicated host.
    tags Mapping[str, str]
    The tags of the dedicated host.
    zone_id str
    The zone id of the dedicated host.
    hosts List<Property Map>
    A list of ECS Dedicated Hosts. Each element contains the following attributes:
    id String
    The provider-assigned unique ID for this managed resource.
    ids List<String>
    names List<String>
    A list of ECS Dedicated Host names.
    dedicatedHostId String
    ID of the ECS Dedicated Host.
    dedicatedHostName String
    The name of the dedicated host.
    dedicatedHostType String
    The type of the dedicated host.
    nameRegex String
    operationLocks List<Property Map>
    (Available since v1.123.1) The operation_locks. contains the following attribute:
    outputFile String
    resourceGroupId String
    The ID of the resource group to which the dedicated host belongs.
    status String
    The service status of the dedicated host.
    tags Map<String>
    The tags of the dedicated host.
    zoneId String
    The zone id of the dedicated host.

    Supporting Types

    GetDedicatedHostsHost

    ActionOnMaintenance string
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    AutoPlacement string
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    AutoReleaseTime string
    The automatic release time of the dedicated host.
    Capacities List<Pulumi.AliCloud.Ecs.Inputs.GetDedicatedHostsHostCapacity>
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    Cores int
    A mapping of tags to assign to the resource.
    CpuOverCommitRatio double
    (Available since v1.123.1) CPU oversold ratio.
    DedicatedHostId string
    The ID of ECS Dedicated Host.
    DedicatedHostName string
    The name of ECS Dedicated Host.
    DedicatedHostType string
    The type of the dedicated host.
    Description string
    The description of the dedicated host.
    ExpiredTime string
    The expiration time of the subscription dedicated host.
    GpuSpec string
    The GPU model.
    Id string
    ID of the ECS Dedicated Host.
    Instances List<Pulumi.AliCloud.Ecs.Inputs.GetDedicatedHostsHostInstance>
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    MachineId string
    The machine code of the dedicated host.
    NetworkAttributes List<Pulumi.AliCloud.Ecs.Inputs.GetDedicatedHostsHostNetworkAttribute>
    dedicated host network parameters. contains the following attributes:
    OperationLocks List<Pulumi.AliCloud.Ecs.Inputs.GetDedicatedHostsHostOperationLock>
    The reason why the dedicated host resource is locked. See operation_locks below.
    PaymentType string
    The billing method of the dedicated host.
    PhysicalGpus int
    The number of physical GPUs.
    ResourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    SaleCycle string
    The unit of the subscription billing method.
    Sockets int
    The number of physical CPUs.
    Status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    SupportedCustomInstanceTypeFamilies List<string>
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    SupportedInstanceTypeFamilies List<string>
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    SupportedInstanceTypesLists List<string>
    The list of ECS instance.
    Tags Dictionary<string, string>
    A mapping of tags to assign to the resource.
    ZoneId string
    The zone ID of the ECS Dedicated Host.
    ActionOnMaintenance string
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    AutoPlacement string
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    AutoReleaseTime string
    The automatic release time of the dedicated host.
    Capacities []GetDedicatedHostsHostCapacity
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    Cores int
    A mapping of tags to assign to the resource.
    CpuOverCommitRatio float64
    (Available since v1.123.1) CPU oversold ratio.
    DedicatedHostId string
    The ID of ECS Dedicated Host.
    DedicatedHostName string
    The name of ECS Dedicated Host.
    DedicatedHostType string
    The type of the dedicated host.
    Description string
    The description of the dedicated host.
    ExpiredTime string
    The expiration time of the subscription dedicated host.
    GpuSpec string
    The GPU model.
    Id string
    ID of the ECS Dedicated Host.
    Instances []GetDedicatedHostsHostInstance
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    MachineId string
    The machine code of the dedicated host.
    NetworkAttributes []GetDedicatedHostsHostNetworkAttribute
    dedicated host network parameters. contains the following attributes:
    OperationLocks []GetDedicatedHostsHostOperationLock
    The reason why the dedicated host resource is locked. See operation_locks below.
    PaymentType string
    The billing method of the dedicated host.
    PhysicalGpus int
    The number of physical GPUs.
    ResourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    SaleCycle string
    The unit of the subscription billing method.
    Sockets int
    The number of physical CPUs.
    Status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    SupportedCustomInstanceTypeFamilies []string
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    SupportedInstanceTypeFamilies []string
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    SupportedInstanceTypesLists []string
    The list of ECS instance.
    Tags map[string]string
    A mapping of tags to assign to the resource.
    ZoneId string
    The zone ID of the ECS Dedicated Host.
    actionOnMaintenance String
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    autoPlacement String
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    autoReleaseTime String
    The automatic release time of the dedicated host.
    capacities List<GetDedicatedHostsHostCapacity>
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    cores Integer
    A mapping of tags to assign to the resource.
    cpuOverCommitRatio Double
    (Available since v1.123.1) CPU oversold ratio.
    dedicatedHostId String
    The ID of ECS Dedicated Host.
    dedicatedHostName String
    The name of ECS Dedicated Host.
    dedicatedHostType String
    The type of the dedicated host.
    description String
    The description of the dedicated host.
    expiredTime String
    The expiration time of the subscription dedicated host.
    gpuSpec String
    The GPU model.
    id String
    ID of the ECS Dedicated Host.
    instances List<GetDedicatedHostsHostInstance>
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    machineId String
    The machine code of the dedicated host.
    networkAttributes List<GetDedicatedHostsHostNetworkAttribute>
    dedicated host network parameters. contains the following attributes:
    operationLocks List<GetDedicatedHostsHostOperationLock>
    The reason why the dedicated host resource is locked. See operation_locks below.
    paymentType String
    The billing method of the dedicated host.
    physicalGpus Integer
    The number of physical GPUs.
    resourceGroupId String
    The ID of the resource group to which the ECS Dedicated Host belongs.
    saleCycle String
    The unit of the subscription billing method.
    sockets Integer
    The number of physical CPUs.
    status String
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    supportedCustomInstanceTypeFamilies List<String>
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    supportedInstanceTypeFamilies List<String>
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    supportedInstanceTypesLists List<String>
    The list of ECS instance.
    tags Map<String,String>
    A mapping of tags to assign to the resource.
    zoneId String
    The zone ID of the ECS Dedicated Host.
    actionOnMaintenance string
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    autoPlacement string
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    autoReleaseTime string
    The automatic release time of the dedicated host.
    capacities GetDedicatedHostsHostCapacity[]
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    cores number
    A mapping of tags to assign to the resource.
    cpuOverCommitRatio number
    (Available since v1.123.1) CPU oversold ratio.
    dedicatedHostId string
    The ID of ECS Dedicated Host.
    dedicatedHostName string
    The name of ECS Dedicated Host.
    dedicatedHostType string
    The type of the dedicated host.
    description string
    The description of the dedicated host.
    expiredTime string
    The expiration time of the subscription dedicated host.
    gpuSpec string
    The GPU model.
    id string
    ID of the ECS Dedicated Host.
    instances GetDedicatedHostsHostInstance[]
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    machineId string
    The machine code of the dedicated host.
    networkAttributes GetDedicatedHostsHostNetworkAttribute[]
    dedicated host network parameters. contains the following attributes:
    operationLocks GetDedicatedHostsHostOperationLock[]
    The reason why the dedicated host resource is locked. See operation_locks below.
    paymentType string
    The billing method of the dedicated host.
    physicalGpus number
    The number of physical GPUs.
    resourceGroupId string
    The ID of the resource group to which the ECS Dedicated Host belongs.
    saleCycle string
    The unit of the subscription billing method.
    sockets number
    The number of physical CPUs.
    status string
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    supportedCustomInstanceTypeFamilies string[]
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    supportedInstanceTypeFamilies string[]
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    supportedInstanceTypesLists string[]
    The list of ECS instance.
    tags {[key: string]: string}
    A mapping of tags to assign to the resource.
    zoneId string
    The zone ID of the ECS Dedicated Host.
    action_on_maintenance str
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    auto_placement str
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    auto_release_time str
    The automatic release time of the dedicated host.
    capacities Sequence[GetDedicatedHostsHostCapacity]
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    cores int
    A mapping of tags to assign to the resource.
    cpu_over_commit_ratio float
    (Available since v1.123.1) CPU oversold ratio.
    dedicated_host_id str
    The ID of ECS Dedicated Host.
    dedicated_host_name str
    The name of ECS Dedicated Host.
    dedicated_host_type str
    The type of the dedicated host.
    description str
    The description of the dedicated host.
    expired_time str
    The expiration time of the subscription dedicated host.
    gpu_spec str
    The GPU model.
    id str
    ID of the ECS Dedicated Host.
    instances Sequence[GetDedicatedHostsHostInstance]
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    machine_id str
    The machine code of the dedicated host.
    network_attributes Sequence[GetDedicatedHostsHostNetworkAttribute]
    dedicated host network parameters. contains the following attributes:
    operation_locks Sequence[GetDedicatedHostsHostOperationLock]
    The reason why the dedicated host resource is locked. See operation_locks below.
    payment_type str
    The billing method of the dedicated host.
    physical_gpus int
    The number of physical GPUs.
    resource_group_id str
    The ID of the resource group to which the ECS Dedicated Host belongs.
    sale_cycle str
    The unit of the subscription billing method.
    sockets int
    The number of physical CPUs.
    status str
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    supported_custom_instance_type_families Sequence[str]
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    supported_instance_type_families Sequence[str]
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    supported_instance_types_lists Sequence[str]
    The list of ECS instance.
    tags Mapping[str, str]
    A mapping of tags to assign to the resource.
    zone_id str
    The zone ID of the ECS Dedicated Host.
    actionOnMaintenance String
    The policy used to migrate the instances from the dedicated host when the dedicated host fails or needs to be repaired online.
    autoPlacement String
    Specifies whether to add the dedicated host to the resource pool for automatic deployment.
    autoReleaseTime String
    The automatic release time of the dedicated host.
    capacities List<Property Map>
    (Available since v1.123.1) A collection of proprietary host performance indicators.
    cores Number
    A mapping of tags to assign to the resource.
    cpuOverCommitRatio Number
    (Available since v1.123.1) CPU oversold ratio.
    dedicatedHostId String
    The ID of ECS Dedicated Host.
    dedicatedHostName String
    The name of ECS Dedicated Host.
    dedicatedHostType String
    The type of the dedicated host.
    description String
    The description of the dedicated host.
    expiredTime String
    The expiration time of the subscription dedicated host.
    gpuSpec String
    The GPU model.
    id String
    ID of the ECS Dedicated Host.
    instances List<Property Map>
    (Available since v1.250.0) The ECS instances that were created on the dedicated host.
    machineId String
    The machine code of the dedicated host.
    networkAttributes List<Property Map>
    dedicated host network parameters. contains the following attributes:
    operationLocks List<Property Map>
    The reason why the dedicated host resource is locked. See operation_locks below.
    paymentType String
    The billing method of the dedicated host.
    physicalGpus Number
    The number of physical GPUs.
    resourceGroupId String
    The ID of the resource group to which the ECS Dedicated Host belongs.
    saleCycle String
    The unit of the subscription billing method.
    sockets Number
    The number of physical CPUs.
    status String
    The status of the ECS Dedicated Host. Valid Value: Available, Creating, PermanentFailure, Released, UnderAssessment.
    supportedCustomInstanceTypeFamilies List<String>
    (Available since v1.123.1) A custom instance type family supported by a dedicated host.
    supportedInstanceTypeFamilies List<String>
    (Available since v1.123.1) ECS instance type family supported by the dedicated host.
    supportedInstanceTypesLists List<String>
    The list of ECS instance.
    tags Map<String>
    A mapping of tags to assign to the resource.
    zoneId String
    The zone ID of the ECS Dedicated Host.

    GetDedicatedHostsHostCapacity

    AvailableLocalStorage int
    The remaining local disk capacity. Unit: GiB.
    AvailableMemory double
    The remaining memory capacity, unit: GiB.
    AvailableVcpus int
    The number of remaining vCPU cores.
    AvailableVgpus int
    The number of available virtual GPUs.
    LocalStorageCategory string
    Local disk type.
    TotalLocalStorage int
    The total capacity of the local disk, in GiB.
    TotalMemory double
    The total memory capacity, unit: GiB.
    TotalVcpus int
    The total number of vCPU cores.
    TotalVgpus int
    The total number of virtual GPUs.
    AvailableLocalStorage int
    The remaining local disk capacity. Unit: GiB.
    AvailableMemory float64
    The remaining memory capacity, unit: GiB.
    AvailableVcpus int
    The number of remaining vCPU cores.
    AvailableVgpus int
    The number of available virtual GPUs.
    LocalStorageCategory string
    Local disk type.
    TotalLocalStorage int
    The total capacity of the local disk, in GiB.
    TotalMemory float64
    The total memory capacity, unit: GiB.
    TotalVcpus int
    The total number of vCPU cores.
    TotalVgpus int
    The total number of virtual GPUs.
    availableLocalStorage Integer
    The remaining local disk capacity. Unit: GiB.
    availableMemory Double
    The remaining memory capacity, unit: GiB.
    availableVcpus Integer
    The number of remaining vCPU cores.
    availableVgpus Integer
    The number of available virtual GPUs.
    localStorageCategory String
    Local disk type.
    totalLocalStorage Integer
    The total capacity of the local disk, in GiB.
    totalMemory Double
    The total memory capacity, unit: GiB.
    totalVcpus Integer
    The total number of vCPU cores.
    totalVgpus Integer
    The total number of virtual GPUs.
    availableLocalStorage number
    The remaining local disk capacity. Unit: GiB.
    availableMemory number
    The remaining memory capacity, unit: GiB.
    availableVcpus number
    The number of remaining vCPU cores.
    availableVgpus number
    The number of available virtual GPUs.
    localStorageCategory string
    Local disk type.
    totalLocalStorage number
    The total capacity of the local disk, in GiB.
    totalMemory number
    The total memory capacity, unit: GiB.
    totalVcpus number
    The total number of vCPU cores.
    totalVgpus number
    The total number of virtual GPUs.
    available_local_storage int
    The remaining local disk capacity. Unit: GiB.
    available_memory float
    The remaining memory capacity, unit: GiB.
    available_vcpus int
    The number of remaining vCPU cores.
    available_vgpus int
    The number of available virtual GPUs.
    local_storage_category str
    Local disk type.
    total_local_storage int
    The total capacity of the local disk, in GiB.
    total_memory float
    The total memory capacity, unit: GiB.
    total_vcpus int
    The total number of vCPU cores.
    total_vgpus int
    The total number of virtual GPUs.
    availableLocalStorage Number
    The remaining local disk capacity. Unit: GiB.
    availableMemory Number
    The remaining memory capacity, unit: GiB.
    availableVcpus Number
    The number of remaining vCPU cores.
    availableVgpus Number
    The number of available virtual GPUs.
    localStorageCategory String
    Local disk type.
    totalLocalStorage Number
    The total capacity of the local disk, in GiB.
    totalMemory Number
    The total memory capacity, unit: GiB.
    totalVcpus Number
    The total number of vCPU cores.
    totalVgpus Number
    The total number of virtual GPUs.

    GetDedicatedHostsHostInstance

    InstanceId string
    The ID of the ECS instance.
    InstanceOwnerId int
    The ID of the ECS instance owner.
    InstanceType string
    The instance type of the ECS instance that was created on the dedicated host.
    SocketId string
    The ID of the socket to which the ECS instance belongs.
    InstanceId string
    The ID of the ECS instance.
    InstanceOwnerId int
    The ID of the ECS instance owner.
    InstanceType string
    The instance type of the ECS instance that was created on the dedicated host.
    SocketId string
    The ID of the socket to which the ECS instance belongs.
    instanceId String
    The ID of the ECS instance.
    instanceOwnerId Integer
    The ID of the ECS instance owner.
    instanceType String
    The instance type of the ECS instance that was created on the dedicated host.
    socketId String
    The ID of the socket to which the ECS instance belongs.
    instanceId string
    The ID of the ECS instance.
    instanceOwnerId number
    The ID of the ECS instance owner.
    instanceType string
    The instance type of the ECS instance that was created on the dedicated host.
    socketId string
    The ID of the socket to which the ECS instance belongs.
    instance_id str
    The ID of the ECS instance.
    instance_owner_id int
    The ID of the ECS instance owner.
    instance_type str
    The instance type of the ECS instance that was created on the dedicated host.
    socket_id str
    The ID of the socket to which the ECS instance belongs.
    instanceId String
    The ID of the ECS instance.
    instanceOwnerId Number
    The ID of the ECS instance owner.
    instanceType String
    The instance type of the ECS instance that was created on the dedicated host.
    socketId String
    The ID of the socket to which the ECS instance belongs.

    GetDedicatedHostsHostNetworkAttribute

    SlbUdpTimeout int
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    UdpTimeout int
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
    SlbUdpTimeout int
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    UdpTimeout int
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
    slbUdpTimeout Integer
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    udpTimeout Integer
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
    slbUdpTimeout number
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    udpTimeout number
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
    slb_udp_timeout int
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    udp_timeout int
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.
    slbUdpTimeout Number
    The timeout period for a UDP session between Server Load Balancer (SLB) and the dedicated host. Unit: seconds.
    udpTimeout Number
    (Available since v1.123.1) The timeout period for a UDP session between a user and an Alibaba Cloud service on the dedicated host. Unit: seconds.

    GetDedicatedHostsHostOperationLock

    LockReason string
    The reason why the dedicated host resource is locked.
    LockReason string
    The reason why the dedicated host resource is locked.
    lockReason String
    The reason why the dedicated host resource is locked.
    lockReason string
    The reason why the dedicated host resource is locked.
    lock_reason str
    The reason why the dedicated host resource is locked.
    lockReason String
    The reason why the dedicated host resource is locked.

    GetDedicatedHostsOperationLock

    LockReason string
    The reason why the dedicated host resource is locked.
    LockReason string
    The reason why the dedicated host resource is locked.
    lockReason String
    The reason why the dedicated host resource is locked.
    lockReason string
    The reason why the dedicated host resource is locked.
    lock_reason str
    The reason why the dedicated host resource is locked.
    lockReason String
    The reason why the dedicated host resource is locked.

    Package Details

    Repository
    Alibaba Cloud pulumi/pulumi-alicloud
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the alicloud Terraform Provider.
    alicloud logo
    Alibaba Cloud v3.81.0 published on Monday, Jun 23, 2025 by Pulumi
    pulumi/pulumi-alicloud