1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. Core
  5. getComputeHostGroup
Oracle Cloud Infrastructure v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi

oci.Core.getComputeHostGroup

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi

    This data source provides details about a specific Compute Host Group resource in Oracle Cloud Infrastructure Core service.

    Gets information about the specified compute host group

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as oci from "@pulumi/oci";
    
    const testComputeHostGroup = oci.Core.getComputeHostGroup({
        computeHostGroupId: testComputeHostGroupOciCoreComputeHostGroup.id,
    });
    
    import pulumi
    import pulumi_oci as oci
    
    test_compute_host_group = oci.Core.get_compute_host_group(compute_host_group_id=test_compute_host_group_oci_core_compute_host_group["id"])
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-oci/sdk/v3/go/oci/core"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := core.GetComputeHostGroup(ctx, &core.GetComputeHostGroupArgs{
    			ComputeHostGroupId: testComputeHostGroupOciCoreComputeHostGroup.Id,
    		}, nil)
    		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 testComputeHostGroup = Oci.Core.GetComputeHostGroup.Invoke(new()
        {
            ComputeHostGroupId = testComputeHostGroupOciCoreComputeHostGroup.Id,
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.oci.Core.CoreFunctions;
    import com.pulumi.oci.Core.inputs.GetComputeHostGroupArgs;
    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 testComputeHostGroup = CoreFunctions.getComputeHostGroup(GetComputeHostGroupArgs.builder()
                .computeHostGroupId(testComputeHostGroupOciCoreComputeHostGroup.id())
                .build());
    
        }
    }
    
    variables:
      testComputeHostGroup:
        fn::invoke:
          function: oci:Core:getComputeHostGroup
          arguments:
            computeHostGroupId: ${testComputeHostGroupOciCoreComputeHostGroup.id}
    

    Using getComputeHostGroup

    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 getComputeHostGroup(args: GetComputeHostGroupArgs, opts?: InvokeOptions): Promise<GetComputeHostGroupResult>
    function getComputeHostGroupOutput(args: GetComputeHostGroupOutputArgs, opts?: InvokeOptions): Output<GetComputeHostGroupResult>
    def get_compute_host_group(compute_host_group_id: Optional[str] = None,
                               opts: Optional[InvokeOptions] = None) -> GetComputeHostGroupResult
    def get_compute_host_group_output(compute_host_group_id: Optional[pulumi.Input[str]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetComputeHostGroupResult]
    func LookupComputeHostGroup(ctx *Context, args *LookupComputeHostGroupArgs, opts ...InvokeOption) (*LookupComputeHostGroupResult, error)
    func LookupComputeHostGroupOutput(ctx *Context, args *LookupComputeHostGroupOutputArgs, opts ...InvokeOption) LookupComputeHostGroupResultOutput

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

    public static class GetComputeHostGroup 
    {
        public static Task<GetComputeHostGroupResult> InvokeAsync(GetComputeHostGroupArgs args, InvokeOptions? opts = null)
        public static Output<GetComputeHostGroupResult> Invoke(GetComputeHostGroupInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetComputeHostGroupResult> getComputeHostGroup(GetComputeHostGroupArgs args, InvokeOptions options)
    public static Output<GetComputeHostGroupResult> getComputeHostGroup(GetComputeHostGroupArgs args, InvokeOptions options)
    
    fn::invoke:
      function: oci:Core/getComputeHostGroup:getComputeHostGroup
      arguments:
        # arguments dictionary

    The following arguments are supported:

    ComputeHostGroupId string
    The OCID of the compute host group.
    ComputeHostGroupId string
    The OCID of the compute host group.
    computeHostGroupId String
    The OCID of the compute host group.
    computeHostGroupId string
    The OCID of the compute host group.
    compute_host_group_id str
    The OCID of the compute host group.
    computeHostGroupId String
    The OCID of the compute host group.

    getComputeHostGroup Result

    The following output properties are available:

    AvailabilityDomain string
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    CompartmentId string
    The OCID of the compartment that contains host group.
    ComputeHostGroupId string
    Configurations List<GetComputeHostGroupConfiguration>
    A list of HostGroupConfiguration objects
    DefinedTags Dictionary<string, string>
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FreeformTags Dictionary<string, string>
    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 for the Customer-unique host group
    IsTargetedPlacementRequired bool
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    State string
    The lifecycle state of the host group
    SystemTags Dictionary<string, string>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    TimeCreated string
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    AvailabilityDomain string
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    CompartmentId string
    The OCID of the compartment that contains host group.
    ComputeHostGroupId string
    Configurations []GetComputeHostGroupConfiguration
    A list of HostGroupConfiguration objects
    DefinedTags map[string]string
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    FreeformTags map[string]string
    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 for the Customer-unique host group
    IsTargetedPlacementRequired bool
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    State string
    The lifecycle state of the host group
    SystemTags map[string]string
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    TimeCreated string
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    TimeUpdated string
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    availabilityDomain String
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    compartmentId String
    The OCID of the compartment that contains host group.
    computeHostGroupId String
    configurations List<GetComputeHostGroupConfiguration>
    A list of HostGroupConfiguration objects
    definedTags Map<String,String>
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    freeformTags Map<String,String>
    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 for the Customer-unique host group
    isTargetedPlacementRequired Boolean
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    state String
    The lifecycle state of the host group
    systemTags Map<String,String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    timeCreated String
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    availabilityDomain string
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    compartmentId string
    The OCID of the compartment that contains host group.
    computeHostGroupId string
    configurations GetComputeHostGroupConfiguration[]
    A list of HostGroupConfiguration objects
    definedTags {[key: string]: string}
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    freeformTags {[key: string]: string}
    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 for the Customer-unique host group
    isTargetedPlacementRequired boolean
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    state string
    The lifecycle state of the host group
    systemTags {[key: string]: string}
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    timeCreated string
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated string
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    availability_domain str
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    compartment_id str
    The OCID of the compartment that contains host group.
    compute_host_group_id str
    configurations Sequence[GetComputeHostGroupConfiguration]
    A list of HostGroupConfiguration objects
    defined_tags Mapping[str, str]
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    freeform_tags Mapping[str, str]
    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 for the Customer-unique host group
    is_targeted_placement_required bool
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    state str
    The lifecycle state of the host group
    system_tags Mapping[str, str]
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    time_created str
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    time_updated str
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    availabilityDomain String
    The availability domain of a host group. Example: Uocm:PHX-AD-1
    compartmentId String
    The OCID of the compartment that contains host group.
    computeHostGroupId String
    configurations List<Property Map>
    A list of HostGroupConfiguration objects
    definedTags Map<String>
    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 user-friendly name. Does not have to be unique, and it's changeable. Avoid entering confidential information.
    freeformTags Map<String>
    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 for the Customer-unique host group
    isTargetedPlacementRequired Boolean
    A flag that allows customers to restrict placement for hosts attached to the group. If true, the only way to place on hosts is to target the specific host group.
    state String
    The lifecycle state of the host group
    systemTags Map<String>
    Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see Resource Tags. Example: {"Operations.CostCenter": "42"}
    timeCreated String
    The date and time the host group was created, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z
    timeUpdated String
    The date and time the host group was updated, in the format defined by RFC3339. Example: 2016-08-25T21:10:29.600Z

    Supporting Types

    GetComputeHostGroupConfiguration

    FirmwareBundleId string
    The OCID for firmware bundle
    RecycleLevel string
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    Target string
    Either the platform name or compute shape that the configuration is targeting
    FirmwareBundleId string
    The OCID for firmware bundle
    RecycleLevel string
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    Target string
    Either the platform name or compute shape that the configuration is targeting
    firmwareBundleId String
    The OCID for firmware bundle
    recycleLevel String
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    target String
    Either the platform name or compute shape that the configuration is targeting
    firmwareBundleId string
    The OCID for firmware bundle
    recycleLevel string
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    target string
    Either the platform name or compute shape that the configuration is targeting
    firmware_bundle_id str
    The OCID for firmware bundle
    recycle_level str
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    target str
    Either the platform name or compute shape that the configuration is targeting
    firmwareBundleId String
    The OCID for firmware bundle
    recycleLevel String
    Preferred recycle level for hosts associated with the reservation config.

    • SKIP_RECYCLE - Skips host wipe.
    • FULL_RECYCLE - Does not skip host wipe. This is the default behavior.
    target String
    Either the platform name or compute shape that the configuration is targeting

    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 v3.3.0 published on Thursday, Jul 17, 2025 by Pulumi