GetInstanceLicense - 查询实例的License信息

更新时间:
复制为 MD 格式

查询实例当前生效的 License 信息。

接口说明

请确保您当前的实例已经不再使用,当 EIAM 实例被删除后,所有相关的数据都将被删除。

调试

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

调试

授权信息

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

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

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

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

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

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

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

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

操作

访问级别

资源类型

条件关键字

关联操作

eiam:GetInstanceLicense

get

*Instance

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

请求参数

名称

类型

必填

描述

示例值

InstanceId

string

实例 Id

idaas_ue2jvisn35ea5lmthk2676xxxx

返回参数

名称

类型

描述

示例值

object

RequestId

string

请求 Id

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

License

object

返回结果。

LicenseId

string

License 的唯一标识

license_1234xxxx

LicenseStatus

string

License 的状态

枚举值:

  • valid :

    有效

  • expired :

    过期

  • released :

    释放

valid

LicenseChargeType

string

License 的付费类型

枚举值:

  • prepay :

    预付费

  • postpay :

    后付费

prepay

LicenseConfigJson

string

License 详细配置 JSON 字符串

{"modules":[{"features":[{"name":"urn:alibaba:idaas:license:module:ud:customField","status":"enabled"}]……{"name":"urn:alibaba:idaas:license:tag:enterprise","status":"enabled"}],"version":"1.0"}

LicenseCreateTime

integer

License 的创建时间,时间戳

1720509699000

PurchaseChannel

string

License 的购买渠道

枚举值:

  • alibaba_cloud :

    阿里云售卖渠道

  • system_free :

    系统免费渠道

  • system_trial :

    系统试用渠道

alibaba_cloud

PurchaseInstanceId

string

License 对应的外部商品唯一标识

eiam-cn-xxxxx

Edition

string

License 的版本型号

枚举值:

  • enterprise :

    企业版

  • free :

    免费版

  • trial :

    试用版

free

UserQuota

integer

License 的用户配额

100

StartTime

integer

License 的有效期开始日期,时间戳

1720509699000

EndTime

integer

License 的有效期终止日期,时间戳

1723996800000

InstanceLicenseDetail

object

实例 License 详细信息

UserQuota

integer

License 的用户配额

100

PrepaidActiveUserNumber

integer

M2mApplicationQuota

integer

License 的 M2M 应用配额

2

M2mApplicationLicenseStatus

string

M2M License 状态

枚举值:

  • disabled :

    禁用

  • enabled :

    启用

enabled

MimApplicationLicenseStatus

string

NetworkAccessEndpointQuota

integer

License 的网络访问端点配额

1

ConditionalAccessPolicyLicenseStatus

string

条件访问 License 状态

枚举值:

  • disabled :

    禁用

  • enabled :

    启用

enabled

示例

正常返回示例

JSON格式

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "License": {
    "LicenseId": "license_1234xxxx",
    "LicenseStatus": "valid",
    "LicenseChargeType": "prepay",
    "LicenseConfigJson": "{\"modules\":[{\"features\":[{\"name\":\"urn:alibaba:idaas:license:module:ud:customField\",\"status\":\"enabled\"}]……{\"name\":\"urn:alibaba:idaas:license:tag:enterprise\",\"status\":\"enabled\"}],\"version\":\"1.0\"}",
    "LicenseCreateTime": 1720509699000,
    "PurchaseChannel": "alibaba_cloud",
    "PurchaseInstanceId": "eiam-cn-xxxxx",
    "Edition": "free",
    "UserQuota": 100,
    "StartTime": 1720509699000,
    "EndTime": 1723996800000,
    "InstanceLicenseDetail": {
      "UserQuota": 100,
      "PrepaidActiveUserNumber": 0,
      "M2mApplicationQuota": 2,
      "M2mApplicationLicenseStatus": "enabled",
      "MimApplicationLicenseStatus": "",
      "NetworkAccessEndpointQuota": 1,
      "ConditionalAccessPolicyLicenseStatus": "enabled"
    }
  }
}

错误码

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

变更历史

更多信息,参考变更详情