Download OpenAPI specification:Download
The IONOS Billing API is a REST API that can be used to retrieve information about resource usage and invoices. Please note that only Contract Holders can log in and retrieve data. Information on usage is provided without liability.
The following features have been added to the Billing API:
401 Unauthorized
and 403 Forbidden
)subsidiary
field anymore/{contractId}/invoices
returns amount of each invoice (if permissions allow)deprecated
field that points out if the product item is considered as deprecatedLocation | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | A01000 | 30d per static IP address | 30 days |
EU / US | C01000 | 1h core AMD | 1 hour |
EU | C010EU | 1h core AMD - EU | 1 hour |
US | C010US | 1h core AMD - US | 1 hour |
EU / US | C02000 | 1h core Intel Broadwell (+1 hyperthread core) | 1 hour |
EU / US | C03000 | 1h core Intel Skylake (+1 hyperthread core) | 1 hour |
EU / US | C04000 | 1h core Intel Ice Lake (+1 hyperthread core) | 1 hour |
EU / US | C05000 | 1h core AMD EPYC (+1 hyperthread core) | 1 hour |
EU / US | CW1000 | 1 MS core - per hour | 1 hour |
EU / US | CW1000 | 1 MS core - per hour | 1 hour |
EU | CW10EU | 1 MS core - per hour EU | 1 hour |
US | CW10US | 1 MS core - per hour US | 1 hour |
EU / US | R01000 | 1h per GB RAM | 1G * 1 hour |
EU | R010EU | 1h per GB RAM - EU | 1G * 1 hour |
US | R010US | 1h per GB RAM - US | 1G * 1 hour |
EU / US | CWSQL1001 | 1h per 2 cores License MS SQL Standard | 1hour |
EU / US | CWSQL2001 | 1h per 2 cores License MS SQL Enterprise | 1hour |
EU / US | CWSQL3001 | 1h per 2 cores License MS SQL Web | 1hour |
EU / US | NAT1000 | 1h per NAT | 1 hour |
EU / US | NLB1000 | 1h of first 5 forwarding rules for network load balancer | 1 hour |
EU / US | NLB1100 | 1h of additional forwarding rule for network load balancer | 1 hour |
EU / US | ALB1000 | 1h of first 5 forwarding rules for application load balancer | 1 hour |
EU / US | ALB1100 | 1h of additional forwarding rule for application load balancer | 1 hour |
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | S01000 | 30d per 1 GB HDD Storage | 1 GB * 30 days |
EU / US | S02000 | 30d per 1 GB SSD Storage Premium | 1 GB * 30 days |
EU / US | S03000 | 30d per 1 GB HDD Snapshot | 1 GB * 30 days |
EU / US | S05000 | 30d per 1 GB SSD Storage Standard | 1 GB * 30 days |
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | CUBExxxx * | 1h of IONOS cloud Cubes with a certain configuration | 1 hour |
EU / US | CC1000 ** | 1h Cubes core | 1 hour |
EU / US | CR1000 ** | 1h per GB Cubes RAM | 1G * 1 hour |
EU / US | DAS1000 ** | 30d per 1 GB Cubes Directly Attached Storage | 1 GB * 30 days |
*) Dynamically generated product item (e.g. CUBE1100
, CUBE1200
etc.), it references to a certain CUBE template (VM preset with overprovisioning)
**) Non-billable items, provided just for estimation the consuming
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU | BU1100 | 30d per 1GB Backup Storage for Orphaned Backup | 1 GB * 30 days |
EU | BU1200 | 30d per 1GB Backup Storage for Win. or Mac WS Backup | 1 GB * 30 days |
EU | BU1300 | 30d per 1GB Backup Storage for Win. or Linux Server Backup | 1 GB * 30 days |
EU | BU1400 | 30d per 1GB Backup Storage for Virtual Machine Backup | 1 GB * 30 days |
EU | BU1500 | 30d per 1GB Backup Storage for Office365 | 1 GB * 30 days |
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU | S3AU1100 | Count of PUT/COPY/POST/LOST Object Storage API request per 1,000 calls | 1,000 calls |
EU | S3AU1200 | Count of GET Object Storage API request per 10,000 calls | 10,000 calls |
EU | S3AU1300 | Count of DELETE Object Storage API request per 10,000 calls | 10,000 calls |
EU | S3SU1100 | 30d per 1 GB IONOS Object Storage for first 50 TB | 1 GB x 30 days |
EU | S3SU1200 | 30d per 1 GB IONOS Object Storage for next 450 TB | 1 GB x 30 days |
EU | S3SU1300 | 30d per 1 GB IONOS Object Storage above 500 TB | 1 GB x 30 days |
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | CTI1000 | 1 GB cumulative traffic inbound | 1 GB |
EU / US | CTO1100 | 1 GB cumulative traffic outbound for first 10 TB | 1 GB |
EU / US | CTO1200 | 1 GB cumulative traffic outbound for next 40 TB | 1 GB |
EU / US | CTO1300 | 1 GB cumulative traffic outbound for next 100 TB | 1 GB |
EU / US | CTO1400 | 1 GB cumulative traffic outbound for above 150 TB | 1 GB |
These values report total traffic for Virtual Data Centers and IONOS Object Storage.
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | TI1000 | 1 GB traffic inbound | 1 GB |
EU / US | TO1000 | 1 GB traffic outbound | 1 GB |
EU | S3TI1000 | 1 GB Object Storage total traffic inbound | 1 GB |
EU | S3TO1000 | 1 GB Object Storage total traffic outbound | 1 GB |
Location | MeterID | Meter Description | Unit |
---|---|---|---|
EU / US | WL1000 | 1h per core AMD MS Windows license | 1 hour |
EU / US | WL2000 | 1h per core Intel MS Windows license Intel (+1 hyper-thread core) | 1 hour |
EU / US | WL3000 | 1h per core AMD MS Windows 2016 license | 1 hour |
EU / US | WL4000 | 1h per core Intel MS Windows 2016 license Intel (+1 hyper-thread core) | 1 hour |
EU / US | WL5000 | 1h per Cube core MS Windows license | 1 hour |
EU / US | WL6000 | 1h per Cube core MS Windows 2016 license | 1 hour |
Returns provisioning itemized data for a current month
contract required | string <int32> [0-9]{5,10} Contract number |
{- "metadata": {
- "customerId": "112505406",
- "contractId": "031805900",
- "period": "2020-01"
}, - "datacenters": [
- {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "name": "Main VDC",
- "data": [
- {
- "resourceType": "SERVER",
- "resourceUUID": "504b4dff-56e3-49cd-89b1-dbed716c6265",
- "intervalMin": 44640,
- "intervalDivisor": 60,
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-31T23:59:59.999Z",
- "itemStub": "C01000",
- "value": 2,
- "valueDivisor": 1,
- "additionalParameters": "AMD_OPTERON"
}
]
}
], - "evnCSV": [
- "contractId,VDCUUID,VDCName,ResourceType,ResourceUUID,IntervalMin,IntervalDivisor,From,To,ItemStub,Value,ValueDivisor,Additional Parameters",
- "31805900,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,SERVER,504b4dff-56e3-49cd-89b1-dbed716c6265,44640,60,2020-01-01T00:00:00.000Z,2020-01-31T23:59:59.999Z,C01000,2,1,AMD_OPTERON"
]
}
Returns provisioning itemized data for a certain period
contract required | string <int32> [0-9]{5,10} Contract number |
period required | string or null^(\d{4}-\d{2}|null)$ Example: 2020-01 Period of interest in format YYYY-MM |
{- "metadata": {
- "customerId": "112505406",
- "contractId": "031805900",
- "period": "2020-01"
}, - "datacenters": [
- {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "name": "Main VDC",
- "data": [
- {
- "resourceType": "SERVER",
- "resourceUUID": "504b4dff-56e3-49cd-89b1-dbed716c6265",
- "intervalMin": 44640,
- "intervalDivisor": 60,
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-31T23:59:59.999Z",
- "itemStub": "C01000",
- "value": 2,
- "valueDivisor": 1,
- "additionalParameters": "AMD_OPTERON"
}
]
}
], - "evnCSV": [
- "contractId,VDCUUID,VDCName,ResourceType,ResourceUUID,IntervalMin,IntervalDivisor,From,To,ItemStub,Value,ValueDivisor,Additional Parameters",
- "31805900,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,SERVER,504b4dff-56e3-49cd-89b1-dbed716c6265,44640,60,2020-01-01T00:00:00.000Z,2020-01-31T23:59:59.999Z,C01000,2,1,AMD_OPTERON"
]
}
Returns a list of all invoices.
contract required | string <int32> [0-9]{5,10} Contract number |
{- "metadata": {
- "contractId": "031805900",
- "customerId": "112505406",
- "reference": "31805900"
}, - "invoices": [
- {
- "id": "GY00101408",
- "date": "2020-01",
- "amount": 10.76,
- "unit": "EUR"
}
]
}
Returns the invoice for a given invoice ID.
contract required | string <int32> [0-9]{5,10} Contract number |
id required | string Invoice ID |
dateformat | string Vendor date format |
{- "metadata": {
- "invoiceId": "GY00012345",
- "contractId": "318002123",
- "customerId": "112345678",
- "createdDate": "2020-02-05T04:00:00",
- "startDate": "2020-01-01",
- "endDate": "2020-01-31",
- "postingPeriod": "2020-01",
- "finallyPosted": true,
- "reference": "123456|111",
- "resellerRef": "bricksonline"
}, - "datacenters": [
- {
- "id": "54eb1ed9-06f5-4bfb-a4f0-07cc373f5ee1",
- "name": "Main VDC",
- "location": "EU",
- "productGroup": "PG 1",
- "meters": [
- {
- "meterId": "C010EU",
- "meterDesc": "1h core AMD - EU",
- "productGroup": "PG 1",
- "quantity": {
- "quantity": 12960,
- "unit": "1hour"
}, - "rate": {
- "quantity": 2.94,
- "unit": "EUR"
}, - "amount": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
], - "rebate": {
- "amount": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
}
], - "total": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
Returns invoices of billing profiles of a use.
period required | string^\d{4}-\d{2}$ Example: 2020-01 Period of interest in format YYYY-MM |
contractid | string Filter out the exact contractID |
dateformat | string Vendor date format |
[- {
- "metadata": {
- "invoiceId": "GY00012345",
- "contractId": "318002123",
- "customerId": "112345678",
- "createdDate": "2020-02-05T04:00:00",
- "startDate": "2020-01-01",
- "endDate": "2020-01-31",
- "postingPeriod": "2020-01",
- "finallyPosted": true,
- "reference": "123456|111",
- "resellerRef": "bricksonline"
}, - "datacenters": [
- {
- "id": "54eb1ed9-06f5-4bfb-a4f0-07cc373f5ee1",
- "name": "Main VDC",
- "location": "EU",
- "productGroup": "PG 1",
- "meters": [
- {
- "meterId": "C010EU",
- "meterDesc": "1h core AMD - EU",
- "productGroup": "PG 1",
- "quantity": {
- "quantity": 12960,
- "unit": "1hour"
}, - "rate": {
- "quantity": 2.94,
- "unit": "EUR"
}, - "amount": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
], - "rebate": {
- "amount": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
}
], - "total": {
- "quantity": 2.94,
- "unit": "EUR"
}
}
]
Get a high-granularity list of utilization resources for current month by default
contract required | string <int32> [0-9]{5,10} Contract number |
ip | boolean Provide report grouped by IPs |
output | string Default: "all" Enum: "all" "obj" "arr" "csv" The output format (object, array, CSV or all of them) |
{- "type": "vdc",
- "trafficObj": {
- "ip": [
- {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "vdcName": "Main VDC",
- "ip": "157.97.107.158",
- "dates": [
- {
- "Date": "2019-08-01",
- "In": "0.7254719333723187",
- "Out": "0.22908576484769583"
}, - {
- "Date": "2019-08-02",
- "In": "1.2738572908565402",
- "Out": "0.24987032916396856"
}, - {
- "Date": "2019-08-03",
- "In": "0.3472602190449834",
- "Out": 0.23526559863239527
}
]
}, - {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "vdcName": "Main VDC",
- "ip": "157.97.107.157",
- "dates": [
- {
- "Date": "2019-08-01",
- "In": "0.0443666810169816",
- "Out": "0.15891019999980927"
}, - {
- "Date": "2019-08-02",
- "In": "0.04538741987198591",
- "Out": "0.16538945399224758"
}, - {
- "Date": "2019-08-03",
- "In": "0.04669629875570536",
- "Out": "0.16466102469712496"
}
]
}
]
}, - "trafficArr": [
- [
- "In/Out",
- "VDC UUID",
- "VDC Name",
- "IP",
- "2019-08-01",
- "2019-08-02",
- "2019-08-03"
], - [
- "In",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.158",
- "0.7254719333723187",
- "1.2738572908565402",
- "0.3472602190449834"
], - [
- "Out",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.158",
- "0.22908576484769583",
- "0.24987032916396856",
- "0.23526559863239527"
], - [
- "In",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.157",
- "0.0443666810169816",
- "0.04538741987198591",
- "0.04669629875570536"
], - [
- "Out",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.157",
- "0.15891019999980927",
- "0.16538945399224758",
- "0.16466102469712496"
]
], - "traffic": [
- "In/Out,VDC UUID,VDC Name,IP,2019-08-01,2019-08-02,2019-08-03",
- "In,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.158,0.7254719333723187,1.2738572908565402,0.3472602190449834",
- "Out,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.158,0.22908576484769583,0.24987032916396856,0.23526559863239527",
- "In,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.157,0.0443666810169816,0.04538741987198591,0.04669629875570536",
- "Out,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.157,0.15891019999980927,0.16538945399224758,0.16466102469712496"
]
}
Get a high-granularity list of utilization resources for a certain period
contract required | string <int32> [0-9]{5,10} Contract number |
period required | string or null^(\d{4}-\d{2}|null)$ Example: 2020-01 Period of interest in format YYYY-MM |
ip | boolean Provide report grouped by IPs |
output | string Default: "all" Enum: "all" "obj" "arr" "csv" The output format (object, array, CSV or all of them) |
{- "type": "vdc",
- "trafficObj": {
- "ip": [
- {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "vdcName": "Main VDC",
- "ip": "157.97.107.158",
- "dates": [
- {
- "Date": "2019-08-01",
- "In": "0.7254719333723187",
- "Out": 0.22908576484769583
}, - {
- "Date": "2019-08-02",
- "In": "1.2738572908565402",
- "Out": 0.24987032916396856
}, - {
- "Date": "2019-08-03",
- "In": "0.3472602190449834",
- "Out": 0.23526559863239527
}
]
}, - {
- "vdcUUID": "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "vdcName": "Main VDC",
- "ip": "157.97.107.157",
- "dates": [
- {
- "Date": "2019-08-01",
- "In": 0.0443666810169816,
- "Out": 0.15891019999980927
}, - {
- "Date": "2019-08-02",
- "In": 0.04538741987198591,
- "Out": 0.16538945399224758
}, - {
- "Date": "2019-08-03",
- "In": 0.04669629875570536,
- "Out": 0.16466102469712496
}
]
}
]
}, - "trafficArr": [
- [
- "In/Out",
- "VDC UUID",
- "VDC Name",
- "IP",
- "2019-08-01",
- "2019-08-02",
- "2019-08-03"
], - [
- "In",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.158",
- "0.7254719333723187",
- "1.2738572908565402",
- "0.3472602190449834"
], - [
- "Out",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.158",
- "0.22908576484769583",
- "0.24987032916396856",
- "0.23526559863239527"
], - [
- "In",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.157",
- "0.0443666810169816",
- "0.04538741987198591",
- "0.04669629875570536"
], - [
- "Out",
- "f2c2edf6-49f7-4687-8100-872b4d02ddcc",
- "Main VDC",
- "157.97.107.157",
- "0.15891019999980927",
- "0.16538945399224758",
- "0.16466102469712496"
]
], - "traffic": [
- "In/Out,VDC UUID,VDC Name,IP,2019-08-01,2019-08-02,2019-08-03",
- "In,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.158,0.7254719333723187,1.2738572908565402,0.3472602190449834",
- "Out,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.158,0.22908576484769583,0.24987032916396856,0.23526559863239527",
- "In,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.157,0.0443666810169816,0.04538741987198591,0.04669629875570536",
- "Out,f2c2edf6-49f7-4687-8100-872b4d02ddcc,Main VDC,157.97.107.157,0.15891019999980927,0.16538945399224758,0.16466102469712496"
]
}
Get a high-granularity data of resources utilization
contract required | string <int32> [0-9]{5,10} Contract number |
dc | string <uuid> Filter out by particular VDC UUID (or "Bucket" UUID for non-vdc related resources) |
resource | string <uuid> Filter out by particular resource UUID (e.g.VM UUID, NIC UUID) |
type | string (ResourceTypes) Enum: "SERVER" "STORAGE" "SNAPSHOT" "NATGATEWAY" "NIC" "IP" "IP_ADDRESS" "CUBETEMPLATE" "LOADBALANCER" "BACKUP" "S3" "TRAFFIC" "DB" "BMC" "DBAAS" "CRAAS" "LAAS" "DSAAS" "DNS" Filter out by particular type of items |
{- "startDate": "2020-01-01",
- "endDate": "2020-01-12",
- "datacenters": [
- {
- "id": "ad34b997-43c7-4666-889b-57acbeaeeb8b",
- "name": "Standard-Image",
- "meters": [
- {
- "id": "2f01dc10-0e81-4521-b80e-1a2c1465f041",
- "resourceId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "Main server",
- "type": "SERVER",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "C01000",
- "meterDesc": "1h core AMD",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1hour"
}
}, - {
- "id": "1f0d5077-256a-4316-bad5-53a5fccd72e5",
- "resourceId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "Main server",
- "type": "SERVER",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "R01000",
- "meterDesc": "1h per GB RAM",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*1hour"
}
}, - {
- "id": "3a580d13-54b9-4a98-a5bf-707dcb956f78",
- "resourceId": "7cae1937-8f4f-416c-8aaf-9808b1e54d69",
- "serverId": null,
- "name": "HDD default",
- "type": "STORAGE",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "S01000",
- "meterDesc": "30d per 1GB HDD Storage",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*30Days"
}
}, - {
- "id": "fbb4f4e4-70f6-4026-b205-c200a2a19872",
- "resourceId": "48190e9b-1f66-4f64-8530-ee2227cab0f3",
- "serverId": null,
- "name": "",
- "type": "NIC",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "NC1000",
- "meterDesc": "",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": ""
}
}, - {
- "id": "7e24a19b-d310-4e7e-99ee-e76b89116d42",
- "resourceId": "48190e9b-1f66-4f64-8530-ee2227cab0f3",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "",
- "type": "TRAFFIC",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-01T23:59:59.999Z",
- "exists": null,
- "meterId": "TO1000",
- "meterDesc": "1GB traffic outbound",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1GB"
}
}
]
}, - {
- "id": "d278bce0-7221-4d72-aeb3-e81a19374cfd",
- "name": "Default",
- "meters": [
- {
- "id": "86263665-8ce4-4d6c-ae26-58a2cecc2974",
- "resourceId": "4ce6d055-99a2-47c7-9416-ad681aaa6015",
- "serverId": null,
- "name": "Main server snapshot 10.01.2020",
- "type": "SNAPSHOT",
- "from": "2020-01-10T13:11:47.367Z",
- "to": "2020-01-11T15:07:13.498Z",
- "exists": false,
- "meterId": "S03000",
- "meterDesc": "30d per 1GB HDD Snapshot",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*30Days"
}
}
]
}
], - "metadata": {
- "contractId": "031865123",
- "customerId": "112565225",
- "reference": "31865123"
}
}
Get a high-granularity data of resources utilization for a certain period
contract required | string <int32> [0-9]{5,10} Contract number |
period required | string or null^(\d{4}-\d{2}|null)$ Example: 2020-01 Period of interest in format YYYY-MM |
dc | string <uuid> Filter out by particular VDC UUID (or "Bucket" UUID for non-vdc related resources) |
resource | string <uuid> Filter out by particular resource UUID (e.g.VM UUID, NIC UUID) |
type | string (ResourceTypes) Enum: "SERVER" "STORAGE" "SNAPSHOT" "NATGATEWAY" "NIC" "IP" "IP_ADDRESS" "CUBETEMPLATE" "LOADBALANCER" "BACKUP" "S3" "TRAFFIC" "DB" "BMC" "DBAAS" "CRAAS" "LAAS" "DSAAS" "DNS" Filter out by particular type of items |
{- "startDate": "2020-01-01",
- "endDate": "2020-01-12",
- "datacenters": [
- {
- "id": "ad34b997-43c7-4666-889b-57acbeaeeb8b",
- "name": "Standard-Image",
- "meters": [
- {
- "id": "2f01dc10-0e81-4521-b80e-1a2c1465f041",
- "resourceId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "Main server",
- "type": "SERVER",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "C01000",
- "meterDesc": "1h core AMD",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1hour"
}
}, - {
- "id": "1f0d5077-256a-4316-bad5-53a5fccd72e5",
- "resourceId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "Main server",
- "type": "SERVER",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "R01000",
- "meterDesc": "1h per GB RAM",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*1hour"
}
}, - {
- "id": "3a580d13-54b9-4a98-a5bf-707dcb956f78",
- "resourceId": "7cae1937-8f4f-416c-8aaf-9808b1e54d69",
- "serverId": null,
- "name": "HDD default",
- "type": "STORAGE",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "S01000",
- "meterDesc": "30d per 1GB HDD Storage",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*30Days"
}
}, - {
- "id": "fbb4f4e4-70f6-4026-b205-c200a2a19872",
- "resourceId": "48190e9b-1f66-4f64-8530-ee2227cab0f3",
- "serverId": null,
- "name": "",
- "type": "NIC",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-12T23:59:59.999Z",
- "exists": true,
- "meterId": "NC1000",
- "meterDesc": "",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": ""
}
}, - {
- "id": "7e24a19b-d310-4e7e-99ee-e76b89116d42",
- "resourceId": "48190e9b-1f66-4f64-8530-ee2227cab0f3",
- "serverId": "83debc7b-fbee-4c69-83a9-df57bb186726",
- "name": "",
- "type": "TRAFFIC",
- "from": "2020-01-01T00:00:00.000Z",
- "to": "2020-01-01T23:59:59.999Z",
- "exists": null,
- "meterId": "TO1000",
- "meterDesc": "1GB traffic outbound",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1GB"
}
}
]
}, - {
- "id": "d278bce0-7221-4d72-aeb3-e81a19374cfd",
- "name": "Default",
- "meters": [
- {
- "id": "86263665-8ce4-4d6c-ae26-58a2cecc2974",
- "resourceId": "4ce6d055-99a2-47c7-9416-ad681aaa6015",
- "serverId": null,
- "name": "Main server snapshot 10.01.2020",
- "type": "SNAPSHOT",
- "from": "2020-01-10T13:11:47.367Z",
- "to": "2020-01-11T15:07:13.498Z",
- "exists": false,
- "meterId": "S03000",
- "meterDesc": "30d per 1GB HDD Snapshot",
- "region": "de/txl",
- "quantity": {
- "quantity": "xxx.xx",
- "unit": "1G*30Days"
}
}
]
}
], - "metadata": {
- "contractId": "031865123",
- "customerId": "112565225",
- "reference": "31865123"
}
}
Returns a list of products available for the given contract (only billable and active)
contract required | string <int32> [0-9]{5,10} contract number |
{- "metadata": {
- "contractId": "031805900",
- "customerId": "112505406",
- "reference": "31805900"
}, - "liability": "Please double check your contract for prices.",
- "products": [
- {
- "meterId": "C01000",
- "meterDesc": "1h core AMD",
- "unit": "1hour",
- "unitCost": {
- "quantity": "0.02",
- "unit": "EUR"
}
}
]
}
Returns the usage of a contract
contract required | string <int32> [0-9]{5,10} Contract number |
period | string^\d{4}-\d{2}$ Period of interest in format YYYY-MM (current month by default if not specified) |
{- "startDate": "2020-01-01",
- "endDate": "2020-01-12",
- "datacenters": [
- {
- "id": "ad34b997-43c7-4666-889b-57acbeaeeb8b",
- "name": "Main VDC",
- "location": "EU",
- "meters": [
- {
- "meterId": "C01000",
- "meterDesc": "1h core AMD",
- "quantity": {
- "quantity": "742.00",
- "unit": "1hour"
}
}
]
}
], - "metadata": {
- "contractId": "031805900",
- "customerId": "112505406",
- "reference": "31805900"
}
}
Returns the usage of a contract for a given data-center
contract required | string <int32> [0-9]{5,10} Contract number |
dc required | string or null^([a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4... Example: ad34b997-43c7-4666-889b-57acbeaeeb8b Get data for the particular data-center ID (VDC UUID) |
period | string^\d{4}-\d{2}$ Period of interest in format YYYY-MM (current month by default if not specified) |
{- "startDate": "2020-01-01",
- "endDate": "2020-01-12",
- "datacenters": [
- {
- "id": "ad34b997-43c7-4666-889b-57acbeaeeb8b",
- "name": "Main VDC",
- "location": "EU",
- "meters": [
- {
- "meterId": "C01000",
- "meterDesc": "1h core AMD",
- "quantity": {
- "quantity": "742.00",
- "unit": "1hour"
}
}
]
}
], - "metadata": {
- "contractId": "031805900",
- "customerId": "112505406",
- "reference": "31805900"
}
}