全部产品
Search
文档中心

应用身份服务:GetCloudAccount - 查询一个云账号信息

更新时间:Oct 10, 2026

查询一个云账号资源信息。

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

eiam:GetCloudAccount

get

*CloudAccount

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/cloudaccount/{#CloudAccountId}

无 无

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

是

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

CloudAccountId

string

是

云账号 ID。

ca_01kmegjc11qa1txxxxx

返回参数

名称

类型

描述

示例值

object

CloudAccount

object

云账号详情。

CloudAccountExternalId

string

云账号外部唯一标识。

1234567

CloudAccountHealth

string

云账号健康状态。取值可选范围:

  • healthy:健康。

  • unhealthy:不健康。

  • unknown:未知。

枚举值:

  • healthy :

    healthy

  • unhealthy :

    unhealthy

  • unknown :

    unknown

healthy

CloudAccountHealthCheckResult

object

云账号健康状态检查结果。

ErrorReason

object

错误原因。当健康检查状态为 unhealthy 时,该字段会返回值。

ErrorCode

string

错误码。

AuthenticationFail.NoPermission

ErrorMessage

string

错误描述。

There is no permission.

LastCheckTime

integer

最后一次检测时间,Unix 时间戳格式,单位为毫秒。

1649830226000

Result

string

云账号健康检查结果。取值可选范围:

  • success:成功。

  • failed:失败。

枚举值:

  • success :

    success

  • failed :

    failed

success

CloudAccountId

string

云账号 ID。

ca_01kmegjc11qa1txxxxx

CloudAccountName

string

云账号名称。

cloud_accout_xxxx

CloudAccountProviderConfig

object

身份提供商配置信息。

Audience

string

受众标识。

urn:cloud:idaas:sts:xxx:xxx

AuthorizationServerId

string

授权服务器 ID。

iauths_system

Issuer

string

Issuer。

https://xxxxx.aliyunidaas.com/api/v2/iauths_system/oauth2

OidcJwksEndpoint

string

验签公钥端点。

https://xxxxx.aliyunidaas.com/api/v2/iauths_system/oauth2/jwks

CloudAccountProviderName

string

身份提供商名称。

idaas-eiam-oidc-provider

CloudAccountSite

string

云账号站点

  • china_mainland:中国内地。

  • global:全球。

china_mainland

CloudAccountVendorType

string

云账号类型。取值可选范围:

  • alibaba_cloud:阿里云

枚举值:

  • alibaba_cloud :

    alibaba_cloud

alibaba_cloud

CreateTime

integer

创建时间,Unix 时间戳格式,单位为毫秒。

1649830225000

Description

string

云账号描述。

cloud_accout_description

InstanceId

string

实例 ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

PrivilegeApplicationIds

array

关联的特权应用 ID 列表

string

关联的特权应用 ID 列表

app_mkv7rgt4d7i4u7zqtzev2mxxxx

PrivilegeHostingError

object

特权托管或移除失败原因

ErrorCode

string

失败错误码

Error

ErrorMessage

string

失败信息

test message

PrivilegeHostingState

string

云账号托管状态,默认为未托管,取值可选范围:

  • hosting_unmanaged:未托管,云账号尚未发起托管,处于初始状态。

  • hosting_pending:托管中,托管任务已提交并异步执行中,需等待托管流程完成后进入最终状态。

  • hosting_completed:托管完成,云账号托管流程执行成功,相关权限模板与托管绑定已生效。

  • hosting_failed:托管失败,托管流程执行异常,可查看失败原因后重新发起托管。

  • hosting_removing:移除中,移除托管任务已提交并异步执行中,需等待移除流程完成后进入最终状态。

  • hosting_remove_failed:移除失败,移除托管流程执行异常,可查看失败原因后重新发起移除。

hosting_unmanaged

PrivilegeStatus

string

特权开关状态,取值可选范围:

  • enabled:启用,资源处于生效状态,可正常使用。

  • disabled:禁用,资源处于停用状态,不再生效,可重新启用恢复。

enabled

UpdateTime

integer

最近更新时间,Unix 时间戳格式,单位为毫秒。

1649830227000

RequestId

string

请求 ID。

0441BD79-92F3-53AA-8657-F8CE4A2B912A

示例

正常返回示例

JSON格式

{
  "CloudAccount": {
    "CloudAccountExternalId": "1234567",
    "CloudAccountHealth": "healthy",
    "CloudAccountHealthCheckResult": {
      "ErrorReason": {
        "ErrorCode": "AuthenticationFail.NoPermission",
        "ErrorMessage": "There is no permission."
      },
      "LastCheckTime": 1649830226000,
      "Result": "success"
    },
    "CloudAccountId": "ca_01kmegjc11qa1txxxxx",
    "CloudAccountName": "cloud_accout_xxxx",
    "CloudAccountProviderConfig": {
      "Audience": "urn:cloud:idaas:sts:xxx:xxx",
      "AuthorizationServerId": "iauths_system",
      "Issuer": "https://xxxxx.aliyunidaas.com/api/v2/iauths_system/oauth2",
      "OidcJwksEndpoint": "https://xxxxx.aliyunidaas.com/api/v2/iauths_system/oauth2/jwks"
    },
    "CloudAccountProviderName": "idaas-eiam-oidc-provider",
    "CloudAccountSite": "china_mainland",
    "CloudAccountVendorType": "alibaba_cloud",
    "CreateTime": 1649830225000,
    "Description": "cloud_accout_description",
    "InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
    "PrivilegeApplicationIds": [
      "app_mkv7rgt4d7i4u7zqtzev2mxxxx"
    ],
    "PrivilegeHostingError": {
      "ErrorCode": "Error",
      "ErrorMessage": "test message"
    },
    "PrivilegeHostingState": "hosting_unmanaged",
    "PrivilegeStatus": "enabled",
    "UpdateTime": 1649830227000
  },
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A"
}

错误码

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

变更历史

更多信息,参考变更详情。