Oracle Cloud Infrastructure Documentation

Administering Managed Instance Groups

Managed instance groups enable you to group instances together for scheduling updates. Currently, managed instance groups are for scheduling updates only. You cannot use a managed instance group to manage settings or configurations across a group of instances, such as assigning the same software sources to all instances in the group.

You can create managed instance groups for Linux and Windows instances.

Important

Managed instance groups must be composed of instances that are of the same OS family and release. Therefore you would not include Oracle Linux 8 instances in a managed instance group that contains Oracle Linux 7 instances. Similarly, you would not include Windows 2019 Standard instances in a managed instance group that contains Windows 2016 Standard instances.

The following tasks for administering managed instance groups are covered in this topic:

  • Creating managed instance groups
  • Adding (attaching) managed instances to groups
  • Removing (detaching) managed instances from groups
  • Deleting a managed instance group

Creating Managed Instance Groups

To create a managed instance group for Linux instances
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. Under List Scope, for Compartment, select the compartment where you want to create the group.
  3. Click Create Instance Group.
  4. Enter the following values:

    • OS Family: Select the radio button for Linux.

    • Name: The name to identify the instance group. The name can contain a maximum of 64 characters.

    • Description: (Optional) The description of the group, for example "development web servers." The description can contain a maximum of 200 characters.

    • Tagging: (Optional) Add metadata resources. For information about tagging resources, see Tagging Overview.

  5. Click Create Group.
  6. Click Add Managed Instances.
  7. In the Add Managed Instances dialog box, find and select the instances you want to add to the group.
  8. Click Add Managed Instance.
  9. Proceed to Managing Linux Packages where you can apply patch updates to a managed instance group or schedule updates as a recurring task for future use.
To create a managed instance group for Windows instances
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. Under List Scope, for Compartment, select the compartment where you want to create the group.
  3. Click Create Instance Group.
  4. Enter the following values:

    • OS Family: Select the radio button for Windows.

    • Name: The name to identify the instance group. The name can contain a maximum of 64 characters.

    • Description: (Optional) The description of the group, for example "development web servers." The description can contain a maximum of 200 characters.

    • Tagging: (Optional) Add metadata resources. For information about tagging resources, see Tagging Overview.

  5. Click Create Group.
  6. Click Add Managed Instances.
  7. In the Add Managed Instances dialog box, find and select the instances you want to add to the group.
  8. Click Add Managed Instance.
  9. Proceed to Managing Windows Updates where you can apply updates to a managed instance group or schedule updates as a recurring task for future use.

Adding Managed Instances to Groups

To add Linux instances to a managed instance group
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. In the List Scope section, select the compartment that contains the instance group.
  3. Find the instance group and click its name.
  4. On the Managed Instance Group Details page, click Add Managed Instances.
  5. In the Add Managed Instances dialog box, find and select the instances you want to add to the group.
  6. Click Add Managed Instance.
  7. Proceed to Managing Linux Packages where you can apply patch updates to a managed instance group or schedule updates as a recurring task for future use.
To add Windows instances to a managed instance group
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. In the List Scope section, select the compartment that contains the Windows instance group.
  3. Find the instance group and click its name.
  4. On the Managed Instance Group Details page, click Add Managed Instances.
  5. In the Add Managed Instances dialog box, find and select the Windows instances you want to add to the group.
  6. Click Add Managed Instance.
  7. Proceed to Managing Windows Updates where you can apply updates to a managed instance group or schedule updates as a recurring task for future use.

Removing Managed Instances from Groups

To remove Linux instances from a managed instance group
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. In the List Scope section, select the compartment that contains the instance group.
  3. Find the instance group and click its name.
  4. On the Managed Instance Group Details page, select the Linux instances you want to remove from the group and click Remove.
  5. On the Remove Managed Instance dialog box, click Remove to confirm that you want to remove these instances.
  6. Click Close after the instances are removed.
To remove Windows instances from a managed instance group

  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. In the List Scope section, select the compartment that contains the instance group.
  3. Find the instance group and click its name.
  4. On the Managed Instance Group Details page, select the Windows instances you want to remove from the group and click Remove.
  5. On the Remove Managed Instance dialog box, click Remove to confirm that you want to remove these instances.
  6. Click Close after the instances are removed.

Deleting Managed Instance Groups

To delete a managed instance group
  1. Open the navigation menu and click Compute. Under OS Management, click Managed Instance Groups.
  2. Under List Scope, for Compartment, select the compartment where you want to delete the group.
  3. Select the check box next to the managed instance group to be deleted.
  4. (Optional) Select View Details to view details about the group before deleting it.
  5. Click Delete.

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Use these API operations for working with managed instances and managed instance groups:

For a full list of API operations available for the OS Management service, see OS Management API.