Oracle Cloud Infrastructure

Pulumi Official
Package maintained by Pulumi
v0.1.1 published on Tuesday, May 3, 2022 by Pulumi

getDedicatedVmHosts

This data source provides the list of Dedicated Vm Hosts in Oracle Cloud Infrastructure Core service.

Returns the list of dedicated virtual machine hosts that match the specified criteria in the specified compartment.

You can limit the list by specifying a dedicated virtual machine host display name. The list will include all the identically-named dedicated virtual machine hosts in the compartment.

Example Usage

using Pulumi;
using Oci = Pulumi.Oci;

class MyStack : Stack
{
    public MyStack()
    {
        var testDedicatedVmHosts = Output.Create(Oci.Core.GetDedicatedVmHosts.InvokeAsync(new Oci.Core.GetDedicatedVmHostsArgs
        {
            CompartmentId = @var.Compartment_id,
            AvailabilityDomain = @var.Dedicated_vm_host_availability_domain,
            DisplayName = @var.Dedicated_vm_host_display_name,
            InstanceShapeName = @var.Dedicated_vm_host_instance_shape_name,
            RemainingMemoryInGbsGreaterThanOrEqualTo = @var.Dedicated_vm_host_remaining_memory_in_gbs_greater_than_or_equal_to,
            RemainingOcpusGreaterThanOrEqualTo = @var.Dedicated_vm_host_remaining_ocpus_greater_than_or_equal_to,
            State = @var.Dedicated_vm_host_state,
        }));
    }

}
package main

import (
	"github.com/pulumi/pulumi-oci/sdk/go/oci/Core"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := Core.GetDedicatedVmHosts(ctx, &core.GetDedicatedVmHostsArgs{
			CompartmentId:                            _var.Compartment_id,
			AvailabilityDomain:                       pulumi.StringRef(_var.Dedicated_vm_host_availability_domain),
			DisplayName:                              pulumi.StringRef(_var.Dedicated_vm_host_display_name),
			InstanceShapeName:                        pulumi.StringRef(_var.Dedicated_vm_host_instance_shape_name),
			RemainingMemoryInGbsGreaterThanOrEqualTo: pulumi.Float64Ref(_var.Dedicated_vm_host_remaining_memory_in_gbs_greater_than_or_equal_to),
			RemainingOcpusGreaterThanOrEqualTo:       pulumi.Float64Ref(_var.Dedicated_vm_host_remaining_ocpus_greater_than_or_equal_to),
			State:                                    pulumi.StringRef(_var.Dedicated_vm_host_state),
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_oci as oci

test_dedicated_vm_hosts = oci.Core.get_dedicated_vm_hosts(compartment_id=var["compartment_id"],
    availability_domain=var["dedicated_vm_host_availability_domain"],
    display_name=var["dedicated_vm_host_display_name"],
    instance_shape_name=var["dedicated_vm_host_instance_shape_name"],
    remaining_memory_in_gbs_greater_than_or_equal_to=var["dedicated_vm_host_remaining_memory_in_gbs_greater_than_or_equal_to"],
    remaining_ocpus_greater_than_or_equal_to=var["dedicated_vm_host_remaining_ocpus_greater_than_or_equal_to"],
    state=var["dedicated_vm_host_state"])
import * as pulumi from "@pulumi/pulumi";
import * as oci from "@pulumi/oci";

const testDedicatedVmHosts = oci.Core.getDedicatedVmHosts({
    compartmentId: _var.compartment_id,
    availabilityDomain: _var.dedicated_vm_host_availability_domain,
    displayName: _var.dedicated_vm_host_display_name,
    instanceShapeName: _var.dedicated_vm_host_instance_shape_name,
    remainingMemoryInGbsGreaterThanOrEqualTo: _var.dedicated_vm_host_remaining_memory_in_gbs_greater_than_or_equal_to,
    remainingOcpusGreaterThanOrEqualTo: _var.dedicated_vm_host_remaining_ocpus_greater_than_or_equal_to,
    state: _var.dedicated_vm_host_state,
});

Coming soon!

Using getDedicatedVmHosts

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 getDedicatedVmHosts(args: GetDedicatedVmHostsArgs, opts?: InvokeOptions): Promise<GetDedicatedVmHostsResult>
function getDedicatedVmHostsOutput(args: GetDedicatedVmHostsOutputArgs, opts?: InvokeOptions): Output<GetDedicatedVmHostsResult>
def get_dedicated_vm_hosts(availability_domain: Optional[str] = None,
                           compartment_id: Optional[str] = None,
                           display_name: Optional[str] = None,
                           filters: Optional[Sequence[_core.GetDedicatedVmHostsFilter]] = None,
                           instance_shape_name: Optional[str] = None,
                           remaining_memory_in_gbs_greater_than_or_equal_to: Optional[float] = None,
                           remaining_ocpus_greater_than_or_equal_to: Optional[float] = None,
                           state: Optional[str] = None,
                           opts: Optional[InvokeOptions] = None) -> GetDedicatedVmHostsResult
def get_dedicated_vm_hosts_output(availability_domain: Optional[pulumi.Input[str]] = None,
                           compartment_id: Optional[pulumi.Input[str]] = None,
                           display_name: Optional[pulumi.Input[str]] = None,
                           filters: Optional[pulumi.Input[Sequence[pulumi.Input[_core.GetDedicatedVmHostsFilterArgs]]]] = None,
                           instance_shape_name: Optional[pulumi.Input[str]] = None,
                           remaining_memory_in_gbs_greater_than_or_equal_to: Optional[pulumi.Input[float]] = None,
                           remaining_ocpus_greater_than_or_equal_to: Optional[pulumi.Input[float]] = None,
                           state: Optional[pulumi.Input[str]] = None,
                           opts: Optional[InvokeOptions] = None) -> Output[GetDedicatedVmHostsResult]
func GetDedicatedVmHosts(ctx *Context, args *GetDedicatedVmHostsArgs, opts ...InvokeOption) (*GetDedicatedVmHostsResult, error)
func GetDedicatedVmHostsOutput(ctx *Context, args *GetDedicatedVmHostsOutputArgs, opts ...InvokeOption) GetDedicatedVmHostsResultOutput

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

public static class GetDedicatedVmHosts 
{
    public static Task<GetDedicatedVmHostsResult> InvokeAsync(GetDedicatedVmHostsArgs args, InvokeOptions? opts = null)
    public static Output<GetDedicatedVmHostsResult> Invoke(GetDedicatedVmHostsInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetDedicatedVmHostsResult> getDedicatedVmHosts(GetDedicatedVmHostsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
Fn::Invoke:
  Function: oci:Core/getDedicatedVmHosts:getDedicatedVmHosts
  Arguments:
    # Arguments dictionary

The following arguments are supported:

CompartmentId string

The OCID of the compartment.

AvailabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

DisplayName string

A filter to return only resources that match the given display name exactly.

Filters List<GetDedicatedVmHostsFilter>
InstanceShapeName string

The name for the instance's shape.

RemainingMemoryInGbsGreaterThanOrEqualTo double

The remaining memory of the dedicated VM host, in GBs.

RemainingOcpusGreaterThanOrEqualTo double

The available OCPUs of the dedicated VM host.

State string

A filter to only return resources that match the given lifecycle state.

CompartmentId string

The OCID of the compartment.

AvailabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

DisplayName string

A filter to return only resources that match the given display name exactly.

Filters []GetDedicatedVmHostsFilter
InstanceShapeName string

The name for the instance's shape.

RemainingMemoryInGbsGreaterThanOrEqualTo float64

The remaining memory of the dedicated VM host, in GBs.

RemainingOcpusGreaterThanOrEqualTo float64

The available OCPUs of the dedicated VM host.

State string

A filter to only return resources that match the given lifecycle state.

compartmentId String

The OCID of the compartment.

availabilityDomain String

The name of the availability domain. Example: Uocm:PHX-AD-1

displayName String

A filter to return only resources that match the given display name exactly.

filters List<GetDedicatedVmHostsFilter>
instanceShapeName String

The name for the instance's shape.

remainingMemoryInGbsGreaterThanOrEqualTo Double

The remaining memory of the dedicated VM host, in GBs.

remainingOcpusGreaterThanOrEqualTo Double

The available OCPUs of the dedicated VM host.

state String

A filter to only return resources that match the given lifecycle state.

compartmentId string

The OCID of the compartment.

availabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

displayName string

A filter to return only resources that match the given display name exactly.

filters GetDedicatedVmHostsFilter[]
instanceShapeName string

The name for the instance's shape.

remainingMemoryInGbsGreaterThanOrEqualTo number

The remaining memory of the dedicated VM host, in GBs.

remainingOcpusGreaterThanOrEqualTo number

The available OCPUs of the dedicated VM host.

state string

A filter to only return resources that match the given lifecycle state.

compartment_id str

The OCID of the compartment.

availability_domain str

The name of the availability domain. Example: Uocm:PHX-AD-1

display_name str

A filter to return only resources that match the given display name exactly.

filters GetDedicatedVmHostsFilter]
instance_shape_name str

The name for the instance's shape.

remaining_memory_in_gbs_greater_than_or_equal_to float

The remaining memory of the dedicated VM host, in GBs.

remaining_ocpus_greater_than_or_equal_to float

The available OCPUs of the dedicated VM host.

state str

A filter to only return resources that match the given lifecycle state.

compartmentId String

The OCID of the compartment.

availabilityDomain String

The name of the availability domain. Example: Uocm:PHX-AD-1

displayName String

A filter to return only resources that match the given display name exactly.

filters List<Property Map>
instanceShapeName String

The name for the instance's shape.

remainingMemoryInGbsGreaterThanOrEqualTo Number

The remaining memory of the dedicated VM host, in GBs.

remainingOcpusGreaterThanOrEqualTo Number

The available OCPUs of the dedicated VM host.

state String

A filter to only return resources that match the given lifecycle state.

getDedicatedVmHosts Result

The following output properties are available:

CompartmentId string

The OCID of the compartment that contains the dedicated virtual machine host.

DedicatedVmHosts List<GetDedicatedVmHostsDedicatedVmHost>

The list of dedicated_vm_hosts.

Id string

The provider-assigned unique ID for this managed resource.

AvailabilityDomain string

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

DisplayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

Filters List<GetDedicatedVmHostsFilter>
InstanceShapeName string
RemainingMemoryInGbsGreaterThanOrEqualTo double
RemainingOcpusGreaterThanOrEqualTo double
State string

The current state of the dedicated VM host.

CompartmentId string

The OCID of the compartment that contains the dedicated virtual machine host.

DedicatedVmHosts []GetDedicatedVmHostsDedicatedVmHost

The list of dedicated_vm_hosts.

Id string

The provider-assigned unique ID for this managed resource.

AvailabilityDomain string

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

DisplayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

Filters []GetDedicatedVmHostsFilter
InstanceShapeName string
RemainingMemoryInGbsGreaterThanOrEqualTo float64
RemainingOcpusGreaterThanOrEqualTo float64
State string

The current state of the dedicated VM host.

compartmentId String

The OCID of the compartment that contains the dedicated virtual machine host.

dedicatedVmHosts List<GetDedicatedVmHostsDedicatedVmHost>

The list of dedicated_vm_hosts.

id String

The provider-assigned unique ID for this managed resource.

availabilityDomain String

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

displayName String

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

filters List<GetDedicatedVmHostsFilter>
instanceShapeName String
remainingMemoryInGbsGreaterThanOrEqualTo Double
remainingOcpusGreaterThanOrEqualTo Double
state String

The current state of the dedicated VM host.

compartmentId string

The OCID of the compartment that contains the dedicated virtual machine host.

dedicatedVmHosts GetDedicatedVmHostsDedicatedVmHost[]

The list of dedicated_vm_hosts.

id string

The provider-assigned unique ID for this managed resource.

availabilityDomain string

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

displayName string

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

filters GetDedicatedVmHostsFilter[]
instanceShapeName string
remainingMemoryInGbsGreaterThanOrEqualTo number
remainingOcpusGreaterThanOrEqualTo number
state string

The current state of the dedicated VM host.

compartment_id str

The OCID of the compartment that contains the dedicated virtual machine host.

dedicated_vm_hosts GetDedicatedVmHostsDedicatedVmHost]

The list of dedicated_vm_hosts.

id str

The provider-assigned unique ID for this managed resource.

availability_domain str

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

display_name str

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

filters GetDedicatedVmHostsFilter]
instance_shape_name str
remaining_memory_in_gbs_greater_than_or_equal_to float
remaining_ocpus_greater_than_or_equal_to float
state str

The current state of the dedicated VM host.

compartmentId String

The OCID of the compartment that contains the dedicated virtual machine host.

dedicatedVmHosts List<Property Map>

The list of dedicated_vm_hosts.

id String

The provider-assigned unique ID for this managed resource.

availabilityDomain String

The availability domain the dedicated virtual machine host is running in. Example: Uocm:PHX-AD-1

displayName String

A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.

filters List<Property Map>
instanceShapeName String
remainingMemoryInGbsGreaterThanOrEqualTo Number
remainingOcpusGreaterThanOrEqualTo Number
state String

The current state of the dedicated VM host.

Supporting Types

GetDedicatedVmHostsDedicatedVmHost

AvailabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

CompartmentId string

The OCID of the compartment.

DedicatedVmHostShape string

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

DefinedTags Dictionary<string, object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A filter to return only resources that match the given display name exactly.

FaultDomain string

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

FreeformTags Dictionary<string, object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

The OCID of the dedicated VM host.

RemainingMemoryInGbs double

The current available memory of the dedicated VM host, in GBs.

RemainingOcpus double

The current available OCPUs of the dedicated VM host.

State string

A filter to only return resources that match the given lifecycle state.

TimeCreated string

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

TotalMemoryInGbs double

The current total memory of the dedicated VM host, in GBs.

TotalOcpus double

The current total OCPUs of the dedicated VM host.

AvailabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

CompartmentId string

The OCID of the compartment.

DedicatedVmHostShape string

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

DefinedTags map[string]interface{}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

DisplayName string

A filter to return only resources that match the given display name exactly.

FaultDomain string

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

FreeformTags map[string]interface{}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

Id string

The OCID of the dedicated VM host.

RemainingMemoryInGbs float64

The current available memory of the dedicated VM host, in GBs.

RemainingOcpus float64

The current available OCPUs of the dedicated VM host.

State string

A filter to only return resources that match the given lifecycle state.

TimeCreated string

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

TotalMemoryInGbs float64

The current total memory of the dedicated VM host, in GBs.

TotalOcpus float64

The current total OCPUs of the dedicated VM host.

availabilityDomain String

The name of the availability domain. Example: Uocm:PHX-AD-1

compartmentId String

The OCID of the compartment.

dedicatedVmHostShape String

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

definedTags Map<String,Object>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A filter to return only resources that match the given display name exactly.

faultDomain String

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

freeformTags Map<String,Object>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

The OCID of the dedicated VM host.

remainingMemoryInGbs Double

The current available memory of the dedicated VM host, in GBs.

remainingOcpus Double

The current available OCPUs of the dedicated VM host.

state String

A filter to only return resources that match the given lifecycle state.

timeCreated String

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

totalMemoryInGbs Double

The current total memory of the dedicated VM host, in GBs.

totalOcpus Double

The current total OCPUs of the dedicated VM host.

availabilityDomain string

The name of the availability domain. Example: Uocm:PHX-AD-1

compartmentId string

The OCID of the compartment.

dedicatedVmHostShape string

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

definedTags {[key: string]: any}

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName string

A filter to return only resources that match the given display name exactly.

faultDomain string

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

freeformTags {[key: string]: any}

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id string

The OCID of the dedicated VM host.

remainingMemoryInGbs number

The current available memory of the dedicated VM host, in GBs.

remainingOcpus number

The current available OCPUs of the dedicated VM host.

state string

A filter to only return resources that match the given lifecycle state.

timeCreated string

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

totalMemoryInGbs number

The current total memory of the dedicated VM host, in GBs.

totalOcpus number

The current total OCPUs of the dedicated VM host.

availability_domain str

The name of the availability domain. Example: Uocm:PHX-AD-1

compartment_id str

The OCID of the compartment.

dedicated_vm_host_shape str

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

defined_tags Mapping[str, Any]

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

display_name str

A filter to return only resources that match the given display name exactly.

fault_domain str

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

freeform_tags Mapping[str, Any]

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id str

The OCID of the dedicated VM host.

remaining_memory_in_gbs float

The current available memory of the dedicated VM host, in GBs.

remaining_ocpus float

The current available OCPUs of the dedicated VM host.

state str

A filter to only return resources that match the given lifecycle state.

time_created str

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

total_memory_in_gbs float

The current total memory of the dedicated VM host, in GBs.

total_ocpus float

The current total OCPUs of the dedicated VM host.

availabilityDomain String

The name of the availability domain. Example: Uocm:PHX-AD-1

compartmentId String

The OCID of the compartment.

dedicatedVmHostShape String

The dedicated virtual machine host shape. The shape determines the number of CPUs and other resources available for VMs.

definedTags Map<Any>

Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}

displayName String

A filter to return only resources that match the given display name exactly.

faultDomain String

The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains.

freeformTags Map<Any>

Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see Resource Tags. Example: {"Department": "Finance"}

id String

The OCID of the dedicated VM host.

remainingMemoryInGbs Number

The current available memory of the dedicated VM host, in GBs.

remainingOcpus Number

The current available OCPUs of the dedicated VM host.

state String

A filter to only return resources that match the given lifecycle state.

timeCreated String

The date and time the dedicated VM host was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

totalMemoryInGbs Number

The current total memory of the dedicated VM host, in GBs.

totalOcpus Number

The current total OCPUs of the dedicated VM host.

GetDedicatedVmHostsFilter

Name string
Values List<string>
Regex bool
Name string
Values []string
Regex bool
name String
values List<String>
regex Boolean
name string
values string[]
regex boolean
name str
values Sequence[str]
regex bool
name String
values List<String>
regex Boolean

Package Details

Repository
https://github.com/pulumi/pulumi-oci
License
Apache-2.0
Notes

This Pulumi package is based on the oci Terraform Provider.