文档

ListAccessTokens - 查询激活码

更新时间:

调用ListAccessTokens查询已创建的激活码以及激活码的使用情况。

接口说明

查询已创建的激活码以及激活码的使用情况。 激活码的状态包括已激活、未激活和已过期三种。

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
smc:ListAccessTokensRead
  • 全部资源
    *

请求参数

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

激活码信息集合。

string

激活码信息集合。

at-bp1akz2zp67r0k6r****
Namestring

激活码名称。

test_name
Statusstring

激活码状态。取值范围:

  • activated:已激活。

  • unactivated:未激活。

  • expired:已过期。

activated

返回参数

名称类型描述示例值
object

响应参数。

RequestIdstring

请求 ID。

E2DA3097-79B9-53AE-B0DF-281DC54F****
AccessTokensobject []

迁移源数组信息。

AccessTokenIdstring

激活码 ID。

at-bp1akz2zp67r0k6r****
TimeToLiveInDaysstring

激活码的有效期。有效期为 1~90 天,默认为 30 天。

30
Countstring

激活码使用次数上限。取值范围为 1~1000。

默认值为 100。

100
RegisteredCountstring

已注册的迁移源数。

5
CreationTimestring

激活码创建时间。按照ISO 8601标准表示,并使用 UTC+0 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。

2022-09-09T02:35:44Z
Statusstring

激活码状态。可能值:

  • activated:已激活。

  • unactivated:未激活。

  • expired:已过期。

activated
Namestring

激活码名称。

test_name
Descriptionstring

激活码描述信息。

这是激活码
TotalCountinteger

迁移源总数。

2
PageSizeinteger

当前页码。

1
PageNumberinteger

每页行数。可能值:

  • 10
  • 20
  • 50

默认值:20。

20

示例

正常返回示例

JSON格式

{
  "RequestId": "E2DA3097-79B9-53AE-B0DF-281DC54F****",
  "AccessTokens": {
    "AccessToken": [
      {
        "AccessTokenId": "at-bp1akz2zp67r0k6r****",
        "TimeToLiveInDays": "30",
        "Count": "100",
        "RegisteredCount": "5",
        "CreationTime": "2022-09-09T02:35:44Z",
        "Status": "activated",
        "Name": "test_name",
        "Description": "这是激活码"
      }
    ]
  },
  "TotalCount": 2,
  "PageSize": 1,
  "PageNumber": 20
}

错误码

HTTP status code错误码错误信息描述
500InternalErrorAn error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket.内部错误,请重试。如果多次尝试失败,请提交工单。

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

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈