How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cisco Crosswork Collection Service API

The CollectionService API from Cisco Crosswork — 9 operation(s) for collectionservice.

Cisco Crosswork Collection Service API is one of 99 APIs that Cisco Crosswork publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include CollectionService. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 10 operations across 9 paths, and defines 80 schemas. It is described by OpenAPI 3.2.0, at version 4.0.

Requests are made against the base URL https://{crosswork-host}:{port}.

10 operations 9 paths 80 schemas 1 DELETE8 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.0
Base URL
https://{crosswork-host}:{port}
Resource Areas
1

Paths & Operations 10

Across 9 paths, the API surfaces 10 operations — 1 DELETE, 8 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

CollectionService 10
DELETE
/crosswork/collection/v1/collectionjob
DeleteCollectionJob API DeleteCollectionJob is used to mark an collection job for deletion within collection based on Application Context. Collection Service will clean up associated sensor configs o…
DeleteCollectionJob body → 200
PUT
/crosswork/collection/v1/collectionjob
CreateCollectionJob API This API allows you to a create an collection job for a devcice set. An application sends a request for list of sensor paths where path identified by a YANG model i.e, it coul…
CreateCollectionJob body → 200
POST
/crosswork/collection/v1/collectionjob/config/query
GetCollectionJobConfig API GetConfiguration GetCollectionJobConfig can be used track the configuration request within Collection Service API. It will return all sensor configuration and device set wi…
GetCollectionJobConfig body → 200
POST
/crosswork/collection/v1/collectionjob/controlstatus/query
GetCollectionControlStatusPerDevice API Detailed Granular view of each device within a job for control status GetCollectionControlStatusPerDevice can be used track a control status within Collection…
GetCollectionControlStatusPerDevice body → 200
POST
/crosswork/collection/v1/collectionjob/count/query
Get job count in system,along with list of input count,output count,error count per collection job if collection job application context is passed. If application context is not passed , it will retu…
GetCollectionJobCount body → 200
POST
/crosswork/collection/v1/collectionjob/datametrics/query
GetCollectionDataMetricsPerDevice API Detailed Granular view of each device within a job for data metrics Returns the data metrics from per device per sensor basis . Only last reported values is reta…
GetCollectionDataMetricsPerDevice body → 200
POST
/crosswork/collection/v1/collectionjob/datastatus/query
GetCollectionDataStatusPerDevice API Detailed Granular view of each device within a job for data status Returns the data status from per device per sensor basis . Only last reported values is retaine…
GetCollectionDataStatusPerDevice body → 200
POST
/crosswork/collection/v1/collectionjob/state/query
Returns the overall state of the collection job based on counters.
GetCollectionJobState body → 200
POST
/crosswork/collection/v1/collectionjob/summary/query
GetCollectionJobSummary API GetCollectionJobSummary can be used track a operational state request within Collection Service API. It indicates current status i.e, READY , NOTREADY,FAILED . If the Phas…
GetCollectionJobSummary body → 200
POST
/crosswork/collection/v1/resource/inuse/query
Returns whether a Resource is in use . Currently supported resource is Destination id. Internal use only
GetIsResourceInUse body → 200

Schemas 80

The contract defines 80 schemas that model the data the API accepts and returns. The most detailed are common_collection_dataKeyValue (10 properties), common_collection_dataSensorData (9 properties), collection_serviceCollectionJobStatus (8 properties), collection_serviceGetCollectionJobCountResponse (7 properties). Each schema is shown below with its type and property counts.

gnmiPathElem
object
PathElem encodes an element of a gNMI path, along with any attributes (keys) that may be associated with it. Reference: gNMI Specification Section 2.2.2.
2 properties
collection_serviceCollectionControlStatus
object
7 properties
collection_serviceCollectionLifeCycleState
object
CollectionState aggregate an application context to a State.
3 properties
collection_serviceCollectionDataMetrics
object
2 properties
collection_serviceGetCollectionJobLifeCycleStateRequest
object
GetCollectionJobStateRequest encapsulates requests for the lifetime cycle state of associated collection jobs.
3 properties
collection_serviceSensorOutputConfig
object
Sensor Output represents output of sensor to a destination for given sensor which is a topic on a message broker or GRPC server.
3 properties
collection_serviceGetCollectionJobConfigResponse
object
3 properties
common_collection_dataGnmiSensor
object
3 properties
collection_serviceDeleteCollectionJobRequest
object
1 property
collection_serviceSensorInputConfigCommitted
object
2 properties
collection_serviceJobLifetimeType
string
- UNKNOWNTEMPORALTYPE: Invalid Lifetime - APPLICATIONMANAGED: Create and Delete of Collection job is managed by Application - CALENDARMANAGED: Create and Delet…
common_collection_dataSyslogSensor
object
3 properties
collection_serviceFilterOperator
string
- UNKNOWNOPERATOR: unknown operator - OPERATOROR: OR operator filter applied across filter list - OPERATORAND: AND operator filter applied across filter list -…
collection_serviceGetCollectionJobSummaryRequest
object
Will return all collection job operational status summary if deviceid is empty for given application context or will return on per device basis.
2 properties
common_collection_dataGNMIDeviceSetting
object
6 properties
collection_serviceGetCollectionDataMetricsRequest
object
3 properties
common_collection_dataSnmpSensor
object
2 properties
collection_serviceOutputStatus
object
4 properties
collection_serviceSensorConfigCommitted
object
SensorConfig describing cadence from input and output side along with destination.
2 properties
collection_serviceCollectionStatus
object
3 properties
collection_serviceResult
object
Result is used to convey whether an operation (individual or in a batch) has been accepted or rejected. For sync API's an error or rejection indicates failure…
2 properties
gnmiModelData
object
3 properties
collection_serviceGetCollectionJobSummaryResponse
object
3 properties
common_collection_dataDevicePackage
object
3 properties
collection_serviceCollectionState
string
- ACTIVESTATE: Object is behaving as expected - INACTIVESTATE: Object is in a bad state. - ACCEPTEDSTATE: Object is under evaluation
collection_serviceGetCollectionJobLifeCycleStateResponse
object
3 properties
collection_serviceQueryOptions
object
4 properties
collection_serviceFilter
object
2 properties
collection_serviceGetCollectionControlStatusRequest
object
3 properties
common_collection_dataSnmpYangSensor
object
1 property
collection_serviceGetCollectionControlStatusResponse
object
CollectionControlStatusDeviceResponse indicates the list of devices for which the job is successfully processed.
3 properties
common_collection_dataCliSensor
object
2 properties
collection_serviceGetCollectionJobConfigRequest
object
3 properties
collection_serviceRequestResult
string
- REJECTED: Request has been rejected - ACCEPTED: Request has been accepted for processing
collection_serviceDeviceData
object
2 properties
common_collection_dataSensorData
object
9 properties
collection_serviceKeyValueMetric
object
2 properties
collection_serviceDestination
object
Destination identifier to uniquely identify a destination Output encoding format for destination is derived from Inventory destinationid.
3 properties
collection_servicePhase
string
- ACTIVE: Request is active , Collection Job associated with app Context may be in any one of the above states - TERMINATING: Request is marked for deletion ,…
collection_serviceGetCollectionJobCountResponse
object
7 properties
collection_serviceGetCollectionDataMetricsResponse
object
3 properties
collection_serviceStatus
string
- NOTREADY: NOTREADY indicates that initial setup of the object is in progress, or being retried. - READY: READY indicates that initial setup of the object is…
collection_serviceGetIsResourceInUseResponse
object
2 properties
collection_serviceCollectionMode
object
4 properties
collection_serviceLifeCycleState
string
collection_serviceMetrics
object
1 property
collection_serviceCreateCollectionJobRequest
object
1 property
common_collection_dataMDTSensor
object
1 property
collection_serviceGetIsResourceInUseRequest
object
1 property
collection_serviceFilterField
object
2 properties
collection_serviceSensorOutputConfigCommitted
object
3 properties
common_collection_dataSnmpMib
object
2 properties
collection_serviceDeviceSet
object
Device Grouping Object , for a given request set one of either one of device grouping i.e, list of devices or a device group not both. OneOf construct is enfor…
2 properties
collection_serviceDevices
object
1 property
collection_serviceGetCollectionJobCountRequest
object
1 property
collection_serviceInputMetrics
object
3 properties
collection_serviceJobDeviceSet
object
1 property
common_collection_dataTrapSensor
object
1 property
common_collection_dataCliYangSensor
object
1 property
collection_serviceApplicationContext
object
2 properties
collection_serviceGetCollectionDataStatusRequest
object
3 properties
common_collection_dataKeyValue
object
10 properties
gnmiSubscriptionMode
string
collection_serviceCollectionJobStatus
object
8 properties
collection_serviceCreateCollectionJobResponse
object
1 property
common_collection_dataCollectionType
string
common_collection_dataSnmpOperation
string
gnmiQOSMarking
object
1 property
collection_serviceOutputMetrics
object
4 properties
collection_serviceInputStatus
object
3 properties
collection_serviceError
object
1 property
SyslogSensorPRIs
object
2 properties
gnmiPath
object
Path encodes a data tree path as a series of repeated strings, with each element of the path representing a data tree node name and the associated attributes.…
4 properties
collection_serviceGetCollectionDataStatusResponse
object
CollectionJobDeviceSetStatus indicates the list of devices for which the job is successfully processed.
3 properties
common_collection_dataTrapYangSensor
object
1 property
collection_serviceSensorInputConfig
object
SensorInputConfig represents device side collection at some cadence.
2 properties
collection_serviceCollectionDataStatus
object
2 properties
collection_serviceCollectionJobConfiguration
object
5 properties
collection_serviceDeleteCollectionJobResponse
object
1 property
collection_serviceConfigurationCommitState
string
- COMMITTED: Control config for device was successfully converged based on target state - NOTCOMMITTED: Control config for device was not successfully converge…

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cisco-crosswork-collectionservice-api-openapi.yml Raw ↑

Other APIs Cisco Crosswork publishes across the network.

Cisco Crosswork Add Credentials API
Cisco Crosswork Add Data Gateway Enrollments API
Cisco Crosswork Add Destinations API
Cisco Crosswork Add Nodes/Devices API
Cisco Crosswork Add Policies API
Cisco Crosswork Add Providers API
Cisco Crosswork Add Tags API
Cisco Crosswork Add via CSV file API
Cisco Crosswork Alarms API
Cisco Crosswork Alert API API
Cisco Crosswork API Controller API
Cisco Crosswork Authconfig API
Where this information came from

This is an independent, third-party profile of Cisco Crosswork Collection Service API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.