1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. DedicatedVmHost
Oracle Cloud Infrastructure v1.32.0 published on Thursday, Apr 18, 2024 by Pulumi

oci.Core.DedicatedVmHost

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v1.32.0 published on Thursday, Apr 18, 2024 by Pulumi

    This resource provides the Dedicated Vm Host resource in Oracle Cloud Infrastructure Core service.

    Creates a new dedicated virtual machine host in the specified compartment and the specified availability domain. Dedicated virtual machine hosts enable you to run your Compute virtual machine (VM) instances on dedicated servers that are a single tenant and not shared with other customers. For more information, see Dedicated Virtual Machine Hosts.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testDedicatedVmHost = new oci.core.DedicatedVmHost("testDedicatedVmHost", {
        availabilityDomain: _var.dedicated_vm_host_availability_domain,
        compartmentId: _var.compartment_id,
        dedicatedVmHostShape: _var.dedicated_vm_host_dedicated_vm_host_shape,
        definedTags: {
            "Operations.CostCenter": "42",
        },
        displayName: _var.dedicated_vm_host_display_name,
        faultDomain: _var.dedicated_vm_host_fault_domain,
        freeformTags: {
            Department: "Finance",
        },
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_dedicated_vm_host = oci.core.DedicatedVmHost("testDedicatedVmHost",
        availability_domain=var["dedicated_vm_host_availability_domain"],
        compartment_id=var["compartment_id"],
        dedicated_vm_host_shape=var["dedicated_vm_host_dedicated_vm_host_shape"],
        defined_tags={
            "Operations.CostCenter": "42",
        },
        display_name=var["dedicated_vm_host_display_name"],
        fault_domain=var["dedicated_vm_host_fault_domain"],
        freeform_tags={
            "Department": "Finance",
        })
    
    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.NewDedicatedVmHost(ctx, "testDedicatedVmHost", &Core.DedicatedVmHostArgs{
    			AvailabilityDomain:   pulumi.Any(_var.Dedicated_vm_host_availability_domain),
    			CompartmentId:        pulumi.Any(_var.Compartment_id),
    			DedicatedVmHostShape: pulumi.Any(_var.Dedicated_vm_host_dedicated_vm_host_shape),
    			DefinedTags: pulumi.Map{
    				"Operations.CostCenter": pulumi.Any("42"),
    			},
    			DisplayName: pulumi.Any(_var.Dedicated_vm_host_display_name),
    			FaultDomain: pulumi.Any(_var.Dedicated_vm_host_fault_domain),
    			FreeformTags: pulumi.Map{
    				"Department": pulumi.Any("Finance"),
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Oci = Pulumi.Oci;
    
    return await Deployment.RunAsync(() => 
    {
        var testDedicatedVmHost = new Oci.Core.DedicatedVmHost("testDedicatedVmHost", new()
        {
            AvailabilityDomain = @var.Dedicated_vm_host_availability_domain,
            CompartmentId = @var.Compartment_id,
            DedicatedVmHostShape = @var.Dedicated_vm_host_dedicated_vm_host_shape,
            DefinedTags = 
            {
                { "Operations.CostCenter", "42" },
            },
            DisplayName = @var.Dedicated_vm_host_display_name,
            FaultDomain = @var.Dedicated_vm_host_fault_domain,
            FreeformTags = 
            {
                { "Department", "Finance" },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.Core.DedicatedVmHost;
    import com.pulumi.oci.Core.DedicatedVmHostArgs;
    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 testDedicatedVmHost = new DedicatedVmHost("testDedicatedVmHost", DedicatedVmHostArgs.builder()        
                .availabilityDomain(var_.dedicated_vm_host_availability_domain())
                .compartmentId(var_.compartment_id())
                .dedicatedVmHostShape(var_.dedicated_vm_host_dedicated_vm_host_shape())
                .definedTags(Map.of("Operations.CostCenter", "42"))
                .displayName(var_.dedicated_vm_host_display_name())
                .faultDomain(var_.dedicated_vm_host_fault_domain())
                .freeformTags(Map.of("Department", "Finance"))
                .build());
    
        }
    }
    
    resources:
      testDedicatedVmHost:
        type: oci:Core:DedicatedVmHost
        properties:
          #Required
          availabilityDomain: ${var.dedicated_vm_host_availability_domain}
          compartmentId: ${var.compartment_id}
          dedicatedVmHostShape: ${var.dedicated_vm_host_dedicated_vm_host_shape}
          #Optional
          definedTags:
            Operations.CostCenter: '42'
          displayName: ${var.dedicated_vm_host_display_name}
          faultDomain: ${var.dedicated_vm_host_fault_domain}
          freeformTags:
            Department: Finance
    

    Create DedicatedVmHost Resource

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

    Constructor syntax

    new DedicatedVmHost(name: string, args: DedicatedVmHostArgs, opts?: CustomResourceOptions);
    @overload
    def DedicatedVmHost(resource_name: str,
                        args: DedicatedVmHostArgs,
                        opts: Optional[ResourceOptions] = None)
    
    @overload
    def DedicatedVmHost(resource_name: str,
                        opts: Optional[ResourceOptions] = None,
                        availability_domain: Optional[str] = None,
                        compartment_id: Optional[str] = None,
                        dedicated_vm_host_shape: Optional[str] = None,
                        defined_tags: Optional[Mapping[str, Any]] = None,
                        display_name: Optional[str] = None,
                        fault_domain: Optional[str] = None,
                        freeform_tags: Optional[Mapping[str, Any]] = None)
    func NewDedicatedVmHost(ctx *Context, name string, args DedicatedVmHostArgs, opts ...ResourceOption) (*DedicatedVmHost, error)
    public DedicatedVmHost(string name, DedicatedVmHostArgs args, CustomResourceOptions? opts = null)
    public DedicatedVmHost(String name, DedicatedVmHostArgs args)
    public DedicatedVmHost(String name, DedicatedVmHostArgs args, CustomResourceOptions options)
    
    type: oci:Core:DedicatedVmHost
    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 DedicatedVmHostArgs
    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 DedicatedVmHostArgs
    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 DedicatedVmHostArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args DedicatedVmHostArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args DedicatedVmHostArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Example

    The following reference example uses placeholder values for all input properties.

    var dedicatedVmHostResource = new Oci.Core.DedicatedVmHost("dedicatedVmHostResource", new()
    {
        AvailabilityDomain = "string",
        CompartmentId = "string",
        DedicatedVmHostShape = "string",
        DefinedTags = 
        {
            { "string", "any" },
        },
        DisplayName = "string",
        FaultDomain = "string",
        FreeformTags = 
        {
            { "string", "any" },
        },
    });
    
    example, err := Core.NewDedicatedVmHost(ctx, "dedicatedVmHostResource", &Core.DedicatedVmHostArgs{
    	AvailabilityDomain:   pulumi.String("string"),
    	CompartmentId:        pulumi.String("string"),
    	DedicatedVmHostShape: pulumi.String("string"),
    	DefinedTags: pulumi.Map{
    		"string": pulumi.Any("any"),
    	},
    	DisplayName: pulumi.String("string"),
    	FaultDomain: pulumi.String("string"),
    	FreeformTags: pulumi.Map{
    		"string": pulumi.Any("any"),
    	},
    })
    
    var dedicatedVmHostResource = new DedicatedVmHost("dedicatedVmHostResource", DedicatedVmHostArgs.builder()        
        .availabilityDomain("string")
        .compartmentId("string")
        .dedicatedVmHostShape("string")
        .definedTags(Map.of("string", "any"))
        .displayName("string")
        .faultDomain("string")
        .freeformTags(Map.of("string", "any"))
        .build());
    
    dedicated_vm_host_resource = oci.core.DedicatedVmHost("dedicatedVmHostResource",
        availability_domain="string",
        compartment_id="string",
        dedicated_vm_host_shape="string",
        defined_tags={
            "string": "any",
        },
        display_name="string",
        fault_domain="string",
        freeform_tags={
            "string": "any",
        })
    
    const dedicatedVmHostResource = new oci.core.DedicatedVmHost("dedicatedVmHostResource", {
        availabilityDomain: "string",
        compartmentId: "string",
        dedicatedVmHostShape: "string",
        definedTags: {
            string: "any",
        },
        displayName: "string",
        faultDomain: "string",
        freeformTags: {
            string: "any",
        },
    });
    
    type: oci:Core:DedicatedVmHost
    properties:
        availabilityDomain: string
        compartmentId: string
        dedicatedVmHostShape: string
        definedTags:
            string: any
        displayName: string
        faultDomain: string
        freeformTags:
            string: any
    

    DedicatedVmHost Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The DedicatedVmHost resource accepts the following input properties:

    AvailabilityDomain string
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    CompartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    DefinedTags Dictionary<string, object>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FaultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    FreeformTags Dictionary<string, object>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    AvailabilityDomain string
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    CompartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    DefinedTags map[string]interface{}
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FaultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    FreeformTags map[string]interface{}

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    availabilityDomain String
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId String
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags Map<String,Object>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain String

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags Map<String,Object>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    availabilityDomain string
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags {[key: string]: any}
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags {[key: string]: any}

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    availability_domain str
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartment_id str
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    defined_tags Mapping[str, Any]
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    fault_domain str

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeform_tags Mapping[str, Any]

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    availabilityDomain String
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId String
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags Map<Any>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain String

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags Map<Any>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    Outputs

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

    Id string
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.
    Id string
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.
    id String
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.
    id string
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.
    id str
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.
    id String
    The provider-assigned unique ID for this managed resource.
    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
    The current state of the dedicated VM host.
    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.

    Look up Existing DedicatedVmHost Resource

    Get an existing DedicatedVmHost 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?: DedicatedVmHostState, opts?: CustomResourceOptions): DedicatedVmHost
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            availability_domain: Optional[str] = None,
            compartment_id: Optional[str] = None,
            dedicated_vm_host_shape: Optional[str] = None,
            defined_tags: Optional[Mapping[str, Any]] = None,
            display_name: Optional[str] = None,
            fault_domain: Optional[str] = None,
            freeform_tags: Optional[Mapping[str, Any]] = None,
            remaining_memory_in_gbs: Optional[float] = None,
            remaining_ocpus: Optional[float] = None,
            state: Optional[str] = None,
            time_created: Optional[str] = None,
            total_memory_in_gbs: Optional[float] = None,
            total_ocpus: Optional[float] = None) -> DedicatedVmHost
    func GetDedicatedVmHost(ctx *Context, name string, id IDInput, state *DedicatedVmHostState, opts ...ResourceOption) (*DedicatedVmHost, error)
    public static DedicatedVmHost Get(string name, Input<string> id, DedicatedVmHostState? state, CustomResourceOptions? opts = null)
    public static DedicatedVmHost get(String name, Output<String> id, DedicatedVmHostState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AvailabilityDomain string
    The availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    CompartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    DefinedTags Dictionary<string, object>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FaultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    FreeformTags Dictionary<string, object>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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 availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    CompartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    DefinedTags map[string]interface{}
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FaultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    FreeformTags map[string]interface{}

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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 availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId String
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags Map<String,Object>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain String

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags Map<String,Object>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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 availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId string
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags {[key: string]: any}
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain string

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags {[key: string]: any}

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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 availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartment_id str
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    defined_tags Mapping[str, Any]
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    fault_domain str

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeform_tags Mapping[str, Any]

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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 availability domain of the dedicated virtual machine host. Example: Uocm:PHX-AD-1
    compartmentId String
    (Updatable) 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 VM instances launched on the dedicated virtual machine host.
    definedTags Map<Any>
    (Updatable) 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
    (Updatable) A user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    faultDomain String

    The fault domain for the dedicated virtual machine host's assigned instances. For more information, see Fault Domains. If you do not specify the fault domain, the system selects one for you. To change the fault domain for a dedicated virtual machine host, delete it and create a new dedicated virtual machine host in the preferred fault domain.

    To get a list of fault domains, use the ListFaultDomains operation in the Identity and Access Management Service API.

    Example: FAULT-DOMAIN-1

    freeformTags Map<Any>

    (Updatable) 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"}

    ** IMPORTANT ** Any change to a property that does not support update will force the destruction and recreation of the resource with the new property values

    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
    The current state of the dedicated VM host.
    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.

    Import

    DedicatedVmHosts can be imported using the id, e.g.

    $ pulumi import oci:Core/dedicatedVmHost:DedicatedVmHost test_dedicated_vm_host "id"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    oci pulumi/pulumi-oci
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the oci Terraform Provider.
    oci logo
    Oracle Cloud Infrastructure v1.32.0 published on Thursday, Apr 18, 2024 by Pulumi