GUI - IoT Connect Mobile Type S API リファレンス (2.0.0)

Download OpenAPI specification:Download

概要

本APIでは、IoT Connect Mobile Type S に関するリソースの参照・操作が可能です。

gui

gui画面に表示する API

Profile Usage (年月指定) 一覧表示用 API

使用量表示 > グループ一覧 > SIMグループ 月別使用 に表示するAPI プロファイル使用量 (年月指定)一覧取得

path Parameters
tenantId
required
string ^[\da-f]{32}$
Example: 550e8400e29b41d4a716446655440000

SDPFのテナントに一意に与えられる ID.

simGroupId
required
string ^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$
Example: eea3cd65-1921-4999-bbd7-94f4a4066629

SIMグループID

query Parameters
date
required
string ^\d{4}-\d{2}$
Example: date=2020-08

yyyy-MM形式で年月を指定

header Parameters
X-Auth-Token
required
string ^[\da-f]{32}$
Example: b41715e07684453abbe8a83eb93fde80

クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK

400

Bad Request

get/tenants/{tenantId}/gui/simGroups/{simGroupId}/monthlyUsage
https://api.ntt.com/icms-esim/v2/tenants/{tenantId}/gui/simGroups/{simGroupId}/monthlyUsage

Response samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "sims":
    [
    ]
}

Profile Usage (年月日指定) 一覧表示用 API

使用量表示 > グループ一覧 > SIMグループ 日別使用量 に表示するAPI プロファイル使用量 (年月日指定) 一覧取得

path Parameters
tenantId
required
string ^[\da-f]{32}$
Example: 550e8400e29b41d4a716446655440000

SDPFのテナントに一意に与えられる ID.

simGroupId
required
string ^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$
Example: eea3cd65-1921-4999-bbd7-94f4a4066629

SIMグループID

query Parameters
startDate
required
string ^\d{4}-\d{2}-\d{2}$
Example: startDate=2021-02-04

yyyy-MM-dd形式で開始年月日を指定

endDate
required
string ^\d{4}-\d{2}-\d{2}$
Example: endDate=2021-02-06

yyyy-MM-dd形式で終了年月日を指定

header Parameters
X-Auth-Token
required
string ^[\da-f]{32}$
Example: b41715e07684453abbe8a83eb93fde80

クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK

400

Bad Request

get/tenants/{tenantId}/gui/simGroups/{simGroupId}/dailyUsage
https://api.ntt.com/icms-esim/v2/tenants/{tenantId}/gui/simGroups/{simGroupId}/dailyUsage

Response samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "sims":
    [
    ]
}

SIM一覧(SIMグループ別)表示用API

リソース管理 > SIM管理 > グループ一覧 > SIMグループ SIM一覧 に表示するAPI SIM(SIMグループ別)一覧取得

path Parameters
tenantId
required
string ^[\da-f]{32}$
Example: 550e8400e29b41d4a716446655440000

SDPFのテナントに一意に与えられる ID.

simGroupId
required
string ^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$
Example: eea3cd65-1921-4999-bbd7-94f4a4066629

SIMグループID

query Parameters
quiet
boolean

trueの場合hsn,imsiのみを出力する

quietWithMultiAccessStatus
boolean

trueの場合マルチアクセスSIMに絞り込んだうえでhsn,imsi,profileStatusのみを出力する

showDeletedSim
boolean

trueの場合削除済みSIMも含める

limit
integer [ 0 .. 10000 ]

SIMグループ全体で見てプロファイルを最大で何件返すか。指定なしで全件返す

offset
integer >= 0

SIMグループ全体で見て何件目から返すか。デフォルト0

provider
string
Enum: "nttc" "tsl"

指定したプロバイダーでプロファイルを絞り込む

esimStatus
string
Enum: "enabled" "disabled" "deleted"

指定したeSIMステータスでプロファイルを絞り込む

profileStatus
string
Enum: "inactive" "active" "suspend" "sleeping" "delete"

指定したプロファイルステータスでプロファイルを絞り込む

profileStatus_not
string
Enum: "inactive" "active" "suspend" "sleeping" "delete"

指定したプロファイルステータスを除外するようにプロファイルを絞り込む

hsn
string

hsnに指定した文字を含むかでSIMを絞り込む

eid
string

eidに指定した文字を含むかでSIMを絞り込む

orderNo
string

orderNoに指定した文字を含むかでSIMを絞り込む

imsi
string

imsiに指定した文字を含むかでプロファイルを絞り込む

iccid
string

iccidに指定した文字を含むかでプロファイルを絞り込む

msisdn
string

msisdnに指定した文字を含むかでプロファイルを絞り込む

plan
string
Enum: "payg" "fixed" "null"

指定したプランでプロファイルを絞り込む、nullで開通前などプラン未設定プロファイルに絞り込み

plan_not
string
Enum: "payg" "fixed" "null"

指定したプランを除外するようにプロファイルを絞り込む、nullで開通前などプラン未設定プロファイルのみ除外

upStream
boolean

trueの場合上り特価のみに、falseの場合上り特価以外に絞り込む

cn
boolean

trueの場合閉域のみに、falseの場合インターネット接続のみに絞り込む

icgw
boolean

trueの場合ICGW申し込み済みのみに、falseの場合ICGW申し込み前のみに絞り込む

cnActIpAddress
string

cnActIpAddressに指定した文字を含むかでプロファイルを絞り込む

cnSbyIpAddress
string

cnSbyIpAddressに指定した文字を含むかでプロファイルを絞り込む

icgwEastIpAddress
string

icgwEastIpAddressに指定した文字を含むかでプロファイルを絞り込む

icgwWestIpAddress
string

icgwWestIpAddressに指定した文字を含むかでプロファイルを絞り込む

globalStaticIpAddress
string

globalStaticIpAddressに指定した文字を含むかでプロファイルを絞り込む

header Parameters
X-Auth-Token
required
string ^[\da-f]{32}$
Example: b41715e07684453abbe8a83eb93fde80

クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK

400

Bad Request

get/tenants/{tenantId}/gui/simGroups/{simGroupId}/sims
https://api.ntt.com/icms-esim/v2/tenants/{tenantId}/gui/simGroups/{simGroupId}/sims

Response samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "sims":
    [
    ],
  • "total": 4
}

プロファイル残量一覧(SIMグループ別)表示用API

残量表示 > プロファイル残量 > プロファイル残量一覧 に表示するAPI プロファイル残量一覧(SIMグループ別)取得

path Parameters
tenantId
required
string ^[\da-f]{32}$
Example: 550e8400e29b41d4a716446655440000

SDPFのテナントに一意に与えられる ID.

simGroupId
required
string ^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$
Example: eea3cd65-1921-4999-bbd7-94f4a4066629

SIMグループID

header Parameters
X-Auth-Token
required
string ^[\da-f]{32}$
Example: b41715e07684453abbe8a83eb93fde80

クライアントが Keystone を利用して取得した認証 Token

Responses

200

OK

400

Bad Request

get/tenants/{tenantId}/gui/simGroups/{simGroupId}/remainUsage
https://api.ntt.com/icms-esim/v2/tenants/{tenantId}/gui/simGroups/{simGroupId}/remainUsage

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sims":
    [