Skip to content

Latest commit

 

History

History
68 lines (50 loc) · 2.56 KB

enterprise-settings.md

File metadata and controls

68 lines (50 loc) · 2.56 KB
Raw
copyright lastupdated keywords subcollection
years
2019, 2020
2020-06-10
enterprise, enterprise settings, manage enterprise, view enterprise, rename enterprise
account

{:shortdesc: .shortdesc} {:codeblock: .codeblock} {:important: .important} {:tip: .tip} {:note: .note}

Managing your enterprise

{: #enterprise-settings}

From the dashboard of your {{site.data.keyword.Bluemix}} enterprise, you can view enterprise details, take common actions such as adding accounts and inviting users, and view billing information. You can also rename your enterprise on the dashboard or by using the CLI or API. {:shortdesc}

To manage enterprise settings, you need the Administrator or Editor role on the Enterprise service in the enterprise account. {: tip}

Managing your enterprise in the console

{: #enterprise-manage}

To view your enterprise dashboard, go to Manage > Enterprise in the {{site.data.keyword.Bluemix_notm}} console. The dashboard provides an overview of accounts, users, and subscription credit in your enterprise. The dashboard has quick links so that you can perform the following common actions:

Also, you can rename your enterprise by clicking Rename in the Enterprise details section.

Managing your enterprise from the CLI

{: #enterprise-manage-cli}

  • View enterprise information such as the name, domain, owner, and creation and update dates.

    ibmcloud enterprise show

    {: codeblock}

  • Rename the enterprise by specifying the new name on the -n option in the following command.

    ibmcloud enterprise update -n NEW_NAME

    {:codeblock}

Managing your enterprise by using the API

{: #enterprise-manage-api}

You can programmatically update an enterprise by calling the Enterprise Management API as shown in the following sample request. You can update the enterprise name or domain by passing the new values on the API call. For detailed information about the API, see the Enterprise Management API documentation{: external}.

curl -X PATCH \
"https://enterprise.cloud.ibm.com/v1/enterprises/$ENTERPRISE_ID" \
-H "Authorization: $IAM_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
  "name": "Brand New Sample Enterprise",
  "domain": "new.example.com"
}'