ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm.getContainerDedicatedHost
Explore with Pulumi AI
Retrieve information about a dedicated host. For more information about dedicated hosts, see Creating and managing dedicated hosts on VPC Gen 2 infrastructure.
Example Usage
In the following example, you can retrieve a dedicated host:
import * as pulumi from "@pulumi/pulumi";
import * as ibm from "@pulumi/ibm";
const testDhost = ibm.getContainerDedicatedHost({
    hostId: "abcd12-dh-abcdefgh1234567-abcd123-acbd1234",
    hostPoolId: "dh-abcdefgh1234567",
});
import pulumi
import pulumi_ibm as ibm
test_dhost = ibm.get_container_dedicated_host(host_id="abcd12-dh-abcdefgh1234567-abcd123-acbd1234",
    host_pool_id="dh-abcdefgh1234567")
package main
import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.LookupContainerDedicatedHost(ctx, &ibm.LookupContainerDedicatedHostArgs{
			HostId:     "abcd12-dh-abcdefgh1234567-abcd123-acbd1234",
			HostPoolId: "dh-abcdefgh1234567",
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Ibm = Pulumi.Ibm;
return await Deployment.RunAsync(() => 
{
    var testDhost = Ibm.GetContainerDedicatedHost.Invoke(new()
    {
        HostId = "abcd12-dh-abcdefgh1234567-abcd123-acbd1234",
        HostPoolId = "dh-abcdefgh1234567",
    });
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.IbmFunctions;
import com.pulumi.ibm.inputs.GetContainerDedicatedHostArgs;
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 testDhost = IbmFunctions.getContainerDedicatedHost(GetContainerDedicatedHostArgs.builder()
            .hostId("abcd12-dh-abcdefgh1234567-abcd123-acbd1234")
            .hostPoolId("dh-abcdefgh1234567")
            .build());
    }
}
variables:
  testDhost:
    fn::invoke:
      function: ibm:getContainerDedicatedHost
      arguments:
        hostId: abcd12-dh-abcdefgh1234567-abcd123-acbd1234
        hostPoolId: dh-abcdefgh1234567
Using getContainerDedicatedHost
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 getContainerDedicatedHost(args: GetContainerDedicatedHostArgs, opts?: InvokeOptions): Promise<GetContainerDedicatedHostResult>
function getContainerDedicatedHostOutput(args: GetContainerDedicatedHostOutputArgs, opts?: InvokeOptions): Output<GetContainerDedicatedHostResult>def get_container_dedicated_host(host_id: Optional[str] = None,
                                 host_pool_id: Optional[str] = None,
                                 id: Optional[str] = None,
                                 opts: Optional[InvokeOptions] = None) -> GetContainerDedicatedHostResult
def get_container_dedicated_host_output(host_id: Optional[pulumi.Input[str]] = None,
                                 host_pool_id: Optional[pulumi.Input[str]] = None,
                                 id: Optional[pulumi.Input[str]] = None,
                                 opts: Optional[InvokeOptions] = None) -> Output[GetContainerDedicatedHostResult]func LookupContainerDedicatedHost(ctx *Context, args *LookupContainerDedicatedHostArgs, opts ...InvokeOption) (*LookupContainerDedicatedHostResult, error)
func LookupContainerDedicatedHostOutput(ctx *Context, args *LookupContainerDedicatedHostOutputArgs, opts ...InvokeOption) LookupContainerDedicatedHostResultOutput> Note: This function is named LookupContainerDedicatedHost in the Go SDK.
public static class GetContainerDedicatedHost 
{
    public static Task<GetContainerDedicatedHostResult> InvokeAsync(GetContainerDedicatedHostArgs args, InvokeOptions? opts = null)
    public static Output<GetContainerDedicatedHostResult> Invoke(GetContainerDedicatedHostInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetContainerDedicatedHostResult> getContainerDedicatedHost(GetContainerDedicatedHostArgs args, InvokeOptions options)
public static Output<GetContainerDedicatedHostResult> getContainerDedicatedHost(GetContainerDedicatedHostArgs args, InvokeOptions options)
fn::invoke:
  function: ibm:index/getContainerDedicatedHost:getContainerDedicatedHost
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Host
Id string - The unique identifier of the dedicated host.
 - Host
Pool stringId  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - Id string
 
- Host
Id string - The unique identifier of the dedicated host.
 - Host
Pool stringId  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - Id string
 
- host
Id String - The unique identifier of the dedicated host.
 - host
Pool StringId  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - id String
 
- host
Id string - The unique identifier of the dedicated host.
 - host
Pool stringId  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - id string
 
- host_
id str - The unique identifier of the dedicated host.
 - host_
pool_ strid  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - id str
 
- host
Id String - The unique identifier of the dedicated host.
 - host
Pool StringId  - The unique identifier of the dedicated host pool the dedicated host is associated with.
 - id String
 
getContainerDedicatedHost Result
The following output properties are available:
- Flavor string
 - (String) The flavor of the worker.
 - Host
Id string - Host
Pool stringId  - Id string
 - Life
Cycles List<GetContainer Dedicated Host Life Cycle>  - (List) A nested block describes the lifecycle state of the dedicated host.
 - Placement
Enabled bool - (Bool) Describes if the placement on the dedicated host is enabled
 - Resources
List<Get
Container Dedicated Host Resource>  - (List) A nested block describes the resources of the dedicated host.
 - Workers
List<Get
Container Dedicated Host Worker>  - (List) A nested block describes the workers associated with this dedicated host.
 - Zone string
 - (String) The zone of the dedicated host.
 
- Flavor string
 - (String) The flavor of the worker.
 - Host
Id string - Host
Pool stringId  - Id string
 - Life
Cycles []GetContainer Dedicated Host Life Cycle  - (List) A nested block describes the lifecycle state of the dedicated host.
 - Placement
Enabled bool - (Bool) Describes if the placement on the dedicated host is enabled
 - Resources
[]Get
Container Dedicated Host Resource  - (List) A nested block describes the resources of the dedicated host.
 - Workers
[]Get
Container Dedicated Host Worker  - (List) A nested block describes the workers associated with this dedicated host.
 - Zone string
 - (String) The zone of the dedicated host.
 
- flavor String
 - (String) The flavor of the worker.
 - host
Id String - host
Pool StringId  - id String
 - life
Cycles List<GetContainer Dedicated Host Life Cycle>  - (List) A nested block describes the lifecycle state of the dedicated host.
 - placement
Enabled Boolean - (Bool) Describes if the placement on the dedicated host is enabled
 - resources
List<Get
Container Dedicated Host Resource>  - (List) A nested block describes the resources of the dedicated host.
 - workers
List<Get
Container Dedicated Host Worker>  - (List) A nested block describes the workers associated with this dedicated host.
 - zone String
 - (String) The zone of the dedicated host.
 
- flavor string
 - (String) The flavor of the worker.
 - host
Id string - host
Pool stringId  - id string
 - life
Cycles GetContainer Dedicated Host Life Cycle[]  - (List) A nested block describes the lifecycle state of the dedicated host.
 - placement
Enabled boolean - (Bool) Describes if the placement on the dedicated host is enabled
 - resources
Get
Container Dedicated Host Resource[]  - (List) A nested block describes the resources of the dedicated host.
 - workers
Get
Container Dedicated Host Worker[]  - (List) A nested block describes the workers associated with this dedicated host.
 - zone string
 - (String) The zone of the dedicated host.
 
- flavor str
 - (String) The flavor of the worker.
 - host_
id str - host_
pool_ strid  - id str
 - life_
cycles Sequence[GetContainer Dedicated Host Life Cycle]  - (List) A nested block describes the lifecycle state of the dedicated host.
 - placement_
enabled bool - (Bool) Describes if the placement on the dedicated host is enabled
 - resources
Sequence[Get
Container Dedicated Host Resource]  - (List) A nested block describes the resources of the dedicated host.
 - workers
Sequence[Get
Container Dedicated Host Worker]  - (List) A nested block describes the workers associated with this dedicated host.
 - zone str
 - (String) The zone of the dedicated host.
 
- flavor String
 - (String) The flavor of the worker.
 - host
Id String - host
Pool StringId  - id String
 - life
Cycles List<Property Map> - (List) A nested block describes the lifecycle state of the dedicated host.
 - placement
Enabled Boolean - (Bool) Describes if the placement on the dedicated host is enabled
 - resources List<Property Map>
 - (List) A nested block describes the resources of the dedicated host.
 - workers List<Property Map>
 - (List) A nested block describes the workers associated with this dedicated host.
 - zone String
 - (String) The zone of the dedicated host.
 
Supporting Types
GetContainerDedicatedHostLifeCycle     
- Actual
State string - (String) The actual state of the dedicated host.
 - Desired
State string - (String) The desired state of the dedicated host.
 - Message string
 - (String) Information message about the dedicated host's lifecycle.
 - Message
Date string - (String) The date of the information message.
 - Message
Details string - (String) Additional details of the information message.
 - Message
Details stringDate  - (String) The date of the additional details.
 
- Actual
State string - (String) The actual state of the dedicated host.
 - Desired
State string - (String) The desired state of the dedicated host.
 - Message string
 - (String) Information message about the dedicated host's lifecycle.
 - Message
Date string - (String) The date of the information message.
 - Message
Details string - (String) Additional details of the information message.
 - Message
Details stringDate  - (String) The date of the additional details.
 
- actual
State String - (String) The actual state of the dedicated host.
 - desired
State String - (String) The desired state of the dedicated host.
 - message String
 - (String) Information message about the dedicated host's lifecycle.
 - message
Date String - (String) The date of the information message.
 - message
Details String - (String) Additional details of the information message.
 - message
Details StringDate  - (String) The date of the additional details.
 
- actual
State string - (String) The actual state of the dedicated host.
 - desired
State string - (String) The desired state of the dedicated host.
 - message string
 - (String) Information message about the dedicated host's lifecycle.
 - message
Date string - (String) The date of the information message.
 - message
Details string - (String) Additional details of the information message.
 - message
Details stringDate  - (String) The date of the additional details.
 
- actual_
state str - (String) The actual state of the dedicated host.
 - desired_
state str - (String) The desired state of the dedicated host.
 - message str
 - (String) Information message about the dedicated host's lifecycle.
 - message_
date str - (String) The date of the information message.
 - message_
details str - (String) Additional details of the information message.
 - message_
details_ strdate  - (String) The date of the additional details.
 
- actual
State String - (String) The actual state of the dedicated host.
 - desired
State String - (String) The desired state of the dedicated host.
 - message String
 - (String) Information message about the dedicated host's lifecycle.
 - message
Date String - (String) The date of the information message.
 - message
Details String - (String) Additional details of the information message.
 - message
Details StringDate  - (String) The date of the additional details.
 
GetContainerDedicatedHostResource    
- Capacities
List<Get
Container Dedicated Host Resource Capacity>  - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - Consumeds
List<Get
Container Dedicated Host Resource Consumed>  - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
- Capacities
[]Get
Container Dedicated Host Resource Capacity  - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - Consumeds
[]Get
Container Dedicated Host Resource Consumed  - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
- capacities
List<Get
Container Dedicated Host Resource Capacity>  - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - consumeds
List<Get
Container Dedicated Host Resource Consumed>  - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
- capacities
Get
Container Dedicated Host Resource Capacity[]  - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - consumeds
Get
Container Dedicated Host Resource Consumed[]  - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
- capacities
Sequence[Get
Container Dedicated Host Resource Capacity]  - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - consumeds
Sequence[Get
Container Dedicated Host Resource Consumed]  - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
- capacities List<Property Map>
 - (List) A nested block describes the capacity of the dedicated host.
Nested scheme for 
capacity: - consumeds List<Property Map>
 - (List) A nested block describes the consumed resources of the dedicated host.
Nested scheme for 
capacity: 
GetContainerDedicatedHostResourceCapacity     
- Memory
Bytes double - (Int) Consumed memory capacity of the dedicated host.
 - Vcpu double
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- Memory
Bytes float64 - (Int) Consumed memory capacity of the dedicated host.
 - Vcpu float64
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes Double - (Int) Consumed memory capacity of the dedicated host.
 - vcpu Double
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes number - (Int) Consumed memory capacity of the dedicated host.
 - vcpu number
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory_
bytes float - (Int) Consumed memory capacity of the dedicated host.
 - vcpu float
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes Number - (Int) Consumed memory capacity of the dedicated host.
 - vcpu Number
 - (Int) Consumed VCPU capacity of the dedicated host.
 
GetContainerDedicatedHostResourceConsumed     
- Memory
Bytes double - (Int) Consumed memory capacity of the dedicated host.
 - Vcpu double
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- Memory
Bytes float64 - (Int) Consumed memory capacity of the dedicated host.
 - Vcpu float64
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes Double - (Int) Consumed memory capacity of the dedicated host.
 - vcpu Double
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes number - (Int) Consumed memory capacity of the dedicated host.
 - vcpu number
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory_
bytes float - (Int) Consumed memory capacity of the dedicated host.
 - vcpu float
 - (Int) Consumed VCPU capacity of the dedicated host.
 
- memory
Bytes Number - (Int) Consumed memory capacity of the dedicated host.
 - vcpu Number
 - (Int) Consumed VCPU capacity of the dedicated host.
 
GetContainerDedicatedHostWorker    
- Cluster
Id string - (String) The ID of the cluster the worker is associated with.
 - Flavor string
 - (String) The flavor of the worker.
 - Worker
Id string - (String) The ID of the worker.
 - Worker
Pool stringId  - (String) The ID of the worker pool the worker is associated with.
 
- Cluster
Id string - (String) The ID of the cluster the worker is associated with.
 - Flavor string
 - (String) The flavor of the worker.
 - Worker
Id string - (String) The ID of the worker.
 - Worker
Pool stringId  - (String) The ID of the worker pool the worker is associated with.
 
- cluster
Id String - (String) The ID of the cluster the worker is associated with.
 - flavor String
 - (String) The flavor of the worker.
 - worker
Id String - (String) The ID of the worker.
 - worker
Pool StringId  - (String) The ID of the worker pool the worker is associated with.
 
- cluster
Id string - (String) The ID of the cluster the worker is associated with.
 - flavor string
 - (String) The flavor of the worker.
 - worker
Id string - (String) The ID of the worker.
 - worker
Pool stringId  - (String) The ID of the worker pool the worker is associated with.
 
- cluster_
id str - (String) The ID of the cluster the worker is associated with.
 - flavor str
 - (String) The flavor of the worker.
 - worker_
id str - (String) The ID of the worker.
 - worker_
pool_ strid  - (String) The ID of the worker pool the worker is associated with.
 
- cluster
Id String - (String) The ID of the cluster the worker is associated with.
 - flavor String
 - (String) The flavor of the worker.
 - worker
Id String - (String) The ID of the worker.
 - worker
Pool StringId  - (String) The ID of the worker pool the worker is associated with.
 
Package Details
- Repository
 - ibm ibm-cloud/terraform-provider-ibm
 - License
 - Notes
 - This Pulumi package is based on the 
ibmTerraform Provider.