Get distinct attribute values for devices - Security Cloud Control Firewall Manager API Documentation

{"type":"api","title":"Get distinct attribute values for devices","meta":{"id":"/apps/pubhub/media/cdo-api-documentation/241e37f202cf9838405f7ca5ed9f7d31d807d7bd/9b0e4c9a-48cb-3530-a00a-1f32fbf2438c","info":{"title":"Cisco Security Cloud Control Firewall Manager API","version":"1.22.0","description":"Use the documentation to explore the endpoints Security Cloud Control Firewall Manager has to offer","contact":{"name":"Cisco Security Cloud Control TAC","email":"cdo.tac@cisco.com"}},"openapi":"3.0.1","servers":[{"url":"https://api.us.security.cisco.com/firewall","description":"US"},{"url":"https://api.eu.security.cisco.com/firewall","description":"EU"},{"url":"https://api.apj.security.cisco.com/firewall","description":"APJ"},{"url":"https://api.au.security.cisco.com/firewall","description":"AUS"},{"url":"https://api.in.security.cisco.com/firewall","description":"IN"},{"url":"https://api.uae.security.cisco.com/firewall","description":"UAE"},{"url":"https://api.int.security.cisco.com/firewall","description":"Staging"},{"url":"https://scale.manage.security.cisco.com/api/rest","description":"Scale"},{"url":"https://ci.manage.security.cisco.com/api/rest","description":"CI"},{"url":"https://devfed.cdo.cisco.com/api/rest","description":"Devfed"},{"url":"https://manage.dev.secure.cisco/api/rest","description":"Devf9"},{"url":"https://manage.stg.secure.cisco/api/rest","description":"Stgf9"},{"url":"https://manage.secure.cisco/api/rest","description":"ProdF9"},{"url":"https://manage.securitydod.cisco/api/rest","description":"IL5"}],"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"spec":{"description":"Get distinct values for filterable fields across the devices in the Security Cloud Control tenant.","operationId":"getDevicesAttributeValues","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"configStates":{"description":"The distinct config states for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct config states for the devices in the Security Cloud Control tenant.","enum":["NO_CONFIG","SYNCED","NOT_SYNCED","UNKNOWN"],"type":"string","$$ref":"#/components/schemas/ConfigState"},"type":"array","uniqueItems":true},"conflictDetectionStates":{"description":"The distinct conflict detection states for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct conflict detection states for the devices in the Security Cloud Control tenant.","enum":["CONFLICT_DETECTED","NO_CONFLICTS"],"type":"string","$$ref":"#/components/schemas/ConflictDetectionState"},"type":"array","uniqueItems":true},"connectivityStates":{"description":"The distinct connectivity states for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct connectivity states for the devices in the Security Cloud Control tenant.","enum":["ONLINE","UNREACHABLE","BAD_CREDENTIALS","UNKNOWN","PENDING_SETUP","PENDING","NEW_CERT_DETECTED"],"type":"string","$$ref":"#/components/schemas/ConnectivityState"},"type":"array","uniqueItems":true},"deviceRoles":{"description":"The distinct device roles for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct device roles for the devices in the Security Cloud Control tenant.","enum":["FTD_RA_VPN_HEADEND","ASA_RA_VPN_HEADEND","MFA_PROVIDER","ZTNA_PROVIDER","ANYCONNECT_VPN_HEAD_END","UNIVERSAL_ZTNA_HEADEND"],"type":"string","$$ref":"#/components/schemas/DeviceRole"},"type":"array","uniqueItems":true},"deviceTypes":{"description":"The distinct device types for the devices in the Security Cloud Control tenant.","items":{"description":"The type of the device.","enum":["ASA","CDFMC_MANAGED_FTD","ONPREM_FMC_MANAGED_FTD","ONPREM_FMC_MANAGED_FIREPOWER","ONPREM_FMC_NGIPS","FDM_MANAGED_FTD","IOS","ISR","SSH_DEVICE","GENERIC_DEVICE","MERAKI_MX","CLOUD_DNG","SFCN","SFCN_DNG","SFCN_STS","ONPREM_FMC","CDFMC","AWS_VPC","AZURE_VNET","DUO_ADMIN_PANEL","UMBRELLA_ORGANIZATION"],"example":"CDFMC_MANAGED_FTD","type":"string","$$ref":"#/components/schemas/EntityType"},"type":"array","uniqueItems":true},"hardwareModels":{"description":"The distinct hardware models for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct hardware models for the devices in the Security Cloud Control tenant.","type":"string"},"type":"array","uniqueItems":true},"modelNumbers":{"description":"The distinct model numbers for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct model numbers for the devices in the Security Cloud Control tenant.","type":"string"},"type":"array","uniqueItems":true},"redundancyModes":{"description":"The distinct redundancy modes for the devices in the Security Cloud Control tenant.","items":{"description":"The distinct redundancy modes for the devices in the Security Cloud Control tenant.","enum":["HA","CLUSTER","STANDALONE"],"type":"string"},"type":"array","uniqueItems":true},"softwareVersions":{"additionalProperties":{"description":"The software versions of the devices in the Security Cloud Control tenant, grouped by device type.","items":{"description":"The software versions of the devices in the Security Cloud Control tenant, grouped by device type.","type":"string"},"type":"array","uniqueItems":true},"description":"The software versions of the devices in the Security Cloud Control tenant, grouped by device type.","type":"object"}},"type":"object","$$ref":"#/components/schemas/DeviceDistinctAttributeValues"}}},"description":"Distinct attribute values for devices in the tenant"},"400":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Invalid input provided. Check the response for details.","$$ref":"#/components/responses/http400BadRequest"},"401":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"A human-readable error description in English.","example":"invalid_token","type":"string"},"errorDescription":{"description":"A human-readable error description in English.","example":"Your token is invalid","type":"string"}},"type":"object","$$ref":"#/components/schemas/AuthenticationError"}}},"description":"Request not authorized.","$$ref":"#/components/responses/http401Unauthorised"},"403":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"User does not have sufficient privileges to perform this operation.","$$ref":"#/components/responses/http403Forbidden"},"405":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Method not allowed.","$$ref":"#/components/responses/http405MethodNotAllowed"},"500":{"content":{"application/json":{"schema":{"properties":{"details":{"additionalProperties":{"description":"Additional details, if any, about the error.","example":{},"type":"object"},"description":"Additional details, if any, about the error.","example":{},"type":"object"},"errorCode":{"description":"Unique code that describes the error.","enum":["INVALID_INPUT","UNAUTHORIZED","FORBIDDEN","NOT_FOUND","METHOD_NOT_ALLOWED","CONFLICT","TOO_MANY_REQUESTS","SERVER_ERROR","PROXY_ERROR","BAD_REQUEST","UNPROCESSABLE_ENTITY"],"example":"INVALID_INPUT","type":"string"},"errorMsg":{"description":"Human-readable error description in English.","example":"sample error","type":"string"}},"type":"object","$$ref":"#/components/schemas/CommonApiError"}}},"description":"Internal server error."}},"security":[{"bearerAuth":[]}],"summary":"Get distinct attribute values for devices","tags":["Inventory"],"__originalOperationId":"getDevicesAttributeValues","method":"get","path":"/v1/inventory/devices/attribute-values"}}