pulumi-alicloud-kotlin/com.pulumi.alicloud.ecs.kotlin/EcsFunctions/getSecurityGroups

getSecurityGroups

suspend fun getSecurityGroups(argument: GetSecurityGroupsPlainArgs): GetSecurityGroupsResult

This data source provides a list of Security Groups in an Alibaba Cloud account according to the specified filters.

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetSecurityGroupsArgs;
import com.pulumi.alicloud.vpc.Network;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var secGroupsDs = EcsFunctions.getSecurityGroups(GetSecurityGroupsArgs.builder()
            .nameRegex("^web-")
            .outputFile("web_access.json")
            .build());
        var primaryVpcDs = new Network("primaryVpcDs");
        final var primarySecGroupsDs = EcsFunctions.getSecurityGroups(GetSecurityGroupsArgs.builder()
            .vpcId(primaryVpcDs.id())
            .build());
        ctx.export("firstGroupId", primarySecGroupsDs.applyValue(getSecurityGroupsResult -> getSecurityGroupsResult).applyValue(primarySecGroupsDs -> primarySecGroupsDs.applyValue(getSecurityGroupsResult -> getSecurityGroupsResult.groups()[0].id())));
    }
}
Content copied to clipboard

Return

A collection of values returned by getSecurityGroups.

Parameters

argument

A collection of arguments for invoking getSecurityGroups.

suspend fun getSecurityGroups(enableDetails: Boolean? = null, ids: List<String>? = null, nameRegex: String? = null, outputFile: String? = null, pageNumber: Int? = null, pageSize: Int? = null, resourceGroupId: String? = null, tags: Map<String, Any>? = null, vpcId: String? = null): GetSecurityGroupsResult

Return

A collection of values returned by getSecurityGroups.

See also

Parameters

enableDetails
ids

A list of Security Group IDs.

nameRegex

A regex string to filter the resulting security groups by their names.

outputFile

File name where to save data source results (after running pulumi preview).

pageNumber
pageSize
resourceGroupId

The Id of resource group which the security_group belongs.

tags

A map of tags assigned to the ECS instances. It must be in the format:

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const taggedSecurityGroups = alicloud.ecs.getSecurityGroups({
    tags: {
        tagKey1: "tagValue1",
        tagKey2: "tagValue2",
    },
});
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
tagged_security_groups = alicloud.ecs.get_security_groups(tags={
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2",
})
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var taggedSecurityGroups = AliCloud.Ecs.GetSecurityGroups.Invoke(new()
    {
        Tags =
        {
            { "tagKey1", "tagValue1" },
            { "tagKey2", "tagValue2" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ecs"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ecs.GetSecurityGroups(ctx, &ecs.GetSecurityGroupsArgs{
			Tags: map[string]interface{}{
				"tagKey1": "tagValue1",
				"tagKey2": "tagValue2",
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ecs.EcsFunctions;
import com.pulumi.alicloud.ecs.inputs.GetSecurityGroupsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var taggedSecurityGroups = EcsFunctions.getSecurityGroups(GetSecurityGroupsArgs.builder()
            .tags(Map.ofEntries(
                Map.entry("tagKey1", "tagValue1"),
                Map.entry("tagKey2", "tagValue2")
            ))
            .build());
    }
}
Content copied to clipboard
variables:
  taggedSecurityGroups:
    fn::invoke:
      Function: alicloud:ecs:getSecurityGroups
      Arguments:
        tags:
          tagKey1: tagValue1
          tagKey2: tagValue2
Content copied to clipboard
vpcId

Used to retrieve security groups that belong to the specified VPC ID.

suspend fun getSecurityGroups(argument: suspend GetSecurityGroupsPlainArgsBuilder.() -> Unit): GetSecurityGroupsResult

Return

A collection of values returned by getSecurityGroups.

See also

Parameters

argument

Builder for com.pulumi.alicloud.ecs.kotlin.inputs.GetSecurityGroupsPlainArgs.