REST API - list

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"
        }
    ]
}

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