IX-API
This API allows to config/change/delete Internet Exchange services.
Filters
When querying collections, the provided query parameters are validated. Unknown query parameters are ignored. Providing invalid filter values should yield a validation error.
- Homepage
- https://api.apis.guru/v2/specs/ix-api.net/2.1.0.json
- Provider
- ix-api.net
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/ix-api.net/2.1.0/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/ix-api.net/2.1.0/openapi.yaml
Tools (80)
Extracted live via the executor SDK.
-
accounts.accountsCreateCreate a new account.
-
accounts.accountsDestroyAccounts can be deleted, when all services and configs are decommissioned or the account is not longer referenced e.g. as a
managing_accountorbilling_account.Deleting an account will cascade to
contactsandrole-assignments.The request will immediately fail, if the above preconditions are not met.
-
accounts.accountsListRetrieve a list of
Accounts.This includes all accounts the currently authorized account is managing and the current account itself.
-
accounts.accountsPartialUpdateUpdate parts of an account.
-
accounts.accountsReadGet a single account.
-
accounts.accountsUpdateUpdate the entire account.
-
auth.authTokenCreateAuthenticate an API user identified by
api_keyandapi_secret. -
auth.authTokenRefreshReauthenticate the API user, issue a new
access_tokenandrefresh_tokenpair by providing therefresh_tokenin the request body. -
connections.connectionsListList all
connections. -
connections.connectionsReadRead a
connection. -
contacts.contactsCreateCreate a new contact.
-
contacts.contactsDestroyRemove a contact.
Please note, that a contact can only be removed if it is not longer in use in a network service or config through a role assignment.
-
contacts.contactsListList available contacts managed by the authorized account.
-
contacts.contactsPartialUpdateUpdate parts of a contact
-
contacts.contactsReadGet a contact by it's id
-
contacts.contactsUpdateUpdate a contact
-
devices.devicesListList available devices
-
devices.devicesReadGet a specific device identified by id
-
facilities.facilitiesListGet a (filtered) list of
facilities. -
facilities.facilitiesReadRetrieve a facility by id
-
health.apiHealthReadGet the IX-API service health status.
-
implementation.apiImplementationReadGet the API implementation details.
-
ips.ipsCreateAdd an ip host address or network prefix.
-
ips.ipsListList all ip addresses (and prefixes).
-
ips.ipsPartialUpdateUpdate parts of an ip address.
As with the
PUTopertaion, IP addresses, where you don't have update rights, will yield aresource access deniederror when attempting an update.If the ip address was allocated for you, you might not be able to change anything but the
fqdn. -
ips.ipsReadGet a single ip addresses by it's id.
-
ips.ipsUpdateUpdate an ip address object.
You can only update IP addresses within your current scope. Not all addresses you can read you can update.
If the ip address was allocated for you, you might not be able to change anything but the
fqdn. -
macs.macsCreateRegister a mac address.
-
macs.macsDestroyRemove a mac address.
-
macs.macsListList all mac addresses managed by the authorized customer.
-
macs.macsReadGet a single mac address by it's id.
-
memberJoiningRules.memberJoiningRulesCreateCreate a member joining rule
-
memberJoiningRules.memberJoiningRulesDestroyDelete a joining rule
-
memberJoiningRules.memberJoiningRulesListGet a list of joining rules
-
memberJoiningRules.memberJoiningRulesPartialUpdatePartially update a joining rule
-
memberJoiningRules.memberJoiningRulesReadGet a single rule
-
memberJoiningRules.memberJoiningRulesUpdateUpdate a joining rule
-
metroAreaNetworks.metroAreaNetworksListList all MetroAreaNetworks
-
metroAreaNetworks.metroAreaNetworksReadRetrieve a MetroAreaNetwork
-
metroAreas.metroAreasListList all MetroAreas
-
metroAreas.metroAreasReadGet a single MetroArea
-
networkFeatureConfigs.networkFeatureConfigsCreateCreate a configuration for a
NetworkFeaturedefined in theNetworkFeatures collection. -
networkFeatureConfigs.networkFeatureConfigsDestroyRemove a network feature config.
The network feature config will be marked as
decommission_requested. Decommissioning a network feature config will not cascade to related services or service configs. -
networkFeatureConfigs.networkFeatureConfigsListGet all network feature configs.
-
networkFeatureConfigs.networkFeatureConfigsPartialUpdateUpdate parts of a network feature configuration
-
networkFeatureConfigs.networkFeatureConfigsReadGet a single network feature config.
-
networkFeatureConfigs.networkFeatureConfigsUpdateUpdate a network feature configuration
-
networkFeatures.networkFeaturesListList available network features.
-
networkFeatures.networkFeaturesReadGet a single network feature by it's id.
-
networkServiceConfigs.networkServiceConfigCancellationPolicyReadThe cancellation-policy can be queried to answer the questions:
If I cancel my subscription, when will it be technically decommissioned? If I cancel my subscription, until what date will I be charged?
When the query parameter
decommision_atis not provided it will provide the first possible cancellation date and charge period if cancelled at above date.The granularity of the date field is a day, the start and end of which are to be interpreted by the IXP (some may use UTC, some may use their local time zone).
-
networkServiceConfigs.networkServiceConfigsCreateCreate a
network-service-config. -
networkServiceConfigs.networkServiceConfigsDestroyRequest decommissioning the network service configuration.
The network service config will assume the state
decommission_requested. This will cascade to related resources likenetwork-feature-configs. -
networkServiceConfigs.networkServiceConfigsListGet all
network-service-configs. -
networkServiceConfigs.networkServiceConfigsPartialUpdateUpdate parts of an exisiting
network-service-config. -
networkServiceConfigs.networkServiceConfigsReadGet a
network-service-config -
networkServiceConfigs.networkServiceConfigsUpdateUpdate an exisiting
network-service-config -
networkServices.networkServiceCancellationPolicyReadThe cancellation-policy can be queried to answer the questions:
If I cancel my service, when will it be technically decommissioned? If I cancel my service, until what date will I be charged?
When the query parameter
decommision_atis not provided it will provide the first possible cancellation date and charge period if cancelled at above date.The granularity of the date field is a day, the start and end of which are to be interpreted by the IXP (some may use UTC, some may use their local time zone).
-
networkServices.networkServiceChangeRequestCreateRequest a change to the network service.
A participant in a network service of type
p2p_vccan issue a change request, expressing a desired change in the capacity. The change is accepted when all sides have configured the network service configs with the new bandwidth. These changes can sometimes require a change of the product offering. The product offering may only differ in regards to bandwidth.The network service will change it's state from
productionintoproduction_change_pending.Only one change request may be issued at a time.
-
networkServices.networkServiceChangeRequestDestroyRetract or reject a change to the network service.
-
networkServices.networkServiceChangeRequestReadGet the change request.
-
networkServices.networkServicesCreateCreate a new network service
-
networkServices.networkServicesDestroyRequest decomissioning of the network service.
The network service will enter the state of
decommission_requested. The request will cascade to related network service and feature configs.An optional request body can be provided to request a specific service termination date.
If no date is given in the request body, it is assumed to be the earliest possible date.
Possible values for
decommission_atcan be queried through thenetwork_service_cancellation_policy_readoperation.The response will contain the dates on which the changes will be effected.
-
networkServices.networkServicesListList available
NetworkServices. -
networkServices.networkServicesPartialUpdatePartially update a network service
-
networkServices.networkServicesReadGet a specific
network-serviceby id. -
networkServices.networkServicesUpdateUpdate a network service
-
pops.popsListList all PoPs
-
pops.popsReadGet a single point of presence
-
ports.portsListList all ports.
-
ports.portsReadRetrieve a port.
-
productOfferings.productOfferingsListList all (filtered) products-offerings available on the platform
-
productOfferings.productOfferingsReadGet a single products-offering by id.
-
roleAssignments.roleAssignmentsCreateAssign a
Roleto aContact.The contact needs to have all fields filled, which the role requires. If this is not the case a
400UnableToFulfillwill be returned. -
roleAssignments.roleAssignmentsDestroyRemove a role assignment from a contact.
If the contact is still in use with a given role required, this will yield an
UnableToFulfillerror. -
roleAssignments.roleAssignmentsListList all role assignments for a contact.
-
roleAssignments.roleAssignmentsReadGet a role assignment for a contact.
-
roles.rolesListList all roles available.
-
roles.rolesReadGet a single
Role. -
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools