Alibaba Cloud v3.44.0, Sep 28 23

Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi

alicloud.ros.getChangeSets

Explore with Pulumi AI

Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi

pulumi/pulumi-alicloud

Example Usage

Basic Usage

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

return await Deployment.RunAsync(() => 
{
    var example = AliCloud.Ros.GetChangeSets.Invoke(new()
    {
        StackId = "example_value",
        Ids = new[]
        {
            "example_value",
        },
        NameRegex = "the_resource_name",
    });

    return new Dictionary<string, object?>
    {
        ["firstRosChangeSetId"] = example.Apply(getChangeSetsResult => getChangeSetsResult.Sets[0]?.Id),
    };
});

package main

import (
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/ros"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := ros.GetChangeSets(ctx, &ros.GetChangeSetsArgs{
			StackId: "example_value",
			Ids: []string{
				"example_value",
			},
			NameRegex: pulumi.StringRef("the_resource_name"),
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("firstRosChangeSetId", example.Sets[0].Id)
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.alicloud.ros.RosFunctions;
import com.pulumi.alicloud.ros.inputs.GetChangeSetsArgs;
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 = RosFunctions.getChangeSets(GetChangeSetsArgs.builder()
            .stackId("example_value")
            .ids("example_value")
            .nameRegex("the_resource_name")
            .build());

        ctx.export("firstRosChangeSetId", example.applyValue(getChangeSetsResult -> getChangeSetsResult.sets()[0].id()));
    }
}

import pulumi
import pulumi_alicloud as alicloud

example = alicloud.ros.get_change_sets(stack_id="example_value",
    ids=["example_value"],
    name_regex="the_resource_name")
pulumi.export("firstRosChangeSetId", example.sets[0].id)

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

const example = alicloud.ros.getChangeSets({
    stackId: "example_value",
    ids: ["example_value"],
    nameRegex: "the_resource_name",
});
export const firstRosChangeSetId = example.then(example => example.sets?.[0]?.id);

variables:
  example:
    fn::invoke:
      Function: alicloud:ros:getChangeSets
      Arguments:
        stackId: example_value
        ids:
          - example_value
        nameRegex: the_resource_name
outputs:
  firstRosChangeSetId: ${example.sets[0].id}

Using getChangeSets

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 getChangeSets(args: GetChangeSetsArgs, opts?: InvokeOptions): Promise<GetChangeSetsResult>
function getChangeSetsOutput(args: GetChangeSetsOutputArgs, opts?: InvokeOptions): Output<GetChangeSetsResult>

def get_change_sets(change_set_name: Optional[str] = None,
                    enable_details: Optional[bool] = None,
                    ids: Optional[Sequence[str]] = None,
                    name_regex: Optional[str] = None,
                    output_file: Optional[str] = None,
                    stack_id: Optional[str] = None,
                    status: Optional[str] = None,
                    opts: Optional[InvokeOptions] = None) -> GetChangeSetsResult
def get_change_sets_output(change_set_name: Optional[pulumi.Input[str]] = None,
                    enable_details: Optional[pulumi.Input[bool]] = None,
                    ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                    name_regex: Optional[pulumi.Input[str]] = None,
                    output_file: Optional[pulumi.Input[str]] = None,
                    stack_id: Optional[pulumi.Input[str]] = None,
                    status: Optional[pulumi.Input[str]] = None,
                    opts: Optional[InvokeOptions] = None) -> Output[GetChangeSetsResult]

func GetChangeSets(ctx *Context, args *GetChangeSetsArgs, opts ...InvokeOption) (*GetChangeSetsResult, error)
func GetChangeSetsOutput(ctx *Context, args *GetChangeSetsOutputArgs, opts ...InvokeOption) GetChangeSetsResultOutput

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

public static class GetChangeSets 
{
    public static Task<GetChangeSetsResult> InvokeAsync(GetChangeSetsArgs args, InvokeOptions? opts = null)
    public static Output<GetChangeSetsResult> Invoke(GetChangeSetsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetChangeSetsResult> getChangeSets(GetChangeSetsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: alicloud:ros/getChangeSets:getChangeSets
  arguments:
    # arguments dictionary

The following arguments are supported:

StackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
ChangeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
EnableDetails bool: Default to false. Set it to true can output more details about resource attributes.
Ids List<string>: A list of Change Set IDs.
NameRegex string: A regex string to filter results by Change Set name.
OutputFile string: File name where to save data source results (after running pulumi preview).
Status string: The status of the change set.

StackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
ChangeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
EnableDetails bool: Default to false. Set it to true can output more details about resource attributes.
Ids []string: A list of Change Set IDs.
NameRegex string: A regex string to filter results by Change Set name.
OutputFile string: File name where to save data source results (after running pulumi preview).
Status string: The status of the change set.

stackId String: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
changeSetName String: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
enableDetails Boolean: Default to false. Set it to true can output more details about resource attributes.
ids List<String>: A list of Change Set IDs.
nameRegex String: A regex string to filter results by Change Set name.
outputFile String: File name where to save data source results (after running pulumi preview).
status String: The status of the change set.

stackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
changeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
enableDetails boolean: Default to false. Set it to true can output more details about resource attributes.
ids string[]: A list of Change Set IDs.
nameRegex string: A regex string to filter results by Change Set name.
outputFile string: File name where to save data source results (after running pulumi preview).
status string: The status of the change set.

stack_id str: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
change_set_name str: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
enable_details bool: Default to false. Set it to true can output more details about resource attributes.
ids Sequence[str]: A list of Change Set IDs.
name_regex str: A regex string to filter results by Change Set name.
output_file str: File name where to save data source results (after running pulumi preview).
status str: The status of the change set.

stackId String: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
changeSetName String: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
enableDetails Boolean: Default to false. Set it to true can output more details about resource attributes.
ids List<String>: A list of Change Set IDs.
nameRegex String: A regex string to filter results by Change Set name.
outputFile String: File name where to save data source results (after running pulumi preview).
status String: The status of the change set.

getChangeSets Result

The following output properties are available:

Id string: The provider-assigned unique ID for this managed resource.
Ids List<string>
Names List<string>
Sets List<Pulumi.AliCloud.Ros.Outputs.GetChangeSetsSet>
StackId string
ChangeSetName string
EnableDetails bool
NameRegex string
OutputFile string
Status string

Id string: The provider-assigned unique ID for this managed resource.
Ids []string
Names []string
Sets []GetChangeSetsSet
StackId string
ChangeSetName string
EnableDetails bool
NameRegex string
OutputFile string
Status string

id String: The provider-assigned unique ID for this managed resource.
ids List<String>
names List<String>
sets List<GetChangeSetsSet>
stackId String
changeSetName String
enableDetails Boolean
nameRegex String
outputFile String
status String

id string: The provider-assigned unique ID for this managed resource.
ids string[]
names string[]
sets GetChangeSetsSet[]
stackId string
changeSetName string
enableDetails boolean
nameRegex string
outputFile string
status string

id str: The provider-assigned unique ID for this managed resource.
ids Sequence[str]
names Sequence[str]
sets Sequence[GetChangeSetsSet]
stack_id str
change_set_name str
enable_details bool
name_regex str
output_file str
status str

id String: The provider-assigned unique ID for this managed resource.
ids List<String>
names List<String>
sets List<Property Map>
stackId String
changeSetName String
enableDetails Boolean
nameRegex String
outputFile String
status String

Supporting Types

GetChangeSetsSet

ChangeSetId string: The ID of the change set.
ChangeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
ChangeSetType string: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
Description string: The description of the change set. The description can be up to 1,024 bytes in length.
DisableRollback bool: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
ExecutionStatus string: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
Id string: The ID of the Change Set.
Parameters List<Pulumi.AliCloud.Ros.Inputs.GetChangeSetsSetParameter>: Parameters.
StackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
StackName string: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
Status string: The status of the change set.
TemplateBody string: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
TimeoutInMinutes int: Timeout In Minutes.

ChangeSetId string: The ID of the change set.
ChangeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
ChangeSetType string: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
Description string: The description of the change set. The description can be up to 1,024 bytes in length.
DisableRollback bool: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
ExecutionStatus string: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
Id string: The ID of the Change Set.
Parameters []GetChangeSetsSetParameter: Parameters.
StackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
StackName string: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
Status string: The status of the change set.
TemplateBody string: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
TimeoutInMinutes int: Timeout In Minutes.

changeSetId String: The ID of the change set.
changeSetName String: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
changeSetType String: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
description String: The description of the change set. The description can be up to 1,024 bytes in length.
disableRollback Boolean: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
executionStatus String: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
id String: The ID of the Change Set.
parameters List<GetChangeSetsSetParameter>: Parameters.
stackId String: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
stackName String: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
status String: The status of the change set.
templateBody String: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
timeoutInMinutes Integer: Timeout In Minutes.

changeSetId string: The ID of the change set.
changeSetName string: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
changeSetType string: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
description string: The description of the change set. The description can be up to 1,024 bytes in length.
disableRollback boolean: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
executionStatus string: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
id string: The ID of the Change Set.
parameters GetChangeSetsSetParameter[]: Parameters.
stackId string: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
stackName string: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
status string: The status of the change set.
templateBody string: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
timeoutInMinutes number: Timeout In Minutes.

change_set_id str: The ID of the change set.
change_set_name str: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
change_set_type str: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
description str: The description of the change set. The description can be up to 1,024 bytes in length.
disable_rollback bool: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
execution_status str: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
id str: The ID of the Change Set.
parameters Sequence[GetChangeSetsSetParameter]: Parameters.
stack_id str: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
stack_name str: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
status str: The status of the change set.
template_body str: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
timeout_in_minutes int: Timeout In Minutes.

changeSetId String: The ID of the change set.
changeSetName String: The name of the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter.
changeSetType String: The type of the change set. Valid values: CREATE: creates a change set for a new stack. UPDATE: creates a change set for an existing stack. IMPORT: creates a change set for a new stack or an existing stack to import non-ROS-managed resources. If you create a change set for a new stack, ROS creates a stack that has a unique stack ID. The stack is in the REVIEW_IN_PROGRESS state until you execute the change set. You cannot use the UPDATE type to create a change set for a new stack or the CREATE type to create a change set for an existing stack.
description String: The description of the change set. The description can be up to 1,024 bytes in length.
disableRollback Boolean: Specifies whether to disable rollback on stack creation failure. Default value: false. Valid values: true: disables rollback on stack creation failure. false: enables rollback on stack creation failure. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
executionStatus String: The execution status of change set N. Maximum value of N: 5. Valid values: UNAVAILABLE AVAILABLE EXECUTE_IN_PROGRESS EXECUTE_COMPLETE EXECUTE_FAILED OBSOLETE.
id String: The ID of the Change Set.
parameters List<Property Map>: Parameters.
stackId String: The ID of the stack for which you want to create the change set. ROS generates the change set by comparing the stack information with the information that you submit, such as a modified template or different inputs.
stackName String: The name of the stack for which you want to create the change set. The name can be up to 255 characters in length and can contain digits, letters, hyphens (-), and underscores (_). It must start with a digit or letter. Note This parameter takes effect only when ChangeSetType is set to CREATE or IMPORT.
status String: The status of the change set.
templateBody String: The structure that contains the template body. The template body must be 1 to 524,288 bytes in length. If the length of the template body is longer than required, we recommend that you add parameters to the HTTP POST request body to avoid request failures due to excessive length of URLs. You can specify one of TemplateBody or TemplateURL parameters, but you cannot specify both of them.
timeoutInMinutes Number: Timeout In Minutes.

GetChangeSetsSetParameter

ParameterKey string: The parameters.
ParameterValue string: The parameters.

ParameterKey string: The parameters.
ParameterValue string: The parameters.

parameterKey String: The parameters.
parameterValue String: The parameters.

parameterKey string: The parameters.
parameterValue string: The parameters.

parameter_key str: The parameters.
parameter_value str: The parameters.

parameterKey String: The parameters.
parameterValue String: The parameters.

Package Details

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

Alibaba Cloud v3.44.0 published on Thursday, Sep 28, 2023 by Pulumi

pulumi/pulumi-alicloud

alicloud.ros.getChangeSets

On this page

On this page

Example Usage

Using getChangeSets

getChangeSets Result

Supporting Types

GetChangeSetsSet

GetChangeSetsSetParameter

Package Details

On this page

On this page