ListOrganizations - 查询用户的企业列表

查询当前用户的企业列表。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求语法

GET /organizations/list

请求参数

名称类型必填描述示例值
accessTokenstring

个人访问令牌。 使用阿里云 AK+SK 或使用 STS 临时授权方式不需要传该字段

agp_adf6bc4433173ab3cb43195b6ff9213d
accessLevelinteger

用户权限,用于查询指定权限的企业列表

  • 5:企业外部成员
  • 15:企业成员
  • 60:企业管理员
  • 70:企业拥有者
5
minAccessLevelinteger

最小用户权限,用于查询用户权限大于等于该字段设置的企业列表

  • 5:企业外部成员
  • 15:企业成员
  • 60:企业管理员
  • 70:企业拥有者
说明 minAccessLevel 优先生效,不传 minAccessLevel 时 accessLevel 参数生效
60

返回参数

名称类型描述示例值
object

Schema of Response

requestIdstring

请求 ID

95FE5953-FF5B-5F80-94AD-FFF97D990FE0
errorCodestring

错误码

SYSTEM_UNKNOWN_ERROR
errorMessagestring

错误信息

""
totallong

总记录数

2
successboolean

调用是否成功

true
resultarray<object>

返回的企业列表

object

单个企业信息

idlong

企业主键 ID

说明 无业务实际意义,且在企业未开通 Codeup 时,该值为空
5240
accessLevelinteger

用户在企业中的权限

  • 5:企业外部成员
  • 15:企业成员
  • 60:企业管理员
  • 70:企业拥有者
60
organizationIdstring

企业标识,也称企业 id,字符串形式,可在云效访问链接中获取,如 https://devops.aliyun.com/organization/【OrganizationId】

60de7a6852743a5162b5f957
organizationNamestring

企业名称

云效Codeup
organizationRolestring

用户在企业中的角色

  • ORG_EXTERNAL_MEMBER:企业外部成员

  • ORG_MEMBER:企业成员

  • ORG_ADMIN:企业管理员

  • ORG_OWNER:企业拥有者

ORG_ADMIN
organizationAliasstring

企业别名

说明 若企业开通了 Codeup,那么企业别名一般有值;若没有开通,则为空
alias-云效Codeup
namespaceIdstring

企业空间 ID

600002

示例

正常返回示例

JSON格式

{
  "requestId": "95FE5953-FF5B-5F80-94AD-FFF97D990FE0",
  "errorCode": "SYSTEM_UNKNOWN_ERROR",
  "errorMessage": "\"\"",
  "total": 2,
  "success": true,
  "result": [
    {
      "id": 5240,
      "accessLevel": 60,
      "organizationId": "60de7a6852743a5162b5f957",
      "organizationName": "云效Codeup",
      "organizationRole": "ORG_ADMIN",
      "organizationAlias": "alias-云效Codeup",
      "namespaceId": "600002"
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-04-07OpenAPI 入参发生变更查看变更详情
2024-03-28OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情