- 28 Aug 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
VMware vCloud Director
- Updated on 28 Aug 2024
- 3 Minutes to read
- Print
- DarkLight
- PDF
VMware vCloud Director is a cloud service-delivery platform.
Types of Assets Fetched
This adapter fetches the following types of assets:
- Devices
- Users
Parameters
Select the API Version you want to use to connect - v31.0 or v36.0. Each version requires different connection parameters.
API v31.0
- vCloud Director Domain (required) - The hostname of the VMware vCloud Director server.
- User Name and Password (required) - The user name and password for an account that has the Required Permissions to fetch assets.
The user name has to be in a specific format as described at:
vCloud Director API - VMware API Explorer
You must append either "@system" to the user name or "@orgname". This depends on the role you have set for the user. System administrator users must use "@system" because admin user is not bound to a special organization. org admin or org user must append the organization name.
For example:- superadmin@system
- orgadmin@acme
- superadmin@domain.tld@system (email format)
- Is Admin
- Select this option if user has admin/system permissions.
- Clear this option if user does not have admin/system permissions. In this case, the adapter brings VMs into your organization that the user can view or modify.
- Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.
- HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
API v36.0
- vCloud Director Domain (required) - The hostname of the VMware vCloud Director server.
- API Key - An API Key associated with a user account that has permissions to fetch assets.
- Tenant Name - Tenant name as supplied by VMware.
- Client ID - Enter the Client ID.
- Device Code - used by the Axonius application to poll VMware Cloud Director for the API token.
For instructions on how to generate the Client ID and Device Code, see here. - User Name and Password - The user name and password for an account that has the Required Permissions to fetch assets.
The user name has to be in a specific format as described at:
vCloud Director API - VMware API Explorer
You must append "@Tenant" to the username.
For example: User@Tenant (be sure to replace the 'User' with the actual username and 'Tenant' with your actual Tenant). - HTTPS Proxy (optional) - Connect the adapter to a proxy instead of directly connecting it to the domain.
- When authenticating to API v36.0, use you must provide either of the following parameter pairs:
- User Name and Password
- Tenant Name and API Token
- Client ID and Device Code
Using only one parameter of each pair will result in a connection error.
Advanced Settings
Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection. Refer to Advanced Configuration for Adapters.
- Max parallel requests (required, default: 50) - Specify the number of parallel requests Axonius will send to gain better control on the performance of all connections for this adapter.
To learn more about Adapter Configuration tab advanced settings, see Adapter Advanced Settings.
Required Permissions
For API v31.0: The value supplied in User Name must have Read permissions in order to fetch assets.
For API v36.0: The value supplied in API Key/User Name must be associated with credentials that have Read permissions in order to fetch assets and they must have permissions to fetch virtual centers.
Version Matrix
This adapter has only been tested with the versions marked as supported, but may work with other versions. Please contact Axonius Support if you have a version that is not listed and it is not functioning as expected.
Version | Supported | Notes |
---|---|---|
VMWare vCloud Director 9.0 to 9.5 | Yes | For API v31.0 |
VMWare vCloud Director later than 9.5 | Yes | For API v36.0 |