Download OpenAPI specification:Download
Stitched Network Asset Provisioning API
Create a Network Asset
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
object (AssetWithMOReference) |
{- "data": {
- "type": "asset",
- "attributes": {
- "name": "Circuit A",
- "type": "cicuit",
- "location": {
- "latitude": 9.99,
- "longitude": -10.778
}, - "meta": {
- "city": "Ottawa",
- "color": "blue"
}
}, - "relationships": {
- "assets": {
- "data": [
- {
- "type": "asset",
- "attributes": {
- "name": "Node A",
- "type": "node",
- "location": {
- "latitude": 9.99,
- "longitude": -10.778
}, - "meta": {
- "city": "Ottawa",
- "color": "red"
}
}, - "relationships": {
- "objects": {
- "data": [
- {
- "id": "0x45",
- "type": "monitoredObject"
}
]
}
}
}
]
}
}
}
}
{- "data": {
- "id": "0x77",
- "type": "asset",
- "attributes": {
- "name": "Circuit A",
- "type": "cicuit",
- "location": {
- "latitude": 9.99,
- "longitude": -10.778
}, - "meta": {
- "city": "Ottawa",
- "color": "blue"
}
}, - "relationships": {
- "assets": {
- "data": [
- {
- "id": "0x78",
- "type": "asset",
- "attributes": {
- "name": "Node A",
- "type": "node",
- "location": {
- "latitude": 9.99,
- "longitude": -10.778
}, - "meta": {
- "city": "Ottawa",
- "color": "red"
}
}, - "relationships": {
- "objects": {
- "data": [
- {
- "id": "0x45",
- "type": "monitoredObject"
}
]
}
}
}
]
}
}
}
}
Get all Network Assets
type | string |
name | string Accepts a regular expression |
location | string Example: location=latitude,longitude[,distance] |
filterMetaData | string Example: filterMetaData=city:Montreal,Ottawa#color:blue |
pageSize | number Example: pageSize=25 |
page | number Example: page=10 |
graph | boolean Returns a the asset with direct references or the full graph |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
{- "data": [
- {
- "id": "string",
- "type": "asset",
- "attributes": {
- "name": "string",
- "location": {
- "latitude": 0,
- "longitude": 0
}, - "type": "string",
- "meta": {
- "property1": "string",
- "property2": "string"
}
}, - "relationships": {
- "assets": {
- "data": [
- { }
]
}, - "objects": {
- "data": [
- {
- "id": "string",
- "type": "asset",
- "attributes": {
- "tenantId": "string",
- "objectId": "string",
- "reportingMonitoredObjectId": "string",
- "actuatorName": "string",
- "actuatorType": "unknown",
- "reflectorName": "string",
- "reflectorType": "unknown",
- "objectName": "string",
- "objectType": "string",
- "meta": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "dynamicMetadata": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "sourceLocation": {
- "latitude": 0,
- "longitude": 0
}, - "destinationLocation": {
- "latitude": 0,
- "longitude": 0
}, - "topology": [
- "string"
], - "archiveTimestamp": "string",
- "createdTimestamp": "string",
- "lastModifiedTimestamp": "string",
- "lastReportedTimestamp": "string",
- "previousIdentities": [
- {
- "time": null,
- "objectId": null,
- "objectName": null
}
], - "associatedObjects": [
- { }
]
}
}
]
}
}
}
]
}
Update a Network Asset
id required | string |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
object |
{- "data": {
- "id": "0x45",
- "type": "asset",
- "attributes": {
- "name": "Renamed_Circuit",
- "meta": {
- "city": "Montreal",
- "color": "red"
}, - "location": {
- "latitude": 9.99,
- "longitude": -10.778
}
}, - "relationships": {
- "assets": {
- "data": [
- {
- "id": "0x45",
- "type": "addAsset"
}, - {
- "id": "0x47",
- "type": "removeAsset"
}
]
}, - "objects": {
- "data": [
- {
- "id": "0x45",
- "type": "addMonitoredObject"
}, - {
- "id": "0x47",
- "type": "removeMonitoredObject"
}
]
}
}
}
}
{- "errors": [
- {
- "code": "string",
- "status": 0,
- "title": "string"
}
]
}
Get a Network Asset
id required | string |
graph | boolean Returns a the asset with direct references or the full graph |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
{- "data": {
- "id": "string",
- "type": "asset",
- "attributes": {
- "name": "string",
- "location": {
- "latitude": 0,
- "longitude": 0
}, - "type": "string",
- "meta": {
- "property1": "string",
- "property2": "string"
}
}, - "relationships": {
- "assets": {
- "data": [
- { }
]
}, - "objects": {
- "data": [
- {
- "id": "string",
- "type": "asset",
- "attributes": {
- "tenantId": "string",
- "objectId": "string",
- "reportingMonitoredObjectId": "string",
- "actuatorName": "string",
- "actuatorType": "unknown",
- "reflectorName": "string",
- "reflectorType": "unknown",
- "objectName": "string",
- "objectType": "string",
- "meta": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "dynamicMetadata": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "sourceLocation": {
- "latitude": 0,
- "longitude": 0
}, - "destinationLocation": {
- "latitude": 0,
- "longitude": 0
}, - "topology": [
- "string"
], - "archiveTimestamp": "string",
- "createdTimestamp": "string",
- "lastModifiedTimestamp": "string",
- "lastReportedTimestamp": "string",
- "previousIdentities": [
- {
- "time": "2019-08-24T14:15:22Z",
- "objectId": "string",
- "objectName": "string"
}
], - "associatedObjects": [
- { }
]
}
}
]
}
}
}
}
Get Network Asset counts
type | string |
name | string Accepts a regular expression |
location | string Example: location=latitude,longitude[,distance] |
filterMetaData | string Example: filterMetaData=city:Montreal,Ottawa#color:blue |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
{- "data": {
- "type": "assetCount",
- "attributes": {
- "count": 0
}
}
}
Get a flattened list of all monitored objects, belonging to a network asset which matches the query criteria
type | string |
name | string Accepts a regular expression |
location | string Example: location=latitude,longitude[,distance] |
filterMetaData | string Example: filterMetaData=city:Montreal,Ottawa#color:blue |
circuitsPerPage | number Example: circuitsPerPage=25 |
page | number Example: page=10 |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
{- "data": [
- {
- "id": "string",
- "type": "string",
- "attributes": {
- "tenantId": "<tenantId>",
- "objectId": "<objectId>",
- "objectName": "AB-End",
- "objectType": "twamp-sf",
- "reflectorName": "accedian-nid",
- "reflectorType": "accedian-nid",
- "actuatorName": "accedian-nid",
- "actuatorType": "accedian-nid",
- "assetMembership": [
- {
- "circuit": "0x13b",
- "node": "0x23ffg",
- "vm": "0x34ssa",
- "site": "0x34"
}
]
}
}
]
}
Returns a list of unique object types associated with the given network asset type
assetType | string type of the asset. i.e.: circuit, node, etc |
X-Forwarded-Tenant-Id required | string TenantID |
{- "data": [
- "string"
]
}
Get Monitored Objects. Use query parameters to provide filters
objectName | string Accepts a regular expression |
objectId | string Object Id |
objectType | string |
actuatorType | string |
actuatorName | string |
sourceLocation | string Example: sourceLocation=latitude,longitude[,distance] |
destinationLocation | string Example: destinationLocation=latitude,longitude[,distance] |
filterMetaData | string Example: filterMetaData=city:Montreal,Ottawa#color:blue |
pageSize | number Example: pageSize=25 |
page | number Example: page=10 |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
{- "data": [
- {
- "id": "string",
- "type": "asset",
- "attributes": {
- "tenantId": "string",
- "objectId": "string",
- "reportingMonitoredObjectId": "string",
- "actuatorName": "string",
- "actuatorType": "unknown",
- "reflectorName": "string",
- "reflectorType": "unknown",
- "objectName": "string",
- "objectType": "string",
- "meta": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "dynamicMetadata": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "sourceLocation": {
- "latitude": 0,
- "longitude": 0
}, - "destinationLocation": {
- "latitude": 0,
- "longitude": 0
}, - "topology": [
- "string"
], - "archiveTimestamp": "string",
- "createdTimestamp": "string",
- "lastModifiedTimestamp": "string",
- "lastReportedTimestamp": "string",
- "previousIdentities": [
- {
- "time": "2019-08-24T14:15:22Z",
- "objectId": "string",
- "objectName": "string"
}
], - "associatedObjects": [
- { }
]
}
}
]
}
Update a Monitored Object
uid required | string |
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
object |
{- "data": {
- "attributes": {
- "name": "Renamed_Circuit",
- "meta": {
- "city": "Montreal",
- "color": "red"
}, - "dynamicMetadata": {
- "customer": "Accedian",
- "tier": "premium"
}, - "sourceLocation": {
- "latitude": 9.99,
- "longitude": -10.778
}
}, - "associatedObjects": {
- "data": [
- {
- "id": "0x45",
- "type": "addMonitoredObject"
}, - {
- "id": "0x47",
- "type": "removeMonitoredObject"
}
]
}
}
}
{- "errors": [
- {
- "code": "string",
- "status": 0,
- "title": "string"
}
]
}
Get Monitored Objects. Use body to provide filters
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
required | object |
{- "data": {
- "attributes": {
- "monitoredObjectID": [
- "0fx070gh",
- "0fx034",
- "0fx4456"
], - "objectName": [
- "ABC",
- "DEF",
- "GHI"
]
}
}
}
{- "data": [
- {
- "id": "string",
- "type": "asset",
- "attributes": {
- "tenantId": "string",
- "objectId": "string",
- "reportingMonitoredObjectId": "string",
- "actuatorName": "string",
- "actuatorType": "unknown",
- "reflectorName": "string",
- "reflectorType": "unknown",
- "objectName": "string",
- "objectType": "string",
- "meta": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "dynamicMetadata": {
- "region": "paris",
- "wgs87_x": "-45.7123912",
- "wgs87_y": "-74.2130912"
}, - "sourceLocation": {
- "latitude": 0,
- "longitude": 0
}, - "destinationLocation": {
- "latitude": 0,
- "longitude": 0
}, - "topology": [
- "string"
], - "archiveTimestamp": "string",
- "createdTimestamp": "string",
- "lastModifiedTimestamp": "string",
- "lastReportedTimestamp": "string",
- "previousIdentities": [
- {
- "time": "2019-08-24T14:15:22Z",
- "objectId": "string",
- "objectName": "string"
}
], - "associatedObjects": [
- { }
]
}
}
]
}
Returns a compact view of Network Assets
X-Forwarded-Tenant-Id required | string IGNORED. This value is provided by proxy |
required | object |
{- "data": {
- "attributes": {
- "targetAssets": [
- "0fx070gh",
- "0fx034",
- "0fx4456"
]
}
}
}
{- "data": [
- {
- "id": "0fx070gh",
- "type": "asset",
- "attributes": {
- "name": "CircuitK",
- "type": "circuit",
- "location": {
- "latitude": 9.778,
- "longitude": -9.433
}, - "meta": {
- "city": "Ottawa",
- "color": "blue"
}
}
}
]
}