API Guide
Table Of Contents
- OpenManage Integration for VMware vCenter Version 5.3 API Guide
- Overview
- Get started
- Security
- Use cases
- Session management
- License management
- Console management
- Repository profile management
- Cluster profile management
- Firmware repository inventory management
- Firmware inventory management
- Firmware update management
- System profile management
- Host management
- Get subsystem health report (OMIVV Host Health)
- Host management
- Request body
- Response body
- OMIVV-Specific error codes
response = requests.get(url, verify=False, headers=head)
if (response.status_code == 200):
json_response = json.dumps(response.json(), indent=4, sort_keys=True)
return json_response
else:
print("Get registered vCenter list failed")
def get_cluster_details(url, session_token):
head = {'Authorization': 'Bearer ' + session_token}
response = requests.get(url, verify=False, headers=head)
if (response.status_code == 200):
return response
else:
print(response.status_code)
print("Get cluster details failed")
def set_operational_context(omivv_ip, vcenter_id, session_token, vcenter_username,
vcenter_domain, vcenter_password):
base_url = "https://" + omivv_ip + "/Spectre/api/rest/v1/Services/ConsoleService/
OperationalContext"
postBodyData = {"consoleId": vcenter_id,
"consoleUserCredential": {"username": vcenter_username, "domain":
vcenter_domain,
"password": vcenter_password}}
head = {'Authorization': 'Bearer ' + session_token}
jsonReponse = requests.post(base_url, json=postBodyData, verify=False, headers=head)
if (jsonReponse.status_code != 204):
print("setOperationalContext failed.")
```
● Get list of registered vCenters
Sample code to get the list of registered vCenters:
```json
def get_regitered_vcenter(bearer_token,ip_address, vcenter_ip, serviec_tag, vc_username,
vc_domain, vc_password):
"""Authenticate with OMIVV and enumerate reports."""
try:
""" Get all registered vcenter """
registered_vcenter_list = get_registered_vcenter_list(ip_address, bearer_token)
if(registered_vcenter_list is None):
print("No vcenter is regsitered with this OMIVV")
return
else:
print(registered_vcenter_list)
except:
print("get_vcenter_tree: Unexpected error:", sys.exc_info()[0])
def get_registered_vcenter_list(omivvIP,bearerToken):
"""Get all registered vcenter with this OMIVV"""
url ="https://" + omivvIP + "/Spectre/api/rest/v1/Services/ConsoleService/Consoles"
head = {'Authorization': 'Bearer ' + bearerToken}
response = requests.get(url, verify=False, headers=head)
if(response.status_code == 200):
json_response = json.dumps(response.json(), indent=4, sort_keys=True)
return json_response;
else:
print("Get registered vCenter list failed")
```
● Get host details
Sample code to get the host details:
```json
def get_host_detail_by_service_tag(bearer_token,ip_address, vcenter_ip, serviec_tag,
vc_username, vc_domain, vc_password):
"""Authenticate with OMIVV and enumerate reports."""
18
Use cases