このページでは、ライセンスファイルのアップロード、ライセンスの割り当て、ライセンスおよびアカウントの使用情報の取得、ライセンスルールの作成、更新、削除など、ライセンスおよびアカウントに関連する機能の実行に使用できるライセンス API について説明します。

次のライセンス API は、ライセンスモデル別に分類されています。各モデル内のライセンスについては、「ライセンスの付与および制限事項」を参照してください。

インフラストラクチャベースのライセンスの API:

    ライセンス使用状況 API

    アプリケーション ID または名前、または ホスト ID によってライセンスの使用状況全体をプログラムで取得する RESTful API です。

    アプリケーション ID による使用状況の取得

    アプリケーションのライセンス使用状況の詳細(vCPU カウントなど)をアプリケーション ID で取得できます。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/application/by-id

    形式

    GET /controller/licensing/v1/account/{accountId}/grouped-usage/application/by-id

    パスパラメータ

    Parameter Name

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    あり

    クエリパラメータ

    パラメータ名

    Parameter Type

    必須

    appId

    配列

    アプリケーション ID のセット。

    対応

    includeAgentsブールフラグは、応答にエージェントのリストが必要かどうかを示します。なし

    応答形式

    response appObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数すべてのアプリケーションが実行されているホスト上の vCPU の総数。
    fallbackLicenseUnits
    オブジェクトパッケージ名ごとのアプリケーションで使用される(フォールバック)ライセンスユニットの総数。
    items
    オブジェクトアプリケーション別の使用状況の詳細。
    appItemObject

    パラメータ名

    Parameter Type

    appId
    整数

    アプリケーション ID。

    appName
    文字列

    アプリケーション名。

    vCpu
    整数(Integer)ホスト上の vCPU の数。
    nodes
    オブジェクト(nodeObjectアプリケーションが実行されているノード。
    containers
    オブジェクト(containerObjectアプリケーションが実行されているコンテナ。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    hosts
    オブジェクト(hostObject

    アプリケーションが実行されているホスト。このオブジェクトが自己参照される場合 null になります。

    nodeObject

    パラメータ名

    Parameter Type

    nodeName
    文字列

    ノード名。

    containerObject

    パラメータ名

    Parameter Type

    containerId
    文字列

    コンテナ ID。

    agentObject

    パラメータ名

    Parameter Type

    type
    文字列

    エージェントタイプ。

    version
    文字列

    エージェントバージョン。

    licenseKey
    文字列

    リースの取得に使用されるライセンスキー。

    hostObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数

    ホスト上の vCPU の総数。

    items
    オブジェクト

    ホスト別の使用状況の詳細。

    hostItemObject

    パラメータ名

    Parameter Type

    host
    文字列

    ホスト名。

    fallbackLicenseUnits
    オブジェクト

    パッケージ名ごとのアプリケーション/ホストで使用されるライセンスユニット。

    vCpu
    整数(Integer)ホスト上の vCPU の数。
    nodes
    オブジェクト(nodeObjectホスト上のノードの数。
    containers
    オブジェクト(containerObjectホスト上のコンテナの数。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    application
    オブジェクト(appItemObjectホストで実行されているアプリケーション。このオブジェクトが自己参照される場合 null になります。

    curl --user <user>@<AccountName>:<password> "http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/application/by-id?appId={appId1}&appId={appId2}"
    {
      "vCpuTotal": 4,
      "items": {
        "13": {
          "appId": 13,
          "appName": "ecommerce-demo",
          "vCpu": 4,
          "nodes": [
            {
              "nodeName": "ecommerce-demo-web-node-1"
            },
            {
              "nodeName": "ecommerce-demo-web-node-2"
            }
          ],
          "containers": [
            {
              "containerId": "ecommerce-demo-web-1"
            },
            {
              "containerId": "ecommerce-demo-web-2"
            }
          ],
          "agents": [
            {
              "type": "APP_AGENT",
              "version": "21.4.0",
              "licenseKey": "secret"
            }
          ],
          "hosts": {
            "vCpuTotal": 4,
            "items": {
              "ip-10-20-30-40": {
                "vCpu": 4,
                "host": "ip-10-20-30-40",
                "nodes": [
                  {
                    "nodeName": "ecommerce-demo-web-node-1"
                  },
                  {
                    "nodeName": "ecommerce-demo-web-node-2"
                  }
                ],
                "containers": [
                  {
                    "containerId": "ecommerce-demo-web-1"
                  },
                  {
                    "containerId": "ecommerce-demo-web-2"
                  }
                ],
                "agents": [
                  {
                    "type": "APP_AGENT",
                    "version": "21.4.0",
                    "licenseKey": "secret"
                  }
                ],
                "fallbackLicenseUnits": {}
              }
            }
          }
        }
      }
    }
    JSON

    アプリケーション名による取得

    アプリケーションのライセンス使用状況の詳細(vCPU カウントなど)をアプリケーション名で取得できます。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/application/by-name

    形式

    GET /controller/licensing/v1/account/{accountId}/grouped-usage/application/by-name

    パスパラメータ

    Parameter Name

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    あり

    クエリパラメータ

    パラメータ名

    Parameter Type

    必須

    appName

    配列

    (URL がエスケープされた)アプリケーション名のセット。

    対応

    includeAgentsブールフラグは、応答にエージェントのリストが必要かどうかを示します。なし

    応答形式

    response appObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数すべてのアプリケーションが実行されているホスト上の vCPU の総数。
    fallbackLicenseUnits
    オブジェクトパッケージ名ごとのアプリケーションで使用される(フォールバック)ライセンスユニットの総数。
    items
    オブジェクトアプリケーション別の使用状況の詳細。
    appItemObject

    パラメータ名

    Parameter Type

    appId
    整数

    アプリケーション ID。

    appName
    文字列

    アプリケーション名。

    vCpu
    整数(Integer)ホスト上の vCPU の数。
    nodes
    オブジェクト(nodeObjectアプリケーションが実行されているノード。
    containers
    オブジェクト(containerObjectアプリケーションが実行されているコンテナ。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    hosts
    オブジェクト(hostObject

    アプリケーションが実行されているホスト。このオブジェクトが自己参照される場合 null になります。

    nodeObject

    パラメータ名

    Parameter Type

    nodeName
    文字列

    ノード名。

    containerObject

    パラメータ名

    Parameter Type

    containerId
    文字列

    コンテナ ID。

    agentObject

    パラメータ名

    Parameter Type

    type
    文字列

    エージェントタイプ。

    version
    文字列

    エージェントバージョン。

    licenseKey
    文字列

    リースの取得に使用されるライセンスキー。

    hostObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数

    ホスト上の vCPU の総数。

    items
    オブジェクト

    ホスト別の使用状況の詳細。

    hostItemObject

    パラメータ名

    Parameter Type

    host
    文字列

    ホスト名。

    fallbackLicenseUnits
    オブジェクト

    パッケージ名ごとのアプリケーション/ホストで使用されるライセンスユニット。

    vCpu
    整数(Integer)ホスト上の vCPU ノードの数。
    nodes
    オブジェクト(nodeObjectアプリケーションが実行されているノード。
    containers
    オブジェクト(containerObjectアプリケーションが実行されているコンテナ。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    application
    オブジェクト(appItemObjectホストで実行されているアプリケーション。このオブジェクトが自己参照される場合 null になります。

    curl --user <user>@<AccountName>:<password> "http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/application/by-name?appName={appName1}&appName={appName2}"
    {
      "vCpuTotal": 4,
      "items": {
        "13": {
          "appId": 13,
          "appName": "ecommerce-demo",
          "vCpu": 4,
          "nodes": [
            {
              "nodeName": "ecommerce-demo-web-node-1"
            },
            {
              "nodeName": "ecommerce-demo-web-node-2"
            }
          ],
          "containers": [
            {
              "containerId": "ecommerce-demo-web-1"
            },
            {
              "containerId": "ecommerce-demo-web-2"
            }
          ],
          "agents": [
            {
              "type": "APP_AGENT",
              "version": "21.4.0",
              "licenseKey": "secret"
            }
          ],
          "hosts": {
            "vCpuTotal": 4,
            "items": {
              "ip-10-20-30-40": {
                "vCpu": 4,
                "host": "ip-10-20-30-40",
                "nodes": [
                  {
                    "nodeName": "ecommerce-demo-web-node-1"
                  },
                  {
                    "nodeName": "ecommerce-demo-web-node-2"
                  }
                ],
                "containers": [
                  {
                    "containerId": "ecommerce-demo-web-1"
                  },
                  {
                    "containerId": "ecommerce-demo-web-2"
                  }
                ],
                "agents": [
                  {
                    "type": "APP_AGENT",
                    "version": "21.4.0",
                    "licenseKey": "secret"
                  }
                ],
                "fallbackLicenseUnits": {}
              }
            }
          }
        }
      }
    }
    JSON

    ホスト ID による使用状況の取得

    アプリケーションのライセンス使用状況の情報(vCPU カウントなど)をホスト ID で取得できます。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/host

    形式

    GET /controller/licensing/v1/account/{accountId}/grouped-usage/host

    パスパラメータ

    Parameter Name

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    あり

    クエリパラメータ

    パラメータ名

    Parameter Type

    必須

    hostId

    配列

    (URL がエスケープされた)ホスト ID のセット。

    対応

    includeAgentsブールフラグは、応答にエージェントのリストが必要かどうかを示します。なし


    応答の形式

    response hostObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数

    ホスト上の vCPU の総数。

    items
    オブジェクト

    ホスト別の使用状況の詳細。

    hostItemObject

    パラメータ名

    Parameter Type

    host
    文字列

    ホスト名。

    fallbackLicenseUnits
    オブジェクト

    パッケージ名ごとのアプリケーション/ホストで使用されるライセンスユニット。

    vCpu
    整数(Integer)ホスト上の vCPU の数。
    nodes
    オブジェクト(nodeObjectホスト上のノードの数。
    containers
    オブジェクト(containerObjectホスト上のコンテナの数。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    application
    オブジェクト(appItemObjectホストで実行されているアプリケーション。このオブジェクトが自己参照される場合 null になります。
    nodeObject

    パラメータ名

    Parameter Type

    nodeName
    文字列

    ノード名。

    containerObject

    パラメータ名

    Parameter Type

    containerId
    文字列

    コンテナ ID。

    agentObject

    パラメータ名

    Parameter Type

    type
    文字列

    エージェントタイプ。

    version
    文字列

    エージェントバージョン。

    licenseKey
    文字列

    リースの取得に使用されるライセンスキー。

    appObject

    パラメータ名

    Parameter Type

    vCpuTotal
    整数すべてのアプリケーションが実行されているホスト上の vCPU の総数。
    fallbackLicenseUnits
    オブジェクトパッケージ名ごとのアプリケーションで使用される(フォールバック)ライセンスユニットの総数。
    items
    オブジェクトアプリケーション別の使用状況の詳細。
    appItemObject

    パラメータ名

    Parameter Type

    appId
    整数

    アプリケーション ID。

    appName
    文字列

    アプリケーション名。

    vCpu
    整数(Integer)ホスト上の vCPU の数。
    nodes
    オブジェクト(nodeObjectアプリケーションが実行されているノード。
    containers
    オブジェクト(containerObjectアプリケーションが実行されているコンテナ。
    agents
    オブジェクト(agentObject(オプション)すべてのエージェントに関連付けられたライセンスキー。
    hosts
    オブジェクト(hostObject

    アプリケーションが実行されているホスト。このオブジェクトが自己参照される場合 null になります。

    curl --user <user>@<AccountName>:<password> "http://<host>:<port>/controller/licensing/v1/account/{accountId}/grouped-usage/host?hostId={hostId1}&hostId={hostId2}"
    {
      "vCpuTotal": 4,
      "hosts": {
        "vCpuTotal": 4,
        "items": {
          "ip-10-20-30-40": {
            "vCpu": 4,
            "host": "ip-10-20-30-40",
            "nodes": [
              {
                "nodeName": "ecommerce-demo-web-node-1"
              },
              {
                "nodeName": "ecommerce-demo-web-node-2"
              }
            ],
            "containers": [
              {
                "containerId": "ecommerce-demo-web-1"
              },
              {
                "containerId": "ecommerce-demo-web-2"
              }
            ],
            "agents": [
              {
                "type": "APP_AGENT",
                "version": "21.4.0",
                "licenseKey": "secret"
              }
            ],
            "fallbackLicenseUnits": {},
            "applications": {
              "vCpuTotal": 4,
              "items": {
                "13": {
                  "appId": 13,
                  "appName": "ecommerce-demo",
                  "vCpu": 4,
                  "nodes": [
                    {
                      "nodeName": "ecommerce-demo-web-node-1"
                    },
                    {
                      "nodeName": "ecommerce-demo-web-node-2"
                    }
                  ],
                  "containers": [
                    {
                      "containerId": "ecommerce-demo-web-1"
                    },
                    {
                      "containerId": "ecommerce-demo-web-2"
                    }
                  ],
                  "agents": [
                    {
                      "type": "APP_AGENT",
                      "version": "21.4.0",
                      "licenseKey": "secret"
                    }
                  ]
                }
              }
            }
          }
        }
      }
    }
    JSON


    アカウント使用状況 API

    ライセンスとアカウントの ID によってアカウントの使用状況をプログラムで取得するための RESTful API です。

    ライセンス ID によるアカウント使用状況の取得

    指定されたライセンス ID によって参照されるアカウント使用状況を取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/usage/license/{licenseId}

    形式

    GET /controller/licensing/v1/usage/license/{licenseId} 


    パスパラメータ

    パラメータ名

    Parameter Type

    必須

    licenseId

    文字列

    使用状況の取得が要求されるライセンス ID。

    対応

    クエリパラメータ

    パラメータ名

    Parameter Type

    必須

    dateFrom

    文字列

    要求されたライセンス使用期間の開始日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Z

    はい

    dateTo

    文字列

    要求されたライセンス使用期間の終了日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Z

    はい

    granularityMinutes

    整数型(Integer)

    要求されたライセンス使用状況データの粒度。

    対応

    includeEntityTypes

    ブール

    ライセンスされたエンティティタイプの使用状況を含めるかどうかを指定します。デフォルトは false.

    なし

    includeConsumptionBased

    ブール

    消費ベースの使用状況を含めるかどうか。デフォルト値: false.

    なし

    応答形式

    response オブジェクト

    パラメータ名

    Parameter Type

    accountId

    整数

    アカウント ID。

    licenseRule

    オブジェクト

    アカウントまたは割り当てのライセンス使用状況を表すエンティティ。

    packages

    package オブジェクトの配列


    licenseRule オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割当 ID。

    name

    文字列

    割り当て名。

    licenseKey

    文字列

    この特定の割り当てのライセンスキー。


    package オブジェクト
    パラメータ名Parameter Type
    packageName文字列

    次のパッケージ(エディション)インスタンスの名前を表す列挙型:

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    type文字列

    次のパッケージインスタンスのタイプを表す列挙型:

    • "PAID"
    • "TRIAL" 
    • "LITE"
    kind文字列

    パッケージの作成元のライセンスモデルから派生したパッケージの種類。レガシーエージェントベースのライセンスモジュール(APM、DOTNET など)に基づくパッケージを、新しいインフラストラクチャベースのパッケージと迅速に区別するのに役立ちます。

    列挙型: "AGENT_BASED" "INFRASTRUCTURE_BASED"

    family文字列パッケージファミリ。
    createdDate文字列ライセンス内のパッケージインスタンスの作成日。ISO 8601 日時文字列。
    startDate文字列パッケージインスタンスの開始日。例:パッケージインスタンスがアクティブになる日付:ISO 8601 日時文字列。
    expirationDate文字列パッケージインスタンスの期限日、つまりパッケージインスタンスがアクティブでなくなる日付。ISO 8601 日時文字列。
    licenseUnits文字列パッケージインスタンスで使用可能なライセンスの数。
    propertiesオブジェクトキーと値のペア形式でのパッケージ固有のカスタムプロパティのコレクション。グローバルプロパティとマージする場合は、競合するパッケージ固有のプロパティが優先されます。


    curl --user <user>@<AccountName>:<password> -X GET \
      http://<host>:<port>/controller/licensing/v1/usage/license/{licenseId}?dateFrom=<ISO 8601 date-time string>&dateTo=<ISO 8601 date-time string>&granularityMinutes=<number of minutes as an integer>
    {
        "accountId":0,
        "licenseRule":{
            "id":"string",
            "name":"string",
            "licenseKey":"string"
        },
        "packages":[
            {
                "name":"string",
                "unitUsages":[
                    {
                        "usageType":"string",
                        "granularityInMinutes":0,
                        "data":{
                            "timestamp":"string",
                            "provisioned":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "used":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "registrations":[
                                {
                                    "type":"string",
                                    "registered":{
                                        "min":0,
                                        "max":0,
                                        "avg":0,
                                        "count":0
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    }
    JSON

    アカウント ID によるアカウント使用状況の取得

    指定のアカウント ID で参照するアカウント使用状況を取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/usage/account/{accountId}

    形式

    GET /controller/licensing/v1/usage/account/{accountId}

    Path Parameters

    Parameter NameParameter Type必須
    accountId整数

    使用状況の取得が要求されるアカウント ID。

    対応

    クエリパラメータ

    Parameter NameParameter Type必須
    dateFrom文字列

    要求されたライセンス使用期間の開始日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Z

    はい
    dateTo文字列要求されたライセンス使用期間の終了日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Zはい
    granularityMinutes整数型(Integer)要求されたライセンス使用状況データの粒度。対応
    includeEntityTypesブールライセンスされたエンティティタイプの使用状況を含めるかどうかを指定します。デフォルトは false.なし
    includeConsumptionBasedブール消費ベースの使用状況を含めるかどうか。デフォルト値: false.なし


    応答形式

    response オブジェクト

    Parameter Name

    Parameter Type

    accountId

    整数

    アカウント ID。

    licenseRule

    オブジェクト

    アカウントまたは割り当てのライセンス使用状況を表すエンティティ。

    packages

    配列

    パッケージオブジェクト
    licenseRule オブジェクト

    Parameter Name

    Parameter Type

    id

    文字列

    割当 ID。

    name

    文字列

    割り当て名。

    licenseKey

    文字列

    この特定の割り当てのライセンスキー。


    package オブジェクト
    Parameter NameParameter Type
    packageName文字列

    次のパッケージ(エディション)インスタンスの名前を表す列挙型:

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    type文字列

    次のパッケージインスタンスのタイプを表す列挙型:

    • "PAID"
    • "TRIAL" 
    • "LITE"
    kind文字列

    パッケージの作成元のライセンスモデルから派生したパッケージの種類。レガシーエージェントベースのライセンスモジュール(APM、DOTNET など)に基づくパッケージを、新しいインフラストラクチャベースのパッケージと迅速に区別するのに役立ちます。

    列挙型: "AGENT_BASED" "INFRASTRUCTURE_BASED"

    family文字列パッケージファミリ。
    createdDate文字列ライセンス内のパッケージインスタンスの作成日。ISO 8601 日時文字列。
    startDate文字列パッケージインスタンスの開始日。例:パッケージインスタンスがアクティブになる日付:ISO 8601 日時文字列。
    expirationDate文字列パッケージインスタンスの期限日、つまりパッケージインスタンスがアクティブでなくなる日付。ISO 8601 日時文字列。
    licenseUnits文字列パッケージインスタンスで使用可能なライセンスの数。
    propertiesオブジェクトキーと値のペア形式でのパッケージ固有のカスタムプロパティのコレクション。グローバルプロパティとマージする場合は、競合するパッケージ固有のプロパティが優先されます。

    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/usage/account/{accountId}?dateFrom=<ISO 8601 date-time string>&dateTo=<ISO 8601 date-time string>&granularityMinutes=<number of minutes as an integer>
     
    {
        "accountId":0,
        "licenseRule":{
            "id":"string",
            "name":"string",
            "licenseKey":"string"
        },
        "packages":[
            {
                "name":"string",
                "unitUsages":[
                    {
                        "usageType":"string",
                        "granularityInMinutes":0,
                        "data":{
                            "timestamp":"string",
                            "provisioned":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "used":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "registrations":[
                                {
                                    "type":"string",
                                    "registered":{
                                        "min":0,
                                        "max":0,
                                        "avg":0,
                                        "count":0
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    }
    JSON

    ライセンス割り当て API

    次の方法では、アカウントのライセンス割り当て(ライセンスルール)を取得、作成、フィルタリング、および削除できます。

    すべてのライセンス割り当ての取得

    すべてのライセンス割り当てを取得し、オプションのクエリパラメータを使用して割り当てのリストを絞り込みます。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation

    形式

    GET /controller/licensing/v1/account/{accountId}/allocation

    パスパラメータ

    Parameter NameParameter Type必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    あり

    クエリパラメータ

    パラメータ名

    Parameter Type

    必須

    name

    文字列

    割り当ての名前。license-keytag を組み合わせて使用することはできません。

    いいえ

    license-key

    文字列

    割り当てのライセンスキー。nametag を組み合わせて使用することはできません。

    いいえ

    tag

    文字列

    割り当てに関連付けられたタグ。namelicense-key を組み合わせて使用することはできません。

    なし

    応答形式

    response オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割当 ID。アカウントごとに一意です。

    accountId

    整数

    割り当てが属するアカウント ID。

    name

    文字列

    割り当ての名前。アカウントごとに一意です。

    licenseKey

    文字列

    割り当てで使用するライセンスキー。アカウントごとに一意です。

    filters

    オブジェクトの配列

    filter オブジェクトの配列

    limits

    オブジェクトの配列

    limit オブジェクトの配列

    tags

    文字列の配列

    割り当てに関連付けられたタグ。

    createdDate

    文字列

    割り当ての作成日:ISO 8601 日時文字列。

    lastUpdatedDate

    文字列

    割り当ての最終更新日:ISO 8601 日時文字列。

    filter オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当ての名前。アカウントごとに一意です。

    type

    文字列

    フィルタを適用するエンティティのタイプ。

    列挙型:"APPLICATION" "HOST"

    operator

    文字列

    typevalue: と照合する際に使用する次の列挙型の演算子

    • ID_EQUALS:エンティティ ID の完全一致

    • EQUALS:エンティティ値の完全一致

    • STARTS_WITH:値で始まるエンティティの一致

    • ENDS_WITH:値で終わるエンティティの一致

    • CONTAINS:値を含むエンティティの一致

    • REGEX:正規表現でのエンティティの一致

    value

    文字列

    フィルタ対象の値。

    limit オブジェクト

    パラメータ名

    Parameter Type

    id文字列割り当てパッケージ制限 ID。
    package
    文字列

    制限のパッケージのタイプ。

    サポートされている列挙型は次のとおりです。

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    units整数

    割り当て制限ごとのライセンスユニットの数。

    tags
    Array of Strings割り当てに関連付けられたタグ。

    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation
    [
        {
            "id":"string",
            "accountId":0,
            "name":"string",
            "licenseKey":"string",
            "filters":[
                {
                    "id":"string",
                    "type":"APPLICATION",
                    "operator":"ID_EQUALS",
                    "value":"string"
                }
            ],
            "limits":[
                {
                    "id":"string",
                    "package":"INFRA",
                    "units":0
                }
            ],
            "tags":[
                "string"
            ],
            "createdDate":"string",
            "lastUpdatedDate":"string"
        }
    ]
    JSON

    アカウント ID による割り当て使用状況の取得

    指定のライセンスキー ID で参照する割り当てルール使用状況を取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/usage/account/{accountId}/allocation/{licenseKey}

    形式

    GET /controller/licensing/v1/usage/account/{accountId}/allocation/{licenseKey}

    Path Parameters

    Parameter Name

    Parameter Type

    必須

    accountId整数

    使用状況の取得が要求されるアカウント ID。

    はい
    licenseKey文字列割り当てルールに基づいたライセンスキーが選択されます。返される使用状況は、その特定の割り当てルールに関連します。対応

    クエリパラメータ

    Parameter Name

    Parameter Type

    必須

    dateFrom

    文字列

    要求されたライセンス使用期間の開始日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Z

    はい

    dateTo

    文字列要求されたライセンス使用期間の終了日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Zはい

    granularityMinutes

    整数型(Integer)要求されたライセンス使用状況データの粒度。対応

    includeEntityTypes

    ブールライセンスされたエンティティタイプの使用状況を含めるかどうかを指定します。デフォルトは false. です。なし

    応答形式

    response オブジェクト

    Parameter Name

    Parameter Type

    accountId

    整数

    アカウント ID。

    licenseRule

    オブジェクト

    アカウントまたは割り当てのライセンス使用状況を表すエンティティ。

    packages

    配列

    パッケージオブジェクト。
    licenseRule オブジェクト

    Parameter Name

    Parameter Type

    id

    文字列

    割当 ID。

    name

    文字列

    割り当て名。

    licenseKey

    文字列

    この特定の割り当てのライセンスキー。


    package オブジェクト

    Parameter Name

    Parameter Type

    Parameter Name

    Parameter Type

    packageName文字列

    次のパッケージ(エディション)インスタンスの名前を表す列挙型:

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    type文字列

    次のパッケージインスタンスのタイプを表す列挙型:

    • "PAID"
    • "TRIAL" 
    • "LITE"
    kind文字列

    パッケージの作成元のライセンスモデルから派生したパッケージの種類。レガシーエージェントベースのライセンスモジュール(APM、DOTNET など)に基づくパッケージを、新しいインフラストラクチャベースのパッケージと迅速に区別するのに役立ちます。

    列挙型: "AGENT_BASED" "INFRASTRUCTURE_BASED"

    family文字列パッケージファミリ。
    createdDate文字列ライセンス内のパッケージインスタンスの作成日。ISO 8601 日時文字列。
    startDate文字列パッケージインスタンスの開始日。例:パッケージインスタンスがアクティブになる日付:ISO 8601 日時文字列。
    expirationDate文字列パッケージインスタンスの期限日、つまりパッケージインスタンスがアクティブでなくなる日付。ISO 8601 日時文字列。
    licenseUnits文字列パッケージインスタンスで使用可能なライセンスの数。
    propertiesオブジェクトキーと値のペア形式でのパッケージ固有のカスタムプロパティのコレクション。グローバルプロパティとマージする場合は、競合するパッケージ固有のプロパティが優先されます。

    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/usage/account/{accountId}/allocation/{licenseKey}?dateFrom=<ISO 8601 date-time string>&dateTo=<ISO 8601 date-time string>&granularityMinutes=<number of minutes as an integer>
     
    {
        "accountId":0,
        "licenseRule":{
            "id":"string",
            "name":"string",
            "licenseKey":"string"
        },
        "packages":[
            {
                "name":"string",
                "unitUsages":[
                    {
                        "usageType":"string",
                        "granularityInMinutes":0,
                        "data":{
                            "timestamp":"string",
                            "provisioned":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "used":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "registrations":[
                                {
                                    "type":"string",
                                    "registered":{
                                        "min":0,
                                        "max":0,
                                        "avg":0,
                                        "count":0
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    }
    JSON

    ライセンスキーによる割り当て使用状況の取得

    指定のライセンスキーで参照する割り当て使用状況を取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/usage/license/{licenseId}/allocation/{licenseKey}

    形式

    GET /controller/licensing/v1/usage/license/{licenseId}/allocation/{licenseKey}

    Path Parameters

    Parameter Name

    Parameter Type

    必須

    licenseId
    文字列

    使用状況の取得が要求されるライセンス ID。

    はい
    licenseKey文字列割り当てルールに基づいたライセンスキーが選択されます。返される使用状況は、その特定の割り当てルールに関連します。対応

    クエリパラメータ

    Parameter Name

    Parameter Type

    必須

    dateFrom

    文字列

    要求されたライセンス使用期間の開始日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Z

    はい

    dateTo

    文字列要求されたライセンス使用期間の終了日。対応する形式は ISO-8601(拡張)です。例:2020-10-05T10:00:00Zはい

    granularityMinutes

    整数型(Integer)要求されたライセンス使用状況データの粒度。対応

    includeEntityTypes

    ブールライセンスされたエンティティタイプの使用状況を含めるかどうかを指定します。デフォルトは false. です。なし

    応答形式

    response オブジェクト

    Parameter Name

    Parameter Type

    accountId

    整数

    アカウント ID。

    licenseRule

    オブジェクト

    アカウントまたは割り当てのライセンス使用状況を表すエンティティ。

    packages

    パッケージオブジェクトの配列

    パッケージオブジェクト。
    licenseRule オブジェクト

    Parameter Name

    Parameter Type

    id文字列割当 ID。
    name文字列割り当て名。
    licenseKey文字列この特定の割り当てのライセンスキー。


    package オブジェクト

    Parameter Name

    Parameter Type

    Parameter Name

    Parameter Type

    packageName文字列

    次のパッケージ(エディション)インスタンスの名前を表す列挙型:

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    type文字列

    次のパッケージインスタンスのタイプを表す列挙型:

    • "PAID"
    • "TRIAL" 
    • "LITE"
    kind文字列

    パッケージの作成元のライセンスモデルから派生したパッケージの種類。レガシーエージェントベースのライセンスモジュール(APM、DOTNET など)に基づくパッケージを、新しいインフラストラクチャベースのパッケージと迅速に区別するのに役立ちます。

    列挙型: "AGENT_BASED" "INFRASTRUCTURE_BASED"

    family文字列パッケージファミリ。
    createdDate文字列ライセンス内のパッケージインスタンスの作成日。ISO 8601 日時文字列。
    startDate文字列パッケージインスタンスの開始日。例:パッケージインスタンスがアクティブになる日付:ISO 8601 日時文字列。
    expirationDate文字列パッケージインスタンスの期限日、つまりパッケージインスタンスがアクティブでなくなる日付。ISO 8601 日時文字列。
    licenseUnits文字列パッケージインスタンスで使用可能なライセンスの数。
    propertiesオブジェクトキーと値のペア形式でのパッケージ固有のカスタムプロパティのコレクション。グローバルプロパティとマージする場合は、競合するパッケージ固有のプロパティが優先されます。

    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/usage/license/{licenseId}/allocation/{licenseKey}?dateFrom=<ISO 8601 date-time string>&dateTo=<ISO 8601 date-time string>&granularityMinutes=<number of minutes as an integer>
     
    {
        "accountId":0,
        "licenseRule":{
            "id":"string",
            "name":"string",
            "licenseKey":"string"
        },
        "packages":[
            {
                "name":"string",
                "unitUsages":[
                    {
                        "usageType":"string",
                        "granularityInMinutes":0,
                        "data":{
                            "timestamp":"string",
                            "provisioned":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "used":{
                                "min":0,
                                "max":0,
                                "avg":0,
                                "count":0
                            },
                            "registrations":[
                                {
                                    "type":"string",
                                    "registered":{
                                        "min":0,
                                        "max":0,
                                        "avg":0,
                                        "count":0
                                    }
                                }
                            ]
                        }
                    }
                ]
            }
        ]
    }
    JSON

    ライセンス割り当ての作成

    ライセンス割り当てを作成します。この方法では、次のことを確認します。

    • サブエンティティ(フィルタ、制限)の ID はフィルタリングされない
    • 他の一意のパラメータ(namelicenseKey など)が既存の割り当てと競合しない

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation

    形式

    POST /controller/licensing/v1/account/{accountId}/allocation

    Path Parameters

    Parameter NameParameter Type必須
    accountId整数割り当ての取得が要求されるアカウント ID。あり

    要求の形式

    request オブジェクト

    パラメータ名

    Parameter Type

    name

    文字列

    割り当ての名前。アカウントごとに一意です。

    filters

    オブジェクトの配列

    filter オブジェクトの配列

    limits

    オブジェクトの配列

    limit オブジェクトの配列

    Filter オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当ての名前。アカウントごとに一意です。

    type

    文字列

    フィルタを適用するエンティティのタイプ。

    列挙型:"APPLICATION" "HOST"

    operator

    文字列

    typevalue: と照合する際に使用する次の列挙型の演算子

    • ID_EQUALS :エンティティ ID の完全一致

    • EQUALS :エンティティ値の完全一致

    • STARTS_WITH :値で始まるエンティティの一致

    • ENDS_WITH :値で終わるエンティティの一致

    • CONTAINS :値を含むエンティティの一致

    • REGEX :正規表現でのエンティティの一致

    value

    文字列

    フィルタ対象の値。

    limit オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当てパッケージ制限 ID。

    package

    文字列

    制限のパッケージのタイプ。

    サポートされている列挙型は次のとおりです。

    • "INFRA" 

    • "PREMIUM" 

    • "ENTERPRISE"

    units

    整数

    割り当て制限ごとのライセンスユニットの数。

    tags

    Array of Strings

    割り当てに関連付けられたタグ。


    応答形式

    response オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割当 ID。アカウントごとに一意です。

    accountId

    整数

    割り当てが属するアカウント ID。

    name

    文字列

    割り当ての名前。アカウントごとに一意です。

    licenseKey

    文字列

    割り当てで使用するライセンスキー。アカウントごとに一意です。

    フィルタ

    オブジェクトの配列

    filter オブジェクトの配列

    limits

    オブジェクトの配列

    limit オブジェクトの配列

    tags

    文字列の配列

    割り当てに関連付けられたタグ。

    createdDate

    文字列

    割り当ての作成日:ISO 8601 日時文字列。

    lastUpdatedDate

    文字列

    割り当ての最終更新日:ISO 8601 日時文字列。

    filter オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当ての名前。アカウントごとに一意です。

    type

    文字列

    フィルタを適用するエンティティのタイプ。

    列挙型:"APPLICATION" "HOST"

    operator

    文字列

    typevalue: と照合する際に使用する次の列挙型の演算子

    • ID_EQUALS :エンティティ ID の完全一致

    • EQUALS :エンティティ値の完全一致

    • STARTS_WITH :値で始まるエンティティの一致

    • ENDS_WITH :値で終わるエンティティの一致

    • CONTAINS :値を含むエンティティの一致

    • REGEX :正規表現でのエンティティの一致

    value

    文字列

    フィルタ対象の値。

    limit オブジェクト
    パラメータ名Parameter Type
    id文字列割り当てパッケージ制限 ID。
    package
    文字列

    制限のパッケージのタイプ。

    サポートされている列挙型は次のとおりです。

    • "INFRA" 
    • "PREMIUM" 
    • "ENTERPRISE"
    units整数

    割り当て制限ごとのライセンスユニットの数。

    tags
    Array of Strings割り当てに関連付けられたタグ。

    curl --user <user>@<AccountName>:<password> -X POST \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation \
    -H 'Content-Type: application/json' \
    -d '{
            "name": "string", 
            "filters": [
                {
                    "id": "string",
                     "type": "APPLICATION",
                     "operator": "ID_EQUALS",
                     "value": "string"
                }
            ],
            "limits": [
                {
                    "id": "string",
                    "package": "INFRA",
                    "units": 0
                }
            ],
            "tags": ["string"]
        }'



    [
        {
            "id": "string",        
            "accountId": integer,   
            "name": "string",       
            "licenseKey": "string", 
            "filters": [
                {
                    "id": "string",
                     "type": "APPLICATION",
                     "operator": "ID_EQUALS",
                     "value": "string"
                }
            ],
            "limits": [
                {
                    "id": "string",
                    "package": "INFRA",
                    "units": 0
                }
            ],
            "tags": ["string"],
            "createdDate": "ISO 8601 date-time",
            "lastUpdatedDate": "ISO 8601 date-time"
        },
        ...
    ]
    JSON

    ライセンス割り当ての取得

    割り当て ID によってライセンス割り当てを取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    形式

    GET /controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    Path Parameters

    パラメータ名

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    はい

    allocationId

    文字列

    取得する割り当てを参照する割り当て ID。

    あり

    応答形式

    response オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割当 ID。アカウントごとに一意です。

    accountId

    整数

    割り当てが属するアカウント ID。

    name

    文字列

    割り当ての名前。アカウントごとに一意です。

    licenseKey

    文字列

    割り当てで使用するライセンスキー。アカウントごとに一意です。

    filters

    オブジェクトの配列

    filter オブジェクトの配列

    limits

    オブジェクトの配列

    limit オブジェクトの配列

    tags

    文字列の配列

    割り当てに関連付けられたタグ。

    createdDate

    文字列

    割り当ての作成日:ISO 8601 日時文字列。

    lastUpdatedDate

    文字列

    割り当ての最終更新日:ISO 8601 日時文字列。

    filter オブジェクト
    パラメータ名Parameter Type
    id文字列割り当ての名前。アカウントごとに一意です。
    type文字列

    フィルタを適用するエンティティのタイプ。

    列挙型:"APPLICATION" "HOST"
    operator文字列

    typevalue: と照合する際に使用する次の列挙型の演算子

    • ID_EQUALS :エンティティ ID の完全一致
    • EQUALS :エンティティ値の完全一致
    • STARTS_WITH :値で始まるエンティティの一致
    • ENDS_WITH :値で終わるエンティティの一致
    • CONTAINS :値を含むエンティティの一致
    • REGEX :正規表現でのエンティティの一致
    value文字列フィルタ対象の値。
    limit オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当てパッケージ制限 ID。

    package

    文字列

    制限のパッケージのタイプ。

    サポートされている列挙型は次のとおりです。

    • "INFRA" 

    • "PREMIUM" 

    • "ENTERPRISE"

    units

    整数

    割り当て制限ごとのライセンスユニットの数。

    tags

    Array of Strings

    割り当てに関連付けられたタグ。

    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation/{allocationId} 
    [
        {
            "id": "string",        
            "accountId": integer,   
            "name": "string",       
            "licenseKey": "string", 
            "filters": [
                {
                    "id": "string",
                     "type": "APPLICATION",
                     "operator": "ID_EQUALS",
                     "value": "string"
                }
            ],
            "limits": [
                {
                    "id": "string",
                    "package": "INFRA",
                    "units": 0
                }
            ],
            "tags": ["string"],
            "createdDate": "ISO 8601 date-time",
            "lastUpdatedDate": "ISO 8601 date-time"
        },
        ...
    ]
    JSON

    ライセンス割り当ての更新

    割り当て ID によってライセンス割り当てを更新します。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    形式

    PUT /controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    Path Parameters

    パラメータ名

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    はい

    allocationId

    文字列

    取得する割り当てを参照する割り当て ID。

    あり

    要求の形式

    request オブジェクト

    パラメータ名

    Parameter Type

    必須

    name

    文字列

    割り当ての名前。アカウントごとに一意です。

    はい

    filters

    文字列

    取得する割り当てを参照する割り当て ID。

    いいえ

    limits

    オブジェクト
    いいえ

    tags

    Array of Strings
    いいえ
    filter オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当ての名前。アカウントごとに一意です。

    type

    文字列

    フィルタを適用するエンティティのタイプ。

    列挙型:"APPLICATION" "HOST"

    operator

    文字列

    typevalue: と照合する際に使用する次の列挙型の演算子

    • ID_EQUALS :エンティティ ID の完全一致

    • EQUALS :エンティティ値の完全一致

    • STARTS_WITH :値で始まるエンティティの一致

    • ENDS_WITH :値で終わるエンティティの一致

    • CONTAINS :値を含むエンティティの一致

    • REGEX :正規表現でのエンティティの一致

    value

    文字列

    フィルタ対象の値。

    limit オブジェクト

    パラメータ名

    Parameter Type

    id

    文字列

    割り当てパッケージ制限 ID。

    package

    文字列

    制限のパッケージのタイプ。

    サポートされている列挙型は次のとおりです。

    • "INFRA" 

    • "PREMIUM" 

    • "ENTERPRISE"

    units

    整数

    割り当て制限ごとのライセンスユニットの数。

    tags

    Array of Strings

    割り当てに関連付けられたタグ。


    curl --user <user>@<AccountName>:<password> -X PUT \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation \
    -H 'Content-Type: application/json' \
    -d '{
            "name": "string",
            "filters": [
                {
                    "id": "string",
                    "type": "APPLICATION",
                    "operator": "ID_EQUALS",
                    "value": "string"
                 }
            ],
            "limits": [
                {
                    "id": "string",
                    "package": "INFRA",
                    "units": 0
                }
            ],
            "tags": [
                "string"
            ]
        }'
    {
        "id":"string",
        "accountId":0,
        "name":"string",
        "licenseKey":"string",
        "filters":[
            {
                "id":"string",
                "type":"APPLICATION",
                "operator":"ID_EQUALS",
                "value":"string"
            }
        ],
        "limits":[
            {
                "id":"string",
                "package":"INFRA",
                "units":0
            }
        ],
        "tags":[
            "string"
        ],
        "createdDate":"string",
        "lastUpdatedDate":"string"
    }
    JSON

    ライセンスルール割り当ての削除

    割り当て ID によってライセンス割り当てを削除します。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    形式

    DELETE /controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    Path Parameters

    パラメータ名

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    はい

    allocationId

    文字列

    取得する割り当てを参照する割り当て ID。

    あり


    curl --user <user>@<AccountName>:<password> -X DELETE \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/allocation/{allocationId}

    ライセンス情報 API

    アカウントのライセンス情報(ライセンスタイプ、パッケージ、期限日など)をプログラムで取得するための RESTful API です。

    アカウントライセンス情報の取得

    アカウントのライセンス情報を取得します。

    URL

    http://<host>:<port>/controller/licensing/v1/account/{accountId}/info

    形式

    GET /controller/licensing/v1/account/{accountId}/info

    Path Parameters

    パラメータ名

    Parameter Type

    必須

    accountId

    整数

    割り当ての取得が要求されるアカウント ID。

    あり

    応答形式

    response オブジェクト

    パラメータ名

    Parameter Type

    accountId

    整数

    ライセンス情報が属するアカウント ID。

    licenseId

    文字列

    SFDC ライセンス ID。

    customerId

    文字列

    カスタマー ID。

    customerName

    文字列

    カスタマー名。

    environment

    文字列

    ライセンスが使用される予定の環境を表す列挙型:

    • "DEV/TEST" 

    • PROD"

    hardwareFingerprint

    文字列

    ライセンスが使用される予定のマシンのハードウェア フィンガープリント。現在、MAC アドレスのみがサポートされています。無制限の場合は ANY を使用します。

    type

    文字列

    ライセンスの対象コンシューマを表す列挙型:

    • "SAAS-CONTROLLER" 

    • "SAAS-ACCOUNT" 

    • "ONPREM-CONTROLLER" 

    • "ONPREM-ACCOUNT"

    expirationDate

    文字列

    ライセンス全体の期限日:ISO 8601 日時文字列。

    status

    文字列

    ライセンスステータスを表す列挙型:

    • "ACTIVE":期限切れではない paID ライセンス。すべてのユニットが支払い済みです。

    • "LIMITED":期限切れはしていない Lite または Trial。少なくとも 1 つのユニットが LITE または TRIAL です。

    • "EXPIRED":期限切れライセンス。

    packages

    オブジェクトの配列


    properties

    オブジェクト

    キー → 値の形式でライセンスに関連付けられたグローバル カスタム プロパティのコレクション。これらのプロパティは、すべてのパッケージで共有できます。

    fallbackUnits

    オブジェクト

    アカウントレベルのフォールバックユニットの定義。エージェントタイプ(文字列)をフォールバックユニット(整数)にマッピングします。

    package オブジェクト

    Parameter Name

    Parameter Type

    packageName

    文字列

    次のパッケージ(エディション)インスタンスの名前を表す列挙型:

    • "INFRA" 

    • "PREMIUM" "ENTERPRISE"

    type

    文字列

    次のパッケージインスタンスのタイプを表す列挙型:

    • "PAID"

    • "TRIAL" 

    • "LITE"

    kind

    文字列

    パッケージの作成元のライセンスモデルから派生したパッケージの種類。レガシーエージェントベースのライセンスモジュール(APM、DOTNET など)に基づくパッケージを、新しいインフラストラクチャベースのパッケージと迅速に区別するのに役立ちます。

    列挙型:"INFRASTRUCTURE_BASED"

    family

    文字列

    パッケージファミリ。

    createdDate

    文字列

    ライセンス内のパッケージインスタンスの作成日。ISO 8601 日時文字列。

    startDate

    文字列

    パッケージインスタンスの開始日。例:パッケージインスタンスがアクティブになる日付:ISO 8601 日時文字列。

    expirationDate

    文字列

    パッケージインスタンスの期限日、つまりパッケージインスタンスがアクティブでなくなる日付。ISO 8601 日時文字列。

    licenseUnits

    文字列

    パッケージインスタンスで使用可能なライセンスの数。

    properties

    オブジェクト

    キーと値のペア形式でのパッケージ固有のカスタムプロパティのコレクション。グローバルプロパティとマージする場合は、競合するパッケージ固有のプロパティが優先されます。


    curl --user <user>@<AccountName>:<password> -X GET \
    http://<host>:<port>/controller/licensing/v1/account/{accountId}/info
    {
        "accountId":0,
        "licenseId":"string",
        "customerId":"string",
        "customerName":"string",
        "environment":"DEV/TEST",
        "hardwareFingerprint":"string",
        "type":"SAAS-CONTROLLER",
        "expirationDate":"string",
        "status":"ACTIVE",
        "packages":[
            {
                "packageName":"INFRA",
                "type":"PAID",
                "kind":"AGENT_BASED",
                "family":"string",
                "createdDate":"string",
                "startDate":"string",
                "expirationDate":"string",
                "licenseUnits":0,
                "properties":{
                    
                }
            }
        ],
        "properties":{
            
        },
        "fallbackUnits":{
            
        }
    }
    JSON

    エージェントベースのライセンスの API:

      ライセンスルール API

      このセクションでは、ライセンスルールの作成、更新、および削除や、ID、アクセスキー、および名前によるライセンスルールの取得などの、AppDynamics でモデル化されたライセンスルールに関する情報を取得するために使用できるライセンスルール API メソッドについて説明します。

      すべてのライセンスルール API に以下が適用されます。

      • id:これはグローバルで一意な識別子の頭字語である GUID(または UUID)です。 
      • access_key:すべての licenseRules で一意である必要があります。
      • name:すべての licenseRules で一意である必要があります。
      • account_id:GET API を使用して次のパラメータの現在の値を確認します: account_ID.

      ライセンスルールの新規作成

      URL

      http://<host>:<port>/controller/mds/v1/license/rules

      形式

      POST /controller/mds/v1/license/rules 

      Input Parameters

      Parameter Name

      Parameter Type

      Value

      必須

      license_module_type

      文字列

      ライセンスモジュールのタイプを表す文字列。

      モジュールタイプ:

      • NETVIZ
      • MACHINE_AGENT
      • SIM_MACHINE_AGENT
      • APM
      • APP_AGENT
      • DOT_NET_AGENT
      [はい(Yes)] に設定

      id

      文字列ID または名前を表す文字列。[はい(Yes)] に設定

      version

      整数型(Integer)バージョン番号を示します。[はい(Yes)] に設定

      number_of_licenses

      整数型(Integer)必要なライセンス数を示す整数。[はい(Yes)] に設定

      account_id

      文字列アカウント名またはアカウント ID を提供します。[はい(Yes)] に設定

      access_key

      [パス(Path)]アカウントアクセスキーを提供します。[はい(Yes)] に設定


      LicenseRule は、license_module_type, id, access_key, account_id,version、および number_of_licenses で構成されています。

      curl --user <user>@<AccountName>:<password> -X POST \
        http://<host>:<port>/controller/mds/v1/license/rules \
        -H 'Content-Type: application/json' \
        -d '{
          "id": "011116a4-124c-4b73-9343-f315836f103b",
          "version": 0,
          "name": "Default_API9",
          "description": null,
          "enabled": true,
          "constraints": [],
          "entitlements": [
              {
                  "license_module_type": "JAVA",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NATIVE_WEB_SERVER",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NATIVE_SDK",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "DOT_NET",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NETVIZ",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NODEJS",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "SIM_MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PHP",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PYTHON",
                  "number_of_licenses": 100
              }
          ],
          "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
          "access_key": "ap1845ad-1f3e-4c9b-909b-a3cfa510bfb0",
          "total_licenses": null,
          "peak_usage": null
      }
      {  
         "id": "011116a4-124c-4b73-9343-f315836f103b",
         "version": 0,
         "name": "Default_API9",
         "description": null,
         "enabled": true,
         "constraints": [  
      
         ],
         "entitlements": [  
            {  
               "license_module_type": "JAVA",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "NATIVE_WEB_SERVER",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "NATIVE_SDK",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "DOT_NET",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "NETVIZ",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "MACHINE_AGENT",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "NODEJS",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "SIM_MACHINE_AGENT",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "PHP",
               "number_of_licenses": 100
            },
            {  
               "license_module_type": "PYTHON",
               "number_of_licenses": 100
            }
         ],
         "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
         "access_key": "ap1845ad-1f3e-4c9b-909b-a3cfa510bfb0",
         "total_licenses": null,
         "peak_usage": null
      }
      JSON

      作成時にはバージョンを 0 にする必要があります。


      現在のアカウントのすべてのライセンスルールの概要を返します。

      ライセンスルールの概要を取得するには、これを使用します。返されるデータ転送オブジェクト(DTO)には、制約、一致条件、または権限付与は含まれません。

      URL

      http://<host>:<port>/controller/mds/v1/license/rules

      フォーマット(Format)

      GET /controller/mds/v1/license/rules

      [
          {
              "id":"f36e08e2-5f57-4b8c-9ad2-f18873adcd87",
              "version":2,
              "name":"Default",
              "description":null,
              "enabled":true,
              "constraints":[
                  
              ],
              "entitlements":[
                  
              ],
              "account_id":"0429fc7b-a2b9-42e3-a7fb-f704d436a054",
              "access_key":"account-accesskey-123",
              "total_licenses":120,
              "peak_usage":null
          }
      ]

      ライセンスルールを更新する

      URL

      http://<host>:<port>/controller/mds/v1/license/rules

      形式

      PUT /controller/mds/v1/license/rules

      入力パラメータ

      Parameter Name

      Parameter Type

      Value

      必須

      id
      文字列ID または名前を表す文字列。[はい(Yes)] に設定
      license_module_type
      文字列

      ライセンスモジュールのタイプを表す文字列。

      モジュールタイプ:

      • NetViz
      • マシンエージェント
      • SIM マシンエージェント
      • APM
      [はい(Yes)] に設定
      version
      整数型(Integer)バージョン番号を示します。[はい(Yes)] に設定
      number_of_licenses
      整数型(Integer)必要なライセンス数を示す整数。[はい(Yes)] に設定
      account_id
      文字列アカウント名またはアカウント ID を提供します。[はい(Yes)] に設定
      access_key
      [パス(Path)]アカウントアクセスキーを提供します。[はい(Yes)] に設定

      要求の例

      curl -v -X PUT http://<host>:<port>/controller/mds/v1/license/rules \
        --user <user>@<AccountName>:<password> \
        -H 'Content-Type: application/json' \
        -d '{
          "id": "321116a4-124c-4b73-9343-f315836f103b",
          "version": 0,
          "name": "Default_API",
          "description": null,
          "enabled": true,
          "constraints": [],
          "entitlements": [
              {
                  "license_module_type": "JAVA",
                  "number_of_licenses": 1000
              },
              {
                  "license_module_type": "NATIVE_WEB_SERVER",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NATIVE_SDK",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "DOT_NET",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NETVIZ",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NODEJS",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "SIM_MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PHP",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PYTHON",
                  "number_of_licenses": 100
              }
          ],
          "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
          "access_key": "api845ad-1f3e-4c9b-909b-a3cfa510bfb0",
          "total_licenses": null,
          "peak_usage": null
      }

      ライセンスルールを更新するには、次の手順を実行します。

      1. 使用可能な GET メソッドのいずれかを使用してペイロードを取得します
      2. accessKeys、権限付与などを更新します。
      3. 他のキーと値のペアを変更せずに PUT リクエストを送信します。
      4. "version" は GET 時のままにしておきます。これはインクリメントされます。

      ライセンスルールを削除する

      URL

      http://<host>:<port>/controller/mds/v1/license/rules/f36e08e2-5f57-4b8c-9ad2-f18873adcd87

      形式

      DELETE /controller/mds/v1/license/rules/{id}

      入力パラメータ

      Parameter Name

      Parameter Type

      Value

      必須

      LicenseRuleId

      パス

      ID によってライセンスルールを削除します。

      対応

      ID によるライセンスルールの取得

      ライセンスルール ID によってライセンスルールを取得するには、これを使用します。

      URL

      http://<host>:<port>/mds/v1/license/rules/f36e08e2-5f57-4b8c-9ad2-f18873adcd87

      形式

      GET /mds/v1/license/rules/{licenseRuleId}

      パス パラメータ

      Parameter Name

      Parameter Type

      Value

      必須

      licenseRuleIdパスライセンスルールの UUID を取得します。あり

      出力パラメータ

      Parameter NameParameter TypeValueMandatory
      id
      文字列ID または名前を表す文字列。[はい(Yes)] に設定
      version
      整数型(Integer)バージョン番号を示します。[はい(Yes)] に設定
      total_licenses
      整数型(Integer)ライセンスの合計数を示す整数。[はい(Yes)] に設定
      account_id
      文字列アカウント名またはアカウント ID を提供します。[はい(Yes)] に設定
      access_key
      pathアカウントアクセスキーを提供します。[はい(Yes)] に設定


      curl -X GET --user <user>@<AccountName>:<password> http://<host>:<port>/controller/mds/v1/license/rules/091116a4-124c-4b73-9343-f315836f103b
      {
          "id": "091116a4-124c-4b73-9343-f315836f103b",
          "version": 0,
          "name": "Default",
          "description": null,
          "enabled": true,
          "constraints": [],
          "entitlements": [
              {
                  "license_module_type": "JAVA",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NATIVE_WEB_SERVER",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NATIVE_SDK",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "DOT_NET",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NETVIZ",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "NODEJS",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "SIM_MACHINE_AGENT",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PHP",
                  "number_of_licenses": 100
              },
              {
                  "license_module_type": "PYTHON",
                  "number_of_licenses": 100
              }
          ],
          "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
          "access_key": "bd3845ad-1f3e-4c9b-909b-a3cfa510bfb0",
          "total_licenses": null,
          "peak_usage": null
      }
      JSON

      "version" は UI または API からの更新のたびに更新されます。


      アクセスキーごとにライセンスルールを取得する

      URL

      http://<host>:<port>/controller/mds/v1/license/rules/accessKey/account-accesskey-123

      形式

      GET /controller/mds/v1/license/rules/accessKey/{accessKey}

      パス パラメータ

      Parameter Name

      Parameter Type

      Value

      必須

      access_key

      パス

      ライセンスルールに割り当てられているアクセスキーを取得します。

      あり

      出力パラメータ

      Parameter NameParameter TypeValueMandatory
      id
      文字列ID または名前を表す文字列。[はい(Yes)] に設定
      version
      整数型(Integer)バージョン番号を示します。[はい(Yes)] に設定
      total_licenses
      整数型(Integer)ライセンスの合計数を示す整数。[はい(Yes)] に設定
      account_id
      文字列アカウント名またはアカウント ID を提供します。[はい(Yes)] に設定


      curl -X GET --user <user>@<AccountName>:<password> http://<host>:<port>/controller/mds/v1/license/rules
      [
          {
              "id": "221116a4-124c-4b73-9343-f315836f103b",
              "version": 0,
              "name": "Default",
              "description": null,
              "enabled": true,
              "constraints": [],
              "entitlements": [],
              "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
              "access_key": "bd3845ad-1f3e-4c9b-909b-a3cfa510bfb0",
              "total_licenses": 1000,
              "peak_usage": null
          },
          {
              "id": "321116a4-124c-4b73-9343-f315836f103b",
              "version": 0,
              "name": "Custom1",
              "description": null,
              "enabled": true,
              "constraints": [],
              "entitlements": [],
              "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
              "access_key": "api845ad-1f3e-4c9b-909b-a3cfa510bfb0",
              "total_licenses": 1000,
              "peak_usage": null
          }
      ]
      JSON


      名前ごとにライセンスルールを取得する

      URL

      http://<host>:<port>/controller/mds/v1/license/rules/name/Default

      形式

      GET /controller/mds/v1/license/rules/name/{name}

      パス パラメータ

      Parameter Name

      Parameter Type

      Value

      必須

      name

      パス

      ライセンスルールの名前を取得します。

      あり

      出力パラメータ

      Parameter NameParameter TypeValueMandatory
      id
      文字列ID または名前を表す文字列。[はい(Yes)] に設定
      version
      整数型(Integer)バージョン番号を示します。[はい(Yes)] に設定
      total_licenses
      整数型(Integer)ライセンスの合計数を示す整数。[はい(Yes)] に設定
      account_id
      文字列アカウント名またはアカウント ID を提供します。[はい(Yes)] に設定


      curl -X GET --user <user>@<AccountName>:<password> http://<host>:<port>/controller/mds/v1/license/rules
      [
          {
              "id": "221116a4-124c-4b73-9343-f315836f103b",
              "version": 0,
              "name": "Default",
              "description": null,
              "enabled": true,
              "constraints": [],
              "entitlements": [],
              "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
              "access_key": "bd3845ad-1f3e-4c9b-909b-a3cfa510bfb0",
              "total_licenses": 1000,
              "peak_usage": null
          },
          {
              "id": "321116a4-124c-4b73-9343-f315836f103b",
              "version": 0,
              "name": "Custom1",
              "description": null,
              "enabled": true,
              "constraints": [],
              "entitlements": [],
              "account_id": "8b1e92f2-387c-45b6-9bb5-ebd7f67587d4",
              "access_key": "api845ad-1f3e-4c9b-909b-a3cfa510bfb0",
              "total_licenses": 1000,
              "peak_usage": null
          }
      ]
      JSON