Users Guide

CLI commands for RESTCONF API
rest api restconf
Enables the RESTCONF API service on the switch.
Syntax
rest api restconf
Parameters None
Default RESTCONF API is disabled.
Command Mode CONFIGURATION
Usage
Information
● After you enable the RESTCONF API, you can send curl commands in HTTPS requests from a remote
device.
● The no version of the command disables the RESTCONF API.
Example
OS10(config)# rest api restconf
Supported
Releases
10.4.1.0 or later
rest https cipher-suite
Limits the ciphers to encrypt and decrypt REST HTTPS data.
Syntax
rest https cipher-suite cipher-list
Parameters cipher-list — Enter the ciphers supported in a REST API HTTPS session. Separate multiple entries
with a blank space. Valid cipher suites are:
● dhe-rsa-with-aes-128-gcm-SHA256
● dhe-rsa-with-aes-256-gcm-SHA384
● ecdhe-rsa-with-aes-128-gcm-SHA256
● ecdhe-rsa-with-aes-256-gcm-SHA384
Default All cipher suites installed with OS10 are supported.
Command Mode CONFIGURATION
Usage
Information
● Use the rest https cipher-suite command to restrict the ciphers that a RESTCONF HTTPS
session uses.
● The no version of the command removes the cipher list and restores the default value.
Example
OS10(config)# rest https cipher-suite dhe-rsa-with-aes-128-gcm-SHA256
dhe-rsa-with-aes-256-gcm-SHA384 ecdhe-rsa-with-aes-256-gcm-SHA384
Supported
Releases
10.4.1.0 or later
rest https server-certificate
Creates the SSL self-signed server certificate a RESTCONF HTTPS connection uses.
Syntax
rest https server-certificate name hostname
Parameters name hostname — Enter the IP address or domain name of the OS10 switch.
Default The OS10 switch domain name is used as the hostname.
Command Mode CONFIGURATION
RESTCONF API 1749