Cisco Catalyst SD-WAN Provider

Installation

The Cisco Catalyst SD-WAN provider is available as a package in all Pulumi languages:

• JavaScript/TypeScript: @pulumi/sdwan
• Python: pulumi-sdwan
• Go: github.com/pulumi/pulumi-sdwan/sdk/go/sdwan
• .NET: Pulumi.Sdwan
• Java: com.pulumi/sdwan

Overview

The SDWAN provider provides resources to interact with a Cisco Catalyst SD-WAN environment. It communicates with the SD-WAN Manager via the REST API.

All resources and functions have been tested with the following releases.

Please note: We no longer support or test UX 2.0 resources against 20.12.

Please note: 20.18 support is being rolled out incrementally. Every resource that works on 20.15 is also being tested against a 20.18 lab, but not every UX 2.0 resource has been updated with the full set of 20.18 attributes yet - see the changelog for which resources have been bumped to the 20.18 release.

Example Usage

Username/Password Authentication

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:
config:
    sdwan:password:
        value: password
    sdwan:url:
        value: https://10.1.1.1
    sdwan:username:
        value: admin

API Token Authentication

Alternatively, you can use an API token for authentication:

# Pulumi.yaml provider configuration file
name: configuration-example
runtime:
config:
    sdwan:apiToken:
        value: my-api-token
    sdwan:url:
        value: https://10.1.1.1

Configuration Reference

• apiToken (String, Sensitive) API Token for the SD-WAN Manager. Can be used instead of username and password. This can also be set as the SDWAN_API_TOKEN environment variable.
• deployOnOutOfDate (Boolean) When enabled, Pulumi will detect when a configuration group or policy group device is out of date during refresh and trigger a re-deploy on next apply. This can also be set as the SDWAN_DEPLOY_ON_OUT_OF_DATE environment variable. Defaults to true.
• insecure (Boolean) Allow insecure HTTPS client. This can also be set as the SDWAN_INSECURE environment variable. Defaults to true.
• password (String, Sensitive) Password for the SD-WAN Manager account. This can also be set as the SDWAN_PASSWORD environment variable.
• retries (Number) Number of retries for REST API calls. This can also be set as the SDWAN_RETRIES environment variable. Defaults to 3.
• taskTimeout (Number) Timeout in seconds for asynchronous tasks. This can also be set as the SDWAN_TASK_TIMEOUT environment variable. Defaults to 1500.
• url (String) URL of the Cisco SD-WAN Manager device. This can also be set as the SDWAN_URL environment variable.
• username (String) Username for the SD-WAN Manager account. This can also be set as the SDWAN_USERNAME environment variable.