{"type":"api","title":"Update configuration setting","meta":{"id":"/apps/pubhub/media/sd-wan-api-20-16/58fb893fa751949ea20a40274e9ab219a20e19fa/e77267b5-7b4b-3f93-807c-c6d1c6b41343","info":{"title":"Cisco Catalyst SD-WAN Manager API","description":"The vManage API exposes the functionality of operations maintaining devices and the overlay network","contact":{"email":"vmanage@cisco.com"},"license":{"name":"Commercial License","url":"https://www.cisco.com/c/en/us/solutions/enterprise-networks/sd-wan/index.html"},"version":"2.0.0"},"openapi":"3.0.1","servers":[{"url":"/dataservice"}]},"spec":{"tags":["Configuration - Settings"],"summary":"Update configuration setting","description":"Update configuration setting","operationId":"editConfiguration","parameters":[{"name":"type","in":"path","description":"Type of the certificate configuration","required":true,"schema":{"type":"string"},"examples":{"CSR Properties":{"description":"CSR Properties","value":"csrproperties"},"Quarantine Expired Certificate":{"description":"Quarantine Expired Certificate","value":"quarantineExpiredCertificate"},"Enterprise Root CA":{"description":"Enterprise Root CA","value":"enterpriserootca"},"CRL Settings":{"description":"CRL Settings","value":"crlSetting"},"Certificate":{"description":"Certificate","value":"certificate"},"Hardware Root CA":{"description":"Hardware Root CA","value":"hardwarerootca"}}}],"requestBody":{"description":"Vmanage configuration setting","content":{"application/json":{"schema":{"type":"object"},"examples":{"Certificate Request":{"description":"Certificate Request","value":{"certificateSigning":"cisco","validityPeriod":"2Y","retrieveInterval":"60"},"$$ref":"#/components/examples/PutCertificateRequest"},"CSR Properties Request":{"description":"CSR Properties Request","value":{"domain_name":"ABC.cisco.com","secondary_org_unit":"","org":"ABC","location":"ABC","state":"ABC","email":"ABC@cisco.com","country":"IN","validity":"1Y","org_unit":"ABC","san_dns":"","san_uri":""},"$$ref":"#/components/examples/PostCsrPropertiesRequest"},"CRL Settings Request":{"description":"CRL Settings Request","value":{"action":"disable","crlUrl":"","pollingInterval":"","vpn":""},"$$ref":"#/components/examples/PostCrlSettingsRequest"},"Hardware Root CA Request":{"description":"Hardware Root CA Request","value":{"hardwareCertificate":"enterprise","domain_name":"","org_unit":"","secondary_org_unit":"","org":"","location":"","state":"","email":"","country":"","san_dns":"","san_uri":"","validity":"","hardwareRootCA":"-----BEGIN CERTIFICATE-----\nMIIEgDCCA2igAwIBAgIJAJ/yftGHReNGMA0GCSqGSIb3DQEBCwUAMIGGMQswCQYD\nVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTERMA8GA1UEBxMIU2FuIEpvc2Ux\nFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIGA1UEChMLdklQdGVsYSBJbmMxIjAg\nBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVsYS5jb20wHhcNMTYxMTE3MjIyODQ3\nWhcNMjYxMTE1MjIyODQ3WjCBhjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlm\nb3JuaWExETAPBgNVBAcTCFNhbiBKb3NlMRUwEwYDVQQLEwx2SVB0ZWxhIFRlc3Qx\nFDASBgNVBAoTC3ZJUHRlbGEgSW5jMSIwIAYJKoZIhvcNAQkBFhNzYW50b3NoQHZp\ncHRlbGEuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4pbD82P1\n2rdjXzP+dEx8OAND6ZogqvPPEgO1b2AGRP5v2vMFnKWdj7Qi7LBWXxKnsrpTsodP\nIxwG59sPrQdIC2r05+pW8brF4v6g8NpG1/n/MvhAYIwSduecPPYeUqPHQ4ZcoZLn\nq000eVEQ0ekpg9y5av84DnH18RDHbCfs9inbHTKuSgaaa/M72c1v+PkvYklpK/mA\n90fsGiSzPTsPztGDiVt+uCpTpNsbl+lPF3dwA0WwuEGS6WGT5jWcDeJmZ7MgoOjU\nxOYdrdOyWUx1CEhye4g0Jh/NE8BveYuQj4lj/7U2bVRhEdID7BXUtSk6Q6Czg//F\nqjFA85s97jBXLwIDAQABo4HuMIHrMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFOOD\nL0PNGWmcF+Lz3mfSyB4a+k/SMIG7BgNVHSMEgbMwgbCAFOODL0PNGWmcF+Lz3mfS\nyB4a+k/SoYGMpIGJMIGGMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5p\nYTERMA8GA1UEBxMIU2FuIEpvc2UxFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIG\nA1UEChMLdklQdGVsYSBJbmMxIjAgBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVs\nYS5jb22CCQCf8n7Rh0XjRjANBgkqhkiG9w0BAQsFAAOCAQEAO3vJTfoI/+0Mh+Fb\nPiKj17fV6TATB9JcwWzU4AlL+oK6zwO4QiiruS/3gmdMkqesBZYGubXPX34qa8LT\n/MWrpEEwREqvt5Otf/xu0mLI0TmUegm0mmsC4yH92JJRIxTuFBKCcEOpReON+AKd\n52kGIlCujDebjYL7KVfvqRv8BANIAzmmCc3qBkmhC3q/m9h/R5cTHZVwJ4zSeuBm\n6YEpmMZr+k3mmZpu9l20O6hG2MzFVCQ8ocw6LCCAzlKuxo3iS6TdcRRVOAyxYp3O\nSnsdrXl45O4XPXeWipL+GsJjc7l2YeIxB8Rcos1yCUGvh32f/gxNsGTSP+bDmd2X\nxB/c5g==\n-----END CERTIFICATE-----"},"$$ref":"#/components/examples/PutHardwareRootCARequest"},"Enterprise Root CA Request":{"description":"Enterprise Root CA Request","value":{"enterpriseRootCA":"-----BEGIN CERTIFICATE-----\nMIIEgDCCA2igAwIBAgIJAJ/yftGHReNGMA0GCSqGSIb3DQEBCwUAMIGGMQswCQYD\nVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTERMA8GA1UEBxMIU2FuIEpvc2Ux\nFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIGA1UEChMLdklQdGVsYSBJbmMxIjAg\nBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVsYS5jb20wHhcNMTYxMTE3MjIyODQ3\nWhcNMjYxMTE1MjIyODQ3WjCBhjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlm\nb3JuaWExETAPBgNVBAcTCFNhbiBKb3NlMRUwEwYDVQQLEwx2SVB0ZWxhIFRlc3Qx\nFDASBgNVBAoTC3ZJUHRlbGEgSW5jMSIwIAYJKoZIhvcNAQkBFhNzYW50b3NoQHZp\ncHRlbGEuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4pbD82P1\n2rdjXzP+dEx8OAND6ZogqvPPEgO1b2AGRP5v2vMFnKWdj7Qi7LBWXxKnsrpTsodP\nIxwG59sPrQdIC2r05+pW8brF4v6g8NpG1/n/MvhAYIwSduecPPYeUqPHQ4ZcoZLn\nq000eVEQ0ekpg9y5av84DnH18RDHbCfs9inbHTKuSgaaa/M72c1v+PkvYklpK/mA\n90fsGiSzPTsPztGDiVt+uCpTpNsbl+lPF3dwA0WwuEGS6WGT5jWcDeJmZ7MgoOjU\nxOYdrdOyWUx1CEhye4g0Jh/NE8BveYuQj4lj/7U2bVRhEdID7BXUtSk6Q6Czg//F\nqjFA85s97jBXLwIDAQABo4HuMIHrMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFOOD\nL0PNGWmcF+Lz3mfSyB4a+k/SMIG7BgNVHSMEgbMwgbCAFOODL0PNGWmcF+Lz3mfS\nyB4a+k/SoYGMpIGJMIGGMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5p\nYTERMA8GA1UEBxMIU2FuIEpvc2UxFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIG\nA1UEChMLdklQdGVsYSBJbmMxIjAgBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVs\nYS5jb22CCQCf8n7Rh0XjRjANBgkqhkiG9w0BAQsFAAOCAQEAO3vJTfoI/+0Mh+Fb\nPiKj17fV6TATB9JcwWzU4AlL+oK6zwO4QiiruS/3gmdMkqesBZYGubXPX34qa8LT\n/MWrpEEwREqvt5Otf/xu0mLI0TmUegm0mmsC4yH92JJRIxTuFBKCcEOpReON+AKd\n52kGIlCujDebjYL7KVfvqRv8BANIAzmmCc3qBkmhC3q/m9h/R5cTHZVwJ4zSeuBm\n6YEpmMZr+k3mmZpu9l20O6hG2MzFVCQ8ocw6LCCAzlKuxo3iS6TdcRRVOAyxYp3O\nSnsdrXl45O4XPXeWipL+GsJjc7l2YeIxB8Rcos1yCUGvh32f/gxNsGTSP+bDmd2X\nxB/c5g==\n-----END CERTIFICATE-----"},"$$ref":"#/components/examples/PutEnterpriseRootCARequest"},"Quarantine Expired Certificate Request":{"description":"Quarantine Expired Certificate Request","value":{"action":"enable"},"$$ref":"#/components/examples/PostQuarantineExpCertRequest"}}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"string"},"examples":{"Certificate Response":{"description":"Certificate Response","value":{"data":[{"certificateSigning":"cisco","validityPeriod":"1Y","retrieveInterval":"60"}]},"$$ref":"#/components/examples/GetCertificateResponse"},"CSR Properties Response":{"description":"CSR Properties Response","value":{"data":[{"domain_name":"ABC.cisco.com","secondary_org_unit":"","org":"ABC","location":"ABC","state":"ABC","email":"ABC@cisco.com","country":"IN","validity":"1Y","org_unit":"ABC","san_dns":"","san_uri":"","controlConnectionUp":true}]},"$$ref":"#/components/examples/GetCsrPropertiesResponse"},"CRL Settings Response":{"description":"CRL Settings Response","value":{"data":[{"action":"disable","crlUrl":"","pollingInterval":"1","vpn":"0"}]},"$$ref":"#/components/examples/GetCrlSettingsResponse"},"Enterprise Root CA Response":{"description":"Enterprise Root CA Response","value":{"data":[{"enterpriseRootCA":"-----BEGIN CERTIFICATE-----\nMIIEgDCCA2igAwIBAgIJAJ/yftGHReNGMA0GCSqGSIb3DQEBCwUAMIGGMQswCQYD\nVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTERMA8GA1UEBxMIU2FuIEpvc2Ux\nFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIGA1UEChMLdklQdGVsYSBJbmMxIjAg\nBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVsYS5jb20wHhcNMTYxMTE3MjIyODQ3\nWhcNMjYxMTE1MjIyODQ3WjCBhjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlm\nb3JuaWExETAPBgNVBAcTCFNhbiBKb3NlMRUwEwYDVQQLEwx2SVB0ZWxhIFRlc3Qx\nFDASBgNVBAoTC3ZJUHRlbGEgSW5jMSIwIAYJKoZIhvcNAQkBFhNzYW50b3NoQHZp\ncHRlbGEuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4pbD82P1\n2rdjXzP+dEx8OAND6ZogqvPPEgO1b2AGRP5v2vMFnKWdj7Qi7LBWXxKnsrpTsodP\nIxwG59sPrQdIC2r05+pW8brF4v6g8NpG1/n/MvhAYIwSduecPPYeUqPHQ4ZcoZLn\nq000eVEQ0ekpg9y5av84DnH18RDHbCfs9inbHTKuSgaaa/M72c1v+PkvYklpK/mA\n90fsGiSzPTsPztGDiVt+uCpTpNsbl+lPF3dwA0WwuEGS6WGT5jWcDeJmZ7MgoOjU\nxOYdrdOyWUx1CEhye4g0Jh/NE8BveYuQj4lj/7U2bVRhEdID7BXUtSk6Q6Czg//F\nqjFA85s97jBXLwIDAQABo4HuMIHrMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFOOD\nL0PNGWmcF+Lz3mfSyB4a+k/SMIG7BgNVHSMEgbMwgbCAFOODL0PNGWmcF+Lz3mfS\nyB4a+k/SoYGMpIGJMIGGMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5p\nYTERMA8GA1UEBxMIU2FuIEpvc2UxFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIG\nA1UEChMLdklQdGVsYSBJbmMxIjAgBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVs\nYS5jb22CCQCf8n7Rh0XjRjANBgkqhkiG9w0BAQsFAAOCAQEAO3vJTfoI/+0Mh+Fb\nPiKj17fV6TATB9JcwWzU4AlL+oK6zwO4QiiruS/3gmdMkqesBZYGubXPX34qa8LT\n/MWrpEEwREqvt5Otf/xu0mLI0TmUegm0mmsC4yH92JJRIxTuFBKCcEOpReON+AKd\n52kGIlCujDebjYL7KVfvqRv8BANIAzmmCc3qBkmhC3q/m9h/R5cTHZVwJ4zSeuBm\n6YEpmMZr+k3mmZpu9l20O6hG2MzFVCQ8ocw6LCCAzlKuxo3iS6TdcRRVOAyxYp3O\nSnsdrXl45O4XPXeWipL+GsJjc7l2YeIxB8Rcos1yCUGvh32f/gxNsGTSP+bDmd2X\nxB/c5g==\n-----END CERTIFICATE-----","controlConnectionUp":true}]},"$$ref":"#/components/examples/GetEnterpriseRootCAResponse"},"Hardware Root CA Response":{"description":"Hardware Root CA Response","value":{"data":[{"hardwareCertificate":"enterprise","hardwareRootCA":"-----BEGIN CERTIFICATE-----\nMIIEgDCCA2igAwIBAgIJAJ/yftGHReNGMA0GCSqGSIb3DQEBCwUAMIGGMQswCQYD\nVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5pYTERMA8GA1UEBxMIU2FuIEpvc2Ux\nFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIGA1UEChMLdklQdGVsYSBJbmMxIjAg\nBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVsYS5jb20wHhcNMTYxMTE3MjIyODQ3\nWhcNMjYxMTE1MjIyODQ3WjCBhjELMAkGA1UEBhMCVVMxEzARBgNVBAgTCkNhbGlm\nb3JuaWExETAPBgNVBAcTCFNhbiBKb3NlMRUwEwYDVQQLEwx2SVB0ZWxhIFRlc3Qx\nFDASBgNVBAoTC3ZJUHRlbGEgSW5jMSIwIAYJKoZIhvcNAQkBFhNzYW50b3NoQHZp\ncHRlbGEuY29tMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4pbD82P1\n2rdjXzP+dEx8OAND6ZogqvPPEgO1b2AGRP5v2vMFnKWdj7Qi7LBWXxKnsrpTsodP\nIxwG59sPrQdIC2r05+pW8brF4v6g8NpG1/n/MvhAYIwSduecPPYeUqPHQ4ZcoZLn\nq000eVEQ0ekpg9y5av84DnH18RDHbCfs9inbHTKuSgaaa/M72c1v+PkvYklpK/mA\n90fsGiSzPTsPztGDiVt+uCpTpNsbl+lPF3dwA0WwuEGS6WGT5jWcDeJmZ7MgoOjU\nxOYdrdOyWUx1CEhye4g0Jh/NE8BveYuQj4lj/7U2bVRhEdID7BXUtSk6Q6Czg//F\nqjFA85s97jBXLwIDAQABo4HuMIHrMAwGA1UdEwQFMAMBAf8wHQYDVR0OBBYEFOOD\nL0PNGWmcF+Lz3mfSyB4a+k/SMIG7BgNVHSMEgbMwgbCAFOODL0PNGWmcF+Lz3mfS\nyB4a+k/SoYGMpIGJMIGGMQswCQYDVQQGEwJVUzETMBEGA1UECBMKQ2FsaWZvcm5p\nYTERMA8GA1UEBxMIU2FuIEpvc2UxFTATBgNVBAsTDHZJUHRlbGEgVGVzdDEUMBIG\nA1UEChMLdklQdGVsYSBJbmMxIjAgBgkqhkiG9w0BCQEWE3NhbnRvc2hAdmlwdGVs\nYS5jb22CCQCf8n7Rh0XjRjANBgkqhkiG9w0BAQsFAAOCAQEAO3vJTfoI/+0Mh+Fb\nPiKj17fV6TATB9JcwWzU4AlL+oK6zwO4QiiruS/3gmdMkqesBZYGubXPX34qa8LT\n/MWrpEEwREqvt5Otf/xu0mLI0TmUegm0mmsC4yH92JJRIxTuFBKCcEOpReON+AKd\n52kGIlCujDebjYL7KVfvqRv8BANIAzmmCc3qBkmhC3q/m9h/R5cTHZVwJ4zSeuBm\n6YEpmMZr+k3mmZpu9l20O6hG2MzFVCQ8ocw6LCCAzlKuxo3iS6TdcRRVOAyxYp3O\nSnsdrXl45O4XPXeWipL+GsJjc7l2YeIxB8Rcos1yCUGvh32f/gxNsGTSP+bDmd2X\nxB/c5g==\n-----END CERTIFICATE-----","controlConnectionUp":false}]},"$$ref":"#/components/examples/GetHardwareRootCAResponse"},"Quarantine Expired Certificate Response":{"description":"Quarantine Expired Certificate Response","value":{"data":[{"action":"enable","dbPollingInterval":"10"}]},"$$ref":"#/components/examples/PostQuarantineExpCertResponse"}}}}},"400":{"description":"Bad Request"},"403":{"description":"Forbidden"},"500":{"description":"Internal Server"}},"__originalOperationId":"editConfiguration","method":"put","path":"/settings/configuration/{type}"}}