Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. Oracle Cloud Infrastructure
  3. API Docs
  4. OsManagement
  5. getManagedInstances
Oracle Cloud Infrastructure v2.27.0 published on Thursday, Mar 20, 2025 by Pulumi
pulumi/pulumi-oci

oci.OsManagement.getManagedInstances

Explore with Pulumi AI

oci logo
Oracle Cloud Infrastructure v2.27.0 published on Thursday, Mar 20, 2025 by Pulumi
pulumi/pulumi-oci

    This data source provides the list of Managed Instances in Oracle Cloud Infrastructure OS Management service.

    Returns a list of all Managed Instances.

    Example Usage

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

const testManagedInstances = oci.OsManagement.getManagedInstances({
    compartmentId: compartmentId,
    displayName: managedInstanceDisplayName,
    osFamily: managedInstanceOsFamily,
});

    import pulumi
import pulumi_oci as oci

test_managed_instances = oci.OsManagement.get_managed_instances(compartment_id=compartment_id,
    display_name=managed_instance_display_name,
    os_family=managed_instance_os_family)

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := osmanagement.GetManagedInstances(ctx, &osmanagement.GetManagedInstancesArgs{
			CompartmentId: compartmentId,
			DisplayName:   pulumi.StringRef(managedInstanceDisplayName),
			OsFamily:      pulumi.StringRef(managedInstanceOsFamily),
		}, 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 testManagedInstances = Oci.OsManagement.GetManagedInstances.Invoke(new()
    {
        CompartmentId = compartmentId,
        DisplayName = managedInstanceDisplayName,
        OsFamily = managedInstanceOsFamily,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.oci.OsManagement.OsManagementFunctions;
import com.pulumi.oci.OsManagement.inputs.GetManagedInstancesArgs;
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 testManagedInstances = OsManagementFunctions.getManagedInstances(GetManagedInstancesArgs.builder()
            .compartmentId(compartmentId)
            .displayName(managedInstanceDisplayName)
            .osFamily(managedInstanceOsFamily)
            .build());

    }
}

    variables:
  testManagedInstances:
    fn::invoke:
      function: oci:OsManagement:getManagedInstances
      arguments:
        compartmentId: ${compartmentId}
        displayName: ${managedInstanceDisplayName}
        osFamily: ${managedInstanceOsFamily}

    Using getManagedInstances

    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 getManagedInstances(args: GetManagedInstancesArgs, opts?: InvokeOptions): Promise<GetManagedInstancesResult>
function getManagedInstancesOutput(args: GetManagedInstancesOutputArgs, opts?: InvokeOptions): Output<GetManagedInstancesResult>
    def get_managed_instances(compartment_id: Optional[str] = None,
                          display_name: Optional[str] = None,
                          filters: Optional[Sequence[_osmanagement.GetManagedInstancesFilter]] = None,
                          os_family: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetManagedInstancesResult
def get_managed_instances_output(compartment_id: Optional[pulumi.Input[str]] = None,
                          display_name: Optional[pulumi.Input[str]] = None,
                          filters: Optional[pulumi.Input[Sequence[pulumi.Input[_osmanagement.GetManagedInstancesFilterArgs]]]] = None,
                          os_family: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetManagedInstancesResult]
    func GetManagedInstances(ctx *Context, args *GetManagedInstancesArgs, opts ...InvokeOption) (*GetManagedInstancesResult, error)
func GetManagedInstancesOutput(ctx *Context, args *GetManagedInstancesOutputArgs, opts ...InvokeOption) GetManagedInstancesResultOutput

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

    public static class GetManagedInstances 
{
    public static Task<GetManagedInstancesResult> InvokeAsync(GetManagedInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetManagedInstancesResult> Invoke(GetManagedInstancesInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetManagedInstancesResult> getManagedInstances(GetManagedInstancesArgs args, InvokeOptions options)
public static Output<GetManagedInstancesResult> getManagedInstances(GetManagedInstancesArgs args, InvokeOptions options)

    fn::invoke:
  function: oci:OsManagement/getManagedInstances:getManagedInstances
  arguments:
    # arguments dictionary

    The following arguments are supported:

    CompartmentId string
    The ID of the compartment in which to list resources.
    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    Filters List<GetManagedInstancesFilter>
    OsFamily string
    The OS family for which to list resources.
    CompartmentId string
    The ID of the compartment in which to list resources.
    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    Filters []GetManagedInstancesFilter
    OsFamily string
    The OS family for which to list resources.
    compartmentId String
    The ID of the compartment in which to list resources.
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    filters List<GetManagedInstancesFilter>
    osFamily String
    The OS family for which to list resources.
    compartmentId string
    The ID of the compartment in which to list resources.
    displayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    filters GetManagedInstancesFilter[]
    osFamily string
    The OS family for which to list resources.
    compartment_id str
    The ID of the compartment in which to list resources.
    display_name str
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    filters Sequence[osmanagement.GetManagedInstancesFilter]
    os_family str
    The OS family for which to list resources.
    compartmentId String
    The ID of the compartment in which to list resources.
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    filters List<Property Map>
    osFamily String
    The OS family for which to list resources.

    getManagedInstances Result

    The following output properties are available:

    CompartmentId string
    OCID for the Compartment
    Id string
    The provider-assigned unique ID for this managed resource.
    ManagedInstances List<GetManagedInstancesManagedInstance>
    The list of managed_instances.
    DisplayName string
    User friendly name
    Filters List<GetManagedInstancesFilter>
    OsFamily string
    The Operating System type of the managed instance.
    CompartmentId string
    OCID for the Compartment
    Id string
    The provider-assigned unique ID for this managed resource.
    ManagedInstances []GetManagedInstancesManagedInstance
    The list of managed_instances.
    DisplayName string
    User friendly name
    Filters []GetManagedInstancesFilter
    OsFamily string
    The Operating System type of the managed instance.
    compartmentId String
    OCID for the Compartment
    id String
    The provider-assigned unique ID for this managed resource.
    managedInstances List<GetManagedInstancesManagedInstance>
    The list of managed_instances.
    displayName String
    User friendly name
    filters List<GetManagedInstancesFilter>
    osFamily String
    The Operating System type of the managed instance.
    compartmentId string
    OCID for the Compartment
    id string
    The provider-assigned unique ID for this managed resource.
    managedInstances GetManagedInstancesManagedInstance[]
    The list of managed_instances.
    displayName string
    User friendly name
    filters GetManagedInstancesFilter[]
    osFamily string
    The Operating System type of the managed instance.
    compartment_id str
    OCID for the Compartment
    id str
    The provider-assigned unique ID for this managed resource.
    managed_instances Sequence[osmanagement.GetManagedInstancesManagedInstance]
    The list of managed_instances.
    display_name str
    User friendly name
    filters Sequence[osmanagement.GetManagedInstancesFilter]
    os_family str
    The Operating System type of the managed instance.
    compartmentId String
    OCID for the Compartment
    id String
    The provider-assigned unique ID for this managed resource.
    managedInstances List<Property Map>
    The list of managed_instances.
    displayName String
    User friendly name
    filters List<Property Map>
    osFamily String
    The Operating System type of the managed instance.

    Supporting Types

    GetManagedInstancesFilter

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

    GetManagedInstancesManagedInstance

    Autonomouses List<GetManagedInstancesManagedInstanceAutonomouse>
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    BugUpdatesAvailable int
    Number of bug fix type updates available to be installed
    ChildSoftwareSources List<GetManagedInstancesManagedInstanceChildSoftwareSource>
    list of child Software Sources attached to the Managed Instance
    CompartmentId string
    The ID of the compartment in which to list resources.
    Description string
    Information specified by the user about the managed instance
    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    EnhancementUpdatesAvailable int
    Number of enhancement type updates available to be installed
    Id string
    software source identifier
    IsDataCollectionAuthorized bool
    True if user allow data collection for this instance
    IsRebootRequired bool
    Indicates whether a reboot is required to complete installation of updates.
    KspliceEffectiveKernelVersion string
    The ksplice effective kernel version
    LastBoot string
    Time at which the instance last booted
    LastCheckin string
    Time at which the instance last checked in
    ManagedInstanceGroups List<GetManagedInstancesManagedInstanceManagedInstanceGroup>
    The ids of the managed instance groups of which this instance is a member.
    ManagedInstanceId string
    NotificationTopicId string
    OCID of the ONS topic used to send notification to users
    OsFamily string
    The OS family for which to list resources.
    OsKernelVersion string
    Operating System Kernel Version
    OsName string
    Operating System Name
    OsVersion string
    Operating System Version
    OtherUpdatesAvailable int
    Number of non-classified updates available to be installed
    ParentSoftwareSources List<GetManagedInstancesManagedInstanceParentSoftwareSource>
    the parent (base) Software Source attached to the Managed Instance
    ScheduledJobCount int
    Number of scheduled jobs associated with this instance
    SecurityUpdatesAvailable int
    Number of security type updates available to be installed
    Status string
    status of the managed instance.
    UpdatesAvailable int
    Number of updates available to be installed
    WorkRequestCount int
    Number of work requests associated with this instance
    Autonomouses []GetManagedInstancesManagedInstanceAutonomouse
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    BugUpdatesAvailable int
    Number of bug fix type updates available to be installed
    ChildSoftwareSources []GetManagedInstancesManagedInstanceChildSoftwareSource
    list of child Software Sources attached to the Managed Instance
    CompartmentId string
    The ID of the compartment in which to list resources.
    Description string
    Information specified by the user about the managed instance
    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    EnhancementUpdatesAvailable int
    Number of enhancement type updates available to be installed
    Id string
    software source identifier
    IsDataCollectionAuthorized bool
    True if user allow data collection for this instance
    IsRebootRequired bool
    Indicates whether a reboot is required to complete installation of updates.
    KspliceEffectiveKernelVersion string
    The ksplice effective kernel version
    LastBoot string
    Time at which the instance last booted
    LastCheckin string
    Time at which the instance last checked in
    ManagedInstanceGroups []GetManagedInstancesManagedInstanceManagedInstanceGroup
    The ids of the managed instance groups of which this instance is a member.
    ManagedInstanceId string
    NotificationTopicId string
    OCID of the ONS topic used to send notification to users
    OsFamily string
    The OS family for which to list resources.
    OsKernelVersion string
    Operating System Kernel Version
    OsName string
    Operating System Name
    OsVersion string
    Operating System Version
    OtherUpdatesAvailable int
    Number of non-classified updates available to be installed
    ParentSoftwareSources []GetManagedInstancesManagedInstanceParentSoftwareSource
    the parent (base) Software Source attached to the Managed Instance
    ScheduledJobCount int
    Number of scheduled jobs associated with this instance
    SecurityUpdatesAvailable int
    Number of security type updates available to be installed
    Status string
    status of the managed instance.
    UpdatesAvailable int
    Number of updates available to be installed
    WorkRequestCount int
    Number of work requests associated with this instance
    autonomouses List<GetManagedInstancesManagedInstanceAutonomouse>
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    bugUpdatesAvailable Integer
    Number of bug fix type updates available to be installed
    childSoftwareSources List<GetManagedInstancesManagedInstanceChildSoftwareSource>
    list of child Software Sources attached to the Managed Instance
    compartmentId String
    The ID of the compartment in which to list resources.
    description String
    Information specified by the user about the managed instance
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    enhancementUpdatesAvailable Integer
    Number of enhancement type updates available to be installed
    id String
    software source identifier
    isDataCollectionAuthorized Boolean
    True if user allow data collection for this instance
    isRebootRequired Boolean
    Indicates whether a reboot is required to complete installation of updates.
    kspliceEffectiveKernelVersion String
    The ksplice effective kernel version
    lastBoot String
    Time at which the instance last booted
    lastCheckin String
    Time at which the instance last checked in
    managedInstanceGroups List<GetManagedInstancesManagedInstanceManagedInstanceGroup>
    The ids of the managed instance groups of which this instance is a member.
    managedInstanceId String
    notificationTopicId String
    OCID of the ONS topic used to send notification to users
    osFamily String
    The OS family for which to list resources.
    osKernelVersion String
    Operating System Kernel Version
    osName String
    Operating System Name
    osVersion String
    Operating System Version
    otherUpdatesAvailable Integer
    Number of non-classified updates available to be installed
    parentSoftwareSources List<GetManagedInstancesManagedInstanceParentSoftwareSource>
    the parent (base) Software Source attached to the Managed Instance
    scheduledJobCount Integer
    Number of scheduled jobs associated with this instance
    securityUpdatesAvailable Integer
    Number of security type updates available to be installed
    status String
    status of the managed instance.
    updatesAvailable Integer
    Number of updates available to be installed
    workRequestCount Integer
    Number of work requests associated with this instance
    autonomouses GetManagedInstancesManagedInstanceAutonomouse[]
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    bugUpdatesAvailable number
    Number of bug fix type updates available to be installed
    childSoftwareSources GetManagedInstancesManagedInstanceChildSoftwareSource[]
    list of child Software Sources attached to the Managed Instance
    compartmentId string
    The ID of the compartment in which to list resources.
    description string
    Information specified by the user about the managed instance
    displayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    enhancementUpdatesAvailable number
    Number of enhancement type updates available to be installed
    id string
    software source identifier
    isDataCollectionAuthorized boolean
    True if user allow data collection for this instance
    isRebootRequired boolean
    Indicates whether a reboot is required to complete installation of updates.
    kspliceEffectiveKernelVersion string
    The ksplice effective kernel version
    lastBoot string
    Time at which the instance last booted
    lastCheckin string
    Time at which the instance last checked in
    managedInstanceGroups GetManagedInstancesManagedInstanceManagedInstanceGroup[]
    The ids of the managed instance groups of which this instance is a member.
    managedInstanceId string
    notificationTopicId string
    OCID of the ONS topic used to send notification to users
    osFamily string
    The OS family for which to list resources.
    osKernelVersion string
    Operating System Kernel Version
    osName string
    Operating System Name
    osVersion string
    Operating System Version
    otherUpdatesAvailable number
    Number of non-classified updates available to be installed
    parentSoftwareSources GetManagedInstancesManagedInstanceParentSoftwareSource[]
    the parent (base) Software Source attached to the Managed Instance
    scheduledJobCount number
    Number of scheduled jobs associated with this instance
    securityUpdatesAvailable number
    Number of security type updates available to be installed
    status string
    status of the managed instance.
    updatesAvailable number
    Number of updates available to be installed
    workRequestCount number
    Number of work requests associated with this instance
    autonomouses Sequence[osmanagement.GetManagedInstancesManagedInstanceAutonomouse]
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    bug_updates_available int
    Number of bug fix type updates available to be installed
    child_software_sources Sequence[osmanagement.GetManagedInstancesManagedInstanceChildSoftwareSource]
    list of child Software Sources attached to the Managed Instance
    compartment_id str
    The ID of the compartment in which to list resources.
    description str
    Information specified by the user about the managed instance
    display_name str
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    enhancement_updates_available int
    Number of enhancement type updates available to be installed
    id str
    software source identifier
    is_data_collection_authorized bool
    True if user allow data collection for this instance
    is_reboot_required bool
    Indicates whether a reboot is required to complete installation of updates.
    ksplice_effective_kernel_version str
    The ksplice effective kernel version
    last_boot str
    Time at which the instance last booted
    last_checkin str
    Time at which the instance last checked in
    managed_instance_groups Sequence[osmanagement.GetManagedInstancesManagedInstanceManagedInstanceGroup]
    The ids of the managed instance groups of which this instance is a member.
    managed_instance_id str
    notification_topic_id str
    OCID of the ONS topic used to send notification to users
    os_family str
    The OS family for which to list resources.
    os_kernel_version str
    Operating System Kernel Version
    os_name str
    Operating System Name
    os_version str
    Operating System Version
    other_updates_available int
    Number of non-classified updates available to be installed
    parent_software_sources Sequence[osmanagement.GetManagedInstancesManagedInstanceParentSoftwareSource]
    the parent (base) Software Source attached to the Managed Instance
    scheduled_job_count int
    Number of scheduled jobs associated with this instance
    security_updates_available int
    Number of security type updates available to be installed
    status str
    status of the managed instance.
    updates_available int
    Number of updates available to be installed
    work_request_count int
    Number of work requests associated with this instance
    autonomouses List<Property Map>
    if present, indicates the Managed Instance is an autonomous instance. Holds all the Autonomous specific information
    bugUpdatesAvailable Number
    Number of bug fix type updates available to be installed
    childSoftwareSources List<Property Map>
    list of child Software Sources attached to the Managed Instance
    compartmentId String
    The ID of the compartment in which to list resources.
    description String
    Information specified by the user about the managed instance
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    enhancementUpdatesAvailable Number
    Number of enhancement type updates available to be installed
    id String
    software source identifier
    isDataCollectionAuthorized Boolean
    True if user allow data collection for this instance
    isRebootRequired Boolean
    Indicates whether a reboot is required to complete installation of updates.
    kspliceEffectiveKernelVersion String
    The ksplice effective kernel version
    lastBoot String
    Time at which the instance last booted
    lastCheckin String
    Time at which the instance last checked in
    managedInstanceGroups List<Property Map>
    The ids of the managed instance groups of which this instance is a member.
    managedInstanceId String
    notificationTopicId String
    OCID of the ONS topic used to send notification to users
    osFamily String
    The OS family for which to list resources.
    osKernelVersion String
    Operating System Kernel Version
    osName String
    Operating System Name
    osVersion String
    Operating System Version
    otherUpdatesAvailable Number
    Number of non-classified updates available to be installed
    parentSoftwareSources List<Property Map>
    the parent (base) Software Source attached to the Managed Instance
    scheduledJobCount Number
    Number of scheduled jobs associated with this instance
    securityUpdatesAvailable Number
    Number of security type updates available to be installed
    status String
    status of the managed instance.
    updatesAvailable Number
    Number of updates available to be installed
    workRequestCount Number
    Number of work requests associated with this instance

    GetManagedInstancesManagedInstanceAutonomouse

    IsAutoUpdateEnabled bool
    True if daily updates are enabled
    IsAutoUpdateEnabled bool
    True if daily updates are enabled
    isAutoUpdateEnabled Boolean
    True if daily updates are enabled
    isAutoUpdateEnabled boolean
    True if daily updates are enabled
    is_auto_update_enabled bool
    True if daily updates are enabled
    isAutoUpdateEnabled Boolean
    True if daily updates are enabled

    GetManagedInstancesManagedInstanceChildSoftwareSource

    Id string
    software source identifier
    Name string
    software source name
    Id string
    software source identifier
    Name string
    software source name
    id String
    software source identifier
    name String
    software source name
    id string
    software source identifier
    name string
    software source name
    id str
    software source identifier
    name str
    software source name
    id String
    software source identifier
    name String
    software source name

    GetManagedInstancesManagedInstanceManagedInstanceGroup

    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    Id string
    software source identifier
    DisplayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    Id string
    software source identifier
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    id String
    software source identifier
    displayName string
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    id string
    software source identifier
    display_name str
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    id str
    software source identifier
    displayName String
    A user-friendly name. Does not have to be unique, and it's changeable. Example: My new resource
    id String
    software source identifier

    GetManagedInstancesManagedInstanceParentSoftwareSource

    Id string
    software source identifier
    Name string
    software source name
    Id string
    software source identifier
    Name string
    software source name
    id String
    software source identifier
    name String
    software source name
    id string
    software source identifier
    name string
    software source name
    id str
    software source identifier
    name str
    software source name
    id String
    software source identifier
    name String
    software source name

    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 v2.27.0 published on Thursday, Mar 20, 2025 by Pulumi
    pulumi/pulumi-oci