1. Packages
  2. Bytepluscc Provider
  3. API Docs
  4. iam
  5. getRole
Viewing docs for bytepluscc v0.0.16
published on Monday, Mar 9, 2026 by Byteplus
Schema (JSON)
byteplus-sdk/pulumi-bytepluscc

bytepluscc.iam.getRole

bytepluscc logo
Viewing docs for bytepluscc v0.0.16
published on Monday, Mar 9, 2026 by Byteplus
Schema (JSON)
byteplus-sdk/pulumi-bytepluscc

    Data Source schema for Byteplus::IAM::Role

    Using getRole

    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 getRole(args: GetRoleArgs, opts?: InvokeOptions): Promise<GetRoleResult>
function getRoleOutput(args: GetRoleOutputArgs, opts?: InvokeOptions): Output<GetRoleResult>
    def get_role(id: Optional[str] = None,
             opts: Optional[InvokeOptions] = None) -> GetRoleResult
def get_role_output(id: Optional[pulumi.Input[str]] = None,
             opts: Optional[InvokeOptions] = None) -> Output[GetRoleResult]
    func LookupRole(ctx *Context, args *LookupRoleArgs, opts ...InvokeOption) (*LookupRoleResult, error)
func LookupRoleOutput(ctx *Context, args *LookupRoleOutputArgs, opts ...InvokeOption) LookupRoleResultOutput

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

    public static class GetRole 
{
    public static Task<GetRoleResult> InvokeAsync(GetRoleArgs args, InvokeOptions? opts = null)
    public static Output<GetRoleResult> Invoke(GetRoleInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetRoleResult> getRole(GetRoleArgs args, InvokeOptions options)
public static Output<GetRoleResult> getRole(GetRoleArgs args, InvokeOptions options)

    fn::invoke:
  function: bytepluscc:iam/getRole:getRole
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Id string
    Uniquely identifies the resource.
    Id string
    Uniquely identifies the resource.
    id String
    Uniquely identifies the resource.
    id string
    Uniquely identifies the resource.
    id str
    Uniquely identifies the resource.
    id String
    Uniquely identifies the resource.

    getRole Result

    The following output properties are available:

    CreateDate string
    角色创建时间。
    Description string
    角色描述，长度不超过128。
    DisplayName string
    角色显示名，长度不超过64。
    Id string
    Uniquely identifies the resource.
    IsServiceLinkedRole int
    是否是服务关联角色, 0否，1是。
    MaxSessionDuration int
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    Policies List<Byteplus.GetRolePolicy>
    角色策略。
    RoleId int
    角色ID。
    RoleName string
    角色名，长度1~64，支持英文、数字和.-_符号。
    Tags List<Byteplus.GetRoleTag>
    标签。
    Trn string
    角色TRN。
    TrustPolicyDocument string
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    UpdateDate string
    角色更新时间。
    CreateDate string
    角色创建时间。
    Description string
    角色描述，长度不超过128。
    DisplayName string
    角色显示名，长度不超过64。
    Id string
    Uniquely identifies the resource.
    IsServiceLinkedRole int
    是否是服务关联角色, 0否，1是。
    MaxSessionDuration int
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    Policies []GetRolePolicy
    角色策略。
    RoleId int
    角色ID。
    RoleName string
    角色名，长度1~64，支持英文、数字和.-_符号。
    Tags []GetRoleTag
    标签。
    Trn string
    角色TRN。
    TrustPolicyDocument string
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    UpdateDate string
    角色更新时间。
    createDate String
    角色创建时间。
    description String
    角色描述，长度不超过128。
    displayName String
    角色显示名，长度不超过64。
    id String
    Uniquely identifies the resource.
    isServiceLinkedRole Integer
    是否是服务关联角色, 0否，1是。
    maxSessionDuration Integer
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    policies List<GetRolePolicy>
    角色策略。
    roleId Integer
    角色ID。
    roleName String
    角色名，长度1~64，支持英文、数字和.-_符号。
    tags List<GetRoleTag>
    标签。
    trn String
    角色TRN。
    trustPolicyDocument String
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    updateDate String
    角色更新时间。
    createDate string
    角色创建时间。
    description string
    角色描述，长度不超过128。
    displayName string
    角色显示名，长度不超过64。
    id string
    Uniquely identifies the resource.
    isServiceLinkedRole number
    是否是服务关联角色, 0否，1是。
    maxSessionDuration number
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    policies GetRolePolicy[]
    角色策略。
    roleId number
    角色ID。
    roleName string
    角色名，长度1~64，支持英文、数字和.-_符号。
    tags GetRoleTag[]
    标签。
    trn string
    角色TRN。
    trustPolicyDocument string
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    updateDate string
    角色更新时间。
    create_date str
    角色创建时间。
    description str
    角色描述，长度不超过128。
    display_name str
    角色显示名，长度不超过64。
    id str
    Uniquely identifies the resource.
    is_service_linked_role int
    是否是服务关联角色, 0否，1是。
    max_session_duration int
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    policies Sequence[GetRolePolicy]
    角色策略。
    role_id int
    角色ID。
    role_name str
    角色名，长度1~64，支持英文、数字和.-_符号。
    tags Sequence[GetRoleTag]
    标签。
    trn str
    角色TRN。
    trust_policy_document str
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    update_date str
    角色更新时间。
    createDate String
    角色创建时间。
    description String
    角色描述，长度不超过128。
    displayName String
    角色显示名，长度不超过64。
    id String
    Uniquely identifies the resource.
    isServiceLinkedRole Number
    是否是服务关联角色, 0否，1是。
    maxSessionDuration Number
    角色最大会话时间，角色最大会话时间。用于限制角色扮演产生的临时安全凭证的有效期的最大范围。取值范围：3600~43200，单位为秒，默认为43200。
    policies List<Property Map>
    角色策略。
    roleId Number
    角色ID。
    roleName String
    角色名，长度1~64，支持英文、数字和.-_符号。
    tags List<Property Map>
    标签。
    trn String
    角色TRN。
    trustPolicyDocument String
    角色信任策略，信任策略遵循IAM的策略语法中基于资源的策略规则。
    updateDate String
    角色更新时间。

    Supporting Types

    GetRolePolicy

    PolicyName string
    策略名。
    PolicyType string
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。
    PolicyName string
    策略名。
    PolicyType string
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName String
    策略名。
    policyType String
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName string
    策略名。
    policyType string
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。
    policy_name str
    策略名。
    policy_type str
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。
    policyName String
    策略名。
    policyType String
    策略类型，策略类型。System代表系统预设策略，Custom代表自定义策略。

    GetRoleTag

    Key string
    标签键。
    Value string
    标签值。
    Key string
    标签键。
    Value string
    标签值。
    key String
    标签键。
    value String
    标签值。
    key string
    标签键。
    value string
    标签值。
    key str
    标签键。
    value str
    标签值。
    key String
    标签键。
    value String
    标签值。

    Package Details

    Repository
    bytepluscc byteplus-sdk/pulumi-bytepluscc
    License
    MPL-2.0
    Notes
    This Pulumi package is based on the bytepluscc Terraform Provider.
    bytepluscc logo
    Viewing docs for bytepluscc v0.0.16
    published on Monday, Mar 9, 2026 by Byteplus
    Schema (JSON)
    byteplus-sdk/pulumi-bytepluscc
      Try Pulumi Cloud free. Your team will thank you.