Getting Started

Obtain your API Key

isctl interacts with the Cisco Intersight REST API, so it needs an API key and key ID.

1. Login to the Intersight GUI.
2. Generate a new API Key (under Settings -> API Keys). Choose "API key for OpenAPI schema version 2" as the API Key Purpose.
3. Save the key somewhere on your desktop and make a note of the key ID.

Configure isctl

Run isctl configure to configure it to use your API key. Follow the prompts for your key ID and path to the key file.

keyID is currently ''
Enter new keyID or press Enter to keep existing: 123456789012345678901234/123456789012345678901234/123456789012345678901234
key filename is currently ''
Enter new key file name or press Enter to keep existing: /Users/chris/intersight-key.pem
2020/06/25 17:28:22 Writing config file

isctl is now configured and ready to use.

Execute your first query

isctl get ntp policy

Output:

------------  -----------------------------  ------------------------  -----------------------------
    Enabled                           Moid                      Name                     NtpServers
------------  -----------------------------  ------------------------  -----------------------------
      False       5ecb069c6275722d3143e668           test-ntp-policy

       True       5ee1aa076275722d3122a944          cg-tf-ntp-test-1       10.10.10.10, 10.10.10.12
------------  -----------------------------  ------------------------  -----------------------------