1. Packages
  2. Alibaba Cloud Provider
  3. API Docs
  4. ecs
  5. getAutoSnapshotPolicies
Alibaba Cloud v3.76.0 published on Tuesday, Apr 8, 2025 by Pulumi

alicloud.ecs.getAutoSnapshotPolicies

Explore with Pulumi AI

This data source provides the Ecs Auto Snapshot Policies of the current Alibaba Cloud user.

NOTE: Available in v1.117.0+.

Example Usage

Basic Usage

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

const example = alicloud.ecs.getAutoSnapshotPolicies({
    ids: ["sp-bp14e66xxxxxxxx"],
    nameRegex: "tf-testAcc",
});
export const firstEcsAutoSnapshotPolicyId = example.then(example => example.policies?.[0]?.id);
Copy
import pulumi
import pulumi_alicloud as alicloud

example = alicloud.ecs.get_auto_snapshot_policies(ids=["sp-bp14e66xxxxxxxx"],
    name_regex="tf-testAcc")
pulumi.export("firstEcsAutoSnapshotPolicyId", example.policies[0].id)
Copy
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 {
		example, err := ecs.GetAutoSnapshotPolicies(ctx, &ecs.GetAutoSnapshotPoliciesArgs{
			Ids: []string{
				"sp-bp14e66xxxxxxxx",
			},
			NameRegex: pulumi.StringRef("tf-testAcc"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("firstEcsAutoSnapshotPolicyId", example.Policies[0].Id)
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using AliCloud = Pulumi.AliCloud;

return await Deployment.RunAsync(() => 
{
    var example = AliCloud.Ecs.GetAutoSnapshotPolicies.Invoke(new()
    {
        Ids = new[]
        {
            "sp-bp14e66xxxxxxxx",
        },
        NameRegex = "tf-testAcc",
    });

    return new Dictionary<string, object?>
    {
        ["firstEcsAutoSnapshotPolicyId"] = example.Apply(getAutoSnapshotPoliciesResult => getAutoSnapshotPoliciesResult.Policies[0]?.Id),
    };
});
Copy
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.GetAutoSnapshotPoliciesArgs;
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 example = EcsFunctions.getAutoSnapshotPolicies(GetAutoSnapshotPoliciesArgs.builder()
            .ids("sp-bp14e66xxxxxxxx")
            .nameRegex("tf-testAcc")
            .build());

        ctx.export("firstEcsAutoSnapshotPolicyId", example.applyValue(getAutoSnapshotPoliciesResult -> getAutoSnapshotPoliciesResult.policies()[0].id()));
    }
}
Copy
variables:
  example:
    fn::invoke:
      function: alicloud:ecs:getAutoSnapshotPolicies
      arguments:
        ids:
          - sp-bp14e66xxxxxxxx
        nameRegex: tf-testAcc
outputs:
  firstEcsAutoSnapshotPolicyId: ${example.policies[0].id}
Copy

Using getAutoSnapshotPolicies

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 getAutoSnapshotPolicies(args: GetAutoSnapshotPoliciesArgs, opts?: InvokeOptions): Promise<GetAutoSnapshotPoliciesResult>
function getAutoSnapshotPoliciesOutput(args: GetAutoSnapshotPoliciesOutputArgs, opts?: InvokeOptions): Output<GetAutoSnapshotPoliciesResult>
Copy
def get_auto_snapshot_policies(ids: Optional[Sequence[str]] = None,
                               name_regex: Optional[str] = None,
                               output_file: Optional[str] = None,
                               status: Optional[str] = None,
                               tags: Optional[Mapping[str, str]] = None,
                               opts: Optional[InvokeOptions] = None) -> GetAutoSnapshotPoliciesResult
def get_auto_snapshot_policies_output(ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                               name_regex: Optional[pulumi.Input[str]] = None,
                               output_file: Optional[pulumi.Input[str]] = None,
                               status: Optional[pulumi.Input[str]] = None,
                               tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                               opts: Optional[InvokeOptions] = None) -> Output[GetAutoSnapshotPoliciesResult]
Copy
func GetAutoSnapshotPolicies(ctx *Context, args *GetAutoSnapshotPoliciesArgs, opts ...InvokeOption) (*GetAutoSnapshotPoliciesResult, error)
func GetAutoSnapshotPoliciesOutput(ctx *Context, args *GetAutoSnapshotPoliciesOutputArgs, opts ...InvokeOption) GetAutoSnapshotPoliciesResultOutput
Copy

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

public static class GetAutoSnapshotPolicies 
{
    public static Task<GetAutoSnapshotPoliciesResult> InvokeAsync(GetAutoSnapshotPoliciesArgs args, InvokeOptions? opts = null)
    public static Output<GetAutoSnapshotPoliciesResult> Invoke(GetAutoSnapshotPoliciesInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetAutoSnapshotPoliciesResult> getAutoSnapshotPolicies(GetAutoSnapshotPoliciesArgs args, InvokeOptions options)
public static Output<GetAutoSnapshotPoliciesResult> getAutoSnapshotPolicies(GetAutoSnapshotPoliciesArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: alicloud:ecs/getAutoSnapshotPolicies:getAutoSnapshotPolicies
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Ids Changes to this property will trigger replacement. List<string>
A list of Auto Snapshot Policy IDs.
NameRegex Changes to this property will trigger replacement. string
A regex string to filter results by Auto Snapshot Policy name.
OutputFile string
File name where to save data source results (after running pulumi preview).
Status Changes to this property will trigger replacement. string
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
Tags Dictionary<string, string>
A mapping of tags to assign to the resource.
Ids Changes to this property will trigger replacement. []string
A list of Auto Snapshot Policy IDs.
NameRegex Changes to this property will trigger replacement. string
A regex string to filter results by Auto Snapshot Policy name.
OutputFile string
File name where to save data source results (after running pulumi preview).
Status Changes to this property will trigger replacement. string
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
Tags map[string]string
A mapping of tags to assign to the resource.
ids Changes to this property will trigger replacement. List<String>
A list of Auto Snapshot Policy IDs.
nameRegex Changes to this property will trigger replacement. String
A regex string to filter results by Auto Snapshot Policy name.
outputFile String
File name where to save data source results (after running pulumi preview).
status Changes to this property will trigger replacement. String
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
tags Map<String,String>
A mapping of tags to assign to the resource.
ids Changes to this property will trigger replacement. string[]
A list of Auto Snapshot Policy IDs.
nameRegex Changes to this property will trigger replacement. string
A regex string to filter results by Auto Snapshot Policy name.
outputFile string
File name where to save data source results (after running pulumi preview).
status Changes to this property will trigger replacement. string
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
tags {[key: string]: string}
A mapping of tags to assign to the resource.
ids Changes to this property will trigger replacement. Sequence[str]
A list of Auto Snapshot Policy IDs.
name_regex Changes to this property will trigger replacement. str
A regex string to filter results by Auto Snapshot Policy name.
output_file str
File name where to save data source results (after running pulumi preview).
status Changes to this property will trigger replacement. str
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
tags Mapping[str, str]
A mapping of tags to assign to the resource.
ids Changes to this property will trigger replacement. List<String>
A list of Auto Snapshot Policy IDs.
nameRegex Changes to this property will trigger replacement. String
A regex string to filter results by Auto Snapshot Policy name.
outputFile String
File name where to save data source results (after running pulumi preview).
status Changes to this property will trigger replacement. String
The status of Auto Snapshot Policy. Valid Values: Expire, Normal.
tags Map<String>
A mapping of tags to assign to the resource.

getAutoSnapshotPolicies Result

The following output properties are available:

Id string
The provider-assigned unique ID for this managed resource.
Ids List<string>
Names List<string>
Policies List<Pulumi.AliCloud.Ecs.Outputs.GetAutoSnapshotPoliciesPolicy>
NameRegex string
OutputFile string
Status string
Tags Dictionary<string, string>
Id string
The provider-assigned unique ID for this managed resource.
Ids []string
Names []string
Policies []GetAutoSnapshotPoliciesPolicy
NameRegex string
OutputFile string
Status string
Tags map[string]string
id String
The provider-assigned unique ID for this managed resource.
ids List<String>
names List<String>
policies List<GetAutoSnapshotPoliciesPolicy>
nameRegex String
outputFile String
status String
tags Map<String,String>
id string
The provider-assigned unique ID for this managed resource.
ids string[]
names string[]
policies GetAutoSnapshotPoliciesPolicy[]
nameRegex string
outputFile string
status string
tags {[key: string]: string}
id str
The provider-assigned unique ID for this managed resource.
ids Sequence[str]
names Sequence[str]
policies Sequence[GetAutoSnapshotPoliciesPolicy]
name_regex str
output_file str
status str
tags Mapping[str, str]
id String
The provider-assigned unique ID for this managed resource.
ids List<String>
names List<String>
policies List<Property Map>
nameRegex String
outputFile String
status String
tags Map<String>

Supporting Types

GetAutoSnapshotPoliciesPolicy

AutoSnapshotPolicyId This property is required. string
The ID of the Auto Snapshot Policy.
CopiedSnapshotsRetentionDays This property is required. int
The retention period of the snapshot copied across regions.
DiskNums This property is required. int
The number of disks to which the automatic snapshot policy is applied.
EnableCrossRegionCopy This property is required. bool
Specifies whether to enable the system to automatically copy snapshots across regions.
Id This property is required. string
The ID of the Auto Snapshot Policy.
Name This property is required. string
The snapshot policy name..
RepeatWeekdays This property is required. List<string>
The automatic snapshot repetition dates.
RetentionDays This property is required. int
The snapshot retention time, and the unit of measurement is day.
Status This property is required. string
The status of Auto Snapshot Policy.
Tags This property is required. Dictionary<string, string>
A mapping of tags to assign to the resource.
TargetCopyRegions This property is required. List<string>
The destination region to which the snapshot is copied.
TimePoints This property is required. List<string>
The automatic snapshot creation schedule, and the unit of measurement is hour.
VolumeNums This property is required. int
The number of extended volumes on which this policy is enabled.
AutoSnapshotPolicyId This property is required. string
The ID of the Auto Snapshot Policy.
CopiedSnapshotsRetentionDays This property is required. int
The retention period of the snapshot copied across regions.
DiskNums This property is required. int
The number of disks to which the automatic snapshot policy is applied.
EnableCrossRegionCopy This property is required. bool
Specifies whether to enable the system to automatically copy snapshots across regions.
Id This property is required. string
The ID of the Auto Snapshot Policy.
Name This property is required. string
The snapshot policy name..
RepeatWeekdays This property is required. []string
The automatic snapshot repetition dates.
RetentionDays This property is required. int
The snapshot retention time, and the unit of measurement is day.
Status This property is required. string
The status of Auto Snapshot Policy.
Tags This property is required. map[string]string
A mapping of tags to assign to the resource.
TargetCopyRegions This property is required. []string
The destination region to which the snapshot is copied.
TimePoints This property is required. []string
The automatic snapshot creation schedule, and the unit of measurement is hour.
VolumeNums This property is required. int
The number of extended volumes on which this policy is enabled.
autoSnapshotPolicyId This property is required. String
The ID of the Auto Snapshot Policy.
copiedSnapshotsRetentionDays This property is required. Integer
The retention period of the snapshot copied across regions.
diskNums This property is required. Integer
The number of disks to which the automatic snapshot policy is applied.
enableCrossRegionCopy This property is required. Boolean
Specifies whether to enable the system to automatically copy snapshots across regions.
id This property is required. String
The ID of the Auto Snapshot Policy.
name This property is required. String
The snapshot policy name..
repeatWeekdays This property is required. List<String>
The automatic snapshot repetition dates.
retentionDays This property is required. Integer
The snapshot retention time, and the unit of measurement is day.
status This property is required. String
The status of Auto Snapshot Policy.
tags This property is required. Map<String,String>
A mapping of tags to assign to the resource.
targetCopyRegions This property is required. List<String>
The destination region to which the snapshot is copied.
timePoints This property is required. List<String>
The automatic snapshot creation schedule, and the unit of measurement is hour.
volumeNums This property is required. Integer
The number of extended volumes on which this policy is enabled.
autoSnapshotPolicyId This property is required. string
The ID of the Auto Snapshot Policy.
copiedSnapshotsRetentionDays This property is required. number
The retention period of the snapshot copied across regions.
diskNums This property is required. number
The number of disks to which the automatic snapshot policy is applied.
enableCrossRegionCopy This property is required. boolean
Specifies whether to enable the system to automatically copy snapshots across regions.
id This property is required. string
The ID of the Auto Snapshot Policy.
name This property is required. string
The snapshot policy name..
repeatWeekdays This property is required. string[]
The automatic snapshot repetition dates.
retentionDays This property is required. number
The snapshot retention time, and the unit of measurement is day.
status This property is required. string
The status of Auto Snapshot Policy.
tags This property is required. {[key: string]: string}
A mapping of tags to assign to the resource.
targetCopyRegions This property is required. string[]
The destination region to which the snapshot is copied.
timePoints This property is required. string[]
The automatic snapshot creation schedule, and the unit of measurement is hour.
volumeNums This property is required. number
The number of extended volumes on which this policy is enabled.
auto_snapshot_policy_id This property is required. str
The ID of the Auto Snapshot Policy.
copied_snapshots_retention_days This property is required. int
The retention period of the snapshot copied across regions.
disk_nums This property is required. int
The number of disks to which the automatic snapshot policy is applied.
enable_cross_region_copy This property is required. bool
Specifies whether to enable the system to automatically copy snapshots across regions.
id This property is required. str
The ID of the Auto Snapshot Policy.
name This property is required. str
The snapshot policy name..
repeat_weekdays This property is required. Sequence[str]
The automatic snapshot repetition dates.
retention_days This property is required. int
The snapshot retention time, and the unit of measurement is day.
status This property is required. str
The status of Auto Snapshot Policy.
tags This property is required. Mapping[str, str]
A mapping of tags to assign to the resource.
target_copy_regions This property is required. Sequence[str]
The destination region to which the snapshot is copied.
time_points This property is required. Sequence[str]
The automatic snapshot creation schedule, and the unit of measurement is hour.
volume_nums This property is required. int
The number of extended volumes on which this policy is enabled.
autoSnapshotPolicyId This property is required. String
The ID of the Auto Snapshot Policy.
copiedSnapshotsRetentionDays This property is required. Number
The retention period of the snapshot copied across regions.
diskNums This property is required. Number
The number of disks to which the automatic snapshot policy is applied.
enableCrossRegionCopy This property is required. Boolean
Specifies whether to enable the system to automatically copy snapshots across regions.
id This property is required. String
The ID of the Auto Snapshot Policy.
name This property is required. String
The snapshot policy name..
repeatWeekdays This property is required. List<String>
The automatic snapshot repetition dates.
retentionDays This property is required. Number
The snapshot retention time, and the unit of measurement is day.
status This property is required. String
The status of Auto Snapshot Policy.
tags This property is required. Map<String>
A mapping of tags to assign to the resource.
targetCopyRegions This property is required. List<String>
The destination region to which the snapshot is copied.
timePoints This property is required. List<String>
The automatic snapshot creation schedule, and the unit of measurement is hour.
volumeNums This property is required. Number
The number of extended volumes on which this policy is enabled.

Package Details

Repository
Alibaba Cloud pulumi/pulumi-alicloud
License
Apache-2.0
Notes
This Pulumi package is based on the alicloud Terraform Provider.