Oracle Cloud Infrastructure Documentation

Listing Instances

List the instances in a compartment that are registered with the OS Management Hub service.

For step-by-step instructions on how to register an instance with the service, see Registering an Instance.
    1. Open the navigation menu and click Observability & Management. Under OS Management Hub, click Instances.
    2. Under List scope, select the compartment that contains the instance.
    3. (Optional) Use Filters to refine the list of instances based on OS version, location, or status.
      Status filters include:
      • Active: An instance that's actively checking in with the service. An active instance checks in with the service at an interval of every 2 minutes.
      • Offline: An instance that hasn't checked in with the service for 24 hours (or longer).
      • Inactive: An instance that hasn't checked in with the service in 30 minutes (or longer).
      • Registering: An instance that's in the process of registering with the service.
      • Registration failed: An instance that failed to register with the service.
      • Unregistering: An instance that's unregistering from the service. Once unregistered, OS Management Hub will no longer manage the instance.
    Tip

    Don't see an instance listed? Verify you've selected the correct compartment under List scope.

  • Use the oci os-management-hub managed-instance list command and required parameters to list all managed instances in a compartment.

    oci os-management-hub managed-instance list --compartment-id ocid [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the ListManagedInstances operation to list all managed instances in a compartment.