Dell EMC SmartFabric OS10 User Guide Release 10.5.0

Using the RESTCONF API, you can provision OS10 switches using HTTPS requests. The examples in this section show how to access the OS10 RESTCONF API using curl commands. curl is a Linux shell command that generates HTTPS requests and is executed on an external server.

curl Commands

In curl commands, use %2F to represent a backslash (/); for example, enter ethernet1/2/3 as ethernet1%2F1%2F3.

Usage Information

Consider the following when accessing OS10 RESTCONF API using curl commands:

• Dell EMC recommends using a specific URI of the target resource for GET queries in a scaled system. For example, curl -X GET -k -u admin:admin -H "accept:application/json" https://$TARGET/restconf/data/interfaces/interface/port-channel10

  OS10 does not support REST queries on the root resource of the RESTCONF datastore. For example, the GET query, curl -X GET -k -u admin:admin https://$TARGET/restconf/data returns an error.

• When a RESTCONF query is in progress, you cannot configure any CLI commands until a RESTCONF query is complete.

• It is recommended to use POST request instead of PUT, to replace the target data resources.