TN - iVantageAPI - T0001403 - 31 - Oct - 2023 Rev3
TN - iVantageAPI - T0001403 - 31 - Oct - 2023 Rev3
iVantage API
Evolution
iDX 4.3.x
Revision 3
All rights reserved. Reproduction in whole or in part without permission is prohibited. Information contained herein is
subject to change without notice. The specifications and information regarding the products in this document are
subject to change without notice. While every effort has been made to ensure the accuracy of the statements,
information and recommendations in this document, they are provided without warranty of any kind, express, or
implied. Users must take full responsibility for their application of any products. Trademarks, brand names and
products mentioned in this document are the property of their respective owners. All such references are used strictly
in an editorial fashion with no intent to convey any affiliation with the name or the product's rightful owner.
ST Engineering iDirect is a global leader in satellite communications (satcom) providing technology and solutions
that enable its customers to expand their business, differentiate their services and optimize their satcom networks.
Through the merger with Newtec, a recognized industry pioneer, the combined business unites over 35 years of
innovation focused on solving satellite’s most critical economic and technology challenges, and expands a shared
commitment to shaping the future of how the world connects. The product portfolio, branded under the names iDirect
and Newtec, represents the highest standards in performance, efficiency and reliability, making it possible for its
customers to deliver the best satcom connectivity experience anywhere in the world. ST Engineering iDirect is the
world’s largest TDMA enterprise VSAT manufacturer and is the leader in key industries including broadcast, mobility
and military/government.
iDirect Government created in 2007, is a wholly owned subsidiary of ST Engineering iDirect and was formed to better
serve the U.S. government and defense communities. In 2019, iDirect Government acquired Glowlink
Communications Technology, Inc.
ii Technical Note
Evolution | T0001403 | Revision 3
Revision History
Revision History
The following table shows all revisions for this document. To determine if this is the latest
revision, check the Technical Assistance Center (TAC) Web site. Refer to Getting Help on
page xiii for TAC access information.
iv Technical Note
Evolution | T0001403 | Revision 3
Contents
Contents
About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
Getting Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
iDirect Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiii
iDirect Government Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Document Set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .xiv
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1
API Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
API Processes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Configuring the API Services . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
HTTP Basic Access Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Session Cookie Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Logging In. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Session Cookie Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Logging Out . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Session Timeout. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
GET: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Technical Note v
Evolution | T0001403 | Revision 3
Contents
example Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
example response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
example Call 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
example response 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
example Call 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
example response 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
POST: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
example Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
example Response. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
PATCH: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
example Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
example response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
DELETE: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
example Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
example response . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
iVantage API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Version information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
URI scheme . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Tags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Consumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Produces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Applicationservicegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
GET /applicationservicegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
GET /applicationservicegroup/{applicationservicegroupId} . . . . . . . . . . . . . . . 20
PATCH /applicationservicegroup/{applicationservicegroupId}. . . . . . . . . . . . . . 21
Authorize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
POST /authorize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Buc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
GET /buc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
vi Technical Note
Evolution | T0001403 | Revision 3
Contents
GET /buc/{bucId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Carrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
POST /carrier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
GET /carrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
GET /carrier/{carrierId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
DELETE /carrier/{carrierId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
PATCH /carrier/{carrierId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Downconverter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
POST /downconverter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
GET /downconverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
GET /downconverter/{downconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
DELETE /downconverter/{downconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . 36
PATCH /downconverter/{downconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . 37
Hubrft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
POST /hubrft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
GET /hubrft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
GET /hubrft/{hubrftId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
DELETE /hubrft/{hubrftId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
PATCH /hubrft/{hubrftId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Inroutegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
POST /inroutegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
GET /inroutegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
GET /inroutegroup/{inroutegroupId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
DELETE /inroutegroup/{inroutegroupId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
PATCH /inroutegroup/{inroutegroupId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
Linecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
POST /linecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
GET /linecard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
GET /linecard/{linecardId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
DELETE /linecard/{linecardId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
PATCH /linecard/{linecardId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Lnb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
GET /lnb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
GET /lnb/{lnbId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
POST /network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
GET /network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
GET /network/{networkId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 61
DELETE /network/{networkId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
PATCH /network/{networkId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Reflector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
GET /reflector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
GET /reflector/{reflectorId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
Remote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
POST /remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
GET /remote. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
GET /remote/{remoteId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
DELETE /remote/{remoteId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
PATCH /remote/{remoteId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
POST /remote/{remoteId}/add_roaming_instance . . . . . . . . . . . . . . . . . . . . . 77
PATCH /remote/{remoteId}/apply_changes . . . . . . . . . . . . . . . . . . . . . . . . . 78
GET /remote/{remoteId}/raw_optionsfile . . . . . . . . . . . . . . . . . . . . . . . . . . 79
PATCH /remote/{remoteId}/reset. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
GET /remote/{remoteId}/status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
PATCH /remote/{remoteId}/stop_cw_pn . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
PATCH /remote/{remoteId}/tx_cw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
PATCH /remote/{remoteId}/tx_pn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
Remoteservicegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
GET /remoteservicegroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
GET /remoteservicegroup/{remoteservicegroupId}. . . . . . . . . . . . . . . . . . . . . 87
PATCH /remoteservicegroup/{remoteservicegroupId} . . . . . . . . . . . . . . . . . . . 88
Spacecraft. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
POST /spacecraft. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
GET /spacecraft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
GET /spacecraft/{spacecraftId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
DELETE /spacecraft/{spacecraftId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
PATCH /spacecraft/{spacecraftId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
Teleport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
POST /teleport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
GET /teleport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
GET /teleport/{teleportId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
DELETE /teleport/{teleportId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 99
PATCH /teleport/{teleportId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
Upconverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
POST /upconverter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
GET /upconverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
GET /upconverter/{upconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
DELETE /upconverter/{upconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
PATCH /upconverter/{upconverterId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
POST /user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
GET /user. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
GET /user/{userId}. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
PATCH /user/{userId} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
AggregateAddress . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ApplicationMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
ApplicationServiceGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
ApplicationServiceGroupListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
ApplicationServiceGroupListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
ApplicationServiceGroupResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ApplyChanges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ApplyChangesRequest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
ApplyChangesResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
BUC. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
BUCListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Technical Note ix
Evolution | T0001403 | Revision 3
Contents
BUCListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
BUCResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
CW . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
Carrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
CarrierListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
CarrierListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
CarrierResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
Composition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
ConfigTables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
DhcpClnAddrRange . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
DiscretePort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
DownConverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DownConverterListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
DownConverterListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
DownConverterResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
ElevationGain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
Error . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
GreTunnel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
HubRFT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
HubRFTListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
HubRFTListResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
HubRFTResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
InrouteGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
InrouteGroupListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
InrouteGroupListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
InrouteGroupResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
LNB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
LNBListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
LNBListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
LNBResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
Linecard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
x Technical Note
Evolution | T0001403 | Revision 3
Contents
LinecardResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
MCGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
Meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
MulticastGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
NetworkListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
NetworkListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
NetworkResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
PN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
PeerGroups. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145
Peers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146
PortForward . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
RXCarrier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147
Reflector . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
ReflectorListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
ReflectorListResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
ReflectorResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
Remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
RemoteListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
RemoteListResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
RemoteMember . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
RemoteResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172
RemoteServiceGroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173
RemoteServiceGroupListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
RemoteServiceGroupListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
RemoteServiceGroupResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
RoamingInstance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
RoamingRemote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 181
RouteMaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
Rule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
SVN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
SkewGain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
Technical Note xi
Evolution | T0001403 | Revision 3
Contents
Spacecraft . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
SpacecraftListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
SpacecraftListResponse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
SpacecraftResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
StaticRoute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190
Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
StatusResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
SwitchPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191
Teleport. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
TeleportListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192
TeleportListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
TeleportResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193
UpConverter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
UpConverterListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194
UpConverterListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
UpConverterResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195
User . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
UserListItem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196
UserListResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
UserResponse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
VLanInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
Security . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
basicAuth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
cookieAuth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
Appendix A . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
RemoteList . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
MultiEdit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207
MultiApply . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
About
Purpose
This document provides only a resource tree (list of commands) necessary for controlling and
monitoring an iDirect Evolution NMS. It does not explain the Web Services Interface concept
or general structure and syntax.
Audience
The intended audience for this document is the System Engineering team responsible for
interfacing with iDirect products. It is expected that the reader has a working knowledge of
machine to machine interfacing, software programming, and the REST architectural
approach.
Contents
This document contains the following major sections:
• Introduction
This chapter provides an introduction to the iVantage API.
• Appendix A
The appendix provides examples of dynamic APIs.
Getting Help
The iDirect Technical Assistance Center (TAC) and the iDirect Government Technical
Assistance Center (TAC) are available to provide assistance 24 hours a day, 365 days a year.
Software user guides, installation procedures, FAQs, and other documents that support iDirect
and iDirect Government products are available on the respective TAC Web site.
Document Set
The following iDirect documents are available at TAC and contain information relevant to
installing and using iDirect satellite network software and equipment. Refer to Getting Help
on page xiii for TAC access information.
• Release Notes
• Software Installation Guide or Network Upgrade Procedure Guide
• iBuilder User Guide
• iMonitor User Guide
• Installation and Commissioning Guide for Remote Satellite Routers
• Features and Chassis Licensing Guide
• Software Installation Checklist/Software Upgrade Survey
• Link Budget Analysis Guide
• TRANSEC User Guide
• Technical Note on Setting Up Defense and Universal Line Cards (DLC/ULCs)
The Webservices iVantage API is a new tool supported on Evolution. This API is built on RESTful
Web design principles, the industry-leading way that Web interfaces are built today, and relies
on HTTPS and JSON messaging as the means for encoding.
The iVantage API commands enables machine to machine routines to automate provisioning
and commissioning to improve network operator's productivity.
The API commands can be used to create, read, update, and delete (CRUD) iBuilder
configurations. Functions that are available to modify through iBuilder are now available
within the API. Accessible configuration parameters include remote model, management and
LAN IP addresses, power, CIR and MIR, QoS profile assignment, and so on.
The API also enables reading basic BUC, LNB, network, carrier, inroute group, and spacecraft
information which helps in adding a remote.
Swagger.io is the online documentation engine and is accessible through the web browser
pointed to the NMS. See, https://nodenms_server.
Technical Note 1
Evolution | T0001403 | Revision 3
API Limitations
When not explicitly specified, all resources exist from a base URL:
https://<server>/api/v1/evo/
<server> is the IP address (or DNS name when setup externally) of the NMS. All resources
below exist under an Evolution NMS node.
API Limitations
The following are some limitations with the iVantage API:
• The API does not support all network components.
• The API cannot read statistics and will not be able to replace SatManage monitoring.
• The user will not be able to use the API to create or modify service groups, bandwidth
groups, profiles, QoS, and so on.
• The API is executed as a single client and does not scale effectively for large numbers of
API calls.
• The API will be limited to the visibilities and permissions as the user defined in cxpd.cfg.
API Processes
There are two API processes that are needed to execute this API:
NOTE: Step 3 is only performed when the user is setting up a URL for Swagger
access.
2 Technical Note
Evolution | T0001403 | Revision 3
Authentication
Authentication
HTTP Basic Access Authentication
The standard HTTP Basic Access Authentication is supported and is the preferred mechanism
of user authorization keeping with the RESTful philosophy of a stateless web server. Each
individual HTTP request contains the Authorization HTTP header and the server does not store
any client state.
User credentials are passed with each request using standard Basic Access Authentication;
which is an HTTP header in the following form:
Authorization: Basic <Base64(user:password)>
The following is an example of an actual authorization header:
Authorization: Basic YWRtaW46bXlzZWNyZXRwYXNzd29yZA==
NOTE: The Base64 encoding is not intended to provide any security, but
rather is used to avoid character encoding issues and escape sequences within
the user name or password.
The following is an example of an HTTP request utilizing the HTTP Basic Access
Authentication mechanism:
GET /api/1.0/resource HTTP/1.1
Authorization: Basic YWRtaW46cGFzc3dvcmQ=
Accept: application/json
Content-Type: application/json
Content-Length: 23
{
"JSON": "body"
}
Technical Note 3
Evolution | T0001403 | Revision 3
Authentication
Logging In
Each login request must contain a user name and password as HTTP form fields. A successful
login will contain a session cookie in an HTTP response header. A login request may also
optionally contain redirection URLs upon successful or failed login.
The following is an example of a successful login that redirects to a URL /success.html:
POST
/authorize?user=admin&password=iDirect&success=/success.html&fail=
/fail.html HTTP/1.1
4 Technical Note
Evolution | T0001403 | Revision 3
Authentication
Location: /login.html
Content-Length: 0
The following is an example of a successful login that does not redirect to any other page but
simply contains the session cookie:
POST /authorize?user=admin&password=iDirect&success=&fail=
HTTP/1.1
HTTP/1.1 200 OK
Set-Cookie: session=8df914a9b578973208b1283087561e0d; http-only
Content-Length: 5
Login
The following is an example of a failed login that does not redirect to any other page but
simply indicates an error:
POST /authorize?user=admin&password=wrong&success=&fail= HTTP/1.1
{
"JSON": "body"
}
Logging Out
Sessions are automatically logged out after a period of inactivity but it is good practice to
logout from the session explicitly. A logout request must contain a logout form field and the
session cookie in an HTTP request header. A logout request may also optionally contain a
redirection URL. The following is an example of a logout request that redirects to a URL
/logged-out.html:
Technical Note 5
Evolution | T0001403 | Revision 3
Examples
HTTP/1.1 200 OK
Set-Cookie: session=; Max-Age=0
Content-Length: 6
Logout
Session Timeout
It is good practice to always logout of a session when it is no longer needed. A session will
expire after a period of inactivity; however, this is a contingency and session expiry should not
be relied upon for normal operation. When a session is intended for a long period with
infrequent use, insert a dummy requests during periods of inactivity to keep the session alive
and prevent it from expiring.
Examples
Use the following sample curl commands to login to NMS and GET, POST, or PATCH any object
through the API.
6 Technical Note
Evolution | T0001403 | Revision 3
Examples
GET:
GET retrieves leight-weight information about the requested VSAT terminal. This does not
include the Customer information. Please use api/diagnostic to get the Vsat plus Customer
information.
http(s)://<server IP[:PORT]>/v1/vsat/<ID>/<ATTRIBUTE>
example Call
curl -s -k -u admin:admin -iX GET
https://127.0.0.1:443/api/v1/evo/config/obj/remote/8
example response
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sun, 09 Aug 2015 21:53:38 GMT
Connection: keep-alive
Transfer-Encoding: chunked
{ "Name" : "Remote AT HQ (8)" }
example Call 2
curl -s -k -u admin:admin -iX GET
https://127.0.0.1:443/api/v1/evo/config/obj/remote/8
example response 2
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sun, 012 Sep 2015 13:09:59 GMT
Connection: keep-alive
Transfer-Encoding: chunked
{
"ID": "8",
"Name": "Remote AT HQ (8)",
"SN": "106882",
"DID": "234987906",
"ModelType": "X1",
"InrouteGroupID": "6",
"NetworkID": "2",
"Active": "0",
"MgmtIPAddress": "10.8.0.2",
"MgmtSubnetMask": "255.255.248.0",
"MgmtGateway": "127.0.0.1",
"LanIPAddress": "192.168.85.129",
Technical Note 7
Evolution | T0001403 | Revision 3
Examples
"LanSubnetMask": "255.255.255.252",
"LanGateway": "127.0.0.1",
"RXCarrierID": "4294967295",
"TXCarrierID": "4294967295",
"TXPower": "-15",
"Lat": "-26.24828",
"Lon": "28.18183",
"TCPCompression": "0",
"UDPHdrCompression": "0",
"UDPCompression": "0",
"LinkEncryption": "0",
"CRTP": "0",
"UpCIR": "256",
"UpMIR": "2048",
"UpMIN": "2",
"DownCIR": "512",
"DownMIR": "4096",
"AntennaID": "4",
"AntennaTxHandshake": "0",
"IsMobile": "0",
"IsSCPC": "0",
"SCPCPeerID": "0",
"IsRoaming": "0",
"SymbolRate": "459",
"MODCOD": "QPSK3/4",
"InitialPower": "-15",
"MaxPower": "-5",
"SpreadingFactor": "0",
"PayloadSize": "0",
"1DB": "-4"
}
example Call 3
curl -i -X GET ' http://192.168 . 1.10/v1/vsat'
example response 3
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Mon, 10 Aug 2015 00:13:46 GMT
8 Technical Note
Evolution | T0001403 | Revision 3
Examples
Connection: keep-alive
Transfer-Encoding: chunked
[
{
"Name": "Remote #8",
"ID": "8",
"DID": "234987906",
"NetworkID": "2",
"InrouteGroupID": "6",
"LinecardID": "0"
},
{
"Name": "Remote #10",
"ID": "10",
"DID": "234987911",
"NetworkID": "2",
"InrouteGroupID": "6",
"LinecardID": "0"
},
{
"Name": "Remote #908",
"ID": "908",
"DID": "235021302",
"NetworkID": "2",
"InrouteGroupID": "3",
"LinecardID": "0"
},
{
"Name": "Remote #909",
"ID": "909",
"DID": "235004748",
"NetworkID": "2",
"InrouteGroupID": "3",
"LinecardID": "0"
}
]
Technical Note 9
Evolution | T0001403 | Revision 3
Examples
POST:
POST Creates a new VSAT instance in the iVantage system. With this call you will not be able
to specify the Customer information. For this please use the api/diagnostic – API.
http(s)://<server IP[:PORT]>/v1/vsat
example Call
curl -H "Content-Type: application/json" -i -X POST -d '{
"Name": "New VSat Terminal",
"SN": "106887",
"ModelType": "X1",
"InrouteGroupID": "1",
"NetworkID": "1",
"Active": "1",
"UpCIR": "256",
"UpMIR": "2048",
"UpMIN": "2",
"DownCIR": "512",
"DownMIR": "4096",
"IsMobile": "0",
"TXPower": "-15",
"Lat": "-26.24828",
"Lon": "28.18183",
"SymbolRate": "459",
"MODCOD": "QPSK3/4",
"InitialPower": "-15",
"MaxPower": "-5",
"ID": null,
"DID": null,
"MgmtIPAddress": null,
"MgmtSubnetMask": null,
"MgmtGateway": null,
"LanIPAddress": null,
"LanSubnetMask": null,
"LanGateway": null,
"RXCarrierID": null,
"TXCarrierID": null,
"TCPCompression": null,
"UDPHdrCompression": null,
"UDPCompression": null,
10 Technical Note
Evolution | T0001403 | Revision 3
Examples
"LinkEncryption": null,
"CRTP": null,
"AntennaID": null,
"AntennaTxHandshake": null,
"IsSCPC": null,
"SCPCPeerID": null,
"IsRoaming": null,
"SpreadingFactor": null,
"PayloadSize": null,
"1DB": null
}' http://192.168 . 1.10/v1/vsat
example Response
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 12 Sep 2015 14:31:26 GMT
Connection: keep-alive
Transfer-Encoding: chunked
{
"ID": "80",
"Name": "New VSat Terminal",
"SN": "106887",
"DID": "234987912",
"ModelType": "X1",
"InrouteGroupID": "1",
"NetworkID": "1",
"Active": "1",
"MgmtIPAddress": "null",
"MgmtSubnetMask": "null",
"MgmtGateway": "null",
"LanIPAddress": "null",
"LanSubnetMask": "null",
"LanGateway": "null",
"RXCarrierID": "4294967295",
"TXCarrierID": "3",
"TXPower": "-15",
"Lat": "0",
"Lon": "0",
"TCPCompression": "0",
Technical Note 11
Evolution | T0001403 | Revision 3
Examples
"UDPHdrCompression": "0",
"UDPCompression": "0",
"LinkEncryption": "0",
"CRTP": "0",
"UpCIR": "256",
"UpMIR": "2048",
"UpMIN": "2",
"DownCIR": "512",
"DownMIR": "4096",
"AntennaID": "0",
"AntennaTxHandshake": "0",
"IsMobile": "0",
"IsSCPC": "0",
"SCPCPeerID": "0",
"IsRoaming": "0",
"SymbolRate": "459",
"MODCOD": "QPSK3/4",
"InitialPower": "-15",
"MaxPower": "-5",
"SpreadingFactor": "0",
"PayloadSize": "0",
"1DB": "0"
}
PATCH:
PATCH Updates a set of attributes of the VSAT terminal. The collection of the provided
attributes does not need to be complete. With this call you will not be able to specify the
Customer information. For this please use the api/diagnostic – API.
http(s)://<server IP[:PORT]>/v1/vsat/<ID>/<ATTRIBUTE>/<VALUE>
example Call
curl -s -k -u admin:admin -iX GET
https://127.0.0.1:443/api/v1/evo/config/obj/remote/8
example response
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Sat, 12 Sep 2015 16:45:55 GMT
Connection: keep-alive
Transfer-Encoding: chunked
12 Technical Note
Evolution | T0001403 | Revision 3
Examples
Technical Note 13
Evolution | T0001403 | Revision 3
Examples
"LinkEncryption": "0",
"CRTP": "0",
"UpCIR": "256",
"UpMIR": "2048",
"UpMIN": "2",
"DownCIR": "512",
"DownMIR": "4096",
"AntennaID": "1316",
"AntennaTxHandshake": "0",
"IsMobile": "0",
"IsSCPC": "0",
"SCPCPeerID": "0",
"IsRoaming": "0",
"SymbolRate": "918",
"MODCOD": "QPSK3/4",
"InitialPower": "14",
"MaxPower": "5",
"SpreadingFactor": "0",
"PayloadSize": "1",
"1DB": "-4"
}
DELETE:
DELETE removes a VSAT terminal from the iVantage NMS. Please be advised that once the
terminal is deleted you will no longer be able to recover it.
http(s)://<server IP[:PORT]>/v1/vsat/<ID>
example Call
curl -s -k -u admin:admin -iX DELETE
https://127.0.0.1:443/api/v1/evo/config/obj/remote/1446
example response
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Fri, 21 Aug 2015 23:07:47 GMT
Connection: keep-alive
Transfer-Encoding: chunked
.
14 Technical Note
Evolution | T0001403 | Revision 3
iVantage API
Technical Note 15
Evolution | T0001403 | Revision 3
Overview
This is the iDirect iVantage API.
Version information
Version : 1.0.0
URI scheme
Host : nodenms_server
BasePath : /api/v1/evo/config/obj
Schemes : HTTPS, HTTP
Tags
• Applicationservicegroup : Refers to a group or collection of application services.
• Authorize : Relates to the process of granting or denying access to certain resources or functionalities
based on user permissions or roles.
• Downconverter : Device used to convert the frequency of an incoming signal from a higher frequency
(Ku-band or C-band) to a lower frequency (L-band) for further processing or demodulation.
• Network : A collection of interconnected devices or systems that can communicate and share
resources.
• Reflector : Reflector refers to a large dish-shaped antenna that reflects or focuses incoming or
outgoing signals.
• Upconverter : Device used to convert the frequency of an incoming signal from a lower frequency (L-
band) to a higher frequency (Ku-band or C-band) for further processing or demodulation.
16
• User : A user account.
Consumes
• application/json
• text/xml
Produces
• application/json
• text/html
17
Resources
Applicationservicegroup
Refers to a group or collection of application services.
18
GET /applicationservicegroup
Description
Responses
ApplicationService
200 List all applicationservicegroups
GroupListResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
19
GET /applicationservicegroup/{applicationservicegroupId}
Description
Parameters
applicationser
Path vicegroupId ID of the applicationservicegroup integer
required
Responses
ApplicationService
200 Returns the applicationservicegroup with ID = applicationservicegroupId
GroupResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
20
PATCH /applicationservicegroup/{applicationservicegroupId}
Description
Parameters
applicationser
Path vicegroupId ID of the applicationservicegroup integer
required
ApplicationSer
The applicationservicegroup JSON you want to ApplicationServiceGr
Body viceGroup
update the applicationservicegroup with oup
required
Responses
ApplicationService
200 Returns the updated applicationservicegroup
GroupResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
21
Authorize
Relates to the process of granting or denying access to certain resources or functionalities based on user
permissions or roles.
POST /authorize
Description
Login user and receive a session token in the header, or Logout existing session token.
Parameters
password
Query The password of the user string
required
user
Query The username of the user string
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
22
Buc
BUC stands for Block Upconverter.
GET /buc
Description
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
23
GET /buc/{bucId}
Description
Parameters
bucId
Path ID of the buc integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
24
Carrier
A carrier refers to a signal that carries information.
25
POST /carrier
Description
Parameters
Carrier
Body The carrier JSON you want to post Carrier
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
26
{
"ID": null,
"Name": "carrierName",
"SpacecraftID": "spacecraftID",
"TransponderID": "transponderID",
"BandwidthID": "bandwidthID",
"Type": "carrierType",
"InboundMode": "carrierInboundMode",
"UplinkFreq": "carrierUplinkFreq",
"DownlinkFreq": "carrierDownlinkFreq",
"Power": -25,
"SpreadingFactor": "carrierSpreadingFactor",
"SymbolRate": "carrierSymbolRate",
"FecRate": "carrierFecRate",
"ModulationType": "carrierModulationType",
"MinModcod": "N/A",
"MaxModcod": "N/A",
"CarrierSpacing": 1.2,
"Superburst": true,
"SpreadAcqEnabled": false
}
27
GET /carrier
Description
Responses
CarrierListRespons
200 List all carriers
e
Security
Type Name
basic basicAuth
apiKey cookieAuth
28
GET /carrier/{carrierId}
Description
Parameters
carrierId
Path ID of the carrier integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
29
DELETE /carrier/{carrierId}
Description
Parameters
carrierId
Path ID of the carrier integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
30
PATCH /carrier/{carrierId}
Description
Parameters
carrierId
Path ID of the carrier integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
31
Downconverter
Device used to convert the frequency of an incoming signal from a higher frequency (Ku-band or C-band)
to a lower frequency (L-band) for further processing or demodulation.
POST /downconverter
Description
Parameters
DownConverte
Body r The downconverter JSON you want to post DownConverter
required
Responses
DownConverterRes
201 Creates the DownConverter and returns it
ponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
32
{
"ID": 1,
"Name": "DownConverter_Test",
"ManufacturerID": "manufacturerID",
"ManufacturerPN": "DownConverter_Test",
"iDirectPN": "",
"TranslationFreq": 0,
"ODURxDCPower": false,
"ODURx10MHz": false,
"SpectralInversion": "Normal",
"Stability": 0.01
}
33
GET /downconverter
Description
Responses
DownConverterList
200 List all downconverters
Response
Security
Type Name
basic basicAuth
apiKey cookieAuth
34
GET /downconverter/{downconverterId}
Description
Parameters
downconverter
Path Id ID of the downconverter integer
required
Responses
DownConverterRes
200 Returns the downconverter with ID = downconverterId
ponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
35
DELETE /downconverter/{downconverterId}
Description
Parameters
downconverter
Path Id ID of the downconverter integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
36
PATCH /downconverter/{downconverterId}
Description
Parameters
downconverter
Path Id ID of the downconverter integer
required
DownConverte
The downconverter JSON you want to update the
Body r DownConverter
downconverter with
required
Responses
DownConverterRes
200 Returns the updated downconverter
ponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
37
Hubrft
Hub or central point in a radio frequency transmission system.
POST /hubrft
Description
Parameters
HubRFT
Body The hubrft JSON you want to post HubRFT
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
38
{
"ID": null,
"Name": "Test HubRFT",
"Status": "",
"TeleportID": "teleportID",
"AntennaID": 0,
"UpConverterID": "upConverterID",
"DownConverterID": "downConverterID",
"HPAID": 0,
"SpacecraftID": "spacecraftID"
}
39
GET /hubrft
Description
Responses
HubRFTListRespons
200 List all hubrfts
e
Security
Type Name
basic basicAuth
apiKey cookieAuth
40
GET /hubrft/{hubrftId}
Description
Parameters
hubrftId
Path ID of the hubrft integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
41
DELETE /hubrft/{hubrftId}
Description
Parameters
hubrftId
Path ID of the hubrft integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
42
PATCH /hubrft/{hubrftId}
Description
Parameters
hubrftId
Path ID of the hubrft integer
required
HubRFT
Body The hubrft JSON you want to update the hubrft with HubRFT
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
43
Inroutegroup
Collection of in-route elements or components within a network or communication system.
POST /inroutegroup
Description
Parameters
InrouteGroup
Body The inroutegroup JSON you want to post InrouteGroup
required
Responses
InrouteGroupRespo
201 Creates the InrouteGroup and returns it
nse
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
44
{
"ID" : null,
"Name" : "IGName",
"Status" : "",
"NetworkID" : "validNW",
"QosMode" : "IGQosMode",
"BandwidthGroupIDs" : [
"bandwidthID1",
"bandwidthID2"
],
"MaxCotmSpeed" : 0,
"Timeplan" : {
"AcqAperture" : 1714.37,
"GuardInterval" : 252
},
"Adaptive" : {
"AllowedDropoutFraction" : 0,
"DefaultIgcID" : 0,
"UpdateInterval" : 60,
"FixedIgcID" : 1
},
"CarrierIDs" : [
"validCarrierID1",
"validCarrierID2"
],
"Compositions" : [
{
"ID" : "IGCID",
"Name" : "IGCName",
"ModcodForEachCarrier" : [
"BPSK1/2",
"BPSK1/2"
]
}
]
}
45
GET /inroutegroup
Description
Responses
InrouteGroupListRe
200 List all inroutegroups
sponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
46
GET /inroutegroup/{inroutegroupId}
Description
Parameters
inroutegroupId
Path ID of the inroutegroup integer
required
Responses
InrouteGroupRespo
200 Returns the inroutegroup with ID = inroutegroupId
nse
Security
Type Name
basic basicAuth
apiKey cookieAuth
47
DELETE /inroutegroup/{inroutegroupId}
Description
Parameters
inroutegroupId
Path ID of the inroutegroup integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
48
PATCH /inroutegroup/{inroutegroupId}
Description
Parameters
inroutegroupId
Path ID of the inroutegroup integer
required
Responses
InrouteGroupRespo
200 Returns the updated inroutegroup
nse
Security
Type Name
basic basicAuth
apiKey cookieAuth
49
Linecard
A line card hardware component.
POST /linecard
Description
Parameters
Linecard
Body The linecard JSON you want to post Linecard
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
50
{
"ID": null,
"Name": "validLCName",
"NetworkID": "validNetworkId",
"HubRFTID": "hubRFTID",
"ChassisID": "chasisID",
"SN": "validLCSN",
"DID": null,
"ModelType": "validLCModelType",
"Active": true,
"LinecardType": "validLCType",
"UserPassword": "iDirect",
"AdminPassword": "iDirect",
"ReceiveMode": "validLCRMode",
"MgmtIPAddress": "mgmtLCIPAddress",
"MgmtSubnetMask": "MgmtLCSubnetMask",
"MgmtGateway": "mgmtLCGateway",
"GIG0IPAddress": "GIGOLCIPAddress",
"GIG0SubnetMask": "GIGOLCSubnetMask",
"GIG0Gateway": "GIGOLCGateway",
"GIG0Speed": "GIG0LCSpeed",
"TxCarrierID": "validTXCarrierId",
"AltTxCarrierID": "validTXCarrierId",
"RxCenterFreq": "rxCenterFreq",
"RXCarrierIds": [
{
"Name": "validRXCarrierName",
"ID": "validRXCarrierId"
}
]
}
51
GET /linecard
Description
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
52
GET /linecard/{linecardId}
Description
Parameters
linecardId
Path ID of the linecard integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
53
DELETE /linecard/{linecardId}
Description
Parameters
linecardId
Path ID of the linecard integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
54
PATCH /linecard/{linecardId}
Description
Parameters
linecardId
Path ID of the linecard integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
55
Lnb
LNB stands for Low-Noise Block Downconverter.
GET /lnb
Description
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
56
GET /lnb/{lnbId}
Description
Parameters
lnbId
Path ID of the lnb integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
57
Network
A collection of interconnected devices or systems that can communicate and share resources.
58
POST /network
Description
Parameters
Network
Body The network JSON you want to post Network
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
59
GET /network
Description
Responses
NetworkListRespon
200 List all networks
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
60
GET /network/{networkId}
Description
Parameters
networkId
Path ID of the network integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
61
DELETE /network/{networkId}
Description
Parameters
networkId
Path ID of the network integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
62
PATCH /network/{networkId}
Description
Parameters
networkId
Path ID of the network integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
63
Reflector
Reflector refers to a large dish-shaped antenna that reflects or focuses incoming or outgoing signals.
GET /reflector
Description
Responses
ReflectorListRespon
200 List all reflectors
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
64
GET /reflector/{reflectorId}
Description
Parameters
reflectorId
Path ID of the reflector integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
65
Remote
A remote refers to remote hardware device.
66
POST /remote
Description
Parameters
Remote
Body The remote JSON you want to post Remote
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
{
"ID": null,
"Name": "validRmtName",
"Status": "",
"SN": "fakeSN",
"DID": null,
"ModelType": "X5",
"InrouteGroupID": "validIG",
"NetworkID": "validNW",
"Active": true,
"MgmtIPAddress": "mgmtIPAddress",
"MgmtSubnetMask": "MgmtSubnetMask",
"MgmtGateway": "mgmtGateway",
"LanIPAddress": "lanIPAddress",
"LanSubnetMask": "lanSubnetMask",
"LanGateway": "lanGateway",
"RXCarrierID": -1,
67
"TXCarrierID": -1,
"TXPower": -25,
"Lat": 0,
"Lon": 0,
"TCPCompression": false,
"UDPHdrCompression": false,
"UDPCompression": false,
"LinkEncryption": false,
"CRTP": false,
"UpCIR": -0.001,
"UpMIR": -0.001,
"UpMIN": 0,
"DownCIR": 0,
"DownMIR": -0.001,
"DownMIN": 0.001,
"AntennaID": 278,
"AntennaTxHandshake": false,
"IsMobile": false,
"IsSCPC": false,
"SCPCPeerID": 0,
"IsRoaming": false,
"SymbolRate": 1000,
"MODCOD": "BPSK1/2",
"InitialPower": -25,
"MaxPower": 0,
"SpreadingFactor": 0,
"PayloadSize": 170,
"1DB": 0,
"RxOnly": false,
"RxOnlyMulticast": false,
"RxOnlyMCTimeout": 60,
"Mobile": {
"Security": false,
"Handshake": false,
"GPSInput": "Manual",
"GPSRefreshRate": 120,
"SerialDevice": "ttyS0",
"SerialSettings": "4800, 8N1",
"COTMType": "Maritime",
"MinLookAngle": -1,
"MaxSkew": 90,
"SkewMargin": 90
},
"L2oS": {
"SDT": 0,
"Ethertype1": "",
"Ethertype2": "",
"BFD": false,
"Compression": 0,
"MTU": 0
},
"Customer": {
"Name": "test",
"Phone": "111-222-3333",
"CommissionDate": "( date )",
"ContractNumber": "12345",
"SiteNotes": "Testing Remote Instance"
},
"VLans": [
{
"VLanID": 1,
"ETH0IPAddress": "vlan1ETH0IPAddress",
68
"ETH0SubnetMask": "vlan1ETH0SubnetMask",
"SAT0IPAddress": "vlan1SAT0IPAddress",
"SAT0SubnetMask": "vlan1SAT0SubnetMask",
"ETH0RIPv2": false,
"SAT0RIPv2": false,
"NAT": false,
"DNS": {
"Enabled": true,
"PrimaryName": "ns1",
"PrimaryAddr": "dnsPrimaryAddr",
"SecondaryName": "ns2",
"SecondaryAddr": "dnsSecondaryDnsAddr",
"CacheSize": 100,
"FwdQSize": 1000,
"FwdTimeout": 2000
},
"DHCP": {
"DhcpMode": 1,
"LeaseSeconds": 43200,
"PrimaryDnsAddr": "dhcp1PrimaryAddr",
"SecondaryDnsAddr": "dhcp1SecondaryDnsAddr",
"DefaultGwAddr": "dhcp1GatewayAddr",
"RelayServer": "dhcp1RelayServer",
"ClientAddrRanges": [
{
"StartAddr": "dhcp1StartAddr",
"EndAddr": "dhcp1EndAddr"
}
]
},
"StaticRoutes" : [ {
"IPAddress" : "staticRoute1IP",
"SubnetMask" : "staticRoute1Subnet",
"Gateway" : "staticRoute1Gateway",
"Interface" : "sat0",
"Cost" : 1
},
{
"IPAddress" : "staticRoute2IP",
"SubnetMask" : "staticRoute2Subnet",
"Gateway" : "staticRoute2Gateway",
"Interface" : "sat0",
"Cost" : 1
}
]
}
],
"AntennaComponents": {
"BUCID": "validBUCId",
"LNBIDs": [
"validLNBId"
],
"ReflectorID": "reflectorID",
"BoostLnbVoltage": false,
"ApproxCableLength": 0
},
"RemoteQOS": {
"DSQOS": {
"QOSGroupType": "validDSQOSType",
"FilterProfile": "validDSFilterProfile",
"FilterProfileID": "validDSFilterProfileId",
"ServiceGroup": "validDSServiceGroup",
69
"ServiceGroupID": "validDSServiceGroupId",
"ServiceProfile": "validDSServiceProfile",
"ServiceProfileID": "validDSServiceProfileId",
"MCServiceProfile": "",
"MCServiceProfileID": 0
},
"DSRateShaping": {
"EnableMaxIR": false,
"MaxIR": 0,
"EnableCIR": false,
"CIR": 0,
"Priority": "Cost Based",
"Cost": 1,
"EnableMinIR": false,
"MinIR": 0,
"EnableEIR": false,
"MinMODCOD": "16APSK-8/9"
},
"DSDistributor": {
"Enabled": true,
"SegmentSize": 70
},
"DSAllocRelToCIR": false,
"NominalMODCOD": "16APSK-8/9",
"MaxMODCOD": "16APSK-8/9",
"USQOS": {
"QOSGroupType": "validUSQOSType",
"FilterProfile": "validUSFilterProfile",
"FilterProfileID": "validUSFilterProfileId",
"ServiceGroup": "validUSServiceGroup",
"ServiceGroupID": "validUSServiceGroupId",
"ServiceProfile": "validUSServiceProfile",
"ServiceProfileID": "validUSServiceProfileId"
},
"USRateShaping": {
"EnableMaxIR": false,
"MaxIR": 0,
"EnableCIR": false,
"CIR": 0,
"Priority": "Cost Based",
"Cost": 1,
"EnableMinIR": false,
"MinIR": 0,
"EnableEIR": false,
"MinMODCOD": "N/A"
},
"USDistributor": {
"Enabled": true,
"SegmentSize": 70
},
"USAdaptive": {
"EnableMaxImpairment": false,
"MaxImpairment": -1,
"MinSymrate": 0,
"MaxCN": 25
},
"IdleDormant": {
"Enabled": false,
"IdleSlotsEvery": 8,
"DormantSlotsEvery": 32,
"IdleSTimeout": 120,
"DormantTimeout": 180
70
},
"USAllocRelToCIR": false
},
"AdminPassword": "P@55w0rd!",
"UserPassword": "iDirect",
"CustomKeys": {
"RemoteSide": "",
"HubSide": ""
}
}
71
GET /remote
Description
Parameters
72
Responses
RemoteListRespons
200 List all remotes
e
Security
Type Name
basic basicAuth
apiKey cookieAuth
73
GET /remote/{remoteId}
Description
Parameters
remoteId
Path ID of the remote integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
74
DELETE /remote/{remoteId}
Description
Parameters
remoteId
Path ID of the remote integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
75
PATCH /remote/{remoteId}
Description
Parameters
remoteId
Path ID of the remote integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
76
POST /remote/{remoteId}/add_roaming_instance
Description
Parameters
remoteId
Path The id of the remote to send the probe command to. integer
required
Remote
Body The roaming remote JSON you want to post RoamingRemote
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
77
PATCH /remote/{remoteId}/apply_changes
Description
Parameters
remoteId
Path The id of the remote to apply changes to. integer
required
Responses
ApplyChangesResp
202 Accepted
onse
Security
Type Name
basic basicAuth
apiKey cookieAuth
78
GET /remote/{remoteId}/raw_optionsfile
Description
Parameters
remoteId
Path The id of the remote to retrieve the options file for. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
79
PATCH /remote/{remoteId}/reset
Description
Send a remote probe command to the Remote with the given ID commanding it to perform a software
reset.
Parameters
remoteId
Path The id of the remote to send the stop command to. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
80
GET /remote/{remoteId}/status
Description
Parameters
remoteId
Path The id of the remote to check the status of. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
81
PATCH /remote/{remoteId}/stop_cw_pn
Description
Send a remote probe command to the Remote with the given ID commanding it to stop transmission of
either a CW or a PN carrier..
Parameters
remoteId
Path The id of the remote to send the stop command to. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
82
PATCH /remote/{remoteId}/tx_cw
Description
Send a remote probe command to the Remote with the given ID commanding it to transmit a CW. Can be
reissued with same parameters but with a different transmit power in order to adjust transmit power of a
CW.
Parameters
remoteId
Path The id of the remote to send the probe command to. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
83
PATCH /remote/{remoteId}/tx_pn
Description
Send a remote probe command to the Remote with the given ID commanding it to transmit a PN carrier.
Can be reissued with same parameters but with a different transmit power in order to adjust transmit
power of the carrier.
Parameters
remoteId
Path The id of the remote to send the probe command to. integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
84
Remoteservicegroup
A collection of remote services.
85
GET /remoteservicegroup
Description
Responses
RemoteServiceGrou
200 List all remoteservicegroups
pListResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
86
GET /remoteservicegroup/{remoteservicegroupId}
Description
Parameters
remoteserviceg
Path roupId ID of the remoteservicegroup integer
required
Responses
RemoteServiceGrou
200 Returns the remoteservicegroup with ID = remoteservicegroupId
pResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
87
PATCH /remoteservicegroup/{remoteservicegroupId}
Description
Parameters
remoteserviceg
Path roupId ID of the remoteservicegroup integer
required
RemoteService
The remoteservicegroup JSON you want to update
Body Group RemoteServiceGroup
the remoteservicegroup with
required
Responses
RemoteServiceGrou
200 Returns the updated remoteservicegroup
pResponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
88
Spacecraft
Communication sattelite.
POST /spacecraft
Description
Parameters
Spacecraft
Body The spacecraft JSON you want to post Spacecraft
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
89
{
"ID": null,
"Name": "Test Spacecraft",
"OperatorID": 0,
"OperatorRefName": "",
"Longitude": 0,
"InclineOrbit": 0,
"MinimumLookAngle": 0,
"MaxSkew": 90,
"SkewPolarization": 0,
"SkewMargin": 90,
"StationBoxAngle": 0.1
}
90
GET /spacecraft
Description
Responses
SpacecraftListRespo
200 List all spacecrafts
nse
Security
Type Name
basic basicAuth
apiKey cookieAuth
91
GET /spacecraft/{spacecraftId}
Description
Parameters
spacecraftId
Path ID of the spacecraft integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
92
DELETE /spacecraft/{spacecraftId}
Description
Parameters
spacecraftId
Path ID of the spacecraft integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
93
PATCH /spacecraft/{spacecraftId}
Description
Parameters
spacecraftId
Path ID of the spacecraft integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
94
Teleport
Hub location.
POST /teleport
Description
Parameters
Teleport
Body The teleport JSON you want to post Teleport
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
95
{
"ID": null,
"Name": "Test_Teleport",
"Status": "",
"BackupNMS": false,
"Lat": 0,
"Lon": 0,
"Alt": 0,
"Phone": "123-456-7890",
"CfgSrvIPAddress": "TelCfgSrvIPAddress",
"NrdSrvIPAddress": "TelNrdSrvIPAddress",
"EvtSrvIPAddress": "TelEvtSrvIPAddress"
}
96
GET /teleport
Description
Responses
TeleportListRespon
200 List all teleports
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
97
GET /teleport/{teleportId}
Description
Parameters
teleportId
Path ID of the teleport integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
98
DELETE /teleport/{teleportId}
Description
Parameters
teleportId
Path ID of the teleport integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
99
PATCH /teleport/{teleportId}
Description
Parameters
teleportId
Path ID of the teleport integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
100
Upconverter
Device used to convert the frequency of an incoming signal from a lower frequency (L-band) to a higher
frequency (Ku-band or C-band) for further processing or demodulation.
POST /upconverter
Description
Parameters
UpConverter
Body The upconverter JSON you want to post UpConverter
required
Responses
UpConverterRespon
201 Creates the UpConverter and returns it
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
101
{
"ID": null,
"Name": "UpConverter_Test",
"Status": "",
"ParentID": 0,
"ManufacturerID": "manufacturerID",
"ManufacturerPN": "UpConverter_Test",
"iDirectPN": "345",
"TranslationFreq": 0,
"ODUTxDCPower": false,
"ODUTx10MHz": false,
"SpectralInversion": "Normal"
}
102
GET /upconverter
Description
Responses
UpConverterListRes
200 List all upconverters
ponse
Security
Type Name
basic basicAuth
apiKey cookieAuth
103
GET /upconverter/{upconverterId}
Description
Parameters
upconverterId
Path ID of the upconverter integer
required
Responses
UpConverterRespon
200 Returns the upconverter with ID = upconverterId
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
104
DELETE /upconverter/{upconverterId}
Description
Parameters
upconverterId
Path ID of the upconverter integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
105
PATCH /upconverter/{upconverterId}
Description
Parameters
upconverterId
Path ID of the upconverter integer
required
Responses
UpConverterRespon
200 Returns the updated upconverter
se
Security
Type Name
basic basicAuth
apiKey cookieAuth
106
User
A user account.
POST /user
Description
Parameters
User
Body The user JSON you want to post User
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
Request body
{
"UserGroupID" : "validUserGroupId",
"LoginName" : "username1",
"Password" : "password1",
"AccessLevel" : "Custom",
"Permissions" : [ "DatabaseRead", "DatabaseChange", "DownloadFirmware" ]
}
107
GET /user
Description
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
108
GET /user/{userId}
Description
Parameters
userId
Path ID of the user integer
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
109
PATCH /user/{userId}
Description
Parameters
userId
Path ID of the user integer
required
User
Body The user JSON you want to update the user with User
required
Responses
Security
Type Name
basic basicAuth
apiKey cookieAuth
110
Definitions
AggregateAddress
Name Description Schema
PrefixLen Represents the prefix length property in the aggregate address. integer (int32)
111
ApplicationMember
Name Description Schema
ApplicationServiceGroup
Name Description Schema
AllocRelToNom Whether the allocation is relative to the nominal value for the
boolean
inal Application Service Group.
< ApplicationMember
Applications The list of applications that are available for the service group.
> array
ConfiguredRat
The configured rates for the Application Service Group. ConfiguredRates
es
Downstream The downstream bandwidth for the Application Service Group. boolean
EffectiveRates The effective rates for the Application Service Group. EffectiveRates
112
Name Description Schema
ParentID The unique identifier of the parent Application Service Group. integer (int32)
113
ConfiguredRates
EffectiveRates
114
CirModcodTable
Name Schema
115
Name Schema
116
MirModcodTable
Name Schema
117
Name Schema
118
ApplicationServiceGroupListItem
Name Description Schema
ParentID The unique identifier of the parent service group. integer (int32)
QOSMode The Quality of Service (QoS) mode of the service group. string
ApplicationServiceGroupListResponse
Name Description Schema
<
data The list of service groups returned in the response. ApplicationServiceGr
oupListItem > array
errors Errors
meta Meta
119
ApplicationServiceGroupResponse
Name Schema
data ApplicationServiceGroup
errors Errors
meta Meta
ApplyChanges
Name Schema
Success string
ApplyChangesRequest
Name Schema
HubSide boolean
Reset boolean
Transport string
120
ApplyChangesResponse
Name Schema
data ApplyChanges
BUC
Name Description Schema
TranslationFre
The translation frequency of the BUC. number (double)
q
TxRefOscillato
The transmit reference oscillator frequency of the BUC. string
r
iDirectPartNu
The iDirect part number of the BUC. string
mber
121
BUCListItem
Name Description Schema
BUCListResponse
Name Description Schema
data The list of BUCs returned in the response. < BUCListItem > array
errors Errors
meta Meta
BUCResponse
Name Schema
data BUC
errors Errors
meta Meta
122
CW
Name Description Schema
123
Carrier
Name Description Schema
124
Name Description Schema
SpreadAcqEna
The spread acquisition enable setting of the carrier. boolean
bled
125
CarrierListItem
Name Description Schema
CarrierListResponse
Name Description Schema
errors Errors
meta Meta
CarrierResponse
Name Schema
data Carrier
errors Errors
meta Meta
126
Composition
Name Schema
ID integer (int32)
Name string
ConfigTables
Name Description Schema
AdvertiseMapN
Advertise map number in the configuration tables integer (int32)
umber
ExportMapNu
Export map number in the configuration tables integer (int32)
mber
ImportMapNu
Import map number in the configuration tables integer (int32)
mber
NonExistMapN
Non-existent map number in the configuration tables integer (int32)
umber
DhcpClnAddrRange
Name Description Schema
EndAddr The ending address for a DHCP client address range string
StartAddr The starting address for a DHCP client address range string
127
DiscretePort
Name Description Schema
128
DownConverter
Name Description Schema
ManufacturerI
ID of the manufacturer of a down converter. integer (int32)
D
ManufacturerP
Part number of the manufacturer of a down converter. string
N
ODURxDCPowe
DC power setting of a down converter. boolean
r
TranslationFre
Translation frequency of a down converter. number (double)
q
DownConverterListItem
Name Description Schema
129
DownConverterListResponse
Name Description Schema
<
data Response for a list of down converters. DownConverterListIte
m > array
errors Errors
meta Meta
DownConverterResponse
Name Schema
data DownConverter
errors Errors
meta Meta
ElevationGain
Name Description Schema
130
Error
Name Description Schema
Message The Message property of the Error component in the properties. string
Errors
Type : < Error > array
GreTunnel
Name Description Schema
RemoteGatewa
The remote gateway for a GRE tunnel string
y
131
HubRFT
Name Description Schema
DownConverte
ID of the down converter for a hub RF settings. integer (int32)
rID
HPAID ID of the high power amplifier for a hub RF settings. integer (int32)
HubRFTListItem
Name Description Schema
132
HubRFTListResponse
Name Description Schema
errors Errors
meta Meta
HubRFTResponse
Name Schema
data HubRFT
errors Errors
meta Meta
133
InrouteGroup
Name Description Schema
Adaptive
FixedIgcID ID of the fixed IGC for the adaptive settings of an inroute group. integer (int32)
UpdateInterval Update interval for the adaptive settings of an inroute group. integer (int32)
134
Mesh
Timeplan
InrouteGroupListItem
Name Description Schema
135
InrouteGroupListResponse
Name Description Schema
<
data Response for a list of inroute groups. InrouteGroupListItem
> array
errors Errors
meta Meta
InrouteGroupResponse
Name Schema
data InrouteGroup
errors Errors
meta Meta
136
LNB
Name Description Schema
22KhzEnable Indicates whether the 22KHz is enabled for the LNB boolean
Rx10MHzEnabl
Indicates whether the RX 10MHz is enabled for the LNB boolean
e
TranslationFre
The translation frequency of the LNB number (double)
q
iDirectPartNu
The iDirect part number of the LNB string
mber
LNBListItem
137
Name Description Schema
138
LNBListResponse
Name Description Schema
data The list of LNBs returned in an LNBListResponse < LNBListItem > array
errors Errors
meta Meta
LNBResponse
Name Schema
data LNB
errors Errors
meta Meta
139
Linecard
Name Description Schema
AdminPasswor
The admin password for the Linecard string
d
GIG0SubnetMa
The subnet mask of the GIG0 port of the Linecard string
sk
MgmtIPAddres
The management IP address of the Linecard string
s
MgmtSubnetM
The management subnet mask of the Linecard string
ask
140
Name Description Schema
ParentID The unique identifier of the parent of the Linecard integer (int32)
141
LinecardResponse
Name Schema
data Linecard
errors Errors
meta Meta
MCGroup
Name Description Schema
Meta
Name Description Schema
Count The Count property of the Meta component in the properties. integer (int32)
142
MulticastGroup
Name Description Schema
Network
Name Description Schema
MulticastGrou
The multicast groups associated with the Netowkr < MCGroup > array
ps
NetworkListItem
Name Description Schema
143
NetworkListResponse
Name Description Schema
errors Errors
meta Meta
NetworkResponse
Name Schema
data Network
errors Errors
meta Meta
PN
Name Description Schema
144
PeerGroups
Name Description Schema
ConfigTableNu
Config table number in the peer groups integer (int32)
mber
PeerGroupNu
Peer group number in the peer groups integer (int32)
mber
145
Peers
Name Description Schema
ConfigTableNu
Config table number in the peers integer (int32)
mber
IsReflectorClie
Reflector client in the peers boolean
nt
MD5AuthPassw
MD5 authentication password in the peers string
ord
MaxRoutesPee
Maximum routes per peer in the peers integer (int32)
r
PeerGroupNu
Peer group number in the peers integer (int32)
mber
146
PortForward
Name Description Schema
RXCarrier
Name Description Schema
147
Reflector
Name Description Schema
AntennaContro
The Antenna Controller associated with the Reflector AntennaController
ller
iDirectPartNu
The iDirect part number of the Reflector string
mber
AntennaController
ControllerType The type of the Antenna Controller associated with the Reflector string
The elevation gain of the Antenna Controller associated with < ElevationGain >
ElevationGain
the Reflector array
148
ReflectorListItem
Name Description Schema
ReflectorListResponse
Name Description Schema
errors Errors
meta Meta
ReflectorResponse
Name Schema
data Reflector
errors Errors
meta Meta
149
Remote
Name Description Schema
AdminPasswor
The admin password of the remote. string
d
AntennaCompo
The antenna components. AntennaComponents
nents
DiscretePorts Discrete ports for the remote device. < DiscretePort > array
DownCIR The downlink committed information rate (CIR) of the remote. number (double)
DownMIN The downlink minimum information rate (MIN) of the remote. number (double)
DownMIR The downlink maximum information rate (MIR) of the remote. number (double)
InrouteGroupI The unique identifier of the inroute group that the remote is
integer (int32)
D associated with.
150
Name Description Schema
L2oS The Layer 2 over satellite (L2oS) settings of the remote. L2oS
LanSubnetMas
The LAN subnet mask of the remote. string
k
151
Name Description Schema
MgmtIPAddres
The management IP address of the remote. string
s
MgmtSubnetM
The management subnet mask of the remote. string
ask
152
Name Description Schema
RxOnlyMCTim
The receive-only multicast timeout of the remote. integer (int32)
eout
SecondReceive
The second receiver. SecondReceiver
r
SwitchPorts Switch ports for the remote device. < SwitchPort > array
UpCIR The uplink committed information rate (CIR) of the remote. number (double)
UpMIN The uplink minimum information rate (MIN) of the remote. number (double)
UpMIR The uplink maximum information rate (MIR) of the remote. number (double)
153
Name Description Schema
VLans VLANs for the remote device. < VLanInfo > array
154
AntennaComponents
ApproxCableLe
The approximate cable length of the antenna components. integer (int32)
ngth
BoostLnbVolta
The boost LNB voltage of the antenna components. boolean
ge
ConnectTimeo
The connect timeout of the antenna components. integer (int32)
ut
HuntFreqSelec
The hunt frequency select of the antenna components. string
t
InitTXPowerOf
The initial transmit power offset of the antenna components. number (double)
fset
NoiseRefFreq The noise reference frequency of the antenna components. number (double)
OpenAMIPAnte OpenAMIPAntennaCo
The OpenAMIP antenna controller of the antenna components.
nnaController ntroller
OrbitSBCAnten OrbitSBCAntennaCont
The Orbit SBC antenna controller of the antenna components.
naController roller
155
Name Description Schema
SeaTelDACAnt SeaTelDACAntennaCo
The SeaTel DAC antenna controller of the antenna components.
ennaController ntroller
156
OpenAMIPAntennaController
HuntBandwidt
The hunt bandwidth of the OpenAMIP antenna controller. number (double)
h
TxBandwidth The transmit bandwidth of the OpenAMIP antenna controller. number (double)
TxFreq The transmit frequency of the OpenAMIP antenna controller. number (double)
OrbitSBCAntennaController
Enable22KhzTo Indicates whether the 22Khz tone is enabled for the Orbit SBC
boolean
ne antenna controller.
LNBVoltage The LNB voltage of the Orbit SBC antenna controller. integer (int32)
SeaTelDACAntennaController
DVB_FEC The DVB FEC of the SeaTel DAC antenna controller. number (double)
Enable22KhzTo Indicates whether the 22Khz tone is enabled for the SeaTel DAC
boolean
ne antenna controller.
LNBVoltage The LNB voltage of the SeaTel DAC antenna controller. integer (int32)
157
CustomKeys
HubSide Custom key for the hub side of the connection. string
RemoteSide Custom key for the remote side of the connection. string
Customer
CommissionDa
The commission date of the remote for the customer. string
te
Name The name of the customer associated with the remote. string
Phone The phone number of the customer associated with the remote. string
SiteNotes The site notes for the customer associated with the remote. string
158
L2oS
HeaderCompre
The header compression settings of the L2oS. HeaderCompression
ssion
MTU The maximum transmission unit (MTU) of the L2oS. integer (int32)
SDT The satellite data terminal (SDT) settings of the L2oS. integer (int32)
HeaderCompression
Profiles The profiles used in the header compression of the L2oS. < string > array
159
Mesh
ReceiverFadeM
Fade margin of the receiver for the mesh. number (double)
argin
ReceiverHyster
Hysteresis margin of the receiver for the mesh. number (double)
esisMargin
ReceiverIPAdd
IP address of the receiver for the mesh. string
ress
ReceiverSN Serial number of the receiver for the mesh. integer (int64)
ReceiverSubne
Subnet mask of the receiver for the mesh. string
tMask
Mobile
GPSRefreshRat
The GPS refresh rate of the mobile remote. integer (int32)
e
MinLookAngle The minimum look angle of the mobile remote. number (double)
160
Name Description Schema
161
RemoteQOS
DSAllocRelToC
Maximum MODCOD for the remote device. boolean
IR
IdleDormant Idle and dormant settings for the remote device. IdleDormant
162
Name Description Schema
DSDistributor
163
DSQOS
FilterProfileID ID of the filter profile for downstream data transmission. integer (int32)
MCServiceProfi
Multicast service profile for downstream data transmission. string
le
ServiceGroupI
ID of the service group for downstream data transmission. integer (int32)
D
ServiceProfileI
ID of the service profile for downstream data transmission. integer (int32)
D
164
DSRateShaping
IdleDormant
165
Name Description Schema
DormantSlotsE
Number of slots for dormant periods for the remote device. integer (int32)
very
DormantTimeo
Timeout for dormant periods for the remote device. integer (int32)
ut
Whether the idle and dormant settings are enabled for the
Enabled boolean
remote device.
IdleSTimeout Timeout for idle periods for the remote device. integer (int32)
IdleSlotsEvery Number of slots for idle periods for the remote device. integer (int32)
166
USAdaptive
MaxImpairme
Maximum impairment for upstream data transmission. number (double)
nt
MaxSymrate Maximum symbol rate for upstream data transmission. number (double)
USDistributor
167
USQOS
FilterProfileID ID of the filter profile for upstream data transmission. integer (int32)
ServiceGroupI
ID of the service group for upstream data transmission. integer (int32)
D
ServiceProfileI
ID of the service profile for upstream data transmission. integer (int32)
D
USRateShaping
MinIR Minimum information rate (IR) for upstream data transmission. number (double)
168
Name Description Schema
169
SecondReceiver
SecondRxPort
BoostLnbVolta
The boost LNB voltage of the second receive port. boolean
ge
IFL The intermediate frequency link of the second receive port. string
MCFPEncryptio
boolean
n
170
RemoteListItem
Name Description Schema
InrouteGroupI
ID of the inroute group for a remote device. integer (int32)
D
SCPCPeerID SCPC (Single Channel Per Carrier) peer ID of a remote device. integer (int32)
RemoteListResponse
Name Description Schema
errors Errors
meta Meta
171
RemoteMember
Name Description Schema
RemoteResponse
Name Schema
data Remote
errors Errors
meta Meta
172
RemoteServiceGroup
Name Description Schema
AllocRelToCIR Allocation relative to the CIR for the service group. boolean
AllocRelToNom
Allocation relative to the nominal rate for the service group. boolean
inal
AllocRelToOpe
Allocation relative to the operational rate for the service group. boolean
rational
ConfiguredRat
ConfiguredRates
es
EffectiveRates EffectiveRates
ParentID ID of the parent device for the service group settings. integer (int32)
ParentName Name of the parent device for the service group settings. string
173
Name Description Schema
StickyCIR Whether the CIR is sticky for the service group. boolean
174
ConfiguredRates
Name Schema
EnableCIR boolean
EnableMIR boolean
EffectiveRates
CIRkbps The committed information rate in kilobits per second. number (double)
CirModcodTabl The modulation and coding scheme table for the committed
CirModcodTable
e information rate.
Cost The cost associated with the effective rates. number (double)
MIRkbps The maximum information rate in kilobits per second. number (double)
MirModcodTab The modulation and coding scheme table for the maximum
MirModcodTable
le information rate.
175
CirModcodTable
Name Schema
176
Name Schema
177
MirModcodTable
Name Schema
178
Name Schema
179
RemoteServiceGroupListItem
Name Description Schema
RemoteServiceGroupListResponse
Name Description Schema
<
Represents the data property in the remote service group list
data RemoteServiceGroupL
response.
istItem > array
errors Errors
meta Meta
180
RemoteServiceGroupResponse
Name Schema
data RemoteServiceGroup
errors Errors
meta Meta
RoamingInstance
Name Description Schema
InrouteGroupI
In-route group ID in the roaming instance integer (int32)
D
RoamingRemote
Name Description Schema
InrouteGroupI The unique identifier of the inroute group that the remote is
integer (int32)
D associated with.
181
RouteMaps
Name Description Schema
RouteMapNum
Represents the route map number property in the route maps. integer (int32)
ber
Rules Represents the rules property in the route maps. < Rule > array
182
Rule
Name Description Schema
MaExCommuni
Represents the MaExCommunity property in the rule. string
ty
RuleNumber Represents the rule number property in the rule. integer (int32)
SNRMetricRout
Represents the SNRMetricRouteMapIndex property in the rule. integer (int32)
eMapIndex
SeCommunityA
Represents the SeCommunityAction property in the rule. string
ction
SeExCommunit
Represents the SeExCommunity property in the rule. string
y
SeExCommunit
Represents the SeExCommunityAction property in the rule. string
yAction
183
Name Description Schema
SeNextHopAdd
Represents the SeNextHopAddress property in the rule. string
ress
184
IPPrefix
AFI Represents the AFI property in the IPPrefix property of the rule. string
SVN
Name Description Schema
L3 L3 in the SVN L3
185
Name Description Schema
186
L3
ETH0SubnetMa
ETH0 subnet mask in the L3 of SVN string
sk
SAT0SubnetMa
SAT0 subnet mask in the L3 of SVN string
sk
BGP
ConfigTables Config tables in the BGP of L3 in SVN < ConfigTables > array
PeerGroups Peer groups in the BGP of L3 in SVN < PeerGroups > array
RouteMaps Route maps in the BGP of L3 in SVN < RouteMaps > array
RouteRedistrib
Route redistribution in the BGP of L3 in SVN RouteRedistribution
ution
187
ORF
Type string
RouteRedistribution
SkewGain
Name Description Schema
188
Spacecraft
Name Description Schema
MinimumLook
The minimum look angle of the Spacecraft number (double)
Angle
SkewPolarizati
The polarization of the skew of the Spacecraft number (double)
on
StationBoxAngl
The station box angle of the Spacecraft number (double)
e
SpacecraftListItem
Name Description Schema
189
SpacecraftListResponse
Name Description Schema
errors Errors
meta Meta
SpacecraftResponse
Name Schema
data Spacecraft
errors Errors
meta Meta
StaticRoute
Name Description Schema
190
Status
Name Description Schema
Status The Status property of the Status component in the properties. string
StatusResponse
Name Schema
data Status
meta Meta
SwitchPort
Name Description Schema
AutoNegotiatio
The auto-negotiation feature for a switch port boolean
n
Speed100Mbps The speed setting for a switch port, specifically 100 Mbps boolean
191
Teleport
Name Description Schema
CfgSrvIPAddre
The IP address of the configuration server of the Teleport string
ss
EvtSrvIPAddre
The IP address of the event server of the Teleport string
ss
NrdSrvIPAddre
The IP address of the NRD server of the Teleport string
ss
TeleportListItem
Name Description Schema
192
TeleportListResponse
Name Description Schema
errors Errors
meta Meta
TeleportResponse
Name Schema
data Teleport
errors Errors
meta Meta
193
UpConverter
Name Description Schema
ManufacturerI
The unique identifier of the manufacturer of the UpConverter integer (int32)
D
ManufacturerP
The part number of the UpConverter from the manufacturer string
N
ODUTxDCPowe
Represents the ODUTxDCPower property in the up converter. boolean
r
TranslationFre
The translation frequency of the UpConverter number (double)
q
UpConverterListItem
Name Description Schema
194
UpConverterListResponse
Name Description Schema
<
The list of UpConverters returned in an
data UpConverterListItem
UpConverterListResponse
> array
errors Errors
meta Meta
UpConverterResponse
Name Schema
data UpConverter
errors Errors
meta Meta
195
User
Name Description Schema
UserListItem
Name Description Schema
196
UserListResponse
Name Description Schema
data The list of Users returned in a UserListResponse < UserListItem > array
errors Errors
meta Meta
UserResponse
Name Schema
data User
errors Errors
meta Meta
197
VLanInfo
Name Description Schema
DNS The DNS (Domain Name System) configuration for a VLAN DNS
ETH0RIPv2 The RIPv2 configuration for the ETH0 interface of a VLAN boolean
ETH0SubnetMa
The subnet mask for the ETH0 interface of a VLAN string
sk
PortForward The port forwarding configuration for a VLAN < PortForward > array
SAT0RIPv2 The RIPv2 configuration for the SAT0 interface of a VLAN boolean
SAT0SubnetMa
The subnet mask for the SAT0 interface of a VLAN string
sk
StaticRoutes The static routes configuration for a VLAN < StaticRoute > array
198
DHCP
DhcpMode The DHCP mode for the DHCP configuration of a VLAN integer (int32)
PrimaryDnsAd
The primary DNS address for the DHCP configuration of a VLAN string
dr
RelayServer The relay server for the DHCP configuration of a VLAN string
DNS
CacheSize The cache size for the DNS configuration of a VLAN integer (int64)
Enabled The enabled status for the DNS configuration of a VLAN boolean
FwdQSize The forward queue size for the DNS configuration of a VLAN integer (int64)
FwdTimeout The forward timeout for the DNS configuration of a VLAN integer (int64)
SecondaryNam
The secondary DNS name for a VLAN string
e
199
Security
basicAuth
The standard HTTP Basic Access Authentication is supported.
This is the preferred mechanism of user authorization and is in keeping with the RESTful philosophy of a
stateless web server. Each individual HTTP request must contain the Authorization HTTP header and the
server does not store any client state.
User credentials are passed with each request using standard Basic Access Authentication; which is an
HTTP header in the following form:
The user name, a colon, and password are concatenated and then Base64 encoded. The following is an
example of an actual Authorization header:
Note that the Base64 encoding is not intended to provide any security, but rather is used to avoid character
encoding issues and escape sequences within the user name or password.
More information about the HTTP Basic Access Authentication can be obtained from:
http://en.wikipedia.org/wiki/Basic_access_authentication
Type : basic
200
cookieAuth
For convenience, an HTTP cookie-based authentication mechanism is also supported. With this
authorization approach, separate requests must be made to login and obtain a session cookie, and then
logout when the session is no longer needed. Each subsequent request must contain the session cookie
obtained during log in.
Type : apiKey
Name : Session
In : HEADER
201
Appendix A
This appendix provides examples for the following dynamic APIs in the NMS-API:
• RemoteList on page 204
• MultiEdit on page 207
• MultiApply on page 210
RemoteList
RemoteList filters the response By NetworkID, InrouteGroupID, or DID.
example call
curl -s -k -u admin:admin -d ' { "NetworkId" : 35, "RespondWith"
: [ "NetModemId", "NetModemNam", "NetworkId", "InrouteGroupId",
"SN", "DID", "ModelType", "ActiveStatus", "InitTxPower",
"MaxTxPower", "1DB", "RemoteAntennaId", "Lat", "Lon"i, "BucId",
"LnbIds" ] } ' -iX GET
https://127.0.0.1:443/api/v1/evo/config/obj/remote
example response
{
"RespondWith": [],
"data": [
{
"NetModemId": 2414,
"NetModemName": "New Remote #2413",
"NetworkId": 35,
"InrouteGroupId": 65,
"SN": 23213,
"DID": 234904237,
"ModelType": 140,
"ActiveStatus": 1,
"InitTxPower": -25,
"MaxTxPower": -20,
"1DB": 0,
"RemoteAntennaId": 2298,
"Lat": 1.03417,
"Lon": 5.135,
"BucId": 28,
"LnbIds": "[40]"
},
{
"NetModemId": 2426,
"NetModemName": "New Remote #2426",
"NetworkId": 35,
"InrouteGroupId": 65,
"SN": 0,
"DID": 27262976,
"ModelType": 104,
"ActiveStatus": 0,
"InitTxPower": -25,
"MaxTxPower": 0,
"1DB": 0,
"RemoteAntennaId": 2306,
"Lat": 0,
"Lon": 0,
"BucId": 0,
"LnbIds": "[0]"
},
{
"NetModemId": 2459,
"NetModemName": "Copy of New Remote #2413",
"NetworkId": 35,
"InrouteGroupId": 65,
"SN": 0,
"DID": 234881024,
"ModelType": 140,
"ActiveStatus": 0,
"InitTxPower": -25,
"MaxTxPower": -20,
"1DB": 0,
"RemoteAntennaId": 2340,
"Lat": 1.03417,
"Lon": 5.135,
"BucId": 0,
"LnbIds": "[0]"
}
],
"meta": {
"count": 3
}
}
MultiEdit
One particular use case is to increase TxPower for a set of remotes by 0.5dB instead of setting
the absolute value to say -12.5dB. The Relative-object inside MultiEdit allows doing exactly
this to the TXPower and a set of other remote attributes.
example call
curl -v -s -k -u admin:admin -d ' { "data" : { "Type" : "Remote",
"Targets" : [ 12727, 12726, 12725, 12724, 12723, 12722, 12721, 12720,
12719, 12718, 12717, 12716, 12715, 12714, 12713, 12712, 12711, 12710,
12709, 12708, 12707, 12706, 12705, 12704, 12703, 12702, 12701, 12700,
12699, 12698 ], "Relative" : { "TXPower" : 0.5 } } } ' -iX PATCH
https://127.0.0.1:443/api/v1/evo/config/obj/multiedit/remote
This API also allows you to add or remove custom keys from the existing custom keys in the
options file.
example call
This call adds "[MOBILE]\nlatlong_interval=4\n" to specified remote instances.
curl -v -s -k -u admin:admin -d ' { "data" : { "Type" : "Remote",
"Targets" : [ 12727, 12726, 12725, 12724, 12723, 12722, 12721, 12720,
12719, 12718, 12717, 12716, 12715, 12714, 12713, 12712, 12711, 12710,
12709, 12708, 12707, 12706, 12705, 12704, 12703, 12702, 12701, 12700,
12699, 12698 ], "Relative" : { "AddToHubSideCustomKey" :
"[MOBILE]\nlatlong_interval=4\n" } } } ' -iX PATCH
https://127.0.0.1:443/api/v1/evo/config/obj/multiedit/remote
The following attributes are available for Relative fields:
Remote::InitialPower
Remote::MaxPower
Remote::OneDB
Remote::AntennaComponents::InitTXPowerOffset
Remote::RemoteQOS::DSRateShaping::MaxIR
Remote::RemoteQOS::DSRateShaping::CIR
Remote::RemoteQOS::DSRateShaping::Cost
Remote::RemoteQOS::DSRateShaping::MinIR
Remote::RemoteQOS::USRateShaping::MaxIR
Remote::RemoteQOS::USRateShaping::CIR
Remote::RemoteQOS::USRateShaping::Cost
Remote::RemoteQOS::USRateShaping::MinIR
AddToHubSideCustomKey
AddToRmtSideCustomKey
RemoveFromHubSideCustomKey
RemoveFromRmtSideCustomKey
The following attributes are available for Absolute - fields:
Remote::SN
Remote::DID
Remote::ModelType
Remote::InRouteGroupID
Remote::NetworkID
Remote::Active
Remote::MgmtIPAddress
Remote::MgmtSubnetMask
Remote::MgmtGateway
Remote::LanIPAddress
Remote::LanSubnetMask
Remote::LanGateway
Remote::RXCarrierID
Remote::TXCarrierID
Remote::TCPCompression
Remote::UDPHdrCompression
Remote::UDPCompression
Remote::CRTP
Remote::LinkEncryption
Remote::UpCIR
Remote::UpMIR
Remote::UpMIN
Remote::DownCIR
Remote::DownMIR
Remote::DownMIN
Remote::AntennaID
Remote::AntennaTxHandshake
Remote::IsMobile
Remote::SCPCPeerID
Remote::IsRoaming
Remote::InitialPower
Remote::MaxPower
Remote::OneDB
Remote::RxOnly
Remote::RxOnlyMulticast
Remote::RxOnlyMulticastTimeout
Remote::Mobile::Security
Remote::Mobile::Handshake
Remote::Mobile::GPSInput
Remote::Mobile::GPSRefreshRate
Remote::Mobile::SerialDevice
Remote::Mobile::SerialSettings
Remote::Mobile::COTMType
Remote::AddToHubSideCustomKey
Remote::AddToRmtSideCustomKey
MultiApply
data='{
"Targets" : [ 1194, 107, 1227, 1228, 1229, 1230 ],
"Actions" : {
"Transport": "tcp",
"RemoteSide": false,
"Reset": false
}
}'