tencentcloud.getAsInstances

Start a Neo task

Explain and create a tencentcloud.getAsInstances resource

tencentcloud 1.82.35 published on Friday, Nov 7, 2025 by tencentcloudstack

tencentcloudstack/terraform-provider-tencentcloud

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as tencentcloud from "@pulumi/tencentcloud";

const scalingGroup = new tencentcloud.AsScalingGroup("scaling_group", {
    scalingGroupName: "tf-as-group-ds-ins-basic",
    configurationId: "your_launch_configuration_id",
    maxSize: 1,
    minSize: 1,
    vpcId: "your_vpc_id",
    subnetIds: ["your_subnet_id"],
    tags: {
        test: "test",
    },
});
const instances = tencentcloud.getAsInstancesOutput({
    filters: [{
        name: "auto-scaling-group-id",
        values: [scalingGroup.asScalingGroupId],
    }],
});

import pulumi
import pulumi_tencentcloud as tencentcloud

scaling_group = tencentcloud.AsScalingGroup("scaling_group",
    scaling_group_name="tf-as-group-ds-ins-basic",
    configuration_id="your_launch_configuration_id",
    max_size=1,
    min_size=1,
    vpc_id="your_vpc_id",
    subnet_ids=["your_subnet_id"],
    tags={
        "test": "test",
    })
instances = tencentcloud.get_as_instances_output(filters=[{
    "name": "auto-scaling-group-id",
    "values": [scaling_group.as_scaling_group_id],
}])

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/tencentcloud/tencentcloud"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		scalingGroup, err := tencentcloud.NewAsScalingGroup(ctx, "scaling_group", &tencentcloud.AsScalingGroupArgs{
			ScalingGroupName: pulumi.String("tf-as-group-ds-ins-basic"),
			ConfigurationId:  pulumi.String("your_launch_configuration_id"),
			MaxSize:          pulumi.Float64(1),
			MinSize:          pulumi.Float64(1),
			VpcId:            pulumi.String("your_vpc_id"),
			SubnetIds: pulumi.StringArray{
				pulumi.String("your_subnet_id"),
			},
			Tags: pulumi.StringMap{
				"test": pulumi.String("test"),
			},
		})
		if err != nil {
			return err
		}
		_ = tencentcloud.GetAsInstancesOutput(ctx, tencentcloud.GetAsInstancesOutputArgs{
			Filters: tencentcloud.GetAsInstancesFilterArray{
				&tencentcloud.GetAsInstancesFilterArgs{
					Name: pulumi.String("auto-scaling-group-id"),
					Values: pulumi.StringArray{
						scalingGroup.AsScalingGroupId,
					},
				},
			},
		}, nil)
		return nil
	})
}

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Tencentcloud = Pulumi.Tencentcloud;

return await Deployment.RunAsync(() => 
{
    var scalingGroup = new Tencentcloud.AsScalingGroup("scaling_group", new()
    {
        ScalingGroupName = "tf-as-group-ds-ins-basic",
        ConfigurationId = "your_launch_configuration_id",
        MaxSize = 1,
        MinSize = 1,
        VpcId = "your_vpc_id",
        SubnetIds = new[]
        {
            "your_subnet_id",
        },
        Tags = 
        {
            { "test", "test" },
        },
    });

    var instances = Tencentcloud.GetAsInstances.Invoke(new()
    {
        Filters = new[]
        {
            new Tencentcloud.Inputs.GetAsInstancesFilterInputArgs
            {
                Name = "auto-scaling-group-id",
                Values = new[]
                {
                    scalingGroup.AsScalingGroupId,
                },
            },
        },
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.tencentcloud.AsScalingGroup;
import com.pulumi.tencentcloud.AsScalingGroupArgs;
import com.pulumi.tencentcloud.TencentcloudFunctions;
import com.pulumi.tencentcloud.inputs.GetAsInstancesArgs;
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) {
        var scalingGroup = new AsScalingGroup("scalingGroup", AsScalingGroupArgs.builder()
            .scalingGroupName("tf-as-group-ds-ins-basic")
            .configurationId("your_launch_configuration_id")
            .maxSize(1.0)
            .minSize(1.0)
            .vpcId("your_vpc_id")
            .subnetIds("your_subnet_id")
            .tags(Map.of("test", "test"))
            .build());

        final var instances = TencentcloudFunctions.getAsInstances(GetAsInstancesArgs.builder()
            .filters(GetAsInstancesFilterArgs.builder()
                .name("auto-scaling-group-id")
                .values(scalingGroup.asScalingGroupId())
                .build())
            .build());

    }
}

resources:
  scalingGroup:
    type: tencentcloud:AsScalingGroup
    name: scaling_group
    properties:
      scalingGroupName: tf-as-group-ds-ins-basic
      configurationId: your_launch_configuration_id
      maxSize: 1
      minSize: 1
      vpcId: your_vpc_id
      subnetIds:
        - your_subnet_id
      tags:
        test: test
variables:
  instances:
    fn::invoke:
      function: tencentcloud:getAsInstances
      arguments:
        filters:
          - name: auto-scaling-group-id
            values:
              - ${scalingGroup.asScalingGroupId}

Using getAsInstances

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getAsInstances(args: GetAsInstancesArgs, opts?: InvokeOptions): Promise<GetAsInstancesResult>
function getAsInstancesOutput(args: GetAsInstancesOutputArgs, opts?: InvokeOptions): Output<GetAsInstancesResult>

def get_as_instances(filters: Optional[Sequence[GetAsInstancesFilter]] = None,
                     id: Optional[str] = None,
                     instance_ids: Optional[Sequence[str]] = None,
                     result_output_file: Optional[str] = None,
                     opts: Optional[InvokeOptions] = None) -> GetAsInstancesResult
def get_as_instances_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetAsInstancesFilterArgs]]]] = None,
                     id: Optional[pulumi.Input[str]] = None,
                     instance_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                     result_output_file: Optional[pulumi.Input[str]] = None,
                     opts: Optional[InvokeOptions] = None) -> Output[GetAsInstancesResult]

func GetAsInstances(ctx *Context, args *GetAsInstancesArgs, opts ...InvokeOption) (*GetAsInstancesResult, error)
func GetAsInstancesOutput(ctx *Context, args *GetAsInstancesOutputArgs, opts ...InvokeOption) GetAsInstancesResultOutput

> Note: This function is named GetAsInstances in the Go SDK.

public static class GetAsInstances 
{
    public static Task<GetAsInstancesResult> InvokeAsync(GetAsInstancesArgs args, InvokeOptions? opts = null)
    public static Output<GetAsInstancesResult> Invoke(GetAsInstancesInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetAsInstancesResult> getAsInstances(GetAsInstancesArgs args, InvokeOptions options)
public static Output<GetAsInstancesResult> getAsInstances(GetAsInstancesArgs args, InvokeOptions options)

fn::invoke:
  function: tencentcloud:index/getAsInstances:getAsInstances
  arguments:
    # arguments dictionary

The following arguments are supported:

Filters List<GetAsInstancesFilter>: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
Id string
InstanceIds List<string>: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
ResultOutputFile string: Used to save results.

Filters []GetAsInstancesFilter: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
Id string
InstanceIds []string: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
ResultOutputFile string: Used to save results.

filters List<GetAsInstancesFilter>: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
id String
instanceIds List<String>: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
resultOutputFile String: Used to save results.

filters GetAsInstancesFilter[]: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
id string
instanceIds string[]: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
resultOutputFile string: Used to save results.

filters Sequence[GetAsInstancesFilter]: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
id str
instance_ids Sequence[str]: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
result_output_file str: Used to save results.

filters List<Property Map>: Filter conditions. If there are multiple Filters, the relationship between Filters is a logical AND (AND) relationship. If there are multiple Values in the same Filter, the relationship between Values under the same Filter is a logical OR (OR) relationship.
id String
instanceIds List<String>: Instance ID of the cloud server (CVM) to be queried. The limit is 100 per request.
resultOutputFile String: Used to save results.

getAsInstances Result

The following output properties are available:

Id string
InstanceLists List<GetAsInstancesInstanceList>: List of instance details.
Filters List<GetAsInstancesFilter>
InstanceIds List<string>
ResultOutputFile string

Id string
InstanceLists []GetAsInstancesInstanceList: List of instance details.
Filters []GetAsInstancesFilter
InstanceIds []string
ResultOutputFile string

id String
instanceLists List<GetAsInstancesInstanceList>: List of instance details.
filters List<GetAsInstancesFilter>
instanceIds List<String>
resultOutputFile String

id string
instanceLists GetAsInstancesInstanceList[]: List of instance details.
filters GetAsInstancesFilter[]
instanceIds string[]
resultOutputFile string

id str
instance_lists Sequence[GetAsInstancesInstanceList]: List of instance details.
filters Sequence[GetAsInstancesFilter]
instance_ids Sequence[str]
result_output_file str

id String
instanceLists List<Property Map>: List of instance details.
filters List<Property Map>
instanceIds List<String>
resultOutputFile String

Supporting Types

GetAsInstancesFilter

Name string: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
Values List<string>: Value of the field.

Name string: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
Values []string: Value of the field.

name String: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
values List<String>: Value of the field.

name string: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
values string[]: Value of the field.

name str: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
values Sequence[str]: Value of the field.

name String: Fields to be filtered. Valid names: instance-id: Filters by instance ID, auto-scaling-group-id: Filter by scaling group ID.
values List<String>: Value of the field.

GetAsInstancesInstanceList

AddTime string: The time when the instance joined the group.
AutoScalingGroupId string: Auto scaling group ID.
AutoScalingGroupName string: Auto scaling group name.
CreationType string: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
HealthStatus string: Health status, the valid values are HEALTHY and UNHEALTHY.
InstanceId string: Instance ID.
InstanceType string: Instance type.
LaunchConfigurationId string: Launch configuration ID.
LaunchConfigurationName string: Launch configuration name.
LifeCycleState string: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
ProtectedFromScaleIn bool: Enable scale in protection.
VersionNumber double: Version ID.
Zone string: Available zone.

AddTime string: The time when the instance joined the group.
AutoScalingGroupId string: Auto scaling group ID.
AutoScalingGroupName string: Auto scaling group name.
CreationType string: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
HealthStatus string: Health status, the valid values are HEALTHY and UNHEALTHY.
InstanceId string: Instance ID.
InstanceType string: Instance type.
LaunchConfigurationId string: Launch configuration ID.
LaunchConfigurationName string: Launch configuration name.
LifeCycleState string: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
ProtectedFromScaleIn bool: Enable scale in protection.
VersionNumber float64: Version ID.
Zone string: Available zone.

addTime String: The time when the instance joined the group.
autoScalingGroupId String: Auto scaling group ID.
autoScalingGroupName String: Auto scaling group name.
creationType String: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
healthStatus String: Health status, the valid values are HEALTHY and UNHEALTHY.
instanceId String: Instance ID.
instanceType String: Instance type.
launchConfigurationId String: Launch configuration ID.
launchConfigurationName String: Launch configuration name.
lifeCycleState String: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
protectedFromScaleIn Boolean: Enable scale in protection.
versionNumber Double: Version ID.
zone String: Available zone.

addTime string: The time when the instance joined the group.
autoScalingGroupId string: Auto scaling group ID.
autoScalingGroupName string: Auto scaling group name.
creationType string: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
healthStatus string: Health status, the valid values are HEALTHY and UNHEALTHY.
instanceId string: Instance ID.
instanceType string: Instance type.
launchConfigurationId string: Launch configuration ID.
launchConfigurationName string: Launch configuration name.
lifeCycleState string: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
protectedFromScaleIn boolean: Enable scale in protection.
versionNumber number: Version ID.
zone string: Available zone.

add_time str: The time when the instance joined the group.
auto_scaling_group_id str: Auto scaling group ID.
auto_scaling_group_name str: Auto scaling group name.
creation_type str: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
health_status str: Health status, the valid values are HEALTHY and UNHEALTHY.
instance_id str: Instance ID.
instance_type str: Instance type.
launch_configuration_id str: Launch configuration ID.
launch_configuration_name str: Launch configuration name.
life_cycle_state str: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
protected_from_scale_in bool: Enable scale in protection.
version_number float: Version ID.
zone str: Available zone.

addTime String: The time when the instance joined the group.
autoScalingGroupId String: Auto scaling group ID.
autoScalingGroupName String: Auto scaling group name.
creationType String: Valid values: AUTO_CREATION, MANUAL_ATTACHING.
healthStatus String: Health status, the valid values are HEALTHY and UNHEALTHY.
instanceId String: Instance ID.
instanceType String: Instance type.
launchConfigurationId String: Launch configuration ID.
launchConfigurationName String: Launch configuration name.
lifeCycleState String: Life cycle state. Please refer to the link for field value details: https://cloud.tencent.com/document/api/377/20453#Instance.
protectedFromScaleIn Boolean: Enable scale in protection.
versionNumber Number: Version ID.
zone String: Available zone.