List Pending
Checks if there are any eligible updates.
Request
URLURL
Query Parameters
Query Parameters
checks and lists if there are eligible major version upgrades available. Possible values are true and false when set to true it allows listing of across version upgrade When not specified lists only minor updates available
specific URL to check at If unset then URL is taken from the policy settings
Header Parameters
Header Parameters
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Authentication
Response
Response BodyResponse Body
array
of
UpdateSummary
of type application/json
List of the update summaries
[
{
"description": {
"args": [
"string"
],
"default_message": "string",
"id": "string",
"localized": "string",
"params": {
"key": {
"d": 0,
"dt": "string",
"format": "SHORT_DATE",
"i": 0,
"l": {
"id": "string",
"params": "StdLocalizationParam Object"
},
"precision": 0,
"s": "string"
}
}
},
"name": "string",
"priority": "HIGH",
"reboot_required": false,
"release_date": "string",
"severity": "CRITICAL",
"size": 0,
"update_type": "SECURITY",
"version": "string"
}
]
Description of the update. The short information what this update is. E.g. “Update2 for vCenter Server Appliance 6.5”
Name of the update.
The CommonInfo.Priority enumerated type defines the update installation priority recommendations.
HIGH : Install ASAP
MEDIUM : Install at the earliest convenience
LOW : Install at your discretion
Possible values are: HIGH , MEDIUM , LOW
Flag indicating whether reboot is required after update.
Update release date.
The CommonInfo.Severity enumerated type defines the severity of the issues fixed in the update.
CRITICAL : Vulnerabilities that can be exploited by an unauthenticated attacker from the Internet or those that break the guest/host Operating System isolation. The exploitation results in the complete compromise of confidentiality, integrity, and availability of user data and/or processing resources without user interaction. Exploitation could be leveraged to propagate an Internet worm or execute arbitrary code between Virtual Machines and/or the Host Operating System.
IMPORTANT : Vulnerabilities that are not rated critical but whose exploitation results in the complete compromise of confidentiality and/or integrity of user data and/or processing resources through user assistance or by authenticated attackers. This rating also applies to those vulnerabilities which could lead to the complete compromise of availability when exploitation is by a remote unauthenticated attacker from the Internet or through a breach of virtual machine isolation.
MODERATE : Vulnerabilities where the ability to exploit is mitigated to a significant degree by configuration or difficulty of exploitation, but in certain deployment scenarios could still lead to the compromise of confidentiality, integrity, or availability of user data and/or processing resources.
LOW : All other issues that have a security impact. Vulnerabilities where exploitation is believed to be extremely difficult, or where successful exploitation would have minimal impact
Possible values are: CRITICAL , IMPORTANT , MODERATE , LOW
Download Size of update in Megabytes.
The CommonInfo.Category enumerated type defines update type
SECURITY : Fixes vulnerabilities, doesn’t change functionality
FIX : Fixes bugs/vulnerabilities, doesn’t change functionality
UPDATE : Changes product functionality
UPGRADE : Introduces new features, significantly changes product functionality
Possible values are: SECURITY , FIX , UPDATE , UPGRADE
Version in form of X.Y.Z.P. e.g. 6.5.1.5400 When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: com.vmware.appliance.update.pending. When operations return a value of this structure as a result, the field will be an identifier for the resource type: com.vmware.appliance.update.pending.
Errors
com.vmware.vapi.std.errors.unauthorized : session is not authorized to perform this operation
‘Default’ means this response is used for all HTTP codes that are not covered individually for this operation.
Code Samples
PowerCLI Client SDK Example
cURL Command
Vendor Extensions
x-vmw-doc-deprecated-method: get
x-vmw-doc-deprecated-path: /rest/appliance/update/pending
x-vmw-doc-operation: list