You need to enable JavaScript to run this app.
导航
GetResource - 通过此接口查询指定资源
最近更新时间:2025.09.25 17:18:07首次发布时间:2025.09.25 16:37:12
复制全文
我的收藏
有用
有用
无用
无用

通过此接口查询指定资源

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

GetResource

要执行的操作,取值:GetResource。

Version
String

2025-06-01

API的版本,取值:2025-06-01。

TypeName
String

Volcengine::IAM::User

资源类型的抽象描述,格式为“Volcengine::服务名称::资源名称”,可以通过 ListResourceTypes 查询支持的资源类型

Identifier
String

user-cc

资源实例的唯一标识符,标识符可以由单个或多个资源属性组成,可以使用该标识唯一定位资源

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
TypeName
String

Volcengine::IAM::User

资源类型的抽象描述,格式为“Volcengine::服务名称::资源名称”,可以通过 ListResourceTypes 查询支持的资源类型

ResourceDescription
Object

{
"Identifier": "user-cc",
"Properties": "{"AccountId":2000000191,"CreateDate":"20250919T061541Z","Description":"this is a iam user created by ccapi","DisplayName":"demo","Email":"","EmailIsVerify":false,"LoginProfile":{"CreateDate":"20250919T095404Z","LastLoginDate":"19700101T000000Z","LastLoginIp":"","LastResetPasswordTime":0,"LoginAllowed":false,"LoginLocked":false,"PasswordExpireAt":0,"PasswordResetRequired":false,"SafeAuthExemptDuration":10,"SafeAuthExemptRequired":1,"SafeAuthExemptUnit":0,"SafeAuthFlag":false,"SafeAuthType":"","UpdateDate":"20250919T095404Z"},"MobilePhone":"","MobilePhoneIsVerify":false,"Policies":[{"PolicyName":"IAMReadOnlyAccess","PolicyType":"System"}],"SecurityConfig":{"SafeAuthClose":0,"SafeAuthExemptDuration":10,"SafeAuthType":"phone,email,vmfa"},"Tags":[{"Key":"usage","Value":"ccapi"}],"Trn":"trn:iam::2000000191:user/user-cc","UpdateDate":"20250919T061541Z","UserId":1819703,"UserName":"user-cc"}"
}

完整资源信息,包括资源属性及其值

请求示例

{
    "Identifier": "user-cc",
    "TypeName": "Volcengine::IAM::User"
  }

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20250919175351CC2A2E6C9C1EEB755586",
    "Region": "cn-beijing"
  },
  "Result": {
    "TypeName": "Volcengine::IAM::User",
    "ResourceDescription": {
      "Identifier": "user-cc",
      "Properties": "{\"AccountId\":2000000191,\"CreateDate\":\"20250919T061541Z\",\"Description\":\"this is a iam user created by ccapi\",\"DisplayName\":\"demo\",\"Email\":\"\",\"EmailIsVerify\":false,\"LoginProfile\":{\"CreateDate\":\"20250919T095404Z\",\"LastLoginDate\":\"19700101T000000Z\",\"LastLoginIp\":\"\",\"LastResetPasswordTime\":0,\"LoginAllowed\":false,\"LoginLocked\":false,\"PasswordExpireAt\":0,\"PasswordResetRequired\":false,\"SafeAuthExemptDuration\":10,\"SafeAuthExemptRequired\":1,\"SafeAuthExemptUnit\":0,\"SafeAuthFlag\":false,\"SafeAuthType\":\"\",\"UpdateDate\":\"20250919T095404Z\"},\"MobilePhone\":\"\",\"MobilePhoneIsVerify\":false,\"Policies\":[{\"PolicyName\":\"IAMReadOnlyAccess\",\"PolicyType\":\"System\"}],\"SecurityConfig\":{\"SafeAuthClose\":0,\"SafeAuthExemptDuration\":10,\"SafeAuthType\":\"phone,email,vmfa\"},\"Tags\":[{\"Key\":\"usage\",\"Value\":\"ccapi\"}],\"Trn\":\"trn:iam::2000000191:user/user-cc\",\"UpdateDate\":\"20250919T061541Z\",\"UserId\":1819703,\"UserName\":\"user-cc\"}"
    }
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
QuotaLimitExceeded

an error occurred when calling %s operation: %s

400
ServiceNotEnabled

an error occurred when calling %s operation: %s

400
InvalidParameter

Params %s is invalid

参数无效

400
MissingParameter

an error occurred when calling %s operation: %s

400
InvalidRequest

an error occurred when calling %s operation: %s

401
InvalidCredentials

an error occurred when calling %s operation: %s

403
AccountInvalid

an error occurred when calling %s operation: %s

403
RequestForbidden

an error occurred when calling %s operation: %s

404
NotFound

an error occurred when calling %s operation: %s

404
EntityNotFound

taskID %s was not found

未查询到

409
ConcurrentModification

The resource has been updated by another process

409
NotStabilized

an error occurred when calling %s operation: %s

409
AlreadyExists

an error occurred when calling %s operation: %s

409
ResourceConflict

an error occurred when calling %s operation: %s

422
NotUpdatable

an error occurred when calling %s operation: %s

429
Throttling

an error occurred when calling %s operation: %s

500
InternalError

Some internal service error occurred, please wait and try again.

系统错误,请稍后重试

500
GeneralServiceException

an error occurred when calling %s operation: %s

500
InternalFailure

an error occurred when calling %s operation: %s

500
ServiceInternalError

an error occurred when calling %s operation: %s

500
ServiceLimitExceeded

an error occurred when calling %s operation: %s

500
NoResource

an error occurred when calling %s operation: %s

504
NetworkFailure

an error occurred when calling %s operation: %s