Licenses
In order to use the services offered by this platform, a tenant requires at least 1 subscription. Based on what was ordered certain amount of licenses will be associated to the subscription. These licenses define the services that can be consumed by the subscripton. Currently following licenses are defined:
- MS Teams users licenses: each MS Teams user that requires a phone number on this platform requires a license
- SIP trunk channels: SIP trunks allow to connect an on-prem PBX to this platform. For each SIP trunk channel, 1 simultaneous call can be
Get the licenses of a group
The following endpoint provides the licenses for all the subscription of all the tenants of the given group as well as their current usage.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/groups/{uuid}/licenses
Authorization
Required role
groups.instance.licenses.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the group |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
detailed | boolean | If true will return the license consumption per subscription, otherwise a generic overview | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more licenses found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No license found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
group | object | Object group license detail object with the information about license consumption of each entity in the group. Note that this list will be returned only with query parameter detailed=True. | yes |
Group License detail Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
distributors | object | List of distributor license detail object with the information about license consumption of each distributor. | no |
resellers | object | List of reseller license detail object with the information about license consumption of each direct reseller. | no |
tenants | object | List of tenant license detail object with the information about license consumption of each direct tenant. | no |
Distributor License detail Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
uuid | integer | A system generated unique ID (UUID) identifying the distributor | no |
name | string | Name of the distributor | no |
resellers | object | List of reseller license detail object with the information about license consumption of each reseller. | no |
tenants | object | List of tenant license detail object with the information about license consumption of each direct tenant. | no |
Reseller License detail Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
uuid | integer | A system generated unique ID (UUID) identifying the reseller | no |
name | string | Name of the reseller | no |
tenants | object | List of tenant license detail object with the information about license consumption of each tenant. | no |
Tenant License detail Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
uuid | integer | A system generated unique ID (UUID) identifying the tenant | no |
name | string | Name of the tenant | no |
subscriptions | object | List of subscription license detail object with the information about license consumption of each subscription. | no |
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details. | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details. | no |
Subscription License detail Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
id | integer | Index of the subscription | no |
name | string | Name of the subscription | no |
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
Example with detailed=False
json
{
"msTeamsUsers": {
"assigned": 363,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 123
}
}Example with detailed=True
json
{
"group": {
"distributors": [
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis Distributor",
"resellers": [
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis Reseller",
"sipTrunkChannels": {
"assigned": 105
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 92,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis DEV",
"sipTrunkChannels": {
"assigned": 95
},
"subscriptions": [
{
"id": 2,
"msTeamsUsers": {
"assigned": 59,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Operator Connect DEV",
"sipTrunkChannels": {
"assigned": 69
}
},
...
],
"uuid": "53fd92c7-fbef-44fd-af76-d92334432ac9"
},
...
],
"uuid": "cae902b4-2307-41ef-b554-43a12c63cc97"
},
...
],
"sipTrunkChannels": {
"assigned": 105
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "Test74",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [
{
"id": 126,
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "Test7447",
"sipTrunkChannels": {
"assigned": 0
}
}
],
"uuid": "31a7f9d5-b6ec-4849-888f-53eb60d9eafe"
},
...
],
"uuid": "f3eb54f4-00dc-4278-b323-c66b705d6822"
},
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "CBUR Test Distrib",
"resellers": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "cbu r direct",
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [],
"uuid": "bcd6c6fe-bb62-492b-97b9-bf448b823068"
},
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "cbu r2",
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [],
"uuid": "6fdad56b-5e0a-44f8-96a0-6ed3d8c753d2"
}
],
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [],
"uuid": "0070ab91-d6b6-4a50-910e-f3fc10224882"
},
{
"msTeamsUsers": {
"assigned": 38,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "testPaci",
"resellers": [
{
"msTeamsUsers": {
"assigned": 12,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "PACI-Reseller-Test",
"sipTrunkChannels": {
"assigned": 13
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 12,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "PACI-Tenant-Test",
"sipTrunkChannels": {
"assigned": 13
},
"subscriptions": [
{
"id": 118,
"msTeamsUsers": {
"assigned": 12,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "idal test 1",
"sipTrunkChannels": {
"assigned": 11
}
},
{
"id": 138,
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "paci test 1",
"sipTrunkChannels": {
"assigned": 2
}
}
],
"uuid": "44ddeef1-fc19-4e9f-bb65-2f8333a5ed8b"
}
],
"uuid": "b027211e-1491-450a-921d-8a80f799622f"
},
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "paciRes",
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "paciTen",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [
{
"id": 135,
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "paciSub",
"sipTrunkChannels": {
"assigned": 0
}
}
],
"uuid": "4429b2ab-8878-427b-85eb-5ca2d970bed5"
}
],
"uuid": "5e39ae05-3bf0-4ac4-bb4c-6f239c705c33"
}
],
"sipTrunkChannels": {
"assigned": 16
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 26,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "PACI-Tenant-Direct-Test",
"sipTrunkChannels": {
"assigned": 3
},
"subscriptions": [
{
"id": 111,
"msTeamsUsers": {
"assigned": 26,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "PACI-Subscription-1-Test",
"sipTrunkChannels": {
"assigned": 3
}
}
],
"uuid": "772e3073-5897-4b22-97a7-f556ce8ebd4f"
}
],
"uuid": "43139118-e1c0-4639-8444-930e408a2224"
},
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "id-d1",
"resellers": [],
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "id-t2",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [],
"uuid": "d2b10f83-3d25-46c1-b372-44376b6c363d"
}
],
"uuid": "1bd17fa4-2249-4f26-9f60-5e6f86d5ff70"
}
],
"name": "Netaxis",
"resellers": [
...,
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "id-r2",
"sipTrunkChannels": {
"assigned": 0
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "id-t3",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [],
"uuid": "871ade8b-ae93-46f7-8116-66958b8964ac"
}
],
"uuid": "6e26098c-01bd-49ae-952c-9621a64ae61c"
}
],
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "ToBeDeleted",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [
{
"id": 92,
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "ToBeDeleted",
"sipTrunkChannels": {
"assigned": 0
}
}
],
"uuid": "87aacd3b-8faa-4bbe-9b08-d20886ee846a"
},
...
],
"uuid": "aaf9dba1-9469-40fa-be50-22298d68010d"
},
"msTeamsUsers": {
"assigned": 363,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 123
}
}Get the licenses of a distributor
The following endpoint provides the licenses for all the subscription of all the tenants directly linked to the given distributor or directly linked to it's direct resellers as well as their current usage.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/distributors/{uuid}/licenses
Authorization
Required role
distributors.instance.licenses.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the distributor |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
detailed | boolean | If true will return the license consumption per subscription, otherwise a generic overview | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more licenses found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No license found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
distributor | object | Object distributor license detail object with the information about license consumption of each entity in the distributor. Note that this list will be returned only with query parameter detailed=True. | yes |
Example with detailed=False
json
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 105
}
}Example with detailed=True
json
{
"distributor": {
"name": "Netaxis Distributor",
"resellers": [
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis Reseller",
"sipTrunkChannels": {
"assigned": 105
},
"tenants": [
{
"msTeamsUsers": {
"assigned": 92,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis DEV",
"sipTrunkChannels": {
"assigned": 95
},
"subscriptions": [
{
"id": 2,
"msTeamsUsers": {
"assigned": 59,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Operator Connect DEV",
"sipTrunkChannels": {
"assigned": 69
}
},
...
],
"uuid": "53fd92c7-fbef-44fd-af76-d92334432ac9"
},
...
],
"uuid": "cae902b4-2307-41ef-b554-43a12c63cc97"
},
...
],
"tenants": [
{
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "Test74",
"sipTrunkChannels": {
"assigned": 0
},
"subscriptions": [
{
"id": 126,
"msTeamsUsers": {
"assigned": 0,
"inUse": 0,
"inUseMsResourceAccount": 0,
"inUseMsUsers": 0
},
"name": "Test7447",
"sipTrunkChannels": {
"assigned": 0
}
}
],
"uuid": "31a7f9d5-b6ec-4849-888f-53eb60d9eafe"
},
...
],
"uuid": "f3eb54f4-00dc-4278-b323-c66b705d6822"
},
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 105
}
}Get the licenses of a reseller
The following endpoint provides the licenses for all the subscription of all the tenants directly linked to the given reseller as well as their current usage.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/resellers/{uuid}/licenses
Authorization
Required role
resellers.instance.licenses.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the reseller |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
detailed | boolean | If true will return the license consumption per subscription, otherwise a generic overview | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more licenses found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No license found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
reseller | object | Object reseller license detail object with the information about license consumption of each entity in the reseller. Note that this list will be returned only with query parameter detailed=True. | yes |
Example with detailed=False
json
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 105
}
}Example with detailed=True
json
{
"msTeamsUsers": {
"assigned": 317,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"reseller": {
"name": "Netaxis Reseller",
"tenants": [
{
"msTeamsUsers": {
"assigned": 92,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Netaxis DEV",
"sipTrunkChannels": {
"assigned": 95
},
"subscriptions": [
{
"id": 2,
"msTeamsUsers": {
"assigned": 59,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Operator Connect DEV",
"sipTrunkChannels": {
"assigned": 69
}
},
...
],
"uuid": "53fd92c7-fbef-44fd-af76-d92334432ac9"
},
...
],
"uuid": "cae902b4-2307-41ef-b554-43a12c63cc97"
},
"sipTrunkChannels": {
"assigned": 105
}
}Get the licenses of a tenant
The following endpoint provides the licenses for all the subscription of the given tenant as well as their current usage.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/tenants/{uuid}/licenses
Authorization
Required role
tenants.instance.licenses.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the tenant |
URL/Query parameters
| Parameter | Type | Description | Required? |
|---|---|---|---|
detailed | boolean | If true will return the license consumption per subscription, otherwise a generic overview | no |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more licenses found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No license found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details | no |
tenant | object | Object tenant license detail object with the information about license consumption of each entity in the tenant. Note that this list will be returned only with query parameter detailed=True. | yes |
Example with detailed=False
json
{
"msTeamsUsers": {
"assigned": 92,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 95
}
}Example with detailed=True
json
{
"msTeamsUsers": {
"assigned": 92,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 95
},
"tenant": {
"name": "Netaxis DEV",
"subscriptions": [
{
"id": 2,
"msTeamsUsers": {
"assigned": 59,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"name": "Operator Connect DEV",
"sipTrunkChannels": {
"assigned": 69
}
},
...
],
"uuid": "53fd92c7-fbef-44fd-af76-d92334432ac9"
}
}Get the licenses of a subscription
The following endpoint provides the licenses of the given subscription as well as their current usage.
Request
Endpoint
GET /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/licenses
Authorization
Required role
tenants.instance.subscriptions.licenses.list
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the tenant to which the subscription belongs |
sub_id | string | A system generated ID identifying the subscription for which you want to get the licenses |
Response
Status codes
| Parameter | Description |
|---|---|
200 | One or more licenses found |
400 | Error while processing the request |
403 | The API consumer doesn't have sufficient rights to perform this action |
404 | No license found |
500 | Uncatched error on server side |
Success
Body
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the msTeamsUsers that are currently created but also the amount that can be created. See license object for more details. | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be setup. Note that there is no in use because this is linked to a call admission control mechanism that is enforced at runtime. See license object for more details. | no |
Example
json
{
"msTeamsUsers": {
"assigned": 59,
"inUse": 5,
"inUseMsResourceAccount": 3,
"inUseMsUsers": 2
},
"sipTrunkChannels": {
"assigned": 69
}
}Update the license limits of a subscription
Use this endpoint to associate more or less licenses to a subscription
Request
Endpoint
PUT /api/v01/draas/{draas_instance}/tenants/{uuid}/subscriptions/{subscription_id}/licenses
Authorization
Required role
tenants.instance.subscriptions.licenses.update
Path Parameters
| Parameter | Type | Description |
|---|---|---|
draas_instance | string | See common parameters |
uuid | string | A system generated unique ID (UUID) identifying the tenant to which the subscription belongs |
sub_id | integer | Index of the subscription for which you want to change the licenses |
URL/Query parameters
N/A
Body
| Parameter | Type | Description | Required? |
|---|---|---|---|
msTeamsUsers | object | Object indicating the new amount msTeamsUsers that can be created under this subscription. If not provided, the value will not be updated. See license update object for more details | no |
sipTrunkChannels | object | Object indicating the max amount of SIP trunk calls that can be made simultaneously by this subscription. See license updated object for more details | no |
License updated Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
assigned | integer | New value for the amount of licenses associated to the subscription | no |
Example
json
{
"msTeamsUsers": {
"assigned": 10
}
}Response
Status codes
| Parameter | Description |
|---|---|
200 | The license was updated successfully |
400 | Error while updating the license |
403 | The API consumer doesn't have sufficient rights to perform this action |
500 | Uncatched error on server side |
Success
Body
same as Get the licenses of a subscription
Common Objects
License Object
| Parameter | Type | Description | Conditional? |
|---|---|---|---|
assigned | integer | Amount of licenses associated to the subscription | no |
inUse | integer | Indicates the total amount of licenses currently in use. This is not relevant for SIP Trunk channels. | yes |
inUseMsResourceAccount | integer | Indicates the amount of licenses currently in use by resource account users. This is not relevant for SIP Trunk channels. | yes |
inUseMsUsers | integer | Indicates the amount of licenses currently in use by normal users. This is not relevant for SIP Trunk channels. | yes |