appliance update history: list
Returns information about the list of updates installed. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
Request:
HTTP request
GET https://{server}/rest/appliance/update/history
No request parameters
Response:
HTTP Status Code: 200
Representation:
{
"value" : [
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"release_date" : "2015-01-01T22:13:05.651Z",
"name" : "string",
"install_date" : "2015-01-01T22:13:05.651Z",
"version" : "obj-103"
},
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"release_date" : "2015-01-01T22:13:05.651Z",
"name" : "string",
"install_date" : "2015-01-01T22:13:05.651Z",
"version" : "obj-103"
}
]
}
"value" : [
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"release_date" : "2015-01-01T22:13:05.651Z",
"name" : "string",
"install_date" : "2015-01-01T22:13:05.651Z",
"version" : "obj-103"
},
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"release_date" : "2015-01-01T22:13:05.651Z",
"name" : "string",
"install_date" : "2015-01-01T22:13:05.651Z",
"version" : "obj-103"
}
]
}
Response Type:
Name | Type | Description |
---|---|---|
bold = required | ||
value | summary[] | List of Summary structure with information about installed updates. |
value[].name | string | Name of the update. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. |
value[].install_date | date_time | Installation date and time. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. |
value[].version | string | Version of the update. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. 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.history . 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.history . |
value[].severity | string | The severity of the patch. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Defines the severity of the issues fixed in the update. Warning: This enumeration is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Value is one of: 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. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. 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. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. 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. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. |
value[].release_date | date_time | Update release date. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. |
value[].update_type | string | Update category. Warning: This attribute is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Defines update type. Warning: This enumeration is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Value is one of: SECURITY: Fixes vulnerabilities, doesn't change functionality. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. FIX: Fixes bugs/vulnerabilities, doesn't change functionality. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. UPDATE: Changes product functionality. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. UPGRADE: Introduces new features, significantly changes product functionality. Warning: This constant is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. |
Errors:
HTTP Status Code | Type | Description |
---|---|---|
500 | error | Generic error |
401 | unauthenticated | session is not authenticated |
403 | unauthorized | session is not authorized to perform this operation |
400 | not_allowed_in_current_state | if nothing is installed |