/api/space/configuration-management/cli-configlets/{configlet-id} (v1)

The following operations are supported on this resource:

  • GET - Gets a single CLI configlet
  • PUT - Updates a CLI configlet
  • DELETE - Deletes a CLI configlet
GET /cli-configlets/{configlet-id}Version 1

This API is used to get a CLI configlet by its configlet ID.

Sample Usage

GET /cli-configlets/{configlet-id}


  • Parameters:
    NameTypeURI TypeDescriptionRequired
    idintPathCLIConfiglet id The ID of the configlet to retrieve. Y
  • Sample Output XML:
    <cli-configlet uri="/api/space/configuration-management/cli-configlets/3145734">
      <id>3145734</id>
      <name>ramesh</name>
      <category>Examples</category>
      <context>tr</context>
      <device-family>EX</device-family>
      <execution-type>Single</execution-type>
      <latest-version>1.0</latest-version>
      <creation-time>Nov 27, 2012 3:19:09 PM</creation-time>
      <last-updated-time>Nov 28, 2012 4:46:38 PM</last-updated-time>
      <last-modified-by>super</last-modified-by>
      <preview-show-parameters>true</preview-show-parameters>
      <preview-show-configuration>true</preview-show-configuration>
      <postview-show-parameters>true</postview-show-parameters>
      <postview-show-configuration>true</postview-show-configuration>
      <description>Single Execution - Port Description Example</description>
      <domain-id>2</domain-id>
      <domain-name>Global</domain-name>
      <domain href="/api/space/domain-management/domains/2" />
      <cli-configlet-params href="/api/space/configuration-management/cli-configlets/3145734/cli-configlet-params" />
      <cli-configlet-pages href="/api/space/configuration-management/cli-configlets/3145734/cli-configlet-pages" />
      <apply-configlet href="/api/space/configuration-management/cli-configlets/3145734/apply-configlet" />
      <preview-cli-configlet href="/api/space/configuration-management/cli-configlets/3145734/preview-cli-configlet" />
      <apply-cli-configlet href="/api/space/configuration-management/cli-configlets/3145734/apply-cli-configlet" />
      <submit-cli-configlet href="/api/space/configuration-management/cli-configlets/3145734/submit-cli-configlet" />
      <applicable-devices href="/api/space/configuration-management/cli-configlets/3145734/applicable-devices" />
      <validate-cli-configlet href="/api/space/configuration-management/cli-configlets/3145734/validate-cli-configlet" />
    </cli-configlet>

  • Sample Output JSON:
    {
      "cli-configlet": {
        "@uri": "/api/space/configuration-management/cli-configlets/3145734",
        "id": "3145734",
        "name": "ramesh",
        "category": "Examples",
        "context": "tr",
        "device-family": "EX",
        "execution-type": "Single",
        "latest-version": "1.0",
        "creation-time": "Nov 27, 2012 3:19:09 PM",
        "last-updated-time": "Nov 28, 2012 4:46:38 PM",
        "last-modified-by": "super",
        "preview-show-parameters": "true",
        "preview-show-configuration": "true",
        "postview-show-parameters": "true",
        "postview-show-configuration": "true",
        "description": "Single Execution - Port Description Example",
        "domain-id": "2",
        "domain-name": "Global",
        "domain": {
          "@href": "/api/space/domain-management/domains/2"
        },
        "cli-configlet-params": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/cli-configlet-params"
        },
        "cli-configlet-pages": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/cli-configlet-pages"
        },
        "apply-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/apply-configlet"
        },
        "preview-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/preview-cli-configlet"
        },
        "apply-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/apply-cli-configlet"
        },
        "submit-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/submit-cli-configlet"
        },
        "applicable-devices": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/applicable-devices"
        },
        "validate-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/3145734/validate-cli-configlet"
        }
      }
    }

  • Access Control

    The following capabilities are required to access this API: ViewCliTemplateCap

      For the current version of this API, refer to :
    • version 2

    PUT /cli-configlets/{configlet-id}Version 1

    This API is used to update the CLI configlet.

    Sample Usage

    PUT /cli-configlets/{configlet-id}


    • Parameters:
      NameTypeURI TypeDescriptionRequired
      idIntegerPathThe ID of the CLI Configlet Y
  • Sample Input XML:
    <cli-configlet>
      <name>m</name>
      <category>catmodi</category>
      <context>context</context>
      <device-family>EX</device-family>
      <description>description</description>
      <cli-configlet-params>
        <cli-configlet-param>
          <parameter>variable</parameter>
          <xpath>xpath</xpath>
          <display-name>dispaly name</display-name>
          <default-value>default</default-value>
          <param-order>1</param-order>
          <param-type>READWRITE</param-type>
        </cli-configlet-param>
        <cli-configlet-param>
          <parameter>variable</parameter>
          <xpath>xpath</xpath>
          <display-name>dispaly name</display-name>
          <default-value>default</default-value>
          <param-order>sdfsf</param-order>
          <param-type>READWRITE</param-type>
        </cli-configlet-param>
      </cli-configlet-params>
      <cli-configlet-pages>
        <cli-configlet-page>
          <cli-text>page1</cli-text>
          <pagenumber>2</pagenumber>
        </cli-configlet-page>
        <cli-configlet-page>
          <cli-text>page2</cli-text>
          <pagenumber>2</pagenumber>
        </cli-configlet-page>
      </cli-configlet-pages>
    </cli-configlet>

  • Sample Output XML:
    <cli-configlet uri="/api/space/configuration-management/cli-configlets/491538">
      <id>491538</id>
      <name>Example 1</name>
      <category>Examples</category>
      <context>/device/interface-information/physical-interface|/device/configuration/interfaces/interface</context>
      <device-family>ACX/J/M/MX/T/TX/PTX/EX92xx/EX43xx</device-family>
      <execution-type>Single</execution-type>
      <latest-version>1.0</latest-version>
      <creation-time>Jan 18, 2017 4:07:49 PM</creation-time>
      <last-updated-time>Jan 18, 2017 4:07:49 PM</last-updated-time>
      <last-modified-by>SYSTEM</last-modified-by>
      <preview-show-parameters>true</preview-show-parameters>
      <preview-show-configuration>true</preview-show-configuration>
      <postview-show-parameters>true</postview-show-parameters>
      <postview-show-configuration>true</postview-show-configuration>
      <description>Single Execution - Port Description Example</description>
      <domain-id>2</domain-id>
      <domain-name>Global</domain-name>
      <domain href="/api/space/domain-management/domains/2" />
      <cli-configlet-params href="/api/space/configuration-management/cli-configlets/491538/cli-configlet-params" />
      <cli-configlet-pages href="/api/space/configuration-management/cli-configlets/491538/cli-configlet-pages" />
      <apply-configlet href="/api/space/configuration-management/cli-configlets/491538/apply-configlet" />
      <preview-cli-configlet href="/api/space/configuration-management/cli-configlets/491538/preview-cli-configlet" />
      <apply-cli-configlet href="/api/space/configuration-management/cli-configlets/491538/apply-cli-configlet" />
      <submit-cli-configlet href="/api/space/configuration-management/cli-configlets/491538/submit-cli-configlet" />
      <applicable-devices href="/api/space/configuration-management/cli-configlets/491538/applicable-devices" />
      <validate-cli-configlet href="/api/space/configuration-management/cli-configlets/491538/validate-cli-configlet" />
    </cli-configlet>

  • Sample Input JSON:
    {
      "cli-configlet": {
        "name": "m",
        "category": "catmodi",
        "context": "context",
        "device-family": "EX",
        "description": "description",
        "cli-configlet-params": {
          "cli-configlet-param": [
            {
              "parameter": "variable",
              "xpath": "xpath",
              "display-name": "dispaly name",
              "default-value": "default",
              "param-order": "1",
              "param-type": "READWRITE"
            },
            {
              "parameter": "variable",
              "xpath": "xpath",
              "display-name": "dispaly name",
              "default-value": "default",
              "param-order": "sdfsf",
              "param-type": "READWRITE"
            }
          ]
        },
        "cli-configlet-pages": {
          "cli-configlet-page": [
            {
              "cli-text": "page1",
              "pagenumber": "2"
            },
            {
              "cli-text": "page2",
              "pagenumber": "2"
            }
          ]
        }
      }
    }

  • Sample Output JSON:
    {
      "cli-configlet": {
        "@uri": "/api/space/configuration-management/cli-configlets/491538",
        "id": "491538",
        "name": "Example 1",
        "category": "Examples",
        "context": "/device/interface-information/physical-interface|/device/configuration/interfaces/interface",
        "device-family": "ACX/J/M/MX/T/TX/PTX/EX92xx/EX43xx",
        "execution-type": "Single",
        "latest-version": "1.0",
        "creation-time": "Jan 18, 2017 4:07:49 PM",
        "last-updated-time": "Jan 18, 2017 4:07:49 PM",
        "last-modified-by": "SYSTEM",
        "preview-show-parameters": "true",
        "preview-show-configuration": "true",
        "postview-show-parameters": "true",
        "postview-show-configuration": "true",
        "description": "Single Execution - Port Description Example",
        "domain-id": "2",
        "domain-name": "Global",
        "domain": {
          "@href": "/api/space/domain-management/domains/2"
        },
        "cli-configlet-params": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/cli-configlet-params"
        },
        "cli-configlet-pages": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/cli-configlet-pages"
        },
        "apply-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/apply-configlet"
        },
        "preview-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/preview-cli-configlet"
        },
        "apply-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/apply-cli-configlet"
        },
        "submit-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/submit-cli-configlet"
        },
        "applicable-devices": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/applicable-devices"
        },
        "validate-cli-configlet": {
          "@href": "/api/space/configuration-management/cli-configlets/491538/validate-cli-configlet"
        }
      }
    }

  • Access Control

    The following capabilities are required to access this API: EditCliTemplateCap

      For the current version of this API, refer to :
    • version 2

    DELETE /cli-configlets/{configlet-id}Version 1

    This API is used to delete the CLI configlet.

    Sample Usage

    DELETE /cli-configlets/{configlet-id}


    • Parameters:
      NameTypeURI TypeDescriptionRequired
      idIntegerPathThe ID of the CLI configlet to delete Y

    Access Control

    The following capabilities are required to access this API: DeleteCliTemplateCap

      For the current version of this API, refer to :
    • version 3