resetRSA for controllers - Cisco Catalyst SD-WAN Manager API, Release 20.18

{"type":"api","title":"resetRSA for controllers","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":"resetRSA for controllers","description":"resetRSA for controllers","operationId":"resetRSA","requestBody":{"description":"JSON payload with deviceIP details for rsa reset","content":{"application/json":{"schema":{"type":"string"},"examples":{"Reset RSA Request":{"description":"Reset RSA Request","value":{"deviceIP":"10.103.128.128"},"$$ref":"#/components/examples/ComViptelaVmanageServerCertificateapiRequestExamplePostresetrsarequest"}}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"examples":{"Post Reset RSA Response":{"description":"Post Reset RSA Response","value":{"header":{"columns":[{"title":"Operation Status","property":"state","colorProperty":"globalState","color":[{"key":"Error","value":"ef5350"}],"width":130,"dataType":"string"},{"title":"Controller Type","property":"deviceType","display":"keyvalue","keyvalueProperty":"deviceType","keyvalue":[{"key":"vsmart","value":"vSmart"},{"key":"vbond","value":"vBond"},{"key":"vmanage","value":"vManage"},{"key":"vedge","value":"WAN Edge"}],"width":120,"dataType":"string"},{"title":"Hostname","property":"host-name","width":150,"dataType":"string"},{"title":"System IP","property":"local-system-ip","width":120,"dataType":"ipv4"},{"title":"Site ID","property":"site-id","width":70,"dataType":"numberStr"},{"title":"Certificate Serial","property":"serialNumber","width":150,"dataType":"string"},{"title":"Expiration Date","property":"expirationDateLong","displayFormat":"DD MMM YYYY h:mm:ss A z","inputFormat":"unix-time","colorProperty":"expirationStatus","color":[{"key":"warning","value":"ffb300"},{"key":"invalid","value":"ef5350"}],"width":200,"dataType":"date"},{"title":"uuid","property":"uuid","editable":false,"dataType":"string"},{"title":"vEdge List Status","property":"state_vedgeList","minWidth":80,"dataType":"string"},{"title":"Device IP","property":"deviceIP","width":120,"dataType":"ipv4"}],"fields":[{"property":"state","dataType":"string"},{"property":"deviceType","dataType":"string","display":"keyvalue"},{"property":"certInstallStatus","dataType":"string"},{"property":"host-name","dataType":"string"},{"property":"system-ip","dataType":"ipv4"},{"property":"local-system-ip","dataType":"ipv4"},{"property":"site-id","dataType":"numberStr"},{"property":"username","dataType":"string"},{"property":"password","dataType":"string"},{"property":"CSR","dataType":"string"},{"property":"CSRDetail","dataType":"string"},{"property":"CertificateDetail","dataType":"string"},{"property":"serialNumber","dataType":"string"},{"property":"expirationDate","dataType":"string"},{"property":"expirationDateLong","dataType":"date"},{"property":"valid","dataType":"string"},{"property":"errorDetail","dataType":"string"},{"property":"requestTokenID","dataType":"string"},{"property":"uuid","dataType":"string"},{"property":"state_vedgeList","dataType":"string"},{"property":"deviceIP","dataType":"ipv4"},{"property":"errorDetail_vedgelist","dataType":"string"},{"property":"activity","dataType":"string"}],"viewKeys":{"uniqueKey":[],"preferenceKey":"grid-MultiTenantCertificate"},"modelNameMapping":{"vAnalytics":"Analytics","vSmart":"Controller","vManage":"Manager","Cloud OnRamp":"Cloud onRamp","vBond":"Validator"}},"data":[{"globalState":"normal","timeRemainingForExpiration":31430997892,"certInstallStatus":"Installed","activity":["[6-Jun-2024 5:23:36 UTC] CSR Generated"],"expirationStatus":"normal","deviceCSR":"-----BEGIN CERTIFICATE REQUEST-----\nMIIFTzCCAzcCAQAwgc4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlh\nMREwDwYDVQQHEwhTYW4gSm9zZTEYMBYGA1UECxMPRENBIEFVVCBWTUFOQUdFMRYw\nFAYDVQQKEw1DaXNjbyBTeXN0ZW1zMUEwPwYDVQQDEzh2Ym9uZC1iMzY4ZmYxYS02\nNDBjLTQ0NDAtOGY0ZC0xMzgwZWY4NmQ0ZTYtMi52aXB0ZWxhLmNvbTEiMCAGCSqG\nSIb3DQEJARYTc3VwcG9ydEB2aXB0ZWxhLmNvbTCCAiIwDQYJKoZIhvcNAQEBBQAD\nggIPADCCAgoCggIBAMzZeBy/9zMfvR0flv1Qz9YkXzZfyrksKE0GcWg6AV1XYzPS\nNGFg+iFsv+UV08LtMOXoAcUDDRAllWTU4Q4fvUKGnmdf6yHjM5+K0DeqY+dBVjRl\nFOc/rKN49WDIvn/6oQosg8R0soF3eWFiN2cBtyFvqTU9AQqBXWpNEhQOphC78oMV\nfMn9xr/Otex2ElJiVW+Uv10KNUhKj+NeKXx60kT89phmv8cWJZO6+iPqTn5DscqM\nfUBt0tEK2SC1BdR52oMGi9TMefEXT55NZtwEGF+oezuOMbdvNSvvRJ7SY8mKtOw7\nL/PFSLHpZi2gbaqpWT2D+h9Jr6osezNjHfufsywjxJi8BZcW3VAv0wW4qkfKXuMs\ncERHvbgGNqlSvYmef9BUU+bNMM+sIMFI4vTByQ4dyuHU2ETHjmonxY+jmb7zcL4T\nYgLbkGaDE/pp1lWCVscdV3MT1yyXClETn8zKlvnx3SrDJUyPfpvXN10nAHCtQDv9\nO1XgcWKa/OM4LTQkyBjQVx6Eje4W17MJ60pT/+bl4se+S8uiO7tyERY4lgvZK3mj\nQTP4+GEoZRUX5xuB/lEw7v65Q6QP+djGPlI4r180lIALS43kRiOCilbuEsVNgmjk\n6mnMYdDd46a6xSLyvnzu09IxLSR/R5moqKW+HSgL6pCEwLaU47CS6gdqjBR7AgMB\nAAGgOzA5BgkqhkiG9w0BCQ4xLDAqMAkGA1UdEwQCMAAwHQYDVR0OBBYEFCPwD3W9\nLSG8Y+Jzudu4CzH/caLUMA0GCSqGSIb3DQEBCwUAA4ICAQBhdnQWTJc9ceQCsahV\nJB2gBu+XVXNbQbktWuQubOTvyLJORu0UuU4Qn4Q34eYcIny74TvHsCvBDJZ8mRBZ\n3wVm+hB8LTRa80KYLLnCjCOthGH8fFZBnII20SnMLiP5kcLe/FWDOghlwTIpvMI2\nJfFerO5cuzd3orkPXFbHL8J6hpe0HXhIM1aNSn3M/1d87DA6vT5GYPzy0BLRb8Qo\nvARcoKSCgl/6tp6djR+3PaEPc3nRyUOX4Ucra9RE8J0SntjT1Y7OBaGBtT8zsaLc\nVHud1RPbI8v9nDK9ynxS7i04ukfGnuFVNXais9IgfPhzbHPig0gvrse5I6xtQfnO\n3XNi0Aod6ryxKj5jr9unYPzyBJBvnPJsfZboYHsQslYkbVVNRCGa1S2/GfxPhC6u\nobEdw5/0liP8h8KM87LhD98dctxYayqSPd5Tfqn60FfVWyNY1LaymsOJVYqFQrYx\nIO+4jXhAh/COu6wF6HlS8uQ/Ai7z1adYqQqQFpMor7uyEU/bKN+xfbS9zd7kyApN\nyNHTaDBE4GvYI0I2nidxHFOmW6eqf6PE2oEl5dQ1/sCvpJZUE7pQXT5UkvUnmiXJ\nWRnEEplhZUNkPBYmWuwarZlLN8I0YD70+5x7xRgfDel5TddQaWx6f+07GHcjvti3\nfx73e2hX4jagcPV3rDiqG7vmYw==\n-----END CERTIFICATE REQUEST-----","uuid":"b368ff1a-640c-4440-8f4d-1380ef86d4e6","certificateDetail":"-----BEGIN CERTIFICATE-----\nMIIEjzCCA3cCBBI0VxEwDQYJKoZIhvcNAQELBQAwbTELMAkGA1UEBhMCVVMxEzAR\nBgNVBAgMCkNhbGlmb3JuaWExETAPBgNVBAcMCFNhbiBKb3NlMRQwEgYDVQQKDAt2\nSVB0ZWxhIEluYzEgMB4GCSqGSIb3DQEJARYRbm9yZXBseUBjaXNjby5jb20wHhcN\nMjQwNjA0MDUyMTMwWhcNMjUwNjA0MDUyMTMwWjCBqjERMA8GA1UEBxMIU2FuIEpv\nc2UxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQKEw1D\naXNjbyBTeXN0ZW1zMRgwFgYDVQQLEw9EQ0EgQVVUIFZNQU5BR0UxQTA/BgNVBAMT\nOHZib25kLWIzNjhmZjFhLTY0MGMtNDQ0MC04ZjRkLTEzODBlZjg2ZDRlNi0wLnZp\ncHRlbGEuY29tMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAvG3L3pvH\nmKQsLmC0wSWEKNa2Sk2ssdKCPShHW6gRV04KEAWnf3eOtoYTUwupNxBGAMbyFl4h\nJG2rDJQgdjWMq0iz3unyt27C9U47TdrRk6rA3o/+xkXZPpuNQslaUiNu8KZqHJ2o\nQS4XkNuoBRTTKbShROLa1CuNTlq2KUbgiVIiwAb5uQSN7nnqNW21xV2Oy3OtrwfZ\nGG3zmJdH+09VbS+rWSYZFtFYCz68Uc9I9jC1YnaNLGWGydstX3m7QRyzlbnQg0aj\ntTcpLM9MBrU4qbyGOqhk2iu4a+xXKsG1XCgQHcpSh2LV1wXOZMuAPJQqfY57H86v\n7aFywDyMZvftqvkaIWVGQ52RfHElpPt4kRrnvNIOtIe1WhPJncBTGVh6NIASIMTu\nA20BVwuHa1yNlLhyuB4WQwVOhiDw/4exbqNq9w0lzqPXajDY53sTHa+ULcBZm26Y\nnejQizOkrvmBPZqHcdk9QPL3MH8XdbsbOdP4lVVdbpmaZOGxM46u/AmpQTq9pUor\nfqnfsh+4Zbqi9v604B0P7iuv5HfKJpTSJLRdJ1H06mX/M+uduovN4TU2aDa6GR5F\nqgiZdHTH6B634Jh02CrtCftExFT1rliK9jbYWxn5R1U1yCLXTp5Q/1zdZoXmI6D3\nhA0Zf0PKQwL1QtJJeQvMNuHhOhHZz/H3hGUCAwEAATANBgkqhkiG9w0BAQsFAAOC\nAQEAimacxUFDKW2A5Ytes/Wt/MD0iS0BXeHvmRM29jAjnJKGZfLibUERZewTmfYT\nAJj2Ll6sB1uVlrvfcZCvGPxy9EW0AGoglWSdTZQHBNSFTAOIciXKCiVhyach/0eU\nm6j00QrfZn/NmwdpkY27mo/s0hGgE+44If6X2zPOUEpC/XdTVxbqoeI2YZfK33c8\nieuLk7+b0u5kYW+sYhsc2MXOnd8YDmHaRth5i8D9EDgkY0kt9V0q8FkUl/hcXFaL\nkYvgfh3Os1Yq3WgOg2uX2ehulf5UzhMB46BXo3yarpERiDarFJpPcP+M3/TfXnBB\nqla9scqUUK7SfExJ5PZ2ViBSSA==\n-----END CERTIFICATE-----","platformFamily":"vedge-x86","valid":"N/A","createdAt":"04 Jun 2024 05:29:00 UTC","password":"Cisco#123@Viptela","@rid":4421,"personality":"vedge","chasisNumber":"b368ff1a-640c-4440-8f4d-1380ef86d4e6","configOperationMode":"cli","state":"CSR Generated","expirationDate":"Jun 04 05:21:30 2025 GMT","deviceType":"vbond","deviceIP":"10.103.128.128","CSR":"vbond-b368ff1a-640c-4440-8f4d-1380ef86d4e6-0.viptela.com","serialNumber":"12345711","rootCertHash":"392fb5cdc1dc4156d289359095185263b69b53c6","deviceCSRGenTimeString":"Jun 06 05:23:36 2024 UTC","ncsDeviceName":"vbond-b368ff1a-640c-4440-8f4d-1380ef86d4e6","org":"DCA AUT VMANAGE","deviceCSRCommonName":"vbond-b368ff1a-640c-4440-8f4d-1380ef86d4e6-2.viptela.com","requestTokenID":"N/A","CSRDetail":"-----BEGIN CERTIFICATE REQUEST-----\nMIIFTzCCAzcCAQAwgc4xCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlh\nMREwDwYDVQQHEwhTYW4gSm9zZTEYMBYGA1UECxMPRENBIEFVVCBWTUFOQUdFMRYw\nFAYDVQQKEw1DaXNjbyBTeXN0ZW1zMUEwPwYDVQQDEzh2Ym9uZC1iMzY4ZmYxYS02\nNDBjLTQ0NDAtOGY0ZC0xMzgwZWY4NmQ0ZTYtMC52aXB0ZWxhLmNvbTEiMCAGCSqG\nSIb3DQEJARYTc3VwcG9ydEB2aXB0ZWxhLmNvbTCCAiIwDQYJKoZIhvcNAQEBBQAD\nggIPADCCAgoCggIBALxty96bx5ikLC5gtMElhCjWtkpNrLHSgj0oR1uoEVdOChAF\np393jraGE1MLqTcQRgDG8hZeISRtqwyUIHY1jKtIs97p8rduwvVOO03a0ZOqwN6P\n/sZF2T6bjULJWlIjbvCmahydqEEuF5DbqAUU0ym0oUTi2tQrjU5atilG4IlSIsAG\n+bkEje556jVttcVdjstzra8H2Rht85iXR/tPVW0vq1kmGRbRWAs+vFHPSPYwtWJ2\njSxlhsnbLV95u0Ecs5W50INGo7U3KSzPTAa1OKm8hjqoZNoruGvsVyrBtVwoEB3K\nUodi1dcFzmTLgDyUKn2Oex/Or+2hcsA8jGb37ar5GiFlRkOdkXxxJaT7eJEa57zS\nDrSHtVoTyZ3AUxlYejSAEiDE7gNtAVcLh2tcjZS4crgeFkMFToYg8P+HsW6javcN\nJc6j12ow2Od7Ex2vlC3AWZtumJ3o0IszpK75gT2ah3HZPUDy9zB/F3W7GznT+JVV\nXW6ZmmThsTOOrvwJqUE6vaVKK36p37IfuGW6ovb+tOAdD+4rr+R3yiaU0iS0XSdR\n9Opl/zPrnbqLzeE1Nmg2uhkeRaoImXR0x+get+CYdNgq7Qn7RMRU9a5YivY22FsZ\n+UdVNcgi106eUP9c3WaF5iOg94QNGX9DykMC9ULSSXkLzDbh4ToR2c/x94RlAgMB\nAAGgOzA5BgkqhkiG9w0BCQ4xLDAqMAkGA1UdEwQCMAAwHQYDVR0OBBYEFGYy6dzR\nVv57KFup3rzrNNlSUvb/MA0GCSqGSIb3DQEBCwUAA4ICAQBckqAWr/QlzV8HUrQh\n1xE6fiI/zqnwfCy0lbgFbV33PiGxzB37Sv0EtaZi+8Ik68dbsNCADv9zx4LRnHeW\nyWh4/ndhoEgcs7B5yQOAAmtNkKkcQ7THw40QuoVabJIwgY94G3BLW4HnrexsWBoz\nXVD/4AznZo4LhOutMgfEzolbMR/2ptcXnuiFIXsozrUsLSmC4iWpj2emyuy7GjnA\nuv+GEBAkjUjp60LZBkx3W12jXvKNxPTOSyjlnpmviEJhNM7JmItpFJ1/YYsLtjny\n2zScPOwwHscKcg1M4MTyxkMIM1Hxp123x7iHybblAvYoaiyTRrPTPmlxz+yy/jwY\nCNuovYTAVXpZPHAGLZShyHVf+SBRSv4t6qsgpUhl0EsOjP0eA+uVJobowoZ/2GMH\nudmNbTS2NSO5c3w6p+Enal0L71Vf9zhscnHU2U/WihSW70hJRIOpXM/VpdsVQ5oy\ntxjdFJbCVfdPPDKZUFdcQb+XGDx7FWYmUz147odlKh65olZgTyi16/k1YUVpMcUi\nGWbARNRngWpeh74uU3039wyq99kUIy8QqLPppbrNdlSnuazNw2rU6SlH4zU5LlhA\ngoKvR2olCL3Gif+7irPdQ6jzr3R97baKgiYmwKQru/QYOFfY0ZgzW27wPFUVTZdg\nUyj7Zuv+tEwz/XL04KNpjiyd8g==\n-----END CERTIFICATE REQUEST-----","quickConnectEligible":false,"managementSystemIP":"169.254.10.2","deviceDay0Configuration":"","state_vedgeList":"Sync","deviceCSRGenTime":1717651416963,"createdBy":"user","tenantId":"57501bad-32a7-4f52-8f54-8547dcd7403e","deviceModel":"vedge-cloud","deviceState":"BRING_UP","validity":"valid","expirationDateLong":1749014490000,"isMultiStepUpgradeSupported":true,"username":"admin"}]},"$$ref":"#/components/examples/ComViptelaVmanageServerCertificateapiResponseExamplePostresetrsaresponse"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server"}},"method":"post","path":"/certificate/reset/rsa"}}