pulumi-alicloud-kotlin/com.pulumi.alicloud.bastionhost.kotlin/BastionhostFunctions/getInstances

getInstances

suspend fun getInstances(argument: GetInstancesPlainArgs): GetInstancesResult

NOTE: From the version 1.132.0, the data source has been renamed to alicloud.bastionhost.getInstances. This data source provides a list of cloud Bastionhost instances in an Alibaba Cloud account according to the specified filters. NOTE: Available in 1.63.0+ .

Example Usage

package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.bastionhost.BastionhostFunctions;
import com.pulumi.alicloud.bastionhost.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 instanceInstances = BastionhostFunctions.getInstances(GetInstancesArgs.builder()
            .descriptionRegex("^bastionhost")
            .build());
        ctx.export("instance", alicloud_bastionhost_instances.instance().stream().map(element -> element.id()).collect(toList()));
    }
}
Content copied to clipboard

Return

A collection of values returned by getInstances.

Parameters

argument

A collection of arguments for invoking getInstances.

suspend fun getInstances(descriptionRegex: String? = null, ids: List<String>? = null, outputFile: String? = null, tags: Map<String, Any>? = null): GetInstancesResult

Return

A collection of values returned by getInstances.

See also

Parameters

descriptionRegex

A regex string to filter results by the instance description.

ids

Matched instance IDs to filter data source result.

outputFile

File name to persist data source output.

tags

A map of tags assigned to the bastionhost instance. It must be in the format:

import * as pulumi from "@pulumi/pulumi";
import * as alicloud from "@pulumi/alicloud";
const instance = alicloud.bastionhost.getInstances({
    tags: {
        tagKey1: "tagValue1",
    },
});
Content copied to clipboard
import pulumi
import pulumi_alicloud as alicloud
instance = alicloud.bastionhost.get_instances(tags={
    "tagKey1": "tagValue1",
})
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;
return await Deployment.RunAsync(() =>
{
    var instance = AliCloud.BastionHost.GetInstances.Invoke(new()
    {
        Tags =
        {
            { "tagKey1", "tagValue1" },
        },
    });
});
Content copied to clipboard
package main
import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/bastionhost"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := bastionhost.GetInstances(ctx, &bastionhost.GetInstancesArgs{
			Tags: map[string]interface{}{
				"tagKey1": "tagValue1",
			},
		}, 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.bastionhost.BastionhostFunctions;
import com.pulumi.alicloud.bastionhost.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 instance = BastionhostFunctions.getInstances(GetInstancesArgs.builder()
            .tags(Map.of("tagKey1", "tagValue1"))
            .build());
    }
}
Content copied to clipboard
variables:
  instance:
    fn::invoke:
      Function: alicloud:bastionhost:getInstances
      Arguments:
        tags:
          tagKey1: tagValue1
Content copied to clipboard
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.bastionhost.kotlin.inputs.GetInstancesPlainArgs.