VMware Cloud Foundation Usage Meter Appliance API Operations Index

VMware Cloud Foundation Usage Meter Appliance API Operations Index

All available VMware Cloud Foundation Usage Meter Appliance API Operations

Anonymization
POST
Deanonymize

Returns the same usage report with all fields deanonymized.

GET
Get Anon Settings

Returns all anonymization settings available in this usage meter appliance.

PATCH
Patch Anon Settings

Change anonymization settings with the given values. To disable/enable only provided the disabled flag in the request body. To clear the redaction string, provide a null attribute in the request body. When you want to change a anonymization group, only set it in the settings array. The rest of the groups will be intact.

Cloud Authentication Settings
GET
Get Cloud Authentication

Get the current cloud authentication details.

PUT
Update Cloud Authentication

Update cloud authentication details using the access token from VCF Console.

Customer Rules
GET
Get Rules

Get all customer rules or limit the result for a given name only.

POST
Post Rules

This API creates customer rules. It returns the created rules definition by providing its IDs.

DELETE
Delete Rules

Deletes customer rules from the Usage Meter

PATCH
Patch Rules

This API updates customer rules. Only rule name update is allowed. It returns the updated rules definition.

GET
Get Rule

Get a customer rule by its id.

DELETE
Delete Rule

Deletes customer rule from the Usage Meter

PATCH
Patch Rule

This API updates customer rule. Only rule name update is allowed. It returns the updated rule definition.

GET
Get Rules Audit

Get customer rules audit per type.

POST
Get Inventory Search Result

Get product inventory information based on search criteria.

Info
GET
Get Info

This API provides information like build number, version and UUID of the Usage Meter appliance.

Initialization Wizard Flow Operations
Mail Notification Settings
GET
Get Mail Notification Settings

Returns all email notification settings.

PUT
Update Mail Notification Settings

Perform the update over the existing mail notification settings.

PATCH
Patch Mail Notification Settings

Apply a collection of patch instructions (updates) against the existing mail notification settings.

DELETE
Delete Mail Notification Settings

Delete currently saved email notification settings.

Notifications
GET
Get User Action

Retrieves one or more messages that require user action. For example, after adding a new product to the Usage Meter, you can invoke this API to view the product certificate details and obtain the certificateId.

GET
Get Journal

Retrieves notification messages. For example, you can use this API to check if there are errors in the Usage Meter appliance (with a query param level=Err).

Product
POST
Post Product

This API returns, among other fields, the ID of the newly added product. Please note - This ID must be provided (as productId) for operations like accept certificates, retrieve notification messages or update/delete the product.

GET
Get Product

Retrieves one or more products from the Usage Meter.

PUT
Put Product

Updates and activates a product. For example, this API can update the password for a vCenter.

DELETE
Delete Product

Deletes a product from the Usage Meter

PUT
Accept Certificate

Use this API to accept or decline a certificate. 'certificateId' can be obtained from /user_action API response.

Proxy Configuration Settings
GET
Get Proxy Settings

Obtain the current proxy's configuration.

POST
Update Proxy Settings

Update the current proxy's configuration. This is part of the initialization wizard. Upon successful test_proxy with accessToken and proxy details, invoke this endpoint to save the proxy settings. In case no proxy is involved (direct connection to cloud) invoking this method is not required.

Security
GET
Get Security Settings

Gets security settings currently configured for usage meter.

PUT
Put Security Settings

Update security settings in usage meter

Session
POST
Post Login

This API creates a login session. It returns the bearer token that must be used as a Authorization header parameter for all subsequent Usage Meter operations.

Usage
GET
Get Usage Data List

Provides a list of at most 12 reporting periods (most recent first) for which the usage data is available

GET
Get Usage Data

Downloads usage data in an opaque binary format suitable only for subsequent upload to VMware. Most customers will have no need to use this API.