| copyright |
|
||
|---|---|---|---|
| lastupdated | 2019-01-04 |
{:shortdesc: .shortdesc} {:new_window: target="_blank"} {:codeblock: .codeblock} {:pre: .pre} {:screen: .screen} {:tip: .tip} {:download: .download}
To get started with IBM Cloud Service Endpoint you need to make sure you have the following.
- An IBM Cloud Infrastructure Account
- Account must be enabled for Virtual Routing and Forwarding (VRF). Learn more about VRF on IBM Cloud here.
- Account must be enabled for connectivity to Service Endpoints.
{: #cs_cli_install_steps}
To install the CLIs:
-
As a prerequisite for using Service Endpoints, install the {{site.data.keyword.Bluemix_notm}} CLI. The prefix for running commands by using the {{site.data.keyword.Bluemix_notm}} CLI is
ibmcloud. Make sure the CLI version is 0.13 or greater. -
Log in to the {{site.data.keyword.Bluemix_notm}} CLI. Enter your {{site.data.keyword.Bluemix_notm}} credentials when prompted.
ibmcloud login{: pre}
If you have a federated ID, use
ibmcloud login --ssoto log in to the {{site.data.keyword.Bluemix_notm}} CLI. Enter your user name and use the provided URL in your CLI output to retrieve your one-time passcode. You know you have a federated ID when the login fails without the--ssoand succeeds with the--ssooption. {: tip} -
Check if your account is already enabled for Service Endpoints.
ibmcloud account show{: pre}
Example CLI output:
Retrieving account Mark Anderson's Account of m.anderson@gmail.com... OK Account ID: d154dfbd0bc2edefthyufffc9b5ca318 Currently Targeted Account: true Linked Softlayer Account: 1008967 Service Endpoint Enabled: false{: screen}
If Service Endpoint Enabled is True, your account is already enabled to access Service Endpoints exposed by IBM Cloud Services on the cloud catalog.
-
If Service Endpoint Enabled is False, run the following command to enable it.
ibmcloud account update --service-endpoint-enable true{: pre}
This will prompt the user to open a support ticket with IBM Cloud to enable this account to use Service Endpoints. Example CLI output:
Service Endpoint is not available in linked Softlayer Account 1008967. Enable VRF(Virtual Routing and Forwarding) first to proceed. Learn more about VRF here - https://cloud.ibm.com/docs/infrastructure/direct-link/vrf-on-ibm-cloud.html. Do you want to open a ticket to enable it?[y/N]> y Ticket 70729615 was opened successfully. Follow the link https://control.softlayer.com/support/tickets/70729876 to check the details and track the status of the ticket. You will be required to login to view this ticket. Account ID: 1008967 Ticket: Private Network Question - Enable Service Endpoint connectivity for my account{: screen}
-
Once the account is enabled for Service Endpoints, one can start consuming the Service Endpoints of IBM Cloud Services that have exposed this functionality.
In the very near future support case creation will be automated through the IBM Cloud Console. Additonal updates will be included here when these capabilities are available.