You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 9
Next »
Get / Update / Execute / Delete reports
Authentication: Basic authentication
Authorization: Any user allowed using Reports, see:
curl -u username:password https://<dpod hostname>/op/api/v2/reports/{{productView}}
GET Retrieve All Reports
/op/api/v2/reports/{{productView}}
URL:
GET - https://{{dpodHostname}}/op/api/v2/reports/{{productView}}
Request - None.
Parameters:
Parameter | Value | Description | Parameter Type | Data Type |
|---|
productView | required | Product view APIC / IDG | path | APIC / IDG |
Authorization:
Authentication Type | Required Permissions | More info |
|---|
Basic Auth | View or Edit report Access permissions for required product
| See roles information here: Role Based Access Control |
Response:
Response Type | Value | Description |
|---|
Successful |
{
"resultCode": "SUCCESS",
"resultMessage": "Reports retrieved successfully",
"result": {
"reports": [{
"name": "API Latency Report",
"description": "API Latency",
"productView": "APIC",
"apiReference": "1B1925B3-EAE0-4E4A-97B6-78AD13EDE856",
"indexSets": "apic-log",
"documentType": "APIC_LOGICAL_TRANS",
"jsonQuery": "{\"query\":{\"bool\":{\"must\":{\"match_all\":{}},... }",
"schedule": "",
"recipients": [],
"adHocFilterTypes": ["TIME", "DEVICE",....],
"filtersParameters": { "timeRangeType": "recent",.....},
"lastUpdateTimeInMillis": 1646655197926,
"lastUpdateUserName": "admin",
"esHeadersDictionary": ""
}
]
}
}
| resultCode → SUCCESS resultMessage → “Reports retrieved successfully” result → list of all reports and their data. For report parameters info click here: Reports REST API - Message Structure |
GET Get Specific Report Details
/op/api/v2/report/{{productView}}/{{reportApiReferenceId}}
URL:
GET - https://{{dpodHostname}}/op/api/v2/reports/{{productView}}/{{reportApiReferenceId}}
Request - None.
Parameters:
Parameter | Value | Description | Parameter Type | Data Type |
|---|
productView | required | Product view APIC / IDG | path | APIC / IDG |
reportApiReferenceId | required | The report apiReferenceId (can be retrieved from “Retrieved all reports” response) | path | UUID |
Authorization:
Authentication Type | Required Permissions | More info |
|---|
Basic Auth | View or Edit report Access permissions for required product related to the report
| See roles information here: Role Based Access Control |
Response:
Response Type | Value | Description |
|---|
Successful |
{
"resultCode": "SUCCESS",
"resultMessage": "Report retrieved successfully",
"result": {
"name": "API Latency Report",
"description": "API Latency",
"productView": "APIC",
"apiReference": "1B1925B3-EAE0-4E4A-97B6-78AD13EDE856",
"indexSets": "apic-log",
"documentType": "APIC_LOGICAL_TRANS",
"jsonQuery": "{\"query\":{\"bool\":{\"must\":{\"match_all\":{}},... }",
"schedule": "",
"recipients": [],
"adHocFilterTypes": ["TIME", "DEVICE",....],
"filtersParameters": { "timeRangeType": "recent",.....},
"lastUpdateTimeInMillis": 1644768927839,
"lastUpdateUserName": "Installer",
"esHeadersDictionary": ""
}
}
| resultCode → SUCCESS resultMessage → “Report retrieved successfully” result → The report data. For report parameters info click here: Reports REST API - Message Structure |
Get / Update / Execute / Delete reports
Authentication: Basic authentication
Authorization: Any user allowed using Reports, see:
curl -u username:password https://<dpod hostname>/op/api/v2/reports/{{productView}}
GET Retrieve All Reports
/op/api/v2/reports/{{productView}}
URL:
GET - https://{{dpodHostname}}/op/api/v2/reports/{{productView}}
Parameters:
Parameter | Value | Description | Parameter Type | Data Type |
|---|
productView | required | Product view APIC / IDG | path | APIC / IDG |
Authorization:
Authentication Type | Required Permissions | More info |
|---|
Basic Auth | View or Edit report Access permissions for required product
| See roles information here: Role Based Access Control |
Response:
Response Type | Value | Description |
|---|
Successful |
{
"resultCode": "SUCCESS",
"resultMessage": "Reports retrieved successfully",
"result": {
"reports": [{
"name": "API Latency Report",
"description": "API Latency",
"productView": "APIC",
"apiReference": "1B1925B3-EAE0-4E4A-97B6-78AD13EDE856",
"indexSets": "apic-log",
"documentType": "APIC_LOGICAL_TRANS",
"jsonQuery": "{\"query\":{\"bool\":{\"must\":{\"match_all\":{}},... }",
"schedule": "",
"recipients": [],
"adHocFilterTypes": ["TIME", "DEVICE",....],
"filtersParameters": { "timeRangeType": "recent",.....},
"lastUpdateTimeInMillis": 1646655197926,
"lastUpdateUserName": "admin",
"esHeadersDictionary": ""
}
]
}
}
| resultCode → SUCCESS resultMessage → “Reports retrived successfully” result → list of all reports and their data, for report parameter info click here click here: Reports REST API - Message Structure |