April 21, 2024

Now we have an vital announcement to make – Utilization Meter and Utilization Report APIs are actually a part of the Cloud Supplier Navigator and could be accessed from the Cloud Provider part on developer.vmware.com. Moreover, there’s a new API for registering Utilization Meter with a contract within the VCPP Commerce Portal. Right here is how the Utilization API web page appears to be like like on developer.vmware.com.

On this weblog put up, we are going to display the steps of registering a Utilization Meter occasion, getting data and downloading utilization experiences.

Earlier than utilizing the aforementioned APIs, there are just a few conditions that must be glad.

Conditions

  1. A refresh token generated from Cloud Accomplice Navigator/Person Profile/API Tokens. Data could be discovered here or scroll to the Producing an Entry Token part on this weblog put up.
  2. An entry token generated from the Cloud Accomplice Navigator refresh token. Learn here or scroll to the Producing an Entry Token part on this weblog put up.

Notice: A generated entry token expires after half-hour so it’s worthwhile to regenerate it on occasion.

Producing an Entry Token for Authentication

To execute the API requests described on this weblog put up, you have to to generate a refresh token from Cloud Accomplice Navigator (CPN) after which execute a POST request to the Cloud Providers Portal gateway to get the entry token with which you’ll authenticate with the CPN service – Utilization Perception.

The Utilization Perception service is the service which is able to register your Utilization Meter with a contract within the Commerce Portal and generate experiences for a Utilization Meter occasion.

Now let’s see methods to generate an entry token:

  1. Log in to Cloud Accomplice Navigator.
  2. Change to the group for which you want to register a Utilization Meter or obtain utilization experiences.
  3. Underneath your username, click on My Account.
  4. Click on on the API Tokens tab.
  5. Within the API Tokens web page, click on GENERATE TOKEN.
  6. Copy the token and click on Proceed.

Notice: Save your refresh token someplace as you have to it repeatedly to generate an entry token to your utilization API calls.

  1. In your API shopper, make the next POST Request to the Cloud Accomplice Navigator Service Gateway to generate an entry token.

This entry token you’ll use to authenticate with Utilization Perception when sending the request for registering your Utilization Meter with a contract within the Commerce Portal.

See the pattern request and response:

Pattern cURL Code:

Notice: Substitute the refresh token with your personal generated from the CPN API Token web page.

  1. Copy the entry token from the response. Use it when executing the API requests described on this weblog put up.

Checking if a Utilization Meter occasion is registered

Earlier than registering a Utilization Meter, examine if it has already been registered with Utilization Perception.

Right here is methods to do it:

  1. Execute the next GET registration request:

  • Use the UUID of your Utilization Meter.
  • Use the generated entry token to authenticate to the service.
  1. In case your registration is profitable, you’re going to get the next response: Standing 200 OK, additionally a contract quantity, and a web site identify. See the screenshot under:

Pattern cURL Code

Notice: Substitute the Utilization Meter UUID with your personal. You will discover it in your Utilization Meter internet software, underneath the About tab. Use the entry token you generated for the authorization.

Registering a Utilization Meter within the Commerce Portal

To register your Utilization Meter with a contract within the Commerce Portal utilizing the brand new REST API, you have to to authenticate with the Utilization Perception service to which to ship the registration request.

Listed here are the precise steps:

  1. Ship POST request to the Utilization Perception service, which is able to deal with the registration of the Utilization Meter occasion with a contract within the Commerce Portal.

  1. Within the physique of the request, you should specify the next:

  1. For the authorization with the Utilization Perception service, use the generated entry token.
  1. Execute the request. If the Utilization Meter registration is profitable, then you’re going to get code 202. See an instance under:

If this Utilization Meter has already been registered, you’re going to get code 201.

  1. Go to the VMware Commerce portal to confirm if Utilization Meter is registered with the required contract and org web site.

Pattern cURL code

Notice: Use your Utilization Meter particulars an present the entry token you generated from the CPN refresh token.

Getting Data on All Utilization Reviews

Utilization report API is now dully documented and is able to be carried out in your group. Listed here are the API requests that you should utilize to automate your utilization report technology:

  • Get data on all utilization experiences for a particular month and yr for a corporation
  • Obtain a particular utilization report by specifying its reference quantity retrieved from the get data on all utilization experiences API request
  • Lastly, get data on all experiences related by a utilization meter UUID

Get Data on All Utilization Reviews for a Month

To get data on all utilization experiences of all Utilization Meters in your CPN group for a specific month and yr, do the next:

  1. Execute GET https://ums.vmware.com/utilization/api/v1/experiences/2023/1 request to the Utilization Perception service endpoint.
  2. Present the month and yr for which you want to get all utilization experiences for all of your registered Utilization Meters.
  3. Authenticate to Utilization Perception with the generated entry token.
  4. In case your request is profitable, you’re going to get Standing 200 OK and an inventory of all utilization experiences related to Utilization Meter UUID. Right here is an instance of the response.

Pattern cURL code

Notice: Specify a month and a yr for which to get data on all utilization experiences of a CPN group.

Obtain a Particular Utilization Report

To obtain a particular Utilization Meter report, it’s worthwhile to present within the parameters of your API request the reference variety of that report. To search out it, you want first to set off GET data on all utilization experiences request. See the Getting Data on All Utilization Reviews for a Month part.

Right here is methods to obtain a particular Utilization Meter report:

1. Make a GET request to https://ums.vmware.com/utilization/api/v1/experiences and specify the next:

  • Within the parameters of the request enter the reference variety of the report. This worth you should retrieve from the request defined within the Get Data on All Reviews for a Month part.
  • Within the header of the request, you should specify the Settle for parameter to be the content material kind of the report (once more get this data from the get data on all utilization experiences API request)
  • Authenticate to the Utilization Perception service by utilizing the generated entry code.
  1. The response will likely be Standing 200 OK if the request is profitable, and also you additionally get the textual content of the zipped report. On this instance, the response isn’t decoded as Postman does node decode the content material of zipped information.
  1. Save the response.  In Postman, the way in which to do it’s to click on Save Response. This fashion you’ll obtain the referenced report.

Pattern cURL code

Notice: Use the reference variety of the report you want to obtain the your generated entry token.

Get Data on all Reviews of a Utilization Meter Occasion

To get data on all utilization experiences of a particular Utilization Meters, do the next:

  1. Execute a GET request to the Utilization Perception service, specifying the month and yr for which you want to get data and the uuid of the utilization meter with which the experiences are related.
  1. Present the generated entry token with which to authenticate with the Utilization Perception service.
  1. You’re going to get the next response: Standing 200 OK and the small print of all experiences associated to this Utilization Meter and their reference numbers.

Notice: Use the reference variety of the experiences you want to obtain with the GET / https://ums.vmware.com/utilization/api/v1/experiences API request.

Right here is an instance of the request and its response.

Pattern cURL Code

Notice: Specify a month and a yr for which to get data on all utilization experiences related to the uuid of your utilization meter. Substitute the Utilization Meter UUID on this instance with your personal.

Conclusion

In a conclusion, you should utilize these APIs as a part of your Utilization Meter reporting automation.  Now with the registration of the Utilization Meter occasion you’ll be able to absolutely automate the set up and configuration of your Utilization Meter situations.

We are going to maintain enhancing and increasing our Utilization Meter-related APIs and wish to hear from you about what different APIs we are able to develop to enhance your reporting expertise.

The remainder of the Utilization Meter API requests could be discovered here. Cloud Accomplice Navigator and Commerce Portal APIs could be discovered here and here.

For extra questions or queries, depart a remark under or ship us an electronic mail to [email protected]. There’s a Slack channel accessible to cloud suppliers the place it’s also possible to ask your questions.