Oracle Cloud Infrastructure Documentation

Change Your Message Pack Subscription Using the Command Line

You can change the number of message packs you subscribe to using the Oracle Cloud Infrastructure command line (OCI CLI).

The OCI CLI is part of the Cloud Shell. The Cloud Shell provides access to a pre-installed Linux shell with a pre-authenticated OCI CLI. The Cloud Shell supports a variety of features, tools, and utilities.

To use the Cloud Shell, you must have been granted access through the appropriate Oracle Cloud Infrastructure Identity and Access Management (IAM) policy. See Cloud Shell.

Note

  • After updating the number of message packs, it can take up to 24 hours for additional resources to be added to the instance.
  • Make sure you understand the considerations and message pack sizing noted Edit the Number of Message Packs.
  1. Grant the following IAM policy to the group containing the user requiring access to the Cloud Shell. See Manage Oracle Cloud Console Access.
    allow group group_name to use cloud-shell in tenancy
  2. In the upper-right corner of the Oracle Cloud Console, click the Developer tools icon, and select Cloud Shell to open the Cloud Shell.
    This image shows the region selection dropdown list (Phoenix is selected), the Cloud Shell icon, and three other icons.

    The Cloud Shell drawer opens at the bottom of the screen. The Cloud Shell executes commands against the selected region in which you opened the Cloud Shell (for this example, Phoenix is the selected region).
    Welcome to Oracle Cloud Shell.
Try the new file upload/download capability in Cloud Shell. Access this new feature from the 
Cloud Shell menu.

Your Cloud Shell machine comes with 5GB of storage for your home directory. Your Cloud Shell (machine 
and home directory) are located in: US East (Ashburn).
You are using Cloud Shell in tenancy oicpm as an OCI Federated user 
oracleidentitycloudservice/my_login_name@example.com

Type `help` for more info.
my_login_name@cloudshell:~ (us-phoenix-1)$
  3. Enter the following command to increase the number of message packs.

    For this example, the instance is using an existing Oracle Fusion Middleware license type brought to the cloud (BYOL) that is configured with 20,000 messages per pack. This example shows how to increase the value to 10.

    oci integration integration-instance update --id OCID_value --message-packs 10
    Where:
    • --id is the unique OCID identifier of your instance. This option is required. You get this value by clicking Copy in the OCID field on the details page for the instance.
    • --message-packs is the number of allowed message packs to which to increase your instance. For this example, 10 is specified.

    These are the minimum required options to specify. Additional command line options are also available. See Update Oracle Integration instances.

    You receive an immediate response with a work request ID. For example:
    {
  "opc-work-request-id": "ocid1.integrationworkrequest.oc1.geography-region-1.vmaerdicjfhkgfyaqrkihl6weoxhg6dxktxpdhh5ln6yi2en52xr3bplth4x"
}
  4. Confirm that your work request completed and the message pack number is updated.
    1. In the Oracle Cloud Console, open the navigation menu and click Developer Services, then, under Application Integration, click Integration.
    2. Open the Oracle Integration instance you updated.
      If you don't see the instance you're looking for, make sure you're viewing the correct region (in the banner) and compartment (at the top of the instance list, next to Applied filters).
    3. In the tabs across the top, click Work requests.
      Configuration changes occur quickly, so the operation should show that it has completed.
    4. In the tabs across the top, click Details.
      The Message packs entry should show the updated number of message packs. If you don't see the updated number, you might need to return to the Integration instances list, then reopen the instance to see the change.