role.go

// Code generated by the Pulumi Terraform Bridge (tfgen) Tool DO NOT EDIT.
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***

package resourcemanager

import (
	"context"
	"reflect"

	"errors"
	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/internal"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

// Provides a Resource Manager role resource. Members are resource containers in the resource directory, which can physically isolate resources to form an independent resource grouping unit. You can create members in the resource folder to manage them in a unified manner.
// For information about Resource Manager role and how to use it, see [What is Resource Manager role](https://www.alibabacloud.com/help/en/doc-detail/111231.htm).
//
// > **NOTE:** Available since v1.82.0.
//
// ## Example Usage
//
// ```go
// package main
//
// import (
//
//	"fmt"
//
//	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud"
//	"github.com/pulumi/pulumi-alicloud/sdk/v3/go/alicloud/resourcemanager"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
//	"github.com/pulumi/pulumi/sdk/v3/go/pulumi/config"
//
// )
//
//	func main() {
//		pulumi.Run(func(ctx *pulumi.Context) error {
//			cfg := config.New(ctx, "")
//			name := "tfexample"
//			if param := cfg.Get("name"); param != "" {
//				name = param
//			}
//			_default, err := alicloud.GetAccount(ctx, nil, nil)
//			if err != nil {
//				return err
//			}
//			_, err = resourcemanager.NewRole(ctx, "example", &resourcemanager.RoleArgs{
//				RoleName: pulumi.String(name),
//				AssumeRolePolicyDocument: pulumi.String(fmt.Sprintf(`     {
//	          "Statement": [
//	               {
//	                    "Action": "sts:AssumeRole",
//	                    "Effect": "Allow",
//	                    "Principal": {
//	                        "RAM":[
//	                                "acs:ram::%v:root"
//	                        ]
//	                    }
//	                }
//	          ],
//	          "Version": "1"
//	     }
//
// `, _default.Id)),
//
//			})
//			if err != nil {
//				return err
//			}
//			return nil
//		})
//	}
//
// ```
//
// ## Import
//
// Resource Manager can be imported using the id or role_name, e.g.
//
// ```sh
// $ pulumi import alicloud:resourcemanager/role:Role example testrd
// ```
type Role struct {
	pulumi.CustomResourceState

	// The resource descriptor of the role.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The content of the permissions strategy that plays a role.
	AssumeRolePolicyDocument pulumi.StringOutput `pulumi:"assumeRolePolicyDocument"`
	// The description of the Resource Manager role.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
	MaxSessionDuration pulumi.IntPtrOutput `pulumi:"maxSessionDuration"`
	// This ID of Resource Manager role. The value is set to `roleName`.
	RoleId pulumi.StringOutput `pulumi:"roleId"`
	// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
	RoleName pulumi.StringOutput `pulumi:"roleName"`
	// Role update time.
	UpdateDate pulumi.StringOutput `pulumi:"updateDate"`
}

// NewRole registers a new resource with the given unique name, arguments, and options.
func NewRole(ctx *pulumi.Context,
	name string, args *RoleArgs, opts ...pulumi.ResourceOption) (*Role, error) {
	if args == nil {
		return nil, errors.New("missing one or more required arguments")
	}

	if args.AssumeRolePolicyDocument == nil {
		return nil, errors.New("invalid value for required argument 'AssumeRolePolicyDocument'")
	}
	if args.RoleName == nil {
		return nil, errors.New("invalid value for required argument 'RoleName'")
	}
	opts = internal.PkgResourceDefaultOpts(opts)
	var resource Role
	err := ctx.RegisterResource("alicloud:resourcemanager/role:Role", name, args, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// GetRole gets an existing Role resource's state with the given name, ID, and optional
// state properties that are used to uniquely qualify the lookup (nil if not required).
func GetRole(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *RoleState, opts ...pulumi.ResourceOption) (*Role, error) {
	var resource Role
	err := ctx.ReadResource("alicloud:resourcemanager/role:Role", name, id, state, &resource, opts...)
	if err != nil {
		return nil, err
	}
	return &resource, nil
}

// Input properties used for looking up and filtering Role resources.
type roleState struct {
	// The resource descriptor of the role.
	Arn *string `pulumi:"arn"`
	// The content of the permissions strategy that plays a role.
	AssumeRolePolicyDocument *string `pulumi:"assumeRolePolicyDocument"`
	// The description of the Resource Manager role.
	Description *string `pulumi:"description"`
	// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
	MaxSessionDuration *int `pulumi:"maxSessionDuration"`
	// This ID of Resource Manager role. The value is set to `roleName`.
	RoleId *string `pulumi:"roleId"`
	// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
	RoleName *string `pulumi:"roleName"`
	// Role update time.
	UpdateDate *string `pulumi:"updateDate"`
}

type RoleState struct {
	// The resource descriptor of the role.
	Arn pulumi.StringPtrInput
	// The content of the permissions strategy that plays a role.
	AssumeRolePolicyDocument pulumi.StringPtrInput
	// The description of the Resource Manager role.
	Description pulumi.StringPtrInput
	// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
	MaxSessionDuration pulumi.IntPtrInput
	// This ID of Resource Manager role. The value is set to `roleName`.
	RoleId pulumi.StringPtrInput
	// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
	RoleName pulumi.StringPtrInput
	// Role update time.
	UpdateDate pulumi.StringPtrInput
}

func (RoleState) ElementType() reflect.Type {
	return reflect.TypeOf((*roleState)(nil)).Elem()
}

type roleArgs struct {
	// The content of the permissions strategy that plays a role.
	AssumeRolePolicyDocument string `pulumi:"assumeRolePolicyDocument"`
	// The description of the Resource Manager role.
	Description *string `pulumi:"description"`
	// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
	MaxSessionDuration *int `pulumi:"maxSessionDuration"`
	// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
	RoleName string `pulumi:"roleName"`
}

// The set of arguments for constructing a Role resource.
type RoleArgs struct {
	// The content of the permissions strategy that plays a role.
	AssumeRolePolicyDocument pulumi.StringInput
	// The description of the Resource Manager role.
	Description pulumi.StringPtrInput
	// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
	MaxSessionDuration pulumi.IntPtrInput
	// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
	RoleName pulumi.StringInput
}

func (RoleArgs) ElementType() reflect.Type {
	return reflect.TypeOf((*roleArgs)(nil)).Elem()
}

type RoleInput interface {
	pulumi.Input

	ToRoleOutput() RoleOutput
	ToRoleOutputWithContext(ctx context.Context) RoleOutput
}

func (*Role) ElementType() reflect.Type {
	return reflect.TypeOf((**Role)(nil)).Elem()
}

func (i *Role) ToRoleOutput() RoleOutput {
	return i.ToRoleOutputWithContext(context.Background())
}

func (i *Role) ToRoleOutputWithContext(ctx context.Context) RoleOutput {
	return pulumi.ToOutputWithContext(ctx, i).(RoleOutput)
}

// RoleArrayInput is an input type that accepts RoleArray and RoleArrayOutput values.
// You can construct a concrete instance of `RoleArrayInput` via:
//
//	RoleArray{ RoleArgs{...} }
type RoleArrayInput interface {
	pulumi.Input

	ToRoleArrayOutput() RoleArrayOutput
	ToRoleArrayOutputWithContext(context.Context) RoleArrayOutput
}

type RoleArray []RoleInput

func (RoleArray) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*Role)(nil)).Elem()
}

func (i RoleArray) ToRoleArrayOutput() RoleArrayOutput {
	return i.ToRoleArrayOutputWithContext(context.Background())
}

func (i RoleArray) ToRoleArrayOutputWithContext(ctx context.Context) RoleArrayOutput {
	return pulumi.ToOutputWithContext(ctx, i).(RoleArrayOutput)
}

// RoleMapInput is an input type that accepts RoleMap and RoleMapOutput values.
// You can construct a concrete instance of `RoleMapInput` via:
//
//	RoleMap{ "key": RoleArgs{...} }
type RoleMapInput interface {
	pulumi.Input

	ToRoleMapOutput() RoleMapOutput
	ToRoleMapOutputWithContext(context.Context) RoleMapOutput
}

type RoleMap map[string]RoleInput

func (RoleMap) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*Role)(nil)).Elem()
}

func (i RoleMap) ToRoleMapOutput() RoleMapOutput {
	return i.ToRoleMapOutputWithContext(context.Background())
}

func (i RoleMap) ToRoleMapOutputWithContext(ctx context.Context) RoleMapOutput {
	return pulumi.ToOutputWithContext(ctx, i).(RoleMapOutput)
}

type RoleOutput struct{ *pulumi.OutputState }

func (RoleOutput) ElementType() reflect.Type {
	return reflect.TypeOf((**Role)(nil)).Elem()
}

func (o RoleOutput) ToRoleOutput() RoleOutput {
	return o
}

func (o RoleOutput) ToRoleOutputWithContext(ctx context.Context) RoleOutput {
	return o
}

// The resource descriptor of the role.
func (o RoleOutput) Arn() pulumi.StringOutput {
	return o.ApplyT(func(v *Role) pulumi.StringOutput { return v.Arn }).(pulumi.StringOutput)
}

// The content of the permissions strategy that plays a role.
func (o RoleOutput) AssumeRolePolicyDocument() pulumi.StringOutput {
	return o.ApplyT(func(v *Role) pulumi.StringOutput { return v.AssumeRolePolicyDocument }).(pulumi.StringOutput)
}

// The description of the Resource Manager role.
func (o RoleOutput) Description() pulumi.StringPtrOutput {
	return o.ApplyT(func(v *Role) pulumi.StringPtrOutput { return v.Description }).(pulumi.StringPtrOutput)
}

// Role maximum session time. Valid values: [3600-43200]. Default to `3600`.
func (o RoleOutput) MaxSessionDuration() pulumi.IntPtrOutput {
	return o.ApplyT(func(v *Role) pulumi.IntPtrOutput { return v.MaxSessionDuration }).(pulumi.IntPtrOutput)
}

// This ID of Resource Manager role. The value is set to `roleName`.
func (o RoleOutput) RoleId() pulumi.StringOutput {
	return o.ApplyT(func(v *Role) pulumi.StringOutput { return v.RoleId }).(pulumi.StringOutput)
}

// Role Name. The length is 1 ~ 64 characters, which can include English letters, numbers, dots "." and dashes "-".
func (o RoleOutput) RoleName() pulumi.StringOutput {
	return o.ApplyT(func(v *Role) pulumi.StringOutput { return v.RoleName }).(pulumi.StringOutput)
}

// Role update time.
func (o RoleOutput) UpdateDate() pulumi.StringOutput {
	return o.ApplyT(func(v *Role) pulumi.StringOutput { return v.UpdateDate }).(pulumi.StringOutput)
}

type RoleArrayOutput struct{ *pulumi.OutputState }

func (RoleArrayOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*[]*Role)(nil)).Elem()
}

func (o RoleArrayOutput) ToRoleArrayOutput() RoleArrayOutput {
	return o
}

func (o RoleArrayOutput) ToRoleArrayOutputWithContext(ctx context.Context) RoleArrayOutput {
	return o
}

func (o RoleArrayOutput) Index(i pulumi.IntInput) RoleOutput {
	return pulumi.All(o, i).ApplyT(func(vs []interface{}) *Role {
		return vs[0].([]*Role)[vs[1].(int)]
	}).(RoleOutput)
}

type RoleMapOutput struct{ *pulumi.OutputState }

func (RoleMapOutput) ElementType() reflect.Type {
	return reflect.TypeOf((*map[string]*Role)(nil)).Elem()
}

func (o RoleMapOutput) ToRoleMapOutput() RoleMapOutput {
	return o
}

func (o RoleMapOutput) ToRoleMapOutputWithContext(ctx context.Context) RoleMapOutput {
	return o
}

func (o RoleMapOutput) MapIndex(k pulumi.StringInput) RoleOutput {
	return pulumi.All(o, k).ApplyT(func(vs []interface{}) *Role {
		return vs[0].(map[string]*Role)[vs[1].(string)]
	}).(RoleOutput)
}

func init() {
	pulumi.RegisterInputType(reflect.TypeOf((*RoleInput)(nil)).Elem(), &Role{})
	pulumi.RegisterInputType(reflect.TypeOf((*RoleArrayInput)(nil)).Elem(), RoleArray{})
	pulumi.RegisterInputType(reflect.TypeOf((*RoleMapInput)(nil)).Elem(), RoleMap{})
	pulumi.RegisterOutputType(RoleOutput{})
	pulumi.RegisterOutputType(RoleArrayOutput{})
	pulumi.RegisterOutputType(RoleMapOutput{})
}