List recent application patching details
Relative path: /v1/application-patching-processes/recent/details
List the patching details of all application patching attempts performed recently (within the last few days).
The list might be empty if no application patching has been performed recently.
Stale data (that is, not recent) is removed from the list over the course of several days.
Endpoint URL for Europe, Germany, United States, Canada and Japan regions:
|
https://eu.patch-management.eset.systems/v1/application-patching-processes/recent/details |
|
https://de.patch-management.eset.systems/v1/application-patching-processes/recent/details |
|
https://us.patch-management.eset.systems/v1/application-patching-processes/recent/details |
|
https://ca.patch-management.eset.systems/v1/application-patching-processes/recent/details |
|
https://jpn.patch-management.eset.systems/v1/application-patching-processes/recent/details |
Query parameters
No parameters are required.
Responses
Display Schema+Headers instead of an Example or vice-versa
Code |
Description and Example |
Description, Schema and Headers |
|---|---|---|
200 |
Successful response.
{
"patchingDetails": [
{
"applicationUuid": "string",
"developerDisplayName": "string",
"displayName": "string",
"patchedVersion": {
"id": "string",
"major": 0,
"minor": 0,
"name": "string",
"patch": 0
},
"status": "APPLICATION_PATCHING_STATUS_UNSPECIFIED",
"timePeriod": {
"startTime": "string",
"endTime": "string"
},
"unpatchedVersion": {
"id": "string",
"major": 0,
"minor": 0,
"name": "string",
"patch": 0
}
}
]
}
|
Successful response.
{
"$ref": "v1ListRecentApplicationPatchingDetailsResponse",
"patchingDetails": [
{
"$ref": "v1ApplicationPatchingDetails",
"description": "Details of patching of a single application.",
"applicationUuid": {
"type": "string",
"description": "Reference to the patched [application]. type: application_management.v1.Application"
},
"developerDisplayName": {
"type": "string",
"description": "Developer of the application."
},
"displayName": {
"type": "string",
"description": "A human-friendly name of the application."
},
"patchedVersion": {
"$ref": "v1Version",
"description": "Version descriptor. Both values are required to completely reconstruct version information.",
"id": {
"type": "string",
"description": "[Version id] determines whether one version is more recent than another. More recent versions have higher numbers. Can be processed by machine. If human readable version_name meets certain criteria, it can be converted to version_id automatically. The cases are: Windows => VersionId = MajorVersion << 48 | MinorVersion << 32 | ServicePackMajor << 24 | ServicePackMinor << 16 | CurrentBuildNumber Android => VersionId = API level YYYYMMDD => VersionId = (YYYY & 0xffff ) << 48 | (MM & 0xffff) << 32 | (DD & 0xffff) <<16 YYYY.MM => VersionId = (YYYY & 0xffff ) << 48 | (MM & 0xffff) << 32 YY.MM => VersionId = (YY & 0xffff ) << 48 | (MM & 0xffff) << 32 YYYY => VersionId = (YYYY & 0xffff ) << 48 Major.Minor.Patch => VersionId = (Major & 0xffff ) << 48 | (Minor & 0xffff) << 32 | (Patch & 0xffff) <<16 EULA | Terms of Use => VersionId = MajorVersion << 48 | MinorVersion << 32 | Patch << 16 A.B.C.D => VersionId = (A & 0xffff) << 48 | (B & 0xffff) << 32 | (C & 0xffff) << 16 | (D & 0xffff) A.B.C => VersionId = (A & 0xffff ) << 48 | (B & 0xffff) << 32 | (C & 0xffff) <<16 A.B => VersionId = (A & 0xffff ) << 48 | (B & 0xffff) << 32 A => VersionId = (A & 0xffff ) << 48",
"format": "uint64"
},
"major": {
"type": "integer",
"description": "Major version if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
},
"minor": {
"type": "integer",
"description": "Minor version if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
},
"name": {
"type": "string",
"description": "Human readable name of the version. E.g. '10.2.3.145'"
},
"patch": {
"type": "integer",
"description": "Patch if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
}
},
"status": {
"$ref": "v1ApplicationPatchingStatus",
"type": "string",
"description": "Possible statuses of application patching. DEPRECATED: Use PatchingStatus instead. APPLICATION_PATCHING_STATUS_UNSPECIFIED: fallback APPLICATION_PATCHING_STATUS_OK_INSTALLED: Patching was successful and complete. APPLICATION_PATCHING_STATUS_OK_RESTART_REQUIRED: Patching was successful, but system restart is required. APPLICATION_PATCHING_STATUS_FAILED_TERMINATION_REQUIRED: Patching was unsuccessful, application must be terminated before patching. APPLICATION_PATCHING_STATUS_FAILED_UNINSTALL_REQUIRED: Patching was unsuccessful, application must be uninstalled before patching. APPLICATION_PATCHING_STATUS_FAILED_DOWNLOAD_ERROR: Patching was unsuccessful, patch downloading failed. APPLICATION_PATCHING_STATUS_FAILED_INSTALLER_CORRUPTED: Patching was unsuccessful, downloaded patch installer was corrupted. APPLICATION_PATCHING_STATUS_FAILED_PREPARE_ERROR: Patching was unsuccessful, failed to prepare downloaded patch installer. APPLICATION_PATCHING_STATUS_NOT_APPLICABLE: Patching was unsuccessful, patch is not applicable - already patched/uninstalled.",
"default": "APPLICATION_PATCHING_STATUS_UNSPECIFIED",
"enum": [
"APPLICATION_PATCHING_STATUS_UNSPECIFIED",
"APPLICATION_PATCHING_STATUS_OK_INSTALLED",
"APPLICATION_PATCHING_STATUS_OK_RESTART_REQUIRED",
"APPLICATION_PATCHING_STATUS_FAILED_TERMINATION_REQUIRED",
"APPLICATION_PATCHING_STATUS_FAILED_UNINSTALL_REQUIRED",
"APPLICATION_PATCHING_STATUS_FAILED_DOWNLOAD_ERROR",
"APPLICATION_PATCHING_STATUS_FAILED_INSTALLER_CORRUPTED",
"APPLICATION_PATCHING_STATUS_FAILED_PREPARE_ERROR",
"APPLICATION_PATCHING_STATUS_NOT_APPLICABLE"
]
},
"timePeriod": {
"$ref": "typeInterval",
"description": "Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.",
"startTime": {
"type": "string",
"description": "Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.",
"format": "date-time"
},
"endTime": {
"type": "string",
"description": "Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.",
"format": "date-time"
}
},
"unpatchedVersion": {
"$ref": "v1Version",
"description": "Version descriptor. Both values are required to completely reconstruct version information.",
"id": {
"type": "string",
"description": "[Version id] determines whether one version is more recent than another. More recent versions have higher numbers. Can be processed by machine. If human readable version_name meets certain criteria, it can be converted to version_id automatically. The cases are: Windows => VersionId = MajorVersion << 48 | MinorVersion << 32 | ServicePackMajor << 24 | ServicePackMinor << 16 | CurrentBuildNumber Android => VersionId = API level YYYYMMDD => VersionId = (YYYY & 0xffff ) << 48 | (MM & 0xffff) << 32 | (DD & 0xffff) <<16 YYYY.MM => VersionId = (YYYY & 0xffff ) << 48 | (MM & 0xffff) << 32 YY.MM => VersionId = (YY & 0xffff ) << 48 | (MM & 0xffff) << 32 YYYY => VersionId = (YYYY & 0xffff ) << 48 Major.Minor.Patch => VersionId = (Major & 0xffff ) << 48 | (Minor & 0xffff) << 32 | (Patch & 0xffff) <<16 EULA | Terms of Use => VersionId = MajorVersion << 48 | MinorVersion << 32 | Patch << 16 A.B.C.D => VersionId = (A & 0xffff) << 48 | (B & 0xffff) << 32 | (C & 0xffff) << 16 | (D & 0xffff) A.B.C => VersionId = (A & 0xffff ) << 48 | (B & 0xffff) << 32 | (C & 0xffff) <<16 A.B => VersionId = (A & 0xffff ) << 48 | (B & 0xffff) << 32 A => VersionId = (A & 0xffff ) << 48",
"format": "uint64"
},
"major": {
"type": "integer",
"description": "Major version if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
},
"minor": {
"type": "integer",
"description": "Minor version if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
},
"name": {
"type": "string",
"description": "Human readable name of the version. E.g. '10.2.3.145'"
},
"patch": {
"type": "integer",
"description": "Patch if and only if version name adheres to semantic versioning. 0 or null otherwise.",
"format": "int64",
"readOnly": true
}
}
}
]
}
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
202 |
Response took too long; request cached. Response can be retrieved later using the response-id header. |
Response took too long; request cached. Response can be retrieved later using the response-id header.
[]
{
"response-id": {
"description": "Unique ID of a pending request. Used to retrieve cached result.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
},
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
400 |
One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided. |
One of the errors: 1. Bad or missing authorization. 2. Validation error. Invalid argument provided.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
401 |
Token has expired or is invalid. |
Token has expired or is invalid.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
403 |
Access denied. Check permissions. |
Access denied. Check permissions.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
404 |
Requested resource not found. |
Requested resource not found.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
429 |
Rate limit reached. Try again later. |
Rate limit reached. Try again later.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
500 |
Internal server failure. Try again later. |
Internal server failure. Try again later.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
502 |
Internal server failure. Try again later. |
Internal server failure. Try again later.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
503 |
Environment under maintenance. Try again later. |
Environment under maintenance. Try again later.
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|
504 |
Action took too long; timeout reached |
Action took too long; timeout reached
[]
{
"request-id": {
"description": "Unique ID of the request. Include in support requests.",
"style": "simple",
"explode": false,
"schema": {
"type": "string",
"format": "uuid"
}
}
}
|