openapi: 3.2.0
info:
title: Cisco Secure Firewall Deployment API
version: 1.13.0
contact:
name: Cisco Firepower TAC
email: ngfw-support@cisco.com
description: 'Operations tagged Deployment across 2 of this provider''s published API definitions: cdfmc-openapi.yaml, cisco-secure-firewall-cdfmc-openapi.yml.
Each path carries the servers of the definition it was published in.'
x-provenance:
method: harvested
first_party: true
harvested: '2026-08-19'
source: https://raw.githubusercontent.com/CiscoDevNet/scc-public-api-docs/main/cdo/cdfmc-openapi.yaml
source_repo: https://github.com/CiscoDevNet/scc-public-api-docs
note: Verbatim first-party OpenAPI published by Cisco in the CiscoDevNet scc-public-api-docs repository, the source of
record for developer.cisco.com/docs/cisco-security-cloud-control-firewall-manager/. Not authored or modified by API
Evangelist.
derived_view: Per-tag view of cisco-secure-firewall-cdfmc-openapi.yml, the provider's source document. Operations and
schemas are the provider's, unmodified; only the partition is ours.
derived_from: cisco-secure-firewall-cdfmc-openapi.yml
operation_coverage: 11/11
x-evidence:
fetched: '2026-08-19'
url: https://raw.githubusercontent.com/CiscoDevNet/scc-public-api-docs/main/cdo/cdfmc-openapi.yaml
http_status: 200
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
tags:
- name: Deployment
paths:
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/deployabledevices:
get:
deprecated: false
description: '**Get a list of all devices with configuration changes which are ready to be deployed.**'
operationId: getDeployableDevice
parameters:
- description: Boolean indicating whether the policies ready to deploy have group dependencies. Group dependency value
helps to add dependent policies in Selective Policy Deployment. Results will be shown only when expanded is set
to true. It may affect the performance of the API.
in: query
name: groupDependency
required: false
schema:
type: boolean
- description: 'Boolean value indicating whether to return a list of devices with universal zero trust setting enabled. '
in: query
name: uZTNADevicesOnly
required: false
schema:
type: boolean
- description: Boolean value indicating whether to return a list of devices with universal zero trust settings which
are out of date.
in: query
name: uZTNAConfigOnly
required: false
schema:
type: boolean
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
- $ref: '#/components/parameters/offset'
name: offset
- $ref: '#/components/parameters/limit'
name: limit
- $ref: '#/components/parameters/expanded'
name: expanded
responses:
'200':
content:
application/json:
examples:
? 'Example 1 : GET /fmc_config/v1/domain/DomainUUID/deployment/deployabledevices ( Get all paginated DeployableDevice
instances with group dependency is false. )'
: value:
items:
- canBeDeployed: true
device:
id: ec6fcb5e-d891-11ea-9600-f0f82ba3e0ab
keepLocalEvents: false
name: 10.10.6.71
type: SENSOR
deviceMembers:
- id: ec6fcb5e-d891-11ea-9600-f0f82ba3e0ab
keepLocalEvents: false
name: 10.10.6.71
type: SENSOR
domain:
id: e276abec-e0f2-11e3-8169-6d9ed49b625f
name: Global
type: Domain
uuid: e276abec-e0f2-11e3-8169-6d9ed49b625f
isDeploying: true
message: Cannot perform deployment to the device, as another deployment is in progress for the device.
name: 10.10.6.71
policyStatusList:
- policy:
id: 0050568A-CF43-0ed3-0000-025769804572
type: PG.RA.PkiPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-017179869404
type: PG.PLATFORM.PixInterface
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-017179869872
type: PG.PLATFORM.NgfwVirtualRouterPage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-ADDB-0ed3-0000-042949673276
type: PG.PLATFORM.NgfwInlineSetPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825348030.0
userName: restadmin
- lastModifiedTime: 1597825448031.0
userName: admin
policy:
id: 0050568A-ADDB-0ed3-0000-008589934595
name: AC
type: PG.FIREWALL.NGFWAccessControlPolicy
referredPolicyList:
- policy:
id: 23ccacf2-d950-11ea-86ff-e9faf973fe30
name: IPS
type: IntrusionPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597640332.0
- policy:
id: d6aea7e0-d94f-11ea-86ff-e9faf973fe30
name: File
type: FilePolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597640332.0
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825448031.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825490063.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-025769804386
name: Platform
type: PG.PLATFORM.NgfwPFSettings
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825490063.0
- policy:
id: 0050568A-CF43-0ed3-0000-309237645506
type: PG.PLATFORM.AsaBGPPage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-309237645534
type: PG.PLATFORM.PixDhcpdPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825616301.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-309237645554
type: PG.PLATFORM.PixRipPix72Page
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825616301.0
- policy:
id: 9f97b5ac-d892-11ea-9e54-cf1b2ca3e0ab
name: 10.10.6.71
type: NGFWPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597825640.0
- policy:
id: deviceConfigurationId
type: DeviceConfiguration
referredPolicyList:
- policy:
id: 0050568A-CF43-0ed3-0000-017179869404
type: PG.PLATFORM.PixInterface
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-017179869900
type: PG.PLATFORM.NgfwInlineSetPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-309237645534
type: PG.PLATFORM.PixDhcpdPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- policy:
id: 9f97b5ac-d892-11ea-9e54-cf1b2ca3e0ab
name: 10.10.6.71
type: NGFWPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597825640.0
trafficInterrupting: false
upToDate: false
versionTimeStamp: 0
trafficInterruption: 'NO'
type: DeployableDevice
upToDate: false
version: '1597825642070'
links:
self: https://10.76.157.35:13006/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/deployabledevices?offset=0&limit=1&groupDependency=true&expanded=true
paging:
count: 1
limit: 1
offset: 0
pages: 1
? 'Example 2 : GET /fmc_config/v1/domain/DomainUUID/deployment/deployabledevices ( Get all paginated DeployableDevice
instances with group dependency is true. )'
: value:
items:
- canBeDeployed: true
device:
id: ec6fcb5e-d891-11ea-9600-f0f82ba3e0ab
keepLocalEvents: false
name: 10.10.6.71
type: SENSOR
deviceMembers:
- id: ec6fcb5e-d891-11ea-9600-f0f82ba3e0ab
keepLocalEvents: false
name: 10.10.6.71
type: SENSOR
domain:
id: e276abec-e0f2-11e3-8169-6d9ed49b625f
name: Global
type: Domain
uuid: e276abec-e0f2-11e3-8169-6d9ed49b625f
groupDependencyDetails:
dependentPolicyList:
- dependencyReason: You must always deploy policies with global object changes.
dependentTypeList:
- PG.FIREWALL.NGFWAccessControlPolicy
- SSLPolicy
- dependencyReason: Deploy these out-of-date policies together. Interdependent changes found in policies.
dependentTypeList:
- SSLPolicy
- PG.FIREWALL.NGFWAccessControlPolicy
- dependencyReason: Routing Group policies should be deployed together
dependentTypeList:
- PG.PLATFORM.PixRipPix72Page
- PG.PLATFORM.PixOSPFPage
mandatoryDeployablePolicies:
- PG.FIREWALL.NGFWAccessControlPolicy
- SSLPolicy
- PG.PLATFORM.NgfwInlineSetPage
- PG.PLATFORM.NgfwPFSettings
selectivelyDeployablePolicies:
- PG.PLATFORM.PixRipPix72Page
- PG.PLATFORM.PixOSPFPage
- PG.PLATFORM.ManualNat64Rule
isDeploying: false
name: 10.10.6.71
policyStatusList:
- policy:
id: 0050568A-CF43-0ed3-0000-025769804572
type: PG.RA.PkiPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-017179869404
type: PG.PLATFORM.PixInterface
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-017179869872
type: PG.PLATFORM.NgfwVirtualRouterPage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-017179869900
type: PG.PLATFORM.NgfwInlineSetPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825348030.0
userName: restadmin
- lastModifiedTime: 1597825448031.0
userName: admin
policy:
id: 0050568A-ADDB-0ed3-0000-008589934595
name: AC
type: PG.FIREWALL.NGFWAccessControlPolicy
referredPolicyList:
- policy:
id: 23ccacf2-d950-11ea-86ff-e9faf973fe30
name: IPS
type: IntrusionPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597640332.0
- policy:
id: 64c07d0e-d88f-11ea-a923-966839a3df85
type: NetworkDiscovery
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810833.0
- policy:
id: d6aea7e0-d94f-11ea-86ff-e9faf973fe30
name: File
type: FilePolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597640332.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825446.0
userName: System
policy:
id: dd627c6a-d94f-11ea-86ff-e9faf973fe30
name: SSL
type: SSLPolicy
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825446.0
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825448031.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825468136.0
userName: admin
policy:
id: 0050568A-CF43-0ed3-0000-025769804290
name: NAT
type: PG.PLATFORM.ManualNat64Rule
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825468136.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825490063.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-025769804386
name: Platform
type: PG.PLATFORM.NgfwPFSettings
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825490063.0
- policy:
id: 0050568A-CF43-0ed3-0000-309237645506
type: PG.PLATFORM.AsaBGPPage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-309237645514
type: PG.PLATFORM.PixStaticRouteTablePage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- policy:
id: 0050568A-CF43-0ed3-0000-309237645518
type: PG.PLATFORM.PixMBoundaryPage
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825600655.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-309237645530
type: PG.PLATFORM.PixOSPFPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825600655.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825616301.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-309237645554
type: PG.PLATFORM.PixRipPix72Page
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825616301.0
- policy:
id: 9f97b5ac-d892-11ea-9e54-cf1b2ca3e0ab
name: 10.10.6.71
type: NGFWPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597825640.0
- policy:
id: deviceConfigurationId
type: DeviceConfiguration
referredPolicyList:
- policy:
id: 0050568A-CF43-0ed3-0000-017179869404
type: PG.PLATFORM.PixInterface
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597810841104.0
- modifiedUserInfoList:
- lastModifiedTime: 1597825642070.0
userName: System
policy:
id: 0050568A-CF43-0ed3-0000-017179869900
type: PG.PLATFORM.NgfwInlineSetPage
trafficInterrupting: false
upToDate: false
versionTimeStamp: 1597825642070.0
- policy:
id: 9f97b5ac-d892-11ea-9e54-cf1b2ca3e0ab
name: 10.10.6.71
type: NGFWPolicy
trafficInterrupting: false
upToDate: true
versionTimeStamp: 1597825640.0
trafficInterrupting: false
upToDate: false
versionTimeStamp: 0
trafficInterruption: 'NO'
type: DeployableDevice
upToDate: false
version: '1597825642070'
links:
self: https://10.76.157.35:13006/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/deployabledevices?offset=0&limit=1&groupDependency=true&expanded=true
paging:
count: 1
limit: 1
offset: 0
pages: 1
schema:
$ref: '#/components/schemas/DeployableDeviceListContainer'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/deployabledevices/{containerUUID}/deployments:
get:
deprecated: false
description: '**Get deployment details for a device.**'
operationId: getDeploymentDetail
parameters:
- description: Selects time range for the deployment.
Value is of format startTime:start_time_in_secs;endTime:end_time_in_secs;.
startTime -- start time in unix format (in seconds). startTime and endTime should be specified
together.
endTime -- end time in unix format (in seconds). startTime and endTime should be specified
together.
in: query
name: filter
required: false
schema:
type: string
- description: The container id under which this specific resource is contained.
in: path
name: containerUUID
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
- $ref: '#/components/parameters/offset'
name: offset
- $ref: '#/components/parameters/limit'
name: limit
- $ref: '#/components/parameters/expanded'
name: expanded
responses:
'200':
content:
application/json:
examples:
? 'Example 1 : GET /fmc_config/v1/domain/DomainUUID/deployment/{containerUUID}/deploymentdetails ( Get all
paginated Deployment Detail instances. )'
: value:
items:
- endTime: 1592899423.0
name: cbv_job_2020-06-23 08:01:22.862
policyList:
- type: PG.FIREWALL.NGFWAccessControlPolicy
- type: IntrusionPolicy
startTime: 1592899282.0
status: SUCCEEDED
type: DeploymentDetail
uuid: 0050568B-B74A-0ed3-0000-330712481831
links:
self: https://10.76.157.67:16286/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/deployabledevices/d8c5ada2-a949-11ea-986f-83a5cef58c55/deployments?offset=0&limit=1&filter=startTime:1591683568537;endTime:1591683569038&expanded=false
paging:
count: 1
limit: 1
offset: 0
pages: 1
schema:
$ref: '#/components/schemas/DeploymentDetailListContainer'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/deployabledevices/{containerUUID}/pendingchanges:
get:
deprecated: false
description: '**Get all policy and object changes.**'
operationId: getPendingChanges
parameters:
- description: 'The filter criteria for which the details have to be fetched - Only works when "expanded" is set to
"true". Examples: ParentEntityTypes:AccessPolicy, EntityUUID:0050568C-35A0-0ed3-0000-004294969351.To fetch the historical
data pass the left and right job UUID. Example LeftJobUUID:4b9fe31c-34cc-11ea-8b36-8eb5492fc3a5;RightJobUUID:4b9fe31c-34cc-11ea-8b36-8eb5492fc3a3.For
filter based on User add a filter using key word UserList.Example: UserList : user1,user2.'
in: query
name: filter
required: false
schema:
type: string
- description: The container id under which this specific resource is contained.
in: path
name: containerUUID
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
- $ref: '#/components/parameters/offset'
name: offset
- $ref: '#/components/parameters/limit'
name: limit
- $ref: '#/components/parameters/expanded'
name: expanded
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/PendingChangesListContainer'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/deploymentrequests:
post:
deprecated: false
description: '**Create a request for deploying configuration changes to devices. _Check the response section for applicable
examples (if any)._**'
operationId: createDeploymentRequest
parameters:
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
requestBody:
content:
application/json:
examples:
'Example 1 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request. )':
value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
forceDeploy: false
ignoreWarning: true
type: DeploymentRequest
version: '1457566762351'
? 'Example 2 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request
for Selective Policy Deployment )'
: value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
forceDeploy: false
ignoreWarning: true
selectedPoliciesforDevices:
- deviceUUID: d94f7ada-d141-11e5-acf3-c41f7e67fb1b
selectedPolicies:
- PG.FIREWALL.NGFWAccessControlPolicy
- DNSPolicy
- SSLPolicy
type: DeploymentRequest
version: '1457566762351'
? 'Example 3 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request
for Full Deployment and Selective Policy Deployment )'
: value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
- 88a4b666-9372-11ea-babd-9ebaf536312a
forceDeploy: false
ignoreWarning: true
selectedPoliciesforDevices:
- deviceUUID: d94f7ada-d141-11e5-acf3-c41f7e67fb1b
selectedPolicies:
- PG.FIREWALL.NGFWAccessControlPolicy
- DNSPolicy
- SSLPolicy
type: DeploymentRequest
version: '1589689510428'
schema:
$ref: '#/components/schemas/DeploymentRequest'
type: object
description: The input representation of deployment request model.
required: true
responses:
'202':
content:
application/json:
examples:
'Example 1 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request. )':
value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
forceDeploy: false
ignoreWarning: true
metadata:
task:
id: '133143986189'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143986189
type: DeploymentRequest
version: '1457566762351'
? 'Example 2 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request
for Selective Policy Deployment )'
: value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
forceDeploy: false
ignoreWarning: true
metadata:
task:
id: '133143997176'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143997176
selectedPoliciesforDevices:
- deviceUUID: d94f7ada-d141-11e5-acf3-c41f7e67fb1b
selectedPolicies:
- PG.FIREWALL.NGFWAccessControlPolicy
- DNSPolicy
- SSLPolicy
type: DeploymentRequest
version: '1457566762351'
? 'Example 3 : POST /fmc_config/v1/domain/DomainUUID/deployment/deploymentrequests ( POST a deployment request
for Full Deployment and Selective Policy Deployment )'
: value:
deploymentNote: yournotescomehere
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
- 88a4b666-9372-11ea-babd-9ebaf536312a
forceDeploy: false
ignoreWarning: true
metadata:
task:
id: '133143996156'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143996156
selectedPoliciesforDevices:
- deviceUUID: d94f7ada-d141-11e5-acf3-c41f7e67fb1b
selectedPolicies:
- PG.FIREWALL.NGFWAccessControlPolicy
- DNSPolicy
- SSLPolicy
type: DeploymentRequest
version: '1589689510428'
schema:
$ref: '#/components/schemas/DeploymentRequest'
type: object
description: Accepted
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/jobhistories:
get:
deprecated: false
description: '**Gets all deployment jobs.**'
operationId: getAllJobHistory
parameters:
- description: Various filter criteria can be specified using the format deviceUUID:{uuid};startTime:start_time_in_secs;endTime:end_time_in_secs;rollbackApplicable:true_or_false;status:job_status;jobType:job_type.
startTime -- start time in unix format (in seconds). startTime and endTime should be specified
together.
endTime -- end time in unix format (in seconds). startTime and endTime should be
specified together.
rollbackApplicable -- true/false. Not a mandatory field.
status
-- {DEPLOYING, DEPLOYED, FAILED, ABORTED, EDIT_INUSE}. Not a mandatory field.
jobType -- {DEPLOYMENT,
ROLLBACK, CERTIFICATE}. Not a mandatory field.
in: query
name: filter
required: false
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
- $ref: '#/components/parameters/offset'
name: offset
- $ref: '#/components/parameters/limit'
name: limit
- $ref: '#/components/parameters/expanded'
name: expanded
responses:
'200':
content:
application/json:
examples:
'Example 1 : GET /fmc_config/v1/domain/DomainUUID/deployment/jobhistories ( GET All paginated Job Histories instances. )':
value:
items:
- deploymentNote: yournotescomehere
deviceList:
- deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.104
deviceUUID: d0c422c8-9756-11ea-acb6-961f407b1a9c
- containerName: vFTD-HA
containerUUID: 8c363564-518d-11eb-899b-e37ea1f51142
deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.100
deviceUUID: a6b42c18-50c8-11eb-8556-880cc814430c
- deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.102
deviceUUID: 73dee6c4-9756-11ea-b7d5-c46fa36556b5
endTime: '2020-05-16T10:30:26Z'
id: 0050568B-9937-0ed3-0000-463856468766
jobName: Deploy_Job_6
jobStatus: Deployed
jobType: DEPLOYMENT
startTime: '2020-05-16T10:29:01Z'
type: JobHistory
user: admin
- deploymentNote: yournotescomehere
endTime: '2020-05-16T10:16:56Z'
id: 0050568B-AFA9-0ed3-0000-017179869494
jobName: Deploy_Job_5
jobStatus: DEPLOYED
jobType: UNKNOWN
startTime: '2020-05-16T10:15:19Z'
type: JobHistory
user: System
- deploymentNote: yournotescomehere
deviceList:
- deployedVersion: -1
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.104
deviceUUID: d0c422c8-9756-11ea-acb6-961f407b1a9c
endTime: '2020-05-16T10:10:45Z'
id: 0050568B-9937-0ed3-0000-463856468569
jobName: Deploy_Job_4
jobStatus: Deployed
jobType: ROLLBACK
startTime: '2020-05-16T10:09:10Z'
type: JobHistory
user: System
- deploymentNote: yournotescomehere
deviceList:
- deployedVersion: 1
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.102
deviceUUID: 73dee6c4-9756-11ea-b7d5-c46fa36556b5
endTime: '2020-05-16T10:06:28Z'
id: 0050568B-9937-0ed3-0000-463856468258
jobName: Deploy_Job_3
jobStatus: Deployed
jobType: DEPLOYMENT
startTime: '2020-05-16T10:04:22Z'
type: JobHistory
user: System
links:
self: https://example.cisco.com/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/jobhistories?offset=0&limit=41&expanded=true
paging:
count: 3
limit: 3
offset: 0
pages: 1
? 'Example 2 : GET /fmc_config/v1/domain/DomainUUID/deployment/jobhistories ( GET ALL paginated Job Histories
instances with canRollback response where filter param rollbackApplicable is set as true. )'
: value:
items:
- deviceList:
- canRollback: false
deviceName: 10.10.18.28
deviceUUID: 9b1a4496-f191-11ea-a46b-dbe601ec8233
- canRollback: true
deviceName: 10.10.18.11
deviceUUID: 6bc51b26-401f-11eb-8a50-866b03f66226
- canRollback: true
deviceName: 10.10.18.12
deviceUUID: 4f1e003c-401f-11eb-9c14-d0c01de8132e
id: 0050568A-6DDA-0ed3-0000-012884903748
jobName: Deploy_Job_4
jobType: DEPLOYMENT
type: JobHistory
- deviceList:
- canRollback: false
deviceName: 10.10.18.28
deviceUUID: 9b1a4496-f191-11ea-a46b-dbe601ec8233
id: 0050568A-6DDA-0ed3-0000-012884903564
jobName: Deploy_Job_3
jobType: DEPLOYMENT
type: JobHistory
- deviceList:
- canRollback: true
deviceName: 10.10.18.12
deviceUUID: 4f1e003c-401f-11eb-9c14-d0c01de8132e
id: 0050568A-6DDA-0ed3-0000-012884903413
jobName: Deploy_Job_2
jobType: DEPLOYMENT
type: JobHistory
- deviceList:
- canRollback: true
deviceName: 10.10.18.11
deviceUUID: 6bc51b26-401f-11eb-8a50-866b03f66226
id: 0050568A-6DDA-0ed3-0000-012884902592
jobName: Deploy_Job_1
jobType: DEPLOYMENT
type: JobHistory
links:
self: https://example.cisco.com/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/jobhistories?filter=rollbackApplicable%3Atrue&offset=0&limit=1000&expanded=true
paging:
count: 4
limit: 4
offset: 0
pages: 1
schema:
$ref: '#/components/schemas/JobHistoryListContainer'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/jobhistories/{containerUUID}/operational/downloadreports:
get:
deprecated: false
description: '**Get the deployment job report for download.**'
operationId: getDownloadReport
parameters:
- description: The container id under which this specific resource is contained.
in: path
name: containerUUID
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
- $ref: '#/components/parameters/offset'
name: offset
- $ref: '#/components/parameters/limit'
name: limit
- $ref: '#/components/parameters/expanded'
name: expanded
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/DownloadReportListContainer'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/jobhistories/{containerUUID}/operational/emailreports:
post:
deprecated: false
description: '**Email the deployment job report. _Check the response section for applicable examples (if any)._**'
operationId: createEmailReport
parameters:
- description: The container id under which this specific resource is contained.
in: path
name: containerUUID
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
requestBody:
content:
application/json:
examples:
? 'Example 1 : POST /fmc_config/v1/domain/DomainUUID/deployment/jobhistories/{containerUUID}/operational/emailreports
( POST download report request. )'
: value:
recipientList:
- mail1@cisco.com
- mail2@cisco.com
schema:
$ref: '#/components/schemas/EmailReport'
type: object
description: The input representation of email report model.
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/EmailReport'
type: object
description: Created
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/jobhistories/{objectId}:
get:
deprecated: false
description: '**Get the specified deployment job.**'
operationId: getJobHistory
parameters:
- description: UUID of the deployment job.
in: path
name: objectId
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
responses:
'200':
content:
application/json:
examples:
'Example 1 : GET /fmc_config/v1/domain/DomainUUID/deployment/jobhistories/{jobId} ( Get details of a job. )':
value:
deploymentNote: yournotescomehere
deviceList:
- deployedVersion: 10
deploymentStatus: SUCCEEDED
deviceName: Device-2
deviceUUID: 1535479e-c2f2-11eb-bbbb-ef2177cd37aa
- deployedVersion: 10
deploymentStatus: SUCCEEDED
deviceName: Device-1
deviceUUID: 00e629d4-c2f2-11eb-b348-810d8547fb4e
endTime: '2021-06-02T10:01:25Z'
id: 0050568A-9521-0ed3-0000-012884902671
jobName: Scheduled_Deploy_Job_10
jobStatus: DEPLOYED
jobType: DEPLOYMENT
links:
self: https://example.cisco.com/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/jobhistories/0050568A-9521-0ed3-0000-012884902671
startTime: '2021-06-02T10:00:05Z'
type: JobHistory
user: System
schema:
$ref: '#/components/schemas/JobHistory'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
put:
deprecated: false
description: '**Modify the specified deployment job. _Check the response section for applicable examples (if any)._**'
operationId: updateJobHistory
parameters:
- description: UUID of the deployment job.
in: path
name: objectId
required: true
schema:
type: string
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
requestBody:
content:
application/json:
examples:
'Example 1 : PUT /fmc_config/v1/domain/DomainUUID/deployment/jobhistories/{jobId} ( Update job note for a job. )':
value:
deploymentNote: Updated note
id: 0050568B-9937-0ed3-0000-463856468766
type: JobHistory
schema:
$ref: '#/components/schemas/JobHistory'
type: object
description: The input representation of Job History model.
required: true
responses:
'200':
content:
application/json:
examples:
'Example 1 : PUT /fmc_config/v1/domain/DomainUUID/deployment/jobhistories/{jobId} ( Update job note for a job. )':
value:
items:
- deploymentNote: Updated note
deviceList:
- deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.104
deviceUUID: d0c422c8-9756-11ea-acb6-961f407b1a9c
- containerName: vFTD-HA
containerUUID: 8c363564-518d-11eb-899b-e37ea1f51142
deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.100
deviceUUID: a6b42c18-50c8-11eb-8556-880cc814430c
- deployedVersion: 2
deploymentStatus: SUCCEEDED
deviceName: 10.10.6.102
deviceUUID: 73dee6c4-9756-11ea-b7d5-c46fa36556b5
endTime: '2020-05-16T10:30:26Z'
id: 0050568B-9937-0ed3-0000-463856468766
jobName: Deploy_Job_6
jobStatus: Deployed
jobType: DEPLOYMENT
startTime: '2020-05-16T10:29:01Z'
type: JobHistory
user: admin
links:
self: https://example.cisco.com/api/fmc_config/v1/domain/e276abec-e0f2-11e3-8169-6d9ed49b625f/deployment/jobhistories/{0050568B-9937-0ed3-0000-463856468766}
paging:
count: 1
limit: 1
offset: 0
pages: 1
schema:
$ref: '#/components/schemas/JobHistory'
type: object
description: OK
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/pendingchangesrequests:
post:
deprecated: false
description: '**Create a request for generating pending policy changes or pending CLI changes or both on devices. _Check
the response section for applicable examples (if any)._**'
operationId: createPendingChangesRequest
parameters:
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
requestBody:
content:
application/json:
examples:
? 'Example 1 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST a
pending changes request with request type as CLI_AND_POLICY_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
- 77bb6cd0-f613-11ed-b040-ec1fd6f081d6
requestType: CLI_AND_POLICY_DIFF
? 'Example 2 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST a
pending changes request with request type as CLI_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
- 77bb6cd0-f613-11ed-b040-ec1fd6f081d6
requestType: CLI_DIFF
? 'Example 3 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST a
pending changes request with request type as POLICY_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
- 77bb6cd0-f613-11ed-b040-ec1fd6f081d6
requestType: POLICY_DIFF
schema:
$ref: '#/components/schemas/PendingChangesRequest'
type: object
description: The input representation of pending changes request model.
required: true
responses:
'202':
content:
application/json:
examples:
? 'Example 1 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST
a pending changes request with request type as CLI_AND_POLICY_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
metadata:
task:
description: Pending changes request task queued
id: '133143986189'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143986189
status: '200'
taskType: PENDING_CHANGES_REQUEST
requestType: CLI_AND_POLICY_DIFF
? 'Example 2 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST
a pending changes request with request type as CLI_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
metadata:
task:
description: Pending changes request task queued
id: '133143986189'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143986189
status: '200'
taskType: PENDING_CHANGES_REQUEST
requestType: CLI_DIFF
? 'Example 3 : POST /api/fmc_config/v1/domain/DomainUUID/deployment/pendingchangesrequests ( POST
a pending changes request with request type as POLICY_DIFF. )'
: value:
deviceList:
- d94f7ada-d141-11e5-acf3-c41f7e67fb1b
metadata:
task:
description: Pending changes request task queued
id: '133143986189'
links:
self: /api/fmc_config/v1/domain/DomainUUID/job/taskstatuses/133143986189
status: '200'
taskType: PENDING_CHANGES_REQUEST
requestType: POLICY_DIFF
schema:
$ref: '#/components/schemas/PendingChangesRequest'
type: object
description: Accepted
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
/v1/cdfmc/api/fmc_config/v1/domain/{domainUUID}/deployment/rollbackrequests:
post:
deprecated: false
description: '**Create a request for rollback configuration to devices. _Check the response section for applicable examples
(if any)._**'
operationId: createRollbackRequest
parameters:
- $ref: '#/components/parameters/domainUUID'
name: domainUUID
requestBody:
content:
application/json:
examples:
'Example 1 : POST /fmc_config/v1/domain/DomainUUID/deployment/rollbackrequests ( POST a rollback request. )':
value:
rollbackDeviceList:
- deploymentJobId: 0050568B-9937-0ed3-0000-296352743514
deviceList:
- d0c422c8-9756-11ea-acb6-961f407b1a9c
- 73dee6c4-9756-11ea-b7d5-c46fa36556b5
- deploymentJobId: 0050568B-9937-0ed3-0000-300647710810
deviceList:
- 88a4b666-9372-11ea-babd-9ebaf536312a
type: RollbackRequest
schema:
$ref: '#/components/schemas/RollbackRequest'
type: object
description: The input representation of rollback request model.
required: true
responses:
'201':
content:
application/json:
schema:
$ref: '#/components/schemas/RollbackRequest'
type: object
description: Created
default:
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
type: object
description: Error
tags:
- Deployment
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.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://manage.stg.secure.cisco/api/rest
description: Stgf9
components:
schemas:
IGroupDependencyDetailEntry:
description: Represents the dependency information between out-of-date policies
properties:
dependentPolicyList:
description: Describes the dependency between the out-of-date policies with the reason
items:
$ref: '#/components/schemas/IDependentPolicy'
type: object
type: array
mandatoryDeployablePolicies:
description: List of out-of-date policies which must get deployed always in the upcoming deployment. These policies
will get added into the deployment by default.
items:
type: string
type: array
selectivelyDeployablePolicies:
description: List of out-of-date policies which can be selectively deployed.
items:
type: string
type: array
type: object
IDeviceGroup:
properties:
description:
type: string
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
members:
items:
$ref: '#/components/schemas/IBaseDevice'
type: object
type: array
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
type: string
type:
type: string
version:
type: string
type: object
IValueDelete:
properties:
fieldName:
type: string
oldValue:
type: string
type: object
Domain:
description: The details about the domain.
properties:
id:
description: Unique UUID of this domain
type: string
links:
$ref: '#/components/schemas/ILinks'
description: Links to the domain resource URLs.
type: object
name:
description: Name of the domain.
type: string
type:
description: Domain type definition (fixed).
type: string
uuid:
type: string
type: object
PendingChangesRequestMetadata:
properties:
deployInProgressSkippedDeviceList:
items:
type: string
type: array
domain:
$ref: '#/components/schemas/Domain'
type: object
downloadUrl:
type: string
failedDeviceList:
items:
type: string
type: array
isLocked:
type: boolean
lastUser:
$ref: '#/components/schemas/MetadataUser'
type: object
matches:
items:
type: string
type: array
readOnly:
$ref: '#/components/schemas/ReadOnly'
type: object
task:
$ref: '#/components/schemas/ITaskStatus'
type: object
taskInProgressSkippedDeviceList:
items:
type: string
type: array
timestamp:
format: int32
type: integer
type: object
IReference:
description: Contains reference information.
properties:
id:
description: Unique identifier representing resource.
type: string
links:
$ref: '#/components/schemas/ILinks'
description: Object containing links to this resource.
type: object
name:
description: User chosen resource name.
type: string
type:
description: Response object associated with resource.
type: string
type: object
IAdvanced:
properties:
enableOGS:
type: boolean
type: object
IReadonly:
properties:
reason:
enum:
- RBAC
- SYSTEM
- DOMAIN
type: string
state:
type: boolean
type: object
ITaskStatus:
properties:
description:
type: string
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
message:
type: string
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
type: string
status:
type: string
subTasks:
items:
$ref: '#/components/schemas/ISubTask'
type: object
type: array
taskType:
enum:
- DEVICE_REGISTRATION
- SMART_LICENSE
- DEVICE_DEPLOYMENT
- DEVICE_ROLLBACK
- NGFWHA_OPERATIONS
- COPY_CONFIG_REQUEST
- HIT_COUNT_REFRESH
- FTD_CLUSTER_BOOTSTRAP
- FTD_CLUSTER_CREATE
- FTD_CLUSTER_BREAK
- FTD_CLUSTER_ADD_NODES
- FTD_CLUSTER_REMOVE_NODES
- DEVICE_BACKUP
- FTD_CLUSTER_UPDATE_BOOTSTRAP
- FTD_CLUSTER_COMMAND
- SSP_EPM_OIR
- SSP_EPM_BREAKOUT_DEPLOY
- DEVICE_EXPORT
- DEVICE_IMPORT
- POLICY_EXPORT
- CHASSIS_REGISTRATION
- CHANGE_MANAGER
- CONFIGURE_DEVICE_VALIDATE
- CONFIGURE_DEVICE
- CONFIGURE_MANAGER
- CONFIGURE_MANAGER_ADD
- CONFIGURE_MANAGER_DELETE
- INITIATE_MIGRATION
- DISCARD_MIGRATION
- SWITCH_TO_ANALYTICS
- DELETE_DEVICE
- GENERATE_REPORTS
- FLEXCONFIG_MIGRATION
- DEVICE_UNREGISTRATION
- PENDING_CHANGES_REQUEST
- DEVICE_TROUBLESHOOT
- DEVICE_MODEL_MIGRATION
- DEVICE_TEMPLATE_CREATION
- CHASSIS_CONVERSION_REQUEST
- SNORT_PROFILER
- CPU_PROFILER
- POLICY_REPORT_GENERATION
- DEVICE_TEMPLATE_APPLY
- LTP_ONBOARDING
- POLICY_CLONE_OPERATION
- DEVICE_CERTIFICATE_MANAGEMENT
- OOB_CHANGES_REQUEST
- UPLOAD_TROUBLESHOOT
type: string
type:
type: string
type: object
RollbackRequest:
description: Represents the rollback request object which will be used for config rollback of a device.
properties:
metadata:
$ref: '#/components/schemas/RollbackRequestMetadata'
description: Object representing metadata attributes for the rollback request entry.
type: object
rollbackDeviceList:
description: A list containing job UUID and device UUIDs combination for the rollback.
items:
$ref: '#/components/schemas/IRollbackDeviceListEntry'
type: object
type: array
type:
description: Type must be RollbackRequest.
type: string
type: object
ITarget:
description: This is the target device.
properties:
description:
type: string
id:
description: Unique ID of the device.
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
description: Name of the device.
type: string
type:
description: Device
type: string
version:
type: string
type: object
MetadataUser:
description: This object defines details about the user.
properties:
id:
description: The unique UUID of the user
type: string
links:
$ref: '#/components/schemas/ILinks'
description: Contains the self referencing links to this resource
type: object
name:
description: Name of the user.
type: string
type:
description: The user type (fixed).
type: string
type: object
JobHistoryListContainer:
properties:
items:
$ref: '#/components/schemas/JobHistory'
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
paging:
$ref: '#/components/schemas/PagingContainer'
type: object
type: object
DeploymentRequest:
description: Represents the deployment request object which will be used for policy deployment of a device.
properties:
deploymentNote:
description: User provided job note with max of 512 characters
type: string
description:
description: User provided description of the object.
type: string
deviceList:
description: List of device UUIDs for which the deployment has to triggered.
items:
type: string
type: array
failedDevicesList:
items:
$ref: '#/components/schemas/FailedDevices'
type: object
type: array
forceDeploy:
description: Boolean indicating the deployment is force deploy or not. Value set to `true` only if device is not
out-of-date and user wants to force a deployment. This should not be used unless needed. Default is `false`.
type: boolean
id:
description: Id created as part of the deployment.
type: string
ignoreWarning:
description: Boolean indicating whether the warnings needs to be ignored during the prevalidation of deployment
job. Default is `false`.
type: boolean
links:
$ref: '#/components/schemas/ILinks'
description: Link to the deployment request with the job id.
type: object
metadata:
$ref: '#/components/schemas/DeploymentRequestMetadata'
type: object
name:
description: String represents the name to the device.
type: string
recipients:
type: string
selectedPoliciesforDevices:
description: List of devices for Selective Policy Deployment. The devices mentioned here should be part of
the 'devicelist' attribute.
items:
$ref: '#/components/schemas/ISelectedPoliciesforDevices'
type: object
type: array
type:
description: Type of the Request object. This value is always DeploymentRequest.
type: string
version:
description: Integer indicating the version to which the deployment should be done.
type: string
type: object
IHybridZeroTrustDeviceSetting:
properties:
autoDeployEnabled:
type: boolean
domainSettings:
items:
$ref: '#/components/schemas/IHybridZeroTrustFQDNConfig'
type: object
type: array
universalZeroTrustEnabled:
type: boolean
type: object
IMetadataUser:
properties:
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
name:
type: string
type:
type: string
type: object
ErrorResponse:
properties:
category:
description: Describes the category of the error thrown.
enum:
- FRAMEWORK
- OTHER
- VALIDATION
type: string
messages:
description: List of error messages which the response has.
items:
$ref: '#/components/schemas/ErrorMessagesContainer'
type: object
type: array
severity:
description: Specifies the Highest level severity among all the error messages.
enum:
- ERROR
- WARN
type: string
type: object
LLUniversalZeroTrustSetting:
additionalProperties:
$ref: '#/components/schemas/IHybridZeroTrustDeviceSetting'
type: object
type: object
IPolicyStatus:
properties:
modifiedUserInfoList:
description: List of ModifiedUserInfo objects containing LastModifiedTime and UserName.
items:
$ref: '#/components/schemas/IModifiedUserInfo'
type: object
type: array
policy:
$ref: '#/components/schemas/IPolicyModel'
description: Object which contains Policy Information such as id, name and policy type.
type: object
referredPolicyList:
description: List of PolicyStatus objects which are referred by the policy.
items:
$ref: '#/components/schemas/IPolicyStatus'
type: object
type: array
trafficInterrupting:
description: Boolean indicating a deployment can cause traffic interruption.
type: boolean
upToDate:
description: Boolean indicating whether the policy is out-of-date.
type: boolean
versionTimeStamp:
description: Epoch time, indicating last modified time of the policy.
format: int32
type: integer
type: object
IDependentPolicy:
description: Represents the inter-dependent out-of-date policies with the reason.
properties:
dependencyReason:
description: Describes the reason for the inter-dependency between the out-of-date policies.
type: string
dependentTypeList:
description: List of out-of-date policies which are inter-dependent.
items:
type: string
type: array
type: object
DeploymentDetailListContainer:
properties:
items:
$ref: '#/components/schemas/DeploymentDetail'
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
paging:
$ref: '#/components/schemas/PagingContainer'
type: object
type: object
IModifiedUserInfo:
description: Modified User Information
properties:
lastModifiedTime:
description: Timestamp indicating the time when user has last modified the policy.
format: int32
type: integer
userName:
description: Name of the user.
type: string
type: object
IActionInfo:
type: object
ILinks:
description: This defines the self referencing links for the given resource.
properties:
parent:
description: Full resource URL path to reference the parent (if any) for this resource.
type: string
self:
description: Full resource URL path to reference this particular resource.
type: string
type: object
IDevice_2:
properties:
accessPolicy:
$ref: '#/components/schemas/IPolicyModel'
type: object
actions:
items:
$ref: '#/components/schemas/IPreDeployAction'
type: object
type: array
advanced:
$ref: '#/components/schemas/IAdvanced'
type: object
analyticsOnly:
type: boolean
changeManager:
type: boolean
cloudDeviceId:
type: string
deploymentStatus:
type: string
description:
type: string
deviceGroup:
$ref: '#/components/schemas/IDeviceGroup'
type: object
ftdMode:
enum:
- ROUTED
- TRANSPARENT
type: string
healthMessage:
type: string
healthPolicy:
$ref: '#/components/schemas/IHealthPolicy'
type: object
healthStatus:
type: string
hostName:
type: string
id:
type: string
isConnected:
type: boolean
isMCDManaged:
type: boolean
keepLocalEvents:
type: boolean
license_caps:
items:
type: string
type: array
licenseType:
enum:
- BYOL
- SAAS
- PAYG
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
managementState:
enum:
- MANAGED
- UNMANAGED
type: string
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
model:
type: string
modelId:
type: string
modelNumber:
type: string
modelType:
type: string
name:
type: string
natID:
type: string
performanceTier:
type: string
prohibitPacketTransfer:
type: boolean
regKey:
type: string
role:
type: string
secondaryHostname:
type: string
serialNumber:
type: string
skipDeployment:
type: boolean
snortEngine:
enum:
- SNORT2
- SNORT3
type: string
status:
type: string
sw_version:
type: string
type:
type: string
version:
type: string
required:
- hostName
- license_caps
- regKey
type: object
ISelectedPoliciesforDevices:
description: Represents the object which is responsible for enabling the Selective Policy Deployment
properties:
deviceUUID:
description: Corresponding device UUID for which the selection is mentioned.
type: string
selectedPolicies:
description: 'List of Policy Types which have to be selectively deployed. Note: mandatoryDeployablePolicies should
not be included in this list.'
items:
type: string
type: array
type: object
DialHost:
properties:
host:
type: string
port:
format: int32
type: integer
type: object
HealthThreshold:
properties:
type:
type: string
value:
format: int32
type: integer
type: object
IHybridZeroTrustFQDNConfig:
properties:
FQDN:
type: string
certificate:
$ref: '#/components/schemas/IReference'
type: object
interfaces:
items:
$ref: '#/components/schemas/IReference'
type: object
type: array
type: object
IReferenceUpdate:
properties:
entityName:
type: string
entityType:
type: string
fieldName:
type: string
type: object
EmailReport:
description: Email Job Report. Configure and test System->Configuration->Email Notification prior using this request
properties:
recipientList:
description: string array of recipient mailers
items:
type: string
type: array
type: object
PendingChangesListContainer:
properties:
items:
$ref: '#/components/schemas/PendingChanges'
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
paging:
$ref: '#/components/schemas/PagingContainer'
type: object
type: object
ISubTask:
properties:
description:
type: string
id:
type: string
message:
type: string
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
status:
type: string
target:
$ref: '#/components/schemas/ITarget'
type: object
type: object
PendingChanges:
description: Retrieves list changes between the last successful deployment and current saved configuration for the device,.
properties:
action:
description: Action done on the entity
enum:
- ADD
- DELETE
- UPDATE
- NOCHANGE
type: string
entityName:
description: 'A name field value of modified Entity. '
type: string
entityType:
description: An Entity type type that has been modified.
type: string
entityUUID:
description: ' An identifier of entity which does not change with time.'
type: string
lastUpdatedByUsers:
description: List of users who have modified the entity after last successful deployment.
items:
type: string
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
message:
description: In case for an entity there is no diff, due to no modification or some error during generation proper
message will be given for that entity.
type: string
parentUUID:
description: UUID of the entity to which this entity is grouped to. If it's empty, it means the entity is the parent
entity.
type: string
referencesAdded:
description: References that were added compared to its other state.
items:
$ref: '#/components/schemas/IReferenceUpdate'
type: object
type: array
referencesDeleted:
description: References that were deleted compared to its other state.
items:
$ref: '#/components/schemas/IReferenceUpdate'
type: object
type: array
valueAdded:
description: 'Values that were added compared to its other state. '
items:
$ref: '#/components/schemas/IValueAdd'
type: object
type: array
valueDeleted:
description: Values that were deleted compared to its other state.
items:
$ref: '#/components/schemas/IValueDelete'
type: object
type: array
valueUpdated:
description: 'Values that were specified compared to its other state. '
items:
$ref: '#/components/schemas/IValueUpdate'
type: object
type: array
version:
type: string
type: object
PagingContainer:
properties:
count:
format: int32
type: integer
limit:
format: int32
type: integer
offset:
format: int32
type: integer
pages:
format: int32
type: integer
type: object
JobHistory:
properties:
deploymentNote:
description: User provided job note
type: string
deviceList:
description: List of devices which have been part of the job.
items:
$ref: '#/components/schemas/IDeviceListEntry'
type: object
type: array
endTime:
description: Indicates the end time (in ISO 8601 format) of the deployment job.
type: string
id:
description: UUID of the deployment job.
type: string
jobName:
description: Name of the deployed job
type: string
jobStatus:
description: Represents the status of the job
enum:
- DEPLOYING
- DEPLOYED
- FAILED
- ABORTED
- EDIT_INUSE
type: string
jobType:
enum:
- DEPLOYMENT
- ROLLBACK
- CERTIFICATE
- UNKNOWN
type: string
startTime:
description: Indicates the start time (in ISO 8601 format) of the deployment job.
type: string
type:
description: Type must be JobHistory.
type: string
user:
description: Creator of the deployment task.
type: string
type: object
FailedDevices:
description: Represents the devices which got failed during the deployment of a devices.
properties:
deviceUUID:
description: UUID of device.
type: string
failureReason:
description: The reason for which device got failed.
type: string
type: object
IDeviceListEntry:
properties:
canRollback:
description: Indicates whether the deployed version to device in the deployment job is rollback capable. This field
is available only if context filter parameter has value as RollbackApplicable.
type: boolean
containerName:
description: Name of the container. This will still be displayed after deletion.
type: string
containerUUID:
description: UUID of the container
type: string
deployedVersion:
description: Config version of the device in the deployment job
format: int32
type: integer
deploymentStatus:
description: Deployment status of the device in the deployment job
enum:
- DEPLOYING
- SUCCEEDED
- PARTIALLY_SUCCEEDED
- FAILED
- SSP_SUCCEEDED
- SSP_FAILED
- SSP_PRIMARY_BOOTSTRAP_SUCCEEDED
- SSP_PRIMARY_BOOTSTRAP_FAILED
- SSP_SECONDARY_BOOTSTRAP_SUCCEEDED
- SSP_SECONDARY_BOOTSTRAP_FAILED
- PRIMARY_BOOTSTRAP_SUCCEEDED
- PRIMARY_BOOTSTRAP_FAILED
- SECONDARY_BOOTSTRAP_SUCCEEDED
- SECONDARY_BOOTSTRAP_FAILED
- BREAK_SUCCEEDED
- BREAK_FAILED
- PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SSP_PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SSP_SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- BREAK_PARTIALLY_SUCCEEDED
- CANCELLED
- NONE
type: string
deviceName:
description: Name of the device
type: string
deviceUUID:
description: UUID of the device
type: string
type: object
IMetadata:
properties:
domain:
$ref: '#/components/schemas/IDomain'
type: object
isLocked:
type: boolean
lastUser:
$ref: '#/components/schemas/IMetadataUser'
type: object
matches:
items:
type: string
type: array
readOnly:
$ref: '#/components/schemas/IReadonly'
type: object
timestamp:
format: int32
type: integer
type: object
DeploymentDetail:
description: An object representing the deployment details on a device
properties:
description:
type: string
endTime:
description: Time in seconds at which the deployment ended, timestamp is in unix format
format: int32
type: integer
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
description: 'Name of the deployment job '
type: string
policyList:
description: Details of policies which were deployed to the device.
items:
$ref: '#/components/schemas/IPolicyModel'
type: object
type: array
startTime:
description: Time in seconds at which the deployment was started, timestamp is in unix format
format: int32
type: integer
status:
description: 'Status of the deployment, can be one of DEPLOYING, SUCCEEDED, PARTIALLY_SUCCEEDED, FAILED, SSP_SUCCEEDED,
SSP_FAILED, SSP_PRIMARY_BOOTSTRAP_SUCCEEDED, SSP_PRIMARY_BOOTSTRAP_FAILED, SSP_SECONDARY_BOOTSTRAP_SUCCEEDED,
SSP_SECONDARY_BOOTSTRAP_FAILED, PRIMARY_BOOTSTRAP_SUCCEEDED, PRIMARY_BOOTSTRAP_FAILED, SECONDARY_BOOTSTRAP_SUCCEEDED,
SECONDARY_BOOTSTRAP_FAILED, BREAK_SUCCEEDED, BREAK_FAILED, PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED, SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED,
SSP_PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED, SSP_SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED, BREAK_PARTIALLY_SUCCEEDED,
CANCELLED and NONE '
enum:
- DEPLOYING
- SUCCEEDED
- PARTIALLY_SUCCEEDED
- FAILED
- SSP_SUCCEEDED
- SSP_FAILED
- SSP_PRIMARY_BOOTSTRAP_SUCCEEDED
- SSP_PRIMARY_BOOTSTRAP_FAILED
- SSP_SECONDARY_BOOTSTRAP_SUCCEEDED
- SSP_SECONDARY_BOOTSTRAP_FAILED
- PRIMARY_BOOTSTRAP_SUCCEEDED
- PRIMARY_BOOTSTRAP_FAILED
- SECONDARY_BOOTSTRAP_SUCCEEDED
- SECONDARY_BOOTSTRAP_FAILED
- BREAK_SUCCEEDED
- BREAK_FAILED
- PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SSP_PRIMARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- SSP_SECONDARY_BOOTSTRAP_PARTIALLY_SUCCEEDED
- BREAK_PARTIALLY_SUCCEEDED
- CANCELLED
- NONE
type: string
type:
type: string
version:
type: string
type: object
DeployableDevice:
description: Represents the Deployable Device Object.
properties:
canBeDeployed:
description: Boolean indicating whether the device can be deployed.
type: boolean
device:
$ref: '#/components/schemas/IDevice_2'
description: Object indicating the device object.
type: object
deviceMembers:
description: Describes the member information of the Device.
items:
$ref: '#/components/schemas/IDevice'
type: object
type: array
domain:
$ref: '#/components/schemas/IDomain'
description: Object indicating the domain information of the device.
type: object
groupDependencyDetails:
$ref: '#/components/schemas/IGroupDependencyDetailEntry'
type: object
id:
description: String indicating the id of the device.
type: string
isDeploying:
description: Boolean indicating whether the deployment operation for the device is in progress.
type: boolean
links:
$ref: '#/components/schemas/ILinks'
description: Object containing links to this resource.
type: object
message:
description: Describes the reason for not allowing the deployment for a device.
type: string
name:
description: String indicating the device name.
type: string
policyStatusList:
description: List of policy objects which are part of the device.
items:
$ref: '#/components/schemas/IPolicyStatus'
type: object
type: array
trafficInterruption:
description: Boolean indicating a deployment can cause traffic interruption.
enum:
- 'YES'
- 'NO'
- UNDETERMINED
- ERROR
type: string
type:
description: Type of the Response object. This value is always DeployableDevice.
type: string
upToDate:
description: Boolean indicating whether the device has any out-of-date policies.
type: boolean
version:
description: Integer, indicating the latest deployed version of the device.
type: string
type: object
IHealthPolicy:
description: Description of Health Policy.
properties:
basePolicyID:
type: string
defaultPolicy:
type: boolean
description:
description: Description of Health Policy.
type: string
healthModules:
items:
$ref: '#/components/schemas/HealthModule'
type: object
type: array
id:
description: Unique identifier (UUID) representing the Health policy.
type: string
links:
$ref: '#/components/schemas/ILinks'
description: Object containing links to this resource.
type: object
metadata:
$ref: '#/components/schemas/IMetadata'
description: Object representing metadata attributes for the Health policy.
type: object
name:
description: User-specified name of the Health policy.
type: string
policyType:
type: string
setting:
$ref: '#/components/schemas/HealthSetting'
type: object
type:
description: Type of the Health policy; this value is always HealthPolicy.
type: string
version:
description: Version number of the response object.
type: string
type: object
IDeviceInventoryData:
properties:
cpuCores:
type: string
cpuType:
type: string
memoryInMB:
type: string
storageInGB:
type: string
type: object
DownloadReport:
description: Download Job report
properties: {}
type: object
IValueUpdate:
properties:
fieldName:
type: string
newValue:
type: string
oldValue:
type: string
type: object
DeviceMetadata:
properties:
chassisData:
$ref: '#/components/schemas/DeviceChassisData'
description: This field holds information related to chassis.
type: object
chassisDetails:
$ref: '#/components/schemas/IDeviceChassisData'
type: object
clusterBootstrapSupported:
type: boolean
containerDetails:
$ref: '#/components/schemas/IBaseDevice'
description: If 'isPartOfContainer' field is true then this field will hold the information of container.
type: object
deviceSerialNumber:
type: string
domain:
$ref: '#/components/schemas/Domain'
description: Lists the domains to which this instance belongs if applicable.
type: object
dummyDevice:
type: boolean
inventoryData:
$ref: '#/components/schemas/DeviceInventoryData'
description: Inventory details of the device.
type: object
inventoryDetails:
$ref: '#/components/schemas/IDeviceInventoryData'
type: object
isDummyDevice:
type: boolean
isLocked:
type: boolean
isMultiInstance:
description: Indicated if the device is in multiinstance or native mode.
type: boolean
isPartOfContainer:
description: This field indicates whether it is part of any cluster. This will be true for a device which is part
of NGFWHA, NGFW cluster and firepower devices which is part of Stack.
type: boolean
isSnort3:
type: boolean
lastUser:
$ref: '#/components/schemas/MetadataUser'
description: The last user who modified this instance.
type: object
lspVersion:
type: string
matches:
items:
type: string
type: array
otherAssociatedPolicies:
description: assigned policies to device other than Access Policy
items:
$ref: '#/components/schemas/IReference'
type: object
type: array
readOnly:
$ref: '#/components/schemas/ReadOnly'
description: Details regarding the read only status of this instance.
type: object
snortVersion:
description: Snort version of a particular device.
type: string
sruVersion:
description: SRU version of a particular device.
type: string
task:
$ref: '#/components/schemas/ITaskStatus'
type: object
timestamp:
description: The last updated timestamp.
format: int32
type: integer
universalZeroTrustSetting:
$ref: '#/components/schemas/LLUniversalZeroTrustSetting'
type: object
universalZeroTrustSupported:
type: boolean
vdbVersion:
description: VDB version of a particular device.
type: string
required:
- otherAssociatedPolicies
type: object
HealthModule:
properties:
alertConfig:
items:
$ref: '#/components/schemas/HealthAlertConfig'
type: object
type: array
alertEnabled:
type: boolean
criticalThreshold:
format: int32
type: integer
customThresholds:
items:
$ref: '#/components/schemas/HealthThreshold'
type: object
type: array
enabled:
type: boolean
moduleId:
type: string
severity:
type: string
type:
type: string
warningThreshold:
format: int32
type: integer
type: object
HealthSetting:
properties:
alertEvaluationInterval:
format: int32
type: integer
certFileContent:
type: string
certFileName:
type: string
certFileType:
type: string
certPassphrase:
type: string
configType:
type: string
dataCollectionInterval:
format: int32
type: integer
dialInHosts:
items:
$ref: '#/components/schemas/DialHost'
type: object
type: array
dialOutHosts:
items:
$ref: '#/components/schemas/DialHost'
type: object
type: array
enabledOpenConfig:
type: boolean
grpcPassword:
type: string
grpcUsername:
type: string
readOnly:
type: boolean
type: object
IDevice:
properties:
accessPolicy:
$ref: '#/components/schemas/IPolicyModel'
type: object
actions:
items:
$ref: '#/components/schemas/IPreDeployAction'
type: object
type: array
advanced:
$ref: '#/components/schemas/IAdvanced'
type: object
analyticsOnly:
type: boolean
changeManager:
type: boolean
cloudDeviceId:
type: string
deploymentStatus:
type: string
description:
type: string
deviceGroup:
$ref: '#/components/schemas/IDeviceGroup'
type: object
ftdMode:
enum:
- ROUTED
- TRANSPARENT
type: string
healthMessage:
type: string
healthPolicy:
$ref: '#/components/schemas/IHealthPolicy'
type: object
healthStatus:
type: string
hostName:
type: string
id:
type: string
isAWSDevice:
type: boolean
isAzureDevice:
type: boolean
isConnected:
type: boolean
isMCDManaged:
type: boolean
keepLocalEvents:
type: boolean
license_caps:
items:
type: string
type: array
licenseType:
enum:
- BYOL
- SAAS
- PAYG
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
managementState:
enum:
- MANAGED
- UNMANAGED
type: string
metadata:
$ref: '#/components/schemas/DeviceMetadata'
type: object
model:
type: string
modelId:
type: string
modelNumber:
type: string
modelType:
type: string
name:
type: string
natID:
type: string
performanceTier:
type: string
prohibitPacketTransfer:
type: boolean
regKey:
type: string
role:
type: string
secondaryHostname:
type: string
serialNumber:
type: string
skipDeployment:
type: boolean
snortEngine:
enum:
- SNORT2
- SNORT3
type: string
status:
type: string
sw_version:
type: string
type:
type: string
version:
type: string
required:
- hostName
- license_caps
- regKey
type: object
RollbackRequestMetadata:
properties:
domain:
$ref: '#/components/schemas/Domain'
type: object
isLocked:
type: boolean
lastUser:
$ref: '#/components/schemas/MetadataUser'
type: object
matches:
items:
type: string
type: array
readOnly:
$ref: '#/components/schemas/ReadOnly'
type: object
task:
$ref: '#/components/schemas/TaskStatus'
type: object
timestamp:
format: int32
type: integer
type: object
DeployableDeviceListContainer:
properties:
items:
$ref: '#/components/schemas/DeployableDevice'
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
paging:
$ref: '#/components/schemas/PagingContainer'
type: object
type: object
IPreDeployAction:
properties:
actionInfo:
$ref: '#/components/schemas/IActionInfo'
type: object
actionType:
enum:
- APPLY_TEMPLATE
type: string
type: object
IDomain:
properties:
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
name:
type: string
type:
type: string
type: object
IBaseDevice:
properties:
accessPolicy:
$ref: '#/components/schemas/IPolicyModel'
type: object
advanced:
$ref: '#/components/schemas/IAdvanced'
type: object
description:
type: string
healthMessage:
type: string
healthPolicy:
$ref: '#/components/schemas/IHealthPolicy'
type: object
healthStatus:
type: string
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
model:
type: string
modelId:
type: string
modelNumber:
type: string
modelType:
type: string
name:
type: string
role:
type: string
status:
type: string
sw_version:
type: string
type:
type: string
version:
type: string
type: object
TaskStatus:
properties:
description:
type: string
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
message:
type: string
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
type: string
showDetailedDeviceStatus:
type: string
status:
type: string
subTasks:
items:
$ref: '#/components/schemas/ISubTask'
type: object
type: array
taskType:
enum:
- DEVICE_REGISTRATION
- SMART_LICENSE
- DEVICE_DEPLOYMENT
- DEVICE_ROLLBACK
- NGFWHA_OPERATIONS
- COPY_CONFIG_REQUEST
- HIT_COUNT_REFRESH
- FTD_CLUSTER_BOOTSTRAP
- FTD_CLUSTER_CREATE
- FTD_CLUSTER_BREAK
- FTD_CLUSTER_ADD_NODES
- FTD_CLUSTER_REMOVE_NODES
- DEVICE_BACKUP
- FTD_CLUSTER_UPDATE_BOOTSTRAP
- FTD_CLUSTER_COMMAND
- SSP_EPM_OIR
- SSP_EPM_BREAKOUT_DEPLOY
- DEVICE_EXPORT
- DEVICE_IMPORT
- POLICY_EXPORT
- CHASSIS_REGISTRATION
- CHANGE_MANAGER
- CONFIGURE_DEVICE_VALIDATE
- CONFIGURE_DEVICE
- CONFIGURE_MANAGER
- CONFIGURE_MANAGER_ADD
- CONFIGURE_MANAGER_DELETE
- INITIATE_MIGRATION
- DISCARD_MIGRATION
- SWITCH_TO_ANALYTICS
- DELETE_DEVICE
- GENERATE_REPORTS
- FLEXCONFIG_MIGRATION
- DEVICE_UNREGISTRATION
- PENDING_CHANGES_REQUEST
- DEVICE_TROUBLESHOOT
- DEVICE_MODEL_MIGRATION
- DEVICE_TEMPLATE_CREATION
- CHASSIS_CONVERSION_REQUEST
- SNORT_PROFILER
- CPU_PROFILER
- POLICY_REPORT_GENERATION
- DEVICE_TEMPLATE_APPLY
- LTP_ONBOARDING
- POLICY_CLONE_OPERATION
- DEVICE_CERTIFICATE_MANAGEMENT
- OOB_CHANGES_REQUEST
- UPLOAD_TROUBLESHOOT
type: string
type:
type: string
type: object
DeploymentRequestMetadata:
properties:
domain:
$ref: '#/components/schemas/Domain'
type: object
isLocked:
type: boolean
lastUser:
$ref: '#/components/schemas/MetadataUser'
type: object
matches:
items:
type: string
type: array
readOnly:
$ref: '#/components/schemas/ReadOnly'
type: object
task:
$ref: '#/components/schemas/TaskStatus'
type: object
timestamp:
format: int32
type: integer
type: object
PendingChangesRequest:
description: Represents the pending changes request object which will be used to generate the delta of the changes pending
on the device.
properties:
description:
type: string
deviceList:
description: List of device UUIDs for which the pending changes request has to triggered.
items:
type: string
type: array
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
metadata:
$ref: '#/components/schemas/PendingChangesRequestMetadata'
type: object
name:
type: string
requestType:
description: 'Specifies whether cli diff or policy diff or both need to be generated. One of: CLI_DIFF | POLICY_DIFF
| CLI_AND_POLICY_DIFF.'
enum:
- CLI_DIFF
- POLICY_DIFF
- CLI_AND_POLICY_DIFF
type: string
type:
type: string
version:
type: string
type: object
ErrorMessagesContainer:
properties:
bulkPayloadIndex:
description: More details about the error.
type: string
code:
description: More details about the error.
type: string
description:
description: More details about the error.
type: string
details:
description: More details about the error.
type: string
errorCode:
description: More details about the error.
type: string
location:
description: More details about the error.
type: string
severity:
description: Specifies the Highest level severity among all the error messages.
enum:
- ERROR
- WARN
type: string
type: object
DeviceInventoryData:
properties:
cpuCores:
type: string
cpuType:
type: string
memoryInMB:
type: string
storageInGB:
type: string
type: object
DownloadReportListContainer:
properties:
items:
$ref: '#/components/schemas/DownloadReport'
type: array
links:
$ref: '#/components/schemas/ILinks'
type: object
paging:
$ref: '#/components/schemas/PagingContainer'
type: object
type: object
HealthAlertConfig:
properties:
enabled:
type: boolean
name:
type: string
thresholds:
items:
$ref: '#/components/schemas/HealthThreshold'
type: object
type: array
type: object
IDeviceChassisData:
properties:
chassisSerialNo:
type: string
chassisUrl:
type: string
securityModuleNo:
format: int32
type: integer
securityModuleSN:
type: string
type: object
IValueAdd:
properties:
fieldName:
type: string
newValue:
type: string
type: object
DeviceChassisData:
properties:
chassisSerialNo:
type: string
chassisUrl:
type: string
securityModuleNo:
format: int32
type: integer
securityModuleSN:
type: string
type: object
IRollbackDeviceListEntry:
description: Part of request body which contains deployment job ids and list of devices for config rollback.
properties:
deploymentJobId:
description: Deployment job UUID.
type: string
deviceList:
description: List of device UUIDs which are part of deployment job id.
items:
type: string
type: array
type: object
IPolicyModel:
properties:
description:
type: string
id:
type: string
links:
$ref: '#/components/schemas/ILinks'
type: object
metadata:
$ref: '#/components/schemas/IMetadata'
type: object
name:
type: string
type:
type: string
version:
type: string
type: object
ReadOnly:
description: Defines the read only conditions if the referenced resource is read only.
properties:
reason:
description: Reason the resource is read only - SYSTEM (if it is system defined), RBAC (if user RBAC permissions
make it read only) or DOMAIN (if resource is read only in current domain).
enum:
- RBAC
- SYSTEM
- DOMAIN
type: string
state:
description: True if this resource us read only and false otherwise.
type: boolean
type: object
parameters:
expanded:
description: If set to true, the GET response displays a list of objects with additional attributes.
in: query
name: expanded
required: false
schema:
type: boolean
offset:
description: Index of first item to return.
in: query
name: offset
required: false
schema:
format: int32
type: integer
limit:
description: Number of items to return.
in: query
name: limit
required: false
schema:
format: int32
type: integer
domainUUID:
description: Domain UUID
in: path
name: domainUUID
required: true
schema:
type: string
securitySchemes:
bearerAuth:
bearerFormat: JWT
scheme: bearer
type: http
x-refined-from:
- cdfmc-openapi.yaml
- cisco-secure-firewall-cdfmc-openapi.yml