{"type":"api","title":"get vEdge list","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/744a8207-9965-344e-aed3-d3ef846a4950","info":{"title":"Others","description":"Other APIs\n- Include APIs that do not belong to other categories\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Certificate Management - Device"],"summary":"get vEdge list","description":"get vEdge list","operationId":"getvEdgeList","parameters":[{"name":"model","in":"query","description":"Device Model","schema":{"type":"string"},"examples":{"vEdge Cloud":{"description":"vEdge Cloud","value":"vedge-cloud"},"C8300-1N1S-4T2X":{"description":"C8300-1N1S-4T2X","value":"C8300-1N1S-4T2X"},"ASR1002-HX":{"description":"ASR1002-HX","value":"ASR1002-HX"},"C8000v":{"description":"C8000v","value":"vedge-C8000V"}}},{"name":"state","in":"query","description":"Certificate State","schema":{"type":"string"},"examples":{"CSR Failed":{"description":"CSR Failed","value":"csrfailed"},"Certificate Installed":{"description":"Certificate Installed","value":"certinstalled"},"Token Generated":{"description":"Token Generated","value":"tokengenerated"},"Certificate Installation Failed":{"description":"Certificate Installation Failed","value":"certinstallfailed"},"Bootstrap Config Generated":{"description":"Bootstrap Config Generated","value":"bootstrapconfiggenerated"},"CSR Generated":{"description":"CSR Generated","value":"csrgenerated"},"Certificate serial number pushed to controllers":{"description":"Certificate serial number pushed to controllers","value":"certserialpushedtocontrollers"}}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"examples":{"Vedge List Response":{"description":"Vedge List Response","value":{"header":{"columns":[{"title":"State","property":"vedgeCertificateState","display":"iconAndToolTip","iconProperty":"vedgeCertificateState","toolTipProperty":"vedgeCertificateState","hideable":false,"icon":[{"key":"tokengenerated","value":"images/certStates/token-generated.png","displayKey":"Token Generated"},{"key":"bootstrapconfiggenerated","value":"images/certStates/bootstrap-config-generated.png","displayKey":"Bootstrap Configuration Generated"},{"key":"csrgenerated","value":"images/certStates/csr-generated.png","displayKey":"CSR Generated"},{"key":"csrfailed","value":"images/certStates/csr-failed.png","displayKey":"CSR Failed"},{"key":"certinstallfailed","value":"images/certStates/cert-install-failed.png","displayKey":"Certificate Installation Failed"},{"key":"certinstalled","value":"images/certStates/cert-installed.png","displayKey":"Certificate Installed"}],"width":40,"minWidth":40,"dataType":"string"},{"title":"Device Model","property":"deviceModel","display":"keyvalue","keyvalueProperty":"deviceModel","hideable":false,"minWidth":120,"dataType":"string"},{"title":"Chassis Number","property":"chasisNumber","hideable":false,"width":270,"dataType":"string"},{"title":"Serial No./Token","property":"serialNumber","width":100,"dataType":"string"},{"title":"Enterprise Cert Serial No","property":"hardwareCertSerialNumber","width":100,"dataType":"string"},{"title":"Certificate Expiration Date","property":"expirationDate","width":100,"dataType":"string"},{"title":"Subject SUDI serial #","property":"subjectSerialNumber","hideable":true,"width":100,"dataType":"string"},{"title":"Hostname","property":"host-name","hideable":true,"width":100,"dataType":"string"},{"title":"System IP","property":"local-system-ip","hideable":true,"width":125,"dataType":"ipv4"},{"title":"Validate","property":"validity","display":"toggle","hideable":true,"actionColumn":true,"minWidth":250,"dataType":"string"}],"fields":[{"property":"vedgeCertificateState","dataType":"string","display":"iconAndToolTip"},{"property":"deviceModel","dataType":"string","display":"keyvalue"},{"property":"chasisNumber","dataType":"string"},{"property":"serialNumber","dataType":"string"},{"property":"hardwareCertSerialNumber","dataType":"string"},{"property":"expirationDate","dataType":"string"},{"property":"subjectSerialNumber","dataType":"string"},{"property":"host-name","dataType":"string"},{"property":"local-system-ip","dataType":"ipv4"},{"property":"validity","dataType":"string","display":"toggle"}],"viewKeys":{"uniqueKey":["chasisNumber"],"preferenceKey":"grid-certificateVEdgeList"},"modelNameMapping":{"vAnalytics":"Analytics","vSmart":"Controller","vManage":"Manager","Cloud OnRamp":"Cloud onRamp","vBond":"Validator"}},"data":[{"configuredSiteId":"17902064","configuredSystemIP":"79.2.1.64","deviceType":"vedge","serialNumber":"No certificate installed","ncsDeviceName":"vedge-C8K-0003fa42-952c-4a66-8d26-4d8fa18e0e27","configStatusMessage":"In Sync","templateApplyLog":["[23-May-2024 13:43:30 UTC] Sync-from successful"],"uuid":"C8K-0003fa42-952c-4a66-8d26-4d8fa18e0e27","managementSystemIP":"79.2.1.64","templateStatus":"Success","chasisNumber":"C8K-0003fa42-952c-4a66-8d26-4d8fa18e0e27","configStatusMessageDetails":"","configOperationMode":"cli","deviceModel":"vedge-C8000V","deviceState":"READY","validity":"valid","platformFamily":"c8000v","hardwareVedge":false,"username":"--","rootCertHash":"65ef79171aada3c7bd008fc889aaee56db5005c4","deviceIP":"79.2.1.64","personality":"vedge","uploadSource":"Auto Discovered","solution":"sdwan","site-id":"17902064","host-name":"03f_c8kv-SIM-9_2","system-ip":"79.2.1.64","vbond":"vbond","vmanageConnectionState":"connected","local-system-ip":"79.2.1.64","availableVersions":[],"defaultVersion":"17.13.01.230723.181895","reachability":"unreachable","version":"17.13.01.230723.181895","lastupdated":1716471820491,"vmanage-system-ip":"79.2.1.64","organization-name":"vmng_scale_ind","lifeCycleRequired":true,"vedgeCertificateState":"certinstalled","expirationDate":"NA","hardwareCertSerialNumber":"NA","subjectSerialNumber":"NA","certInstallStatus":"Not Installed","resourceGroup":"global","id":"NA","tags":[],"draftMode":"Disabled","site-name":"SITE_17902064","device-lock":"No","managed-by":"Unmanaged"},{"configuredSiteId":"17404071","configuredSystemIP":"74.4.1.71","deviceType":"vedge","serialNumber":"No certificate installed","ncsDeviceName":"vedge-C8K-000464eb-86ec-4bb0-948e-7f8b7e8595a5","configStatusMessage":"In Sync","templateApplyLog":["[23-May-2024 13:50:45 UTC] Sync-from successful"],"uuid":"C8K-000464eb-86ec-4bb0-948e-7f8b7e8595a5","managementSystemIP":"74.4.1.71","templateStatus":"Success","chasisNumber":"C8K-000464eb-86ec-4bb0-948e-7f8b7e8595a5","configStatusMessageDetails":"","configOperationMode":"cli","deviceModel":"vedge-C8000V","deviceState":"READY","validity":"valid","platformFamily":"c8000v","hardwareVedge":false,"username":"--","rootCertHash":"65ef79171aada3c7bd008fc889aaee56db5005c4","deviceIP":"74.4.1.71","personality":"vedge","uploadSource":"Auto Discovered","solution":"sdwan","site-id":"17404071","host-name":"046_c8kv-SIM-4_04","system-ip":"74.4.1.71","vbond":"vbond","vmanageConnectionState":"connected","local-system-ip":"74.4.1.71","availableVersions":[],"defaultVersion":"17.13.01.230723.181895","reachability":"unreachable","version":"17.13.01.230723.181895","lastupdated":1716472255905,"vmanage-system-ip":"74.4.1.71","organization-name":"vmng_scale_ind","lifeCycleRequired":true,"vedgeCertificateState":"certinstalled","expirationDate":"NA","hardwareCertSerialNumber":"NA","subjectSerialNumber":"NA","certInstallStatus":"Not Installed","resourceGroup":"global","id":"NA","tags":[],"draftMode":"Disabled","site-name":"SITE_17404071","device-lock":"No","managed-by":"Unmanaged"}]},"$$ref":"#/components/examples/ComViptelaVmanageServerCertificateapiResponseExampleGetvedgelistresponse"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server Error"}},"method":"get","path":"/certificate/vedge/list"}}