July 13, 2020 By Kazuki Nobutani 2 min read

Step-by-step instructions on how to change the organization owner.

IBM API Connect on IBM Cloud has several offering styles, including IBM API Connect Reserved Instance. It is an individual API Connect instance that runs on IBM-managed infrastructure and provides a single-tenant environment at a lower cost and with more control over your environment than a traditional cloud-based offering.

Goal

In this post, I am introducing how to change the organization owner. The organization owner has the full set of access permissions to API Connect functions and can also commission APIs and tracks their business adoption. IBM does not have access to change the organization owner in IBM API Connect Reserved Instance, so this operation needs to be done by the user.

Please note that these steps are targeted for IBM API Connect Reserved Instance version 2018 users. If you are using the normal IBM API Connect on IBM Cloud or the IBM API Connect Reserved Instance version 5, you must contact IBM Cloud support to change an organization owner.

Prerequisites

An apic toolkit is provided as executable files, so no actual installation is necessary. You just need to download the required compressed file and extract the contents. In this post, we are using a CLI that provides a command line environment for working with IBM API Connect Reserved Instance.

Step 1. Use apic toolkit and log in to your IBM API Connect Reserved Instance

First, you need to log in to your IBM API Connect Reserved Instance via the toolkit:

apic login --server <server-hostname>

Replace <server-hostname> with the URL of your API Manager home page. Enter your API Connect credentials and provider/default-idp-2 as its Realm.

Command example:

apic login --server api-manager-ui.example.apiconnect.cloud.ibm.com
Enter your API Connect credentials 
Realm? provider/default-idp-2 
Username? kazuki
Password? ***** 
Logged into apicserver successfully 

Step 2. Get a list of organizations

Obtain a list of organizations and the name of the organization that you are planning to change the owner:

apic orgs --server <server-hostname>

Replace <server-hostname> with the URL of your API Manager home page.

Command example:

apic orgs --server api-manager-ui.example.apiconnect.cloud.ibm.com

Response:
ibm-kazuki-test
ibm-kazuki-dev

Step 3. Get a list of members in the org

We are going to use the URL of the user who will be the new organization owner. Use the command below to obtain user details, including the URL.

apic members:list --scope org --org <org-name> --server <server-hostname>

Replace <org-name> with the organization name obtained in Step 2 and <server-hostname> with the URL of your API Manager home page. 

Command example:

apic members:list --scope org --org ibm-kazuki-test --server api-manager-ui.example.apiconnect.cloud.ibm.com

Response:
kazuki    [state: enabled]   https://api-manager-ui.example.apiconnect.cloud.ibm.com/api/orgs/ORGID/members/XXX
jason    [state: enabled]   https://api-manager-ui.example.apiconnect.cloud.ibm.com/api/orgs/ORGID/members/abc123

Note: In this example, we will make the json to a new organization owner.

Step 4. Create a json file with the owner’s member url

The URL of the user needs to be saved as a json file in the following format:

{ 
    "new_owner_member_url": "https://apicserver/api/orgs/ORGID/members/abc123",
} 

I named this file changeOwner.json

Step 5. Change the organization owner

Let’s execute this command to change the organization owner:

apic orgs:transfer-owner --server <server-hostname> <org-name> <json-file>

Command example:

apic orgs:transfer-owner --server api-manager-ui.example.apiconnect.cloud.ibm.com ibm-kazuki-test changerOwner.json 

Response:
ibm-kazuki-test    [state: enabled]   https://api-manager-ui.example.apiconnect.cloud.ibm.com/api/orgs/ORGID

What’s next?

Changing the organization owner is now complete if you have followed these steps. If you have multiple organizations in your instance, you can perform the same steps to change the owner. If you have any questions or concerns with the command usage, please contact IBM Cloud support for assistance.  

Was this article helpful?
YesNo

More from Cloud

Announcing Dizzion Desktop as a Service for IBM Virtual Private Cloud (VPC)

2 min read - For more than four years, Dizzion and IBM Cloud® have strategically partnered to deliver incredible digital workspace experiences to our clients. We are excited to announce that Dizzion has expanded their Desktop as a Service (DaaS) offering to now support IBM Cloud Virtual Private Cloud (VPC). Powered by Frame, Dizzion’s cloud-native DaaS platform, clients can now deploy their Windows and Linux® virtual desktops and applications on IBM Cloud VPC and enjoy fast, dynamic, infrastructure provisioning and a true consumption-based model.…

Microcontrollers vs. microprocessors: What’s the difference?

6 min read - Microcontroller units (MCUs) and microprocessor units (MPUs) are two kinds of integrated circuits that, while similar in certain ways, are very different in many others. Replacing antiquated multi-component central processing units (CPUs) with separate logic units, these single-chip processors are both extremely valuable in the continued development of computing technology. However, microcontrollers and microprocessors differ significantly in component structure, chip architecture, performance capabilities and application. The key difference between these two units is that microcontrollers combine all the necessary elements…

Seven top central processing unit (CPU) use cases

7 min read - The central processing unit (CPU) is the computer’s brain, assigning and processing tasks and managing essential operational functions. Computers have been so seamlessly integrated with modern life that sometimes we’re not even aware of how many CPUs are in use around the world. It’s a staggering amount—so many CPUs that a conclusive figure can only be approximated. How many CPUs are now in use? It’s been estimated that there may be as many as 200 billion CPU cores (or more)…

IBM Newsletters

Get our newsletters and topic updates that deliver the latest thought leadership and insights on emerging trends.
Subscribe now More newsletters