appliance update: summary
The
summary
structure contains the essential information about the update. This structure was added in vSphere API 6.7.Representation:
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"size" : 1,
"release_date" : "2015-01-01T22:13:05.651Z",
"reboot_required" : true,
"name" : "string",
"description" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : {
"<string>" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : {
"<string>" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : {}
}
}
}
}
}
}
},
"priority" : "HIGH",
"version" : "obj-103"
}
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"size" : 1,
"release_date" : "2015-01-01T22:13:05.651Z",
"reboot_required" : true,
"name" : "string",
"description" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : {
"<string>" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : {
"<string>" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : {}
}
}
}
}
}
}
},
"priority" : "HIGH",
"version" : "obj-103"
}
{
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"size" : 1,
"release_date" : "2015-01-01T22:13:05.651Z",
"reboot_required" : true,
"name" : "string",
"description" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"priority" : "HIGH",
"version" : "obj-103"
}
"severity" : "CRITICAL",
"update_type" : "SECURITY",
"size" : 1,
"release_date" : "2015-01-01T22:13:05.651Z",
"reboot_required" : true,
"name" : "string",
"description" : {
"args" : [
"string",
"string"
],
"default_message" : "string",
"localized" : "string",
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"value" : {
"dt" : "2015-01-01T22:13:05.651Z",
"s" : "string",
"d" : 1.5,
"precision" : 1,
"format" : "SHORT_DATE",
"i" : 1,
"l" : {
"id" : "string",
"params" : [
{
"key" : "string"
}
]
}
},
"key" : "string"
}
]
}
},
"key" : "string"
}
]
},
"priority" : "HIGH",
"version" : "obj-103"
}
Attributes:
Name | Type | Description |
---|---|---|
Required | ||
-.version | string | Version in form of X.Y.Z.P. e.g. 6.5.1.5400. This attribute was added in vSphere API 6.7. 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 . |
-.name | string | Name of the update. This attribute was added in vSphere API 6.7. |
-.description | localizable_message | Description of the update. The short information what this update is. E.g. "Update2 for vCenter Server Appliance 6.5". This attribute was added in vSphere API 6.7. |
-.description.id | string | Unique identifier of the localizable string or message template. This identifier is typically used to retrieve a locale-specific string or message template from a message catalog. |
-.description.default_message | string | The value of this localizable string or message template in the en_US (English) locale. If vapi.std.localizable_message.id refers to a message template, the default message will contain the substituted arguments. This value can be used by clients that do not need to display strings and messages in the native language of the user. It could also be used as a fallback if a client is unable to access the appropriate message catalog. |
-.description.args | string[] | Positional arguments to be substituted into the message template. This list will be empty if the message uses named arguments or has no arguments. |
-.priority | string | Update priority. This attribute was added in vSphere API 6.7. Defines the update installation priority recommendations. This enumeration was added in vSphere API 6.7. Value is one of: HIGH: Install ASAP. This constant was added in vSphere API 6.7. MEDIUM: Install at the earliest convenience. This constant was added in vSphere API 6.7. LOW: Install at your discretion. This constant was added in vSphere API 6.7. |
-.severity | string | Update severity. This attribute was added in vSphere API 6.7. Defines the severity of the issues fixed in the update. This enumeration was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. |
-.update_type | string | Update category. This attribute was added in vSphere API 6.7. Defines update type. This enumeration was added in vSphere API 6.7. Value is one of: SECURITY: Fixes vulnerabilities, doesn't change functionality. This constant was added in vSphere API 6.7. FIX: Fixes bugs/vulnerabilities, doesn't change functionality. This constant was added in vSphere API 6.7. UPDATE: Changes product functionality. This constant was added in vSphere API 6.7. UPGRADE: Introduces new features, significantly changes product functionality. This constant was added in vSphere API 6.7. |
-.release_date | date_time | Update release date. This attribute was added in vSphere API 6.7. |
-.reboot_required | boolean | Flag indicating whether reboot is required after update. This attribute was added in vSphere API 6.7. |
-.size | long | Download Size of update in Megabytes. This attribute was added in vSphere API 6.7. |
Optional | ||
-.description.params | object | Named arguments to be substituted into the message template. This attribute was added in vSphere API 7.0.0.0. Optional. Unset means that the message template requires no arguments or positional arguments are used. |
-.description.localized | string | Localized string value as per request requirements. This attribute was added in vSphere API 7.0.0.0. Optional. when the client has not requested specific locale the implementation may not populate this field to conserve resources. |
Attributes:
Name | Type | Description |
---|---|---|
Required | ||
version | string | Version in form of X.Y.Z.P. e.g. 6.5.1.5400. This attribute was added in vSphere API 6.7. 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 . |
name | string | Name of the update. This attribute was added in vSphere API 6.7. |
description | localizable_message | Description of the update. The short information what this update is. E.g. "Update2 for vCenter Server Appliance 6.5". This attribute was added in vSphere API 6.7. |
description.id | string | Unique identifier of the localizable string or message template. This identifier is typically used to retrieve a locale-specific string or message template from a message catalog. |
description.default_message | string | The value of this localizable string or message template in the en_US (English) locale. If vapi.std.localizable_message.id refers to a message template, the default message will contain the substituted arguments. This value can be used by clients that do not need to display strings and messages in the native language of the user. It could also be used as a fallback if a client is unable to access the appropriate message catalog. |
description.args | string[] | Positional arguments to be substituted into the message template. This list will be empty if the message uses named arguments or has no arguments. |
priority | string | Update priority. This attribute was added in vSphere API 6.7. Defines the update installation priority recommendations. This enumeration was added in vSphere API 6.7. Value is one of: HIGH: Install ASAP. This constant was added in vSphere API 6.7. MEDIUM: Install at the earliest convenience. This constant was added in vSphere API 6.7. LOW: Install at your discretion. This constant was added in vSphere API 6.7. |
severity | string | Update severity. This attribute was added in vSphere API 6.7. Defines the severity of the issues fixed in the update. This enumeration was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. 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. This constant was added in vSphere API 6.7. |
update_type | string | Update category. This attribute was added in vSphere API 6.7. Defines update type. This enumeration was added in vSphere API 6.7. Value is one of: SECURITY: Fixes vulnerabilities, doesn't change functionality. This constant was added in vSphere API 6.7. FIX: Fixes bugs/vulnerabilities, doesn't change functionality. This constant was added in vSphere API 6.7. UPDATE: Changes product functionality. This constant was added in vSphere API 6.7. UPGRADE: Introduces new features, significantly changes product functionality. This constant was added in vSphere API 6.7. |
release_date | date_time | Update release date. This attribute was added in vSphere API 6.7. |
reboot_required | boolean | Flag indicating whether reboot is required after update. This attribute was added in vSphere API 6.7. |
size | long | Download Size of update in Megabytes. This attribute was added in vSphere API 6.7. |
Optional | ||
description.params | list | Named arguments to be substituted into the message template. This attribute was added in vSphere API 7.0.0.0. Optional. Unset means that the message template requires no arguments or positional arguments are used. |
description.localized | string | Localized string value as per request requirements. This attribute was added in vSphere API 7.0.0.0. Optional. when the client has not requested specific locale the implementation may not populate this field to conserve resources. |