1. Packages
  2. Volcenginecc Provider
  3. API Docs
  4. iam
  5. Group
volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
volcengine/pulumi-volcenginecc

volcenginecc.iam.Group

Deploy with Pulumi
volcenginecc logo
volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
volcengine/pulumi-volcenginecc

    用户组是用户的集合。当用户组被关联上策略后，同一用户组里的所有用户会拥有对应的策略权限，同一个用户可存在于多个用户组中，可同时拥有多个用户组的权限。

    Example Usage

    Example coming soon!

    Example coming soon!

    Example coming soon!

    Example coming soon!

    Example coming soon!

    resources:
  groupDemo:
    type: volcenginecc:iam:Group
    name: GroupDemo
    properties:
      userGroupName: GroupDemo
      description: GroupDemo-Description
      displayName: GroupDemo-DisplayName
      users:
        - user_name: demo
      attachedPolicys:
        - policy_type: System
          policy_name: ECSFullAccess
          policy_scope:
            - attachTime: 20230810T071***Z
              policyScopeType: Project
              projectDisplayName: demo
              projectName: Project

    Create Group Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Group(name: string, args: GroupArgs, opts?: CustomResourceOptions);
    @overload
def Group(resource_name: str,
          args: GroupArgs,
          opts: Optional[ResourceOptions] = None)

@overload
def Group(resource_name: str,
          opts: Optional[ResourceOptions] = None,
          user_group_name: Optional[str] = None,
          attached_policys: Optional[Sequence[GroupAttachedPolicyArgs]] = None,
          description: Optional[str] = None,
          display_name: Optional[str] = None,
          users: Optional[Sequence[GroupUserArgs]] = None)
    func NewGroup(ctx *Context, name string, args GroupArgs, opts ...ResourceOption) (*Group, error)
    public Group(string name, GroupArgs args, CustomResourceOptions? opts = null)
    public Group(String name, GroupArgs args)
public Group(String name, GroupArgs args, CustomResourceOptions options)

    type: volcenginecc:iam:Group
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args GroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args GroupArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args GroupArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args GroupArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args GroupArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var groupResource = new Volcenginecc.Iam.Group("groupResource", new()
{
    UserGroupName = "string",
    AttachedPolicys = new[]
    {
        new Volcenginecc.Iam.Inputs.GroupAttachedPolicyArgs
        {
            PolicyName = "string",
            PolicyScopes = new[]
            {
                new Volcenginecc.Iam.Inputs.GroupAttachedPolicyPolicyScopeArgs
                {
                    AttachTime = "string",
                    PolicyScopeType = "string",
                    ProjectDisplayName = "string",
                    ProjectName = "string",
                },
            },
            PolicyType = "string",
        },
    },
    Description = "string",
    DisplayName = "string",
    Users = new[]
    {
        new Volcenginecc.Iam.Inputs.GroupUserArgs
        {
            UserName = "string",
        },
    },
});

    example, err := iam.NewGroup(ctx, "groupResource", &iam.GroupArgs{
	UserGroupName: pulumi.String("string"),
	AttachedPolicys: iam.GroupAttachedPolicyArray{
		&iam.GroupAttachedPolicyArgs{
			PolicyName: pulumi.String("string"),
			PolicyScopes: iam.GroupAttachedPolicyPolicyScopeArray{
				&iam.GroupAttachedPolicyPolicyScopeArgs{
					AttachTime:         pulumi.String("string"),
					PolicyScopeType:    pulumi.String("string"),
					ProjectDisplayName: pulumi.String("string"),
					ProjectName:        pulumi.String("string"),
				},
			},
			PolicyType: pulumi.String("string"),
		},
	},
	Description: pulumi.String("string"),
	DisplayName: pulumi.String("string"),
	Users: iam.GroupUserArray{
		&iam.GroupUserArgs{
			UserName: pulumi.String("string"),
		},
	},
})

    var groupResource = new Group("groupResource", GroupArgs.builder()
    .userGroupName("string")
    .attachedPolicys(GroupAttachedPolicyArgs.builder()
        .policyName("string")
        .policyScopes(GroupAttachedPolicyPolicyScopeArgs.builder()
            .attachTime("string")
            .policyScopeType("string")
            .projectDisplayName("string")
            .projectName("string")
            .build())
        .policyType("string")
        .build())
    .description("string")
    .displayName("string")
    .users(GroupUserArgs.builder()
        .userName("string")
        .build())
    .build());

    group_resource = volcenginecc.iam.Group("groupResource",
    user_group_name="string",
    attached_policys=[{
        "policy_name": "string",
        "policy_scopes": [{
            "attach_time": "string",
            "policy_scope_type": "string",
            "project_display_name": "string",
            "project_name": "string",
        }],
        "policy_type": "string",
    }],
    description="string",
    display_name="string",
    users=[{
        "user_name": "string",
    }])

    const groupResource = new volcenginecc.iam.Group("groupResource", {
    userGroupName: "string",
    attachedPolicys: [{
        policyName: "string",
        policyScopes: [{
            attachTime: "string",
            policyScopeType: "string",
            projectDisplayName: "string",
            projectName: "string",
        }],
        policyType: "string",
    }],
    description: "string",
    displayName: "string",
    users: [{
        userName: "string",
    }],
});

    type: volcenginecc:iam:Group
properties:
    attachedPolicys:
        - policyName: string
          policyScopes:
            - attachTime: string
              policyScopeType: string
              projectDisplayName: string
              projectName: string
          policyType: string
    description: string
    displayName: string
    userGroupName: string
    users:
        - userName: string

    Group Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Group resource accepts the following input properties:

    UserGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    AttachedPolicys List<Volcengine.GroupAttachedPolicy>
    Description string
    用户组描述信息。长度不超过128。
    DisplayName string
    用户组显示名称。长度不超过64。
    Users List<Volcengine.GroupUser>
    UserGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    AttachedPolicys []GroupAttachedPolicyArgs
    Description string
    用户组描述信息。长度不超过128。
    DisplayName string
    用户组显示名称。长度不超过64。
    Users []GroupUserArgs
    userGroupName String
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    attachedPolicys List<GroupAttachedPolicy>
    description String
    用户组描述信息。长度不超过128。
    displayName String
    用户组显示名称。长度不超过64。
    users List<GroupUser>
    userGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    attachedPolicys GroupAttachedPolicy[]
    description string
    用户组描述信息。长度不超过128。
    displayName string
    用户组显示名称。长度不超过64。
    users GroupUser[]
    user_group_name str
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    attached_policys Sequence[GroupAttachedPolicyArgs]
    description str
    用户组描述信息。长度不超过128。
    display_name str
    用户组显示名称。长度不超过64。
    users Sequence[GroupUserArgs]
    userGroupName String
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    attachedPolicys List<Property Map>
    description String
    用户组描述信息。长度不超过128。
    displayName String
    用户组显示名称。长度不超过64。
    users List<Property Map>

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Group resource produces the following output properties:

    AccountId int
    用户组所属主账号的ID。
    CreatedTime string
    用户组的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedTime string
    用户组的更新时间。
    UserGroupId int
    用户组ID。
    AccountId int
    用户组所属主账号的ID。
    CreatedTime string
    用户组的创建时间。
    Id string
    The provider-assigned unique ID for this managed resource.
    UpdatedTime string
    用户组的更新时间。
    UserGroupId int
    用户组ID。
    accountId Integer
    用户组所属主账号的ID。
    createdTime String
    用户组的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    updatedTime String
    用户组的更新时间。
    userGroupId Integer
    用户组ID。
    accountId number
    用户组所属主账号的ID。
    createdTime string
    用户组的创建时间。
    id string
    The provider-assigned unique ID for this managed resource.
    updatedTime string
    用户组的更新时间。
    userGroupId number
    用户组ID。
    account_id int
    用户组所属主账号的ID。
    created_time str
    用户组的创建时间。
    id str
    The provider-assigned unique ID for this managed resource.
    updated_time str
    用户组的更新时间。
    user_group_id int
    用户组ID。
    accountId Number
    用户组所属主账号的ID。
    createdTime String
    用户组的创建时间。
    id String
    The provider-assigned unique ID for this managed resource.
    updatedTime String
    用户组的更新时间。
    userGroupId Number
    用户组ID。

    Look up Existing Group Resource

    Get an existing Group resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: GroupState, opts?: CustomResourceOptions): Group
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        account_id: Optional[int] = None,
        attached_policys: Optional[Sequence[GroupAttachedPolicyArgs]] = None,
        created_time: Optional[str] = None,
        description: Optional[str] = None,
        display_name: Optional[str] = None,
        updated_time: Optional[str] = None,
        user_group_id: Optional[int] = None,
        user_group_name: Optional[str] = None,
        users: Optional[Sequence[GroupUserArgs]] = None) -> Group
    func GetGroup(ctx *Context, name string, id IDInput, state *GroupState, opts ...ResourceOption) (*Group, error)
    public static Group Get(string name, Input<string> id, GroupState? state, CustomResourceOptions? opts = null)
    public static Group get(String name, Output<String> id, GroupState state, CustomResourceOptions options)
    resources:  _:    type: volcenginecc:iam:Group    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AccountId int
    用户组所属主账号的ID。
    AttachedPolicys List<Volcengine.GroupAttachedPolicy>
    CreatedTime string
    用户组的创建时间。
    Description string
    用户组描述信息。长度不超过128。
    DisplayName string
    用户组显示名称。长度不超过64。
    UpdatedTime string
    用户组的更新时间。
    UserGroupId int
    用户组ID。
    UserGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    Users List<Volcengine.GroupUser>
    AccountId int
    用户组所属主账号的ID。
    AttachedPolicys []GroupAttachedPolicyArgs
    CreatedTime string
    用户组的创建时间。
    Description string
    用户组描述信息。长度不超过128。
    DisplayName string
    用户组显示名称。长度不超过64。
    UpdatedTime string
    用户组的更新时间。
    UserGroupId int
    用户组ID。
    UserGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    Users []GroupUserArgs
    accountId Integer
    用户组所属主账号的ID。
    attachedPolicys List<GroupAttachedPolicy>
    createdTime String
    用户组的创建时间。
    description String
    用户组描述信息。长度不超过128。
    displayName String
    用户组显示名称。长度不超过64。
    updatedTime String
    用户组的更新时间。
    userGroupId Integer
    用户组ID。
    userGroupName String
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    users List<GroupUser>
    accountId number
    用户组所属主账号的ID。
    attachedPolicys GroupAttachedPolicy[]
    createdTime string
    用户组的创建时间。
    description string
    用户组描述信息。长度不超过128。
    displayName string
    用户组显示名称。长度不超过64。
    updatedTime string
    用户组的更新时间。
    userGroupId number
    用户组ID。
    userGroupName string
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    users GroupUser[]
    account_id int
    用户组所属主账号的ID。
    attached_policys Sequence[GroupAttachedPolicyArgs]
    created_time str
    用户组的创建时间。
    description str
    用户组描述信息。长度不超过128。
    display_name str
    用户组显示名称。长度不超过64。
    updated_time str
    用户组的更新时间。
    user_group_id int
    用户组ID。
    user_group_name str
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    users Sequence[GroupUserArgs]
    accountId Number
    用户组所属主账号的ID。
    attachedPolicys List<Property Map>
    createdTime String
    用户组的创建时间。
    description String
    用户组描述信息。长度不超过128。
    displayName String
    用户组显示名称。长度不超过64。
    updatedTime String
    用户组的更新时间。
    userGroupId Number
    用户组ID。
    userGroupName String
    用户组名称。长度1~64，支持英文、数字和.-_符号。
    users List<Property Map>

    Supporting Types

    GroupAttachedPolicy, GroupAttachedPolicyArgs

    PolicyName string
    策略名。
    PolicyScopes List<Volcengine.GroupAttachedPolicyPolicyScope>
    PolicyType string
    策略类型。System代表系统预设策略，Custom代表自定义策略。
    PolicyName string
    策略名。
    PolicyScopes []GroupAttachedPolicyPolicyScope
    PolicyType string
    策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName String
    策略名。
    policyScopes List<GroupAttachedPolicyPolicyScope>
    policyType String
    策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName string
    策略名。
    policyScopes GroupAttachedPolicyPolicyScope[]
    policyType string
    策略类型。System代表系统预设策略，Custom代表自定义策略。
    policy_name str
    策略名。
    policy_scopes Sequence[GroupAttachedPolicyPolicyScope]
    policy_type str
    策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName String
    策略名。
    policyScopes List<Property Map>
    policyType String
    策略类型。System代表系统预设策略，Custom代表自定义策略。

    GroupAttachedPolicyPolicyScope, GroupAttachedPolicyPolicyScopeArgs

    AttachTime string
    项目授权时间。
    PolicyScopeType string
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    ProjectDisplayName string
    按项目授权时的项目显示名。
    ProjectName string
    按项目授权时的项目名。
    AttachTime string
    项目授权时间。
    PolicyScopeType string
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    ProjectDisplayName string
    按项目授权时的项目显示名。
    ProjectName string
    按项目授权时的项目名。
    attachTime String
    项目授权时间。
    policyScopeType String
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    projectDisplayName String
    按项目授权时的项目显示名。
    projectName String
    按项目授权时的项目名。
    attachTime string
    项目授权时间。
    policyScopeType string
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    projectDisplayName string
    按项目授权时的项目显示名。
    projectName string
    按项目授权时的项目名。
    attach_time str
    项目授权时间。
    policy_scope_type str
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    project_display_name str
    按项目授权时的项目显示名。
    project_name str
    按项目授权时的项目名。
    attachTime String
    项目授权时间。
    policyScopeType String
    授权类型。Global代表全局授权（不限制项目），Project代表按项目授权。
    projectDisplayName String
    按项目授权时的项目显示名。
    projectName String
    按项目授权时的项目名。

    GroupUser, GroupUserArgs

    UserName string
    用户名。
    UserName string
    用户名。
    userName String
    用户名。
    userName string
    用户名。
    user_name str
    用户名。
    userName String
    用户名。

    Import

    $ pulumi import volcenginecc:iam/group:Group example "user_group_name"

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    volcenginecc volcengine/pulumi-volcenginecc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the volcenginecc Terraform Provider.
    volcenginecc logo
    volcenginecc v0.0.2 published on Saturday, Oct 11, 2025 by Volcengine
    volcengine/pulumi-volcenginecc
      Meet Neo: Your AI Platform Teammate