Skip to main content
组织与账号

获取组织信息

获取指定组织的信息

前提条件

已获取阿里云账号或 RAM 用户的 AccessKey,并已为其授予调用本接口所需的 RAM 权限。建议将 AccessKey 配置为环境变量 ALIBABA_CLOUD_ACCESS_KEY_IDALIBABA_CLOUD_ACCESS_KEY_SECRET,避免明文写入代码。

请求说明

  • HTTP 方法:GET
  • 请求地址

    地域

    Endpoint

    新加坡

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization

  • 认证方式 本接口是阿里云 OpenAPI,采用 AccessKey 签名(签名算法 ACS3-HMAC-SHA256),不支持 Authorization: Bearer {API_KEY} 方式。请求需携带公共请求头 x-acs-action: GetOrganizationx-acs-version: 2026-02-10x-acs-datex-acs-content-sha256x-acs-signature-nonce 以及 Authorization 推荐使用阿里云 SDK 或 OpenAPI Explorer 发起调用,可免去自行计算签名。
通过 OrgId,获取指定组织的信息

请求参数

该接口无请求参数。

返回参数

参数

类型

描述

Success

boolean

调用接口是否成功:
true:成功
false:失败

Code

string

响应状态码。

Message

string

响应信息。

Data

object

业务数据

OrgId

string

组织 ID

NamespaceId

string

产品命名空间 ID

Name

string

组织名称

Description

string

组织描述

Status

string

状态(ACTIVE/FROZEN)

OwnerId

string

组织 Owner 的 UAC 账号 ID

OwnerBizAccountId

string

组织 Owner 的业务账号标识(ALIYUN 类型为 aliyunUid,SSO 类型为 userIdentifier)

GmtCreate

string

创建时间

GmtModified

string

修改时间

HttpStatusCode

integer

HTTP 状态码

RequestId

string

请求唯一标识

请求示例

本接口使用阿里云 OpenAPI 签名,下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 算法计算得出,x-acs-datex-acs-signature-nonce 需替换为实际值。
curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/organization" \
    --header "x-acs-action: GetOrganization" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

返回示例

{
  "Success": true,
  "Data": {
    "OrgId": "org_123456789",
    "NamespaceId": "namespace-1",
    "Name": "组织名称",
    "Description": "组织描述",
    "Status": "ACTIVE",
    "OwnerId": "acc_123456789",
    "OwnerBizAccountId": "1543686331379464",
    "GmtCreate": "2025-11-20T02:26:35Z",
    "GmtModified": "2025-11-13T02:11:56Z"
  }
}

错误码

如果调用失败,会返回错误信息。更多错误码及解决方法,请参见错误信息