Get Secure Client Upgrade Run - Security Cloud Control Firewall Manager API Documentation

{"type":"api","title":"Get Secure Client Upgrade Run","meta":{"id":"/apps/pubhub/media/cdo-api-documentation/241e37f202cf9838405f7ca5ed9f7d31d807d7bd/9b0e4c9a-48cb-3530-a00a-1f32fbf2438c","info":{"title":"Cisco Security Cloud Control Firewall Manager API","version":"1.22.0","description":"Use the documentation to explore the endpoints Security Cloud Control Firewall Manager has to offer","contact":{"name":"Cisco Security Cloud Control TAC","email":"cdo.tac@cisco.com"}},"openapi":"3.0.1","servers":[{"url":"https://api.us.security.cisco.com/firewall","description":"US"},{"url":"https://api.eu.security.cisco.com/firewall","description":"EU"},{"url":"https://api.apj.security.cisco.com/firewall","description":"APJ"},{"url":"https://api.au.security.cisco.com/firewall","description":"AUS"},{"url":"https://api.in.security.cisco.com/firewall","description":"IN"},{"url":"https://api.uae.security.cisco.com/firewall","description":"UAE"},{"url":"https://api.int.security.cisco.com/firewall","description":"Staging"},{"url":"https://scale.manage.security.cisco.com/api/rest","description":"Scale"},{"url":"https://ci.manage.security.cisco.com/api/rest","description":"CI"},{"url":"https://devfed.cdo.cisco.com/api/rest","description":"Devfed"},{"url":"https://manage.dev.secure.cisco/api/rest","description":"Devf9"},{"url":"https://manage.stg.secure.cisco/api/rest","description":"Stgf9"},{"url":"https://manage.secure.cisco/api/rest","description":"ProdF9"},{"url":"https://manage.securitydod.cisco/api/rest","description":"IL5"}],"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"spec":{"description":"Get a Secure Client Upgrade Run by UID in the Security Cloud Control tenant. Each upgrade run represents a group of devices having their Secure Client packages upgraded together.","operationId":"getSecureClientUpgradeRun","parameters":[{"description":"The unique identifier, represented as a UUID, of the Secure Client Upgrade Run in Security Cloud Control.","in":"path","name":"upgradeRunUid","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"devices":{"description":"The devices included in this upgrade run.","items":{"description":"The devices included in this upgrade run.","properties":{"errorMsg":{"description":"Error message if the device encountered a failure during the upgrade.","example":"No CLI result received for device","type":"string"},"name":{"description":"The name of the device.","example":"asa-fw-01","type":"string"},"status":{"description":"The overall status of the device in this upgrade run. One of: PENDING, IN_PROGRESS, SUCCESS, FAILED, CLEANUP_FAILED.","enum":["PENDING","IN_PROGRESS","SUCCESS","FAILED","CLEANUP_FAILED"],"example":"SUCCESS","type":"string"},"uid":{"description":"The unique identifier, represented as a UUID, of the device.","example":"f0a09517-bab1-43e4-adae-2037cf3184e3","format":"uuid","type":"string"}},"type":"object","$$ref":"#/components/schemas/UpgradedDeviceDto"},"type":"array"},"errorMsg":{"description":"Error message if the upgrade run failed.","example":"Timeout error","type":"string"},"lastUpdatedTime":{"description":"Time (UTC; represented using the RFC-3339 standard) at which the upgrade run was last updated.","example":"2026-03-30T14:45:00Z","format":"date-time","type":"string"},"name":{"description":"The name of the upgrade run.","example":"upgrade-run-01","type":"string"},"percentageComplete":{"description":"Percentage completion of the current step (0.0 to 1.0). Null when there is no active progress tracking.","example":0.5,"format":"double","nullable":true,"type":"number"},"secureClientVersion":{"description":"The Secure Client version being upgraded to.","example":"5.1.15.287","type":"string"},"submissionTime":{"description":"Time (UTC; represented using the RFC-3339 standard) at which the upgrade run was submitted.","example":"2026-03-30T14:30:00Z","format":"date-time","type":"string"},"transactionUid":{"description":"The unique identifier, represented as a UUID, of the CDO transaction that tracks this upgrade run.","example":"7131daad-e813-4b8f-8f42-be1e241e8cdb","format":"uuid","type":"string"},"uid":{"description":"The unique identifier, represented as a UUID, of the upgrade run.","example":"d4e5f6a7-8901-2345-bcde-f12345678901","format":"uuid","type":"string"},"upgradeRunStatus":{"description":"The current status of the upgrade run. One of: CHECKING_ASA_DEVICES_DNS, CHECKING_ASA_DEVICES_DNS_RESULTS, UPLOADING_IMAGES, CHECKING_IMAGES_UPLOAD_RESULTS, REGISTERING_NEW_RA_VPN_IMAGES, CHECKING_REGISTER_NEW_RA_VPN_IMAGES_RESULTS, UNREGISTERING_OLD_RA_VPN_IMAGES, CHECKING_UNREGISTER_OLD_RA_VPN_IMAGES_RESULTS, WRITING_CHANGES_TO_MEMORY, CHECKING_WRITE_CHANGES_TO_MEMORY_RESULTS, DELETING_OLD_IMAGES, DONE, DONE_WITH_DEVICE_WARNINGS, DONE_WITH_DEVICE_ERRORS, ERROR.","enum":["VALIDATING_INPUTS","FETCHING_CURRENTLY_INSTALLED_PACKAGES","CHECKING_ASA_DEVICES_DNS","CHECKING_ASA_DEVICES_DNS_RESULTS","VALIDATING_RA_VPN_SLOT_CONFLICTS","UPLOADING_IMAGES","CHECKING_IMAGES_UPLOAD_RESULTS","REGISTERING_NEW_RA_VPN_IMAGES","CHECKING_REGISTER_NEW_RA_VPN_IMAGES_RESULTS","UNREGISTERING_OLD_RA_VPN_IMAGES","CHECKING_UNREGISTER_OLD_RA_VPN_IMAGES_RESULTS","WRITING_CHANGES_TO_MEMORY","CHECKING_WRITE_CHANGES_TO_MEMORY_RESULTS","DELETING_OLD_IMAGES","DONE","DONE_WITH_DEVICE_WARNINGS","DONE_WITH_DEVICE_ERRORS","ERROR"],"example":"DONE","type":"string"},"upgradeRunType":{"description":"The type of the Secure Client upgrade. One of: ASA_SECURE_CLIENT_UPGRADE, FTD_SECURE_CLIENT_UPGRADE.","enum":["ASA_SECURE_CLIENT_UPGRADE","FTD_SECURE_CLIENT_UPGRADE"],"example":"ASA_SECURE_CLIENT_UPGRADE","type":"string"},"username":{"description":"Username of the user who initiated the upgrade run.","example":"alice@example.com","type":"string"}},"type":"object","$$ref":"#/components/schemas/SecureClientUpgradeRunDto"}}},"description":"The Secure Client Upgrade Run object"},"400":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Invalid input provided. Check the response for details.","$$ref":"#/components/responses/http400BadRequest"},"401":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"A human-readable error description in English.","example":"invalid_token","type":"string"},"errorDescription":{"description":"A human-readable error description in English.","example":"Your token is invalid","type":"string"}},"type":"object","$$ref":"#/components/schemas/AuthenticationError"}}},"description":"Request not authorized.","$$ref":"#/components/responses/http401Unauthorised"},"403":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"User does not have sufficient privileges to perform this operation.","$$ref":"#/components/responses/http403Forbidden"},"404":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Entity not found.","$$ref":"#/components/responses/http404NotFound"},"405":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Method not allowed.","$$ref":"#/components/responses/http405MethodNotAllowed"},"500":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Internal server error."}},"security":[{"bearerAuth":[]}],"summary":"Get Secure Client Upgrade Run","tags":["Secure Client Management"],"x-beta":"true","__originalOperationId":"getSecureClientUpgradeRun","method":"get","path":"/v1/inventory/devices/secure-client/upgrades/runs/{upgradeRunUid}"}}