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

getInstances

suspend fun getInstances(argument: GetInstancesPlainArgs): GetInstancesResult

The Instances data source list ECS instance resources according to their ID, name regex, image id, status and other fields.

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.GetInstancesArgs;
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 instancesDs = EcsFunctions.getInstances(GetInstancesArgs.builder()
            .nameRegex("web_server")
            .status("Running")
            .build());
        ctx.export("firstInstanceId", instancesDs.applyValue(getInstancesResult -> getInstancesResult.instances()[0].id()));
        ctx.export("instanceIds", instancesDs.applyValue(getInstancesResult -> getInstancesResult.ids()));
    }
}
Content copied to clipboard

Return

A collection of values returned by getInstances.

Parameters

argument

A collection of arguments for invoking getInstances.

suspend fun getInstances(availabilityZone: String? = null, ids: List<String>? = null, imageId: String? = null, nameRegex: String? = null, outputFile: String? = null, pageNumber: Int? = null, pageSize: Int? = null, ramRoleName: String? = null, resourceGroupId: String? = null, status: String? = null, tags: Map<String, Any>? = null, vpcId: String? = null, vswitchId: String? = null): GetInstancesResult

Return

A collection of values returned by getInstances.

See also

Parameters

availabilityZone

Availability zone where instances are located.

ids

A list of ECS instance IDs.

imageId

The image ID of some ECS instance used.

nameRegex

A regex string to filter results by instance name.

outputFile
pageNumber
pageSize
ramRoleName

The RAM role name which the instance attaches.

resourceGroupId

The Id of resource group which the instance belongs.

status

Instance status. Valid values: "Creating", "Starting", "Running", "Stopping" and "Stopped". If undefined, all statuses are considered.

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 taggedInstances = alicloud.ecs.getInstances({
    tags: {
        tagKey1: "tagValue1",
        tagKey2: "tagValue2",
    },
});
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
tagged_instances = alicloud.ecs.get_instances(tags={
    "tagKey1": "tagValue1",
    "tagKey2": "tagValue2",
})
Content copied to clipboard
using System.Collections.Generic;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var taggedInstances = AliCloud.Ecs.GetInstances.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.GetInstances(ctx, &ecs.GetInstancesArgs{
			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.GetInstancesArgs;
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 taggedInstances = EcsFunctions.getInstances(GetInstancesArgs.builder()
            .tags(Map.ofEntries(
                Map.entry("tagKey1", "tagValue1"),
                Map.entry("tagKey2", "tagValue2")
            ))
            .build());
    }
}
Content copied to clipboard
variables:
  taggedInstances:
    fn::invoke:
      Function: alicloud:ecs:getInstances
      Arguments:
        tags:
          tagKey1: tagValue1
          tagKey2: tagValue2
Content copied to clipboard
vpcId

ID of the VPC linked to the instances.

vswitchId

ID of the VSwitch linked to the instances.

suspend fun getInstances(argument: suspend GetInstancesPlainArgsBuilder.() -> Unit): GetInstancesResult

Return

A collection of values returned by getInstances.

See also

Parameters

argument

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