すべてのプロダクト
Search
ドキュメントセンター

Identity as a Service:GetInstanceLicense

最終更新日:Sep 17, 2026

インスタンスの現在有効なライセンス情報を照会します。

操作説明

インスタンスが使用されていないことを確認してください。EIAM インスタンスを削除すると、関連するすべてのデータが削除されます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

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_1234xxxx

LicenseStatus

string

ライセンスのステータス。

列挙値:

  • valid :

    有効。

  • expired :

    期限切れ。

  • released :

    解放済み。

valid

LicenseChargeType

string

ライセンスの課金タイプ。

列挙値:

  • prepay :

    サブスクリプション。

  • postpay :

    従量課金。

prepay

LicenseConfigJson

string

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

ライセンスの作成時間。タイムスタンプフォーマット。

1720509699000

PurchaseChannel

string

ライセンスの購入チャンネル。

列挙値:

  • alibaba_cloud :

    Alibaba Cloud 販売チャンネル。

  • system_free :

    システム無料チャンネル。

  • system_trial :

    システムトライアルチャンネル。

alibaba_cloud

PurchaseInstanceId

string

ライセンスに関連付けられた外部商品の一意な識別子。

eiam-cn-xxxxx

Edition

string

ライセンスのエディション。

列挙値:

  • enterprise :

    エンタープライズエディション。

  • free :

    無料エディション。

  • trial :

    トライアルエディション。

free

UserQuota

integer

ライセンスのユーザークォータ。

100

StartTime

integer

ライセンスの有効期間の開始日。タイムスタンプフォーマット。

1720509699000

EndTime

integer

ライセンスの有効期間の終了日。タイムスタンプフォーマット。

1723996800000

InstanceLicenseDetail

object

インスタンスライセンスの詳細情報。

UserQuota

integer

ライセンスのユーザークォータ。

100

PrepaidActiveUserNumber

integer

前払いのアクティブなユーザー数。

100

M2mApplicationQuota

integer

ライセンスの M2M アプリケーションクォータ。

2

M2mApplicationLicenseStatus

string

M2M ライセンスのステータス。

列挙値:

  • disabled :

    無効。

  • enabled :

    有効。

enabled

MimApplicationLicenseStatus

string

マシン ID ライセンスのステータス。

enabled

PamLicenseStatus

string

PAM 特権アクセス管理ライセンスのステータス。

列挙値:

  • disabled :

    無効。

  • enabled :

    有効。

enabled

NetworkAccessEndpointQuota

integer

ライセンスのネットワークアクセスエンドポイントクォータ。

1

ConditionalAccessPolicyLicenseStatus

string

条件付きアクセスライセンスのステータス。

列挙値:

  • disabled :

    無効。

  • enabled :

    有効。

enabled

例

成功レスポンス

JSONJSON

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "License": {
    "LicenseId": "license_1234xxxx",
    "LicenseStatus": "有効",
    "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": 100,
      "M2mApplicationQuota": 2,
      "M2mApplicationLicenseStatus": "enabled",
      "MimApplicationLicenseStatus": "enabled",
      "PamLicenseStatus": "enabled",
      "NetworkAccessEndpointQuota": 1,
      "ConditionalAccessPolicyLicenseStatus": "enabled"
    }
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。