Get Device Deployment Runs - Security Cloud Control Firewall Manager API Documentation

{"type":"api","title":"Get Device Deployment Runs","meta":{"id":"/apps/pubhub/media/cdo-api-documentation/ae661ad98eb9d16b215978ec6279c70f88560a3e/9b0e4c9a-48cb-3530-a00a-1f32fbf2438c","info":{"title":"Cisco Security Cloud Control Firewall Manager API","version":"1.20.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"}],"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"spec":{"description":"Get a list of device deployment runs in the SCC Firewall Manager Tenant. Each deployment run represents a group of devices being deployed together.","operationId":"getDeviceDeploymentRuns","parameters":[{"description":"Number of results to retrieve.","in":"query","name":"limit","required":false,"schema":{"maximum":200,"minimum":0,"type":"string"}},{"description":"Offset of the results retrieved. The Security Cloud Control APIs use the offset field to determine the index of the first result retrieved, and will retrieve `limit` results from the offset specified.","in":"query","name":"offset","required":false,"schema":{"minimum":0,"type":"string"}},{"description":"The query to execute. Use the Lucene Query Syntax to construct your query.","example":"fieldName:fieldValue","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"The fields to sort results by.","example":"name:DESC","in":"query","name":"sort","required":false,"schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"description":"The total number of results available.","example":100,"format":"int32","type":"integer"},"items":{"description":"The list of items retrieved.","items":{"properties":{"deployerUsername":{"description":"The name of the user performing the deploy.","example":"john.doe@example.com","type":"string"},"deploymentRunStatus":{"description":"The status of the deployment","enum":["PENDING","VALIDATING_DEVICES","DEPLOYING","DEPLOY_COMPLETED","DEPLOY_FAILED"],"example":"WAITING_FOR_DEPLOY","type":"string"},"deploymentType":{"description":"The type of the deployment","enum":["FTD_DEVICE_DEPLOY","ASA_DEVICE_DEPLOY"],"example":"ASA_DEVICE_DEPLOY","type":"string"},"description":{"description":"A human-readable description of this deployment.","example":"This is a test deployment.","type":"string"},"deviceDeploymentStatuses":{"description":"The current status of each device that is being deployed to as part of this deployment.","items":{"properties":{"completionStatus":{"description":"The completion status of the deployment on the device.","properties":{"completedAt":{"description":"Time (UTC; represented using the RFC-3339 standard) when this completion status became terminal. Null if still in progress.","example":"2026-04-15T18:00:10.123Z","format":"date-time","type":"string"},"message":{"description":"A message, indicating current progress, returned from the device.","type":"string"},"name":{"description":"The name of the device. Note: this will be the name of the node on the cdFMC if the device is part of an HA pair or cluster.","type":"string"},"nodeType":{"description":"(HA Pairs and clusters only) The node type of the device.","enum":["HA_PRIMARY","HA_SECONDARY","CLUSTER_CONTROL","CLUSTER_DATA"],"type":"string"},"percentageComplete":{"description":"The percentage completion of the current task being performed","format":"double","type":"number"}},"type":"object","$$ref":"#/components/schemas/CompletionStatusDto"},"errorDetails":{"description":"Detailed error information reported for this device during deployment.","items":{"properties":{"code":{"type":"string"},"description":{"type":"string"},"details":{"additionalProperties":{"type":"string"},"type":"object"},"severity":{"type":"string"}},"type":"object","$$ref":"#/components/schemas/ErrorDetails"},"type":"array"},"errorMsg":{"description":"A summary error message if the deployment failed for this device.","type":"string"},"name":{"description":"The name of the device in SCC Firewall Manager.","example":"My FTD","type":"string"},"status":{"description":"The overall status of the deployment on this device","enum":["IN_PROGRESS","DONE","ERROR","SKIPPED"],"type":"string"},"uid":{"description":"The unique identifier, represented as a UUID, of the device in SCC Firewall Manager.","example":"7131daad-e813-4b8f-8f42-be1e241e8cdb","format":"uuid","type":"string"}},"type":"object","$$ref":"#/components/schemas/DeviceDeploymentStatusDto"},"type":"array"},"deviceUids":{"description":"The set of device UIDs that are part of this deployment.","example":["7131daad-e813-4b8f-8f42-be1e241e8cdb","5141daad-e813-4b8f-8f42-be1e241e8cdb"],"items":{"format":"uuid","type":"string"},"type":"array","uniqueItems":true},"errorMsg":{"description":"Error message if the deployment failed.","example":"Timeout error","type":"string"},"failureReason":{"description":"The reason the deployment failed, if applicable.","enum":["VALIDATION_FAILED","WARNINGS_REJECTED","TRIGGER_ERROR","DEVICE_DEPLOY_FAILED"],"example":"WARNINGS_REJECTED","type":"string"},"ignoreWarnings":{"description":"Boolean indicating whether warnings identified by the deployment sub-system about this deployment were ignored.","type":"boolean"},"lastUpdatedTime":{"description":"Time (UTC; represented using the RFC-3339 standard) at which the deployment run was last updated.","example":"2023-12-13T08:15:44Z","format":"date-time","type":"string"},"name":{"description":"The name of the deployment run. Deployment runs names are unique in a tenant in SCC Firewall Manager.","example":"my-example-device","type":"string"},"submissionTime":{"description":"Time (UTC; represented using the RFC-3339 standard) at which the deployment run was triggered.","example":"2023-12-13T05:15:44Z","format":"date-time","type":"string"},"transactionUid":{"description":"The unique identifier of the CDO transaction that tracks this deployment.","example":"7131daad-e813-4b8f-8f42-be1e241e8cdb","format":"uuid","type":"string"},"uid":{"description":"The unique identifier, represented as a UUID, of the deployment run in SCC Firewall Manager.","example":"7131daad-e813-4b8f-8f42-be1e241e8cdb","format":"uuid","type":"string"}},"type":"object","$$ref":"#/components/schemas/DeploymentRunDto"},"type":"array"},"limit":{"description":"The number of results retrieved.","example":50,"format":"int32","type":"integer"},"offset":{"description":"The offset of the results retrieved. The Security Cloud Control API uses the offset field to determine the index of the first result retrieved, and will retrieve `limit` results from the offset specified.","example":0,"format":"int32","type":"integer"}},"type":"object","$$ref":"#/components/schemas/DeploymentRunDtoPage"}}},"description":"List of Device Deployment Run objects"},"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"}},"$$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"}},"$$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"}},"$$ref":"#/components/schemas/CommonApiError"}}},"description":"User does not have sufficient privileges to perform this operation.","$$ref":"#/components/responses/http403Forbidden"},"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"}},"$$ref":"#/components/schemas/CommonApiError"}}},"description":"Internal server error."}},"security":[{"bearerAuth":[]}],"summary":"Get Device Deployment Runs","tags":["Device Deployments"],"__originalOperationId":"getDeviceDeploymentRuns","method":"get","path":"/v1/inventory/devices/deployments/runs"}}