Sign in Dashboard Get started
  1. Packages
  2. Packages
  3. Cisco Catalyst SD-WAN Provider
  4. API Docs
  5. ActivateTopologyGroup
Viewing docs for Cisco Catalyst SD-WAN v0.9.2
published on Wednesday, Jul 29, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-sdwan

sdwan.ActivateTopologyGroup

sdwan logo
Viewing docs for Cisco Catalyst SD-WAN v0.9.2
published on Wednesday, Jul 29, 2026 by Pulumi
Schema (JSON)
pulumi/pulumi-sdwan

    This resource can activate a topology group. Only one topology group can be active at a time. To switch the active group, change the id attribute on the existing resource in place instead of replacing the resource (destroy + create); an in-place change issues a single activation that supersedes the previous group, whereas a replacement deactivates the previous group first and withdraws all overlay control policy from the vSmarts during the switch.

    • Minimum SD-WAN Manager version: 20.15.0

    Create ActivateTopologyGroup Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new ActivateTopologyGroup(name: string, args: ActivateTopologyGroupArgs, opts?: CustomResourceOptions);
    @overload
def ActivateTopologyGroup(resource_name: str,
                          args: ActivateTopologyGroupArgs,
                          opts: Optional[ResourceOptions] = None)

@overload
def ActivateTopologyGroup(resource_name: str,
                          opts: Optional[ResourceOptions] = None,
                          activate_topology_group_id: Optional[str] = None,
                          feature_versions: Optional[Sequence[str]] = None)
    func NewActivateTopologyGroup(ctx *Context, name string, args ActivateTopologyGroupArgs, opts ...ResourceOption) (*ActivateTopologyGroup, error)
    public ActivateTopologyGroup(string name, ActivateTopologyGroupArgs args, CustomResourceOptions? opts = null)
    public ActivateTopologyGroup(String name, ActivateTopologyGroupArgs args)
public ActivateTopologyGroup(String name, ActivateTopologyGroupArgs args, CustomResourceOptions options)

    type: sdwan:ActivateTopologyGroup
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.


    resource "sdwan_activate_topology_group" "name" {
    # resource properties
}

    Parameters

    name string
    The unique name of the resource.
    args ActivateTopologyGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ActivateTopologyGroupArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ActivateTopologyGroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ActivateTopologyGroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ActivateTopologyGroupArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var activateTopologyGroupResource = new Sdwan.ActivateTopologyGroup("activateTopologyGroupResource", new()
{
    ActivateTopologyGroupId = "string",
    FeatureVersions = new[]
    {
        "string",
    },
});

    example, err := sdwan.NewActivateTopologyGroup(ctx, "activateTopologyGroupResource", &sdwan.ActivateTopologyGroupArgs{
	ActivateTopologyGroupId: pulumi.String("string"),
	FeatureVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
})

    resource "sdwan_activate_topology_group" "activateTopologyGroupResource" {
  lifecycle {
    create_before_destroy = true
  }
  activate_topology_group_id = "string"
  feature_versions           = ["string"]
}

    var activateTopologyGroupResource = new ActivateTopologyGroup("activateTopologyGroupResource", ActivateTopologyGroupArgs.builder()
    .activateTopologyGroupId("string")
    .featureVersions("string")
    .build());

    activate_topology_group_resource = sdwan.ActivateTopologyGroup("activateTopologyGroupResource",
    activate_topology_group_id="string",
    feature_versions=["string"])

    const activateTopologyGroupResource = new sdwan.ActivateTopologyGroup("activateTopologyGroupResource", {
    activateTopologyGroupId: "string",
    featureVersions: ["string"],
});

    type: sdwan:ActivateTopologyGroup
properties:
    activateTopologyGroupId: string
    featureVersions:
        - string

    ActivateTopologyGroup Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The ActivateTopologyGroup resource accepts the following input properties:

    ActivateTopologyGroupId string
    The ID of the topology group to activate
    FeatureVersions List<string>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    ActivateTopologyGroupId string
    The ID of the topology group to activate
    FeatureVersions []string
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activate_topology_group_id string
    The ID of the topology group to activate
    feature_versions list(string)
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId String
    The ID of the topology group to activate
    featureVersions List<String>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId string
    The ID of the topology group to activate
    featureVersions string[]
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activate_topology_group_id str
    The ID of the topology group to activate
    feature_versions Sequence[str]
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId String
    The ID of the topology group to activate
    featureVersions List<String>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the ActivateTopologyGroup resource produces the following output properties:

    DeployedVersion int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    Id string
    The provider-assigned unique ID for this managed resource.
    DeployedVersion int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    Id string
    The provider-assigned unique ID for this managed resource.
    deployed_version number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    id string
    The provider-assigned unique ID for this managed resource.
    deployedVersion Integer
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    id String
    The provider-assigned unique ID for this managed resource.
    deployedVersion number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    id string
    The provider-assigned unique ID for this managed resource.
    deployed_version int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    id str
    The provider-assigned unique ID for this managed resource.
    deployedVersion Number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    id String
    The provider-assigned unique ID for this managed resource.

    Look up Existing ActivateTopologyGroup Resource

    Get an existing ActivateTopologyGroup resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ActivateTopologyGroupState, opts?: CustomResourceOptions): ActivateTopologyGroup
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        activate_topology_group_id: Optional[str] = None,
        deployed_version: Optional[int] = None,
        feature_versions: Optional[Sequence[str]] = None) -> ActivateTopologyGroup
    func GetActivateTopologyGroup(ctx *Context, name string, id IDInput, state *ActivateTopologyGroupState, opts ...ResourceOption) (*ActivateTopologyGroup, error)
    public static ActivateTopologyGroup Get(string name, Input<string> id, ActivateTopologyGroupState? state, CustomResourceOptions? opts = null)
    public static ActivateTopologyGroup get(String name, Output<String> id, ActivateTopologyGroupState state, CustomResourceOptions options)
    resources:  _:    type: sdwan:ActivateTopologyGroup    get:      id: ${id}
    import {
  to = sdwan_activate_topology_group.example
  id = "${id}"
}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    ActivateTopologyGroupId string
    The ID of the topology group to activate
    DeployedVersion int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    FeatureVersions List<string>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    ActivateTopologyGroupId string
    The ID of the topology group to activate
    DeployedVersion int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    FeatureVersions []string
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activate_topology_group_id string
    The ID of the topology group to activate
    deployed_version number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    feature_versions list(string)
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId String
    The ID of the topology group to activate
    deployedVersion Integer
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    featureVersions List<String>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId string
    The ID of the topology group to activate
    deployedVersion number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    featureVersions string[]
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activate_topology_group_id str
    The ID of the topology group to activate
    deployed_version int
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    feature_versions Sequence[str]
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.
    activateTopologyGroupId String
    The ID of the topology group to activate
    deployedVersion Number
    Server-side version of the topology group captured at last activation. Used internally for drift detection.
    featureVersions List<String>
    List of all associated feature versions. Any change to this list will trigger a re-deployment of the topology group.

    Package Details

    Repository
    sdwan pulumi/pulumi-sdwan
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the sdwan Terraform Provider.
    sdwan logo
    Viewing docs for Cisco Catalyst SD-WAN v0.9.2
    published on Wednesday, Jul 29, 2026 by Pulumi
    Schema (JSON)
    pulumi/pulumi-sdwan

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial