1. Packages
  2. Tencentcloud Provider
  3. API Docs
  4. getAsInstances
tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack

tencentcloud.getAsInstances

Explore with Pulumi AI

tencentcloud logo
tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack

    Use this data source to query detailed information of as instances

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as tencentcloud from "@pulumi/tencentcloud";
    
    const scalingGroup = new tencentcloud.AsScalingGroup("scalingGroup", {
        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("scalingGroup",
        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, "scalingGroup", &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("scalingGroup", 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)
                .minSize(1)
                .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
        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:

    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.

    Package Details

    Repository
    tencentcloud tencentcloudstack/terraform-provider-tencentcloud
    License
    Notes
    This Pulumi package is based on the tencentcloud Terraform Provider.
    tencentcloud logo
    tencentcloud 1.81.189 published on Wednesday, Apr 30, 2025 by tencentcloudstack