Reports

Overview

Note: Reports is an extension and needs to be enabled before it can be used. If Designate returns a 404 error, ensure that the following line has been added to the designate.conf file:

enabled_extensions_v1 = reports, ...

Reports about things in the system

Get all tenants

GET /reports/tenants

Fetch all tenants

Example request:

GET /reports/tenants HTTP/1.1
Host: example.com
Accept: application/json
Content-Type: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
  "tenants": [{
      "domain_count": 2,
      "id": "71ee6d049a49435c8f7dd002cfe08d96"
  }]
}
Form Parameters:
 
  • tenants – List of tenants
Status Codes:

Report tenant resources

GET /reports/tenants/(tenant_id)

Report tenant resources

Example request:

GET /reports/tenants/3d8391080d4a4ec4b3eadf18e6b1539a HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "domain_count": 0,
    "domains": [],
    "id": "3d8391080d4a4ec4b3eadf18e6b1539a"
}
Parameters:
  • tenant_id (string) – Tenant Id to get reports for
Form Parameters:
 
  • domain_count – integer
  • domains – Server hostname
  • id – Tenant Id
Status Codes:

Report resource counts

GET /reports/counts

Report resource counts

Example request:

GET /reports/counts HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "domains": 0,
    "records": 0,
    "tenants": 0
}
Form Parameters:
 
  • domains – Domains count
  • records – Records count
  • tenants – Tenants count
Status Codes:

Report tenant counts

GET /reports/counts/tenants

Report tenant counts

Example request:

GET /reports/counts/tenants HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "tenants": 0
}
Form Parameters:
 
  • tenants – Tenants count
Status Codes:

Report domain counts

GET /reports/counts/domains

Report domain counts

Example request:

GET /reports/counts/domains HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "domains": 0
}
Form Parameters:
 
  • domains – Domains count
Status Codes:

Report record counts

GET /reports/counts/records

Report record counts

Example request:

GET /reports/counts/records HTTP/1.1
Host: example.com
Accept: application/json

Example response:

HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

{
    "records": 0
}
Form Parameters:
 
  • records – Records count
Status Codes: