修改权限配置信息

最近更新时间: 2026-10-12 00:11:05

1. 接口描述

接口请求域名： cic.api3.fincloud.tencent.com。

修改权限配置信息

默认接口请求频率限制：20次/秒。

接口更新时间：2024-12-11 12:17:58。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称 必选 允许NULL 类型 描述
Action 是 否 String 公共参数，本接口取值：UpdateRoleConfiguration
Version 是 否 String 公共参数，本接口取值：2021-03-31
Region 是 否 String 公共参数，地域信息本接口不需要传递此参数。
ZoneId 是 是 String 空间 ID
示例值： z-2d8shd8***
RoleConfigurationId 是 是 String 权限配置 ID
示例值： rc-sisjdia
NewDescription 否 是 String 新的权限配置描述。  长度：最大 1024 个字符。
示例值： description
NewSessionDuration 否 是 Int64 新的会话持续时间。  CIC 用户使用权限配置访问集团账号目标账号时，会话最多保持的时间。  单位：秒。  取值范围：900-43200（15 分钟-12 小时）。
示例值： 60
NewRelayState 否 是 String 新的初始访问页面。  CIC 用户使用权限配置访问集团账号目标账号时，初始访问的页面地址。  该页面必须是云控制台页面。
示例值： https://XXX

3. 输出参数

参数名称 类型 描述
RoleConfigurationInfo RoleConfiguration 权限配置详情
示例值：查看
RequestId String 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码 描述
FailedOperation.DBOperationError
FailedOperation.IdentityCenterNotOpen
FailedOperation.ZoneIdNotExist
InvalidParameter.RoleConfigurationNotExist

5. 示例

示例1 修改权限配置信息

输入示例

{
  "ZoneId": "z-22m23mo2",
  "RoleConfigurationId": "rc-ai3n9si2m",
  "NewDescription": "this is role configuration",
  "NewSessionDuration": 900,
  "NewRelayState": "https://console.cloud.XXX.com"
}

输出示例

{
  "Response": {
    "RoleConfigurationInfo": 
      {
        "RoleConfigurationId": "rc-s2ns92ns***",
        "RoleConfigurationName": "test",
        "Description": "this is role configuration",
        "SessionDuration": 900,
        "RelayState": "https://console.cloud.XXX.com",
        "CreateTime": "2019-01-01 12:12:12",
        "UpdateTime": "2019-01-01 12:12:12"
      },
    "RequestId": "e297543a-80de-4039-83c8-9d324545"
  }
}