Jump to

• Request
• Response
• Examples

Get http response code analytics as categorical data for failures.

get

/developers/services/v1/analytics/categorical/failures

Returns analytics for failures as categorical data.

This operation returns the intersection of apiIds, and appIds filters.

Any authenticated user can request this resource. The response contains data the requesting user is authorized to view based on their role and the resources they are issued grants to (APIs, and applications).

Request

Query Parameters

• apiIds(optional): array
  Collection Format: multi

  Filter data by apiIds as repeated query parameters (like ?apiIds=2&apiIds=3) or a single-comma separated query parameter (like ?apiIds=2,3).

  • [0]: string

  {
      "name":"apiIds",
      "in":"query",
      "description":"Filter data by apiIds as repeated query parameters (like <code>?apiIds=2&apiIds=3</code>) or a single-comma separated query parameter (like <code>?apiIds=2,3</code>).",
      "required":false,
      "type":"array",
      "items":{
          "type":"string"
      },
      "collectionFormat":"multi"
  }

• appIds(optional): array
  Collection Format: multi

  Filter data by appIds as repeated query parameters (like ?appIds=2&appIds=3) or a single comma separated query parameter (like ?appIds=2,3).

  • [0]: string

  {
      "name":"appIds",
      "in":"query",
      "description":"Filter data by appIds as repeated query parameters (like <code>?appIds=2&appIds=3</code>) or a single comma separated query parameter (like <code>?appIds=2,3</code>).",
      "required":false,
      "type":"array",
      "items":{
          "type":"string"
      },
      "collectionFormat":"multi"
  }

• groupBys(optional): array
  Collection Format: multi

  Split the query results into groups based on repeated query parameters (like ?groupBys=apiIds&groupBys=appIds) or a single comma separated query parameter (like ?groupBys=apiIds,appIds). Both of these examples display query results grouped by available apiIds and appIds.

  Grouping results by apiIds, and appIds is supported for all endpoints that support the groupBy query parameter.

  • [0]: string

  {
      "name":"groupBys",
      "in":"query",
      "description":"<p>Split the query results into groups based on repeated query parameters (like <code>?groupBys=apiIds&groupBys=appIds</code>) or a single comma separated query parameter (like <code>?groupBys=apiIds,appIds</code>). Both of these examples display query results grouped by available apiIds and appIds.</p><p>Grouping results by <code>apiIds</code>, and <code>appIds</code> is supported for all endpoints that support the <code>groupBy</code> query parameter.</p>",
      "required":false,
      "type":"array",
      "items":{
          "type":"string"
      },
      "collectionFormat":"multi"
  }

• timeEnd(optional): string
  End time filter as ISO8601 offset date. Example: 2016-01-01T00:00:00-07:00, 2016-01-01T00:00:00Z, 2016-01-01T00:00:00. The default value is no filtering. You must use this in conjunction with the timeSetting=custom query parameter.
• timeOffsetId(optional): string

  ISO8601 time offset ID. Example: Z. This parameter overrides the time offset of timeStart or timeEnd. This parameter is also used when calculating the start of time groups. The value of this parameter defaults to Z. (GMT).

  Note: Best effort is made to apply this parameter, but its accuracy may be limited by existing data granularity.

• timeSetting(optional): string
  Time setting mode. Defaults to custom. Valid values include: custom, currentHour, currentWeek, currentMonth, last15minutes, last60minutes, last24hours, last7days, last30days, last365days, january, february, march, april, may, june, july, august, september, october, november, december, year-2015, year-2016, etc.
• timeStart(optional): string
  Start time filter as ISO8601 offset date. Example: 2016-01-01T00:00:00-07:00, 2016-01-01T00:00:00Z, 2016-01-01T00:00:00. The default value is no filtering. You must use this in conjunction with the timeSetting=custom query parameter.

Back to Top

Response

Supported Media Types

• application/json

200 Response

JSON response with categorical http response data for requests.

Body ()

Collection of http response metrics.

Root Schema : ResponseDistributionCollectionResponse

Type: object

Collection of http response metrics.

Show Source

• count(optional): integer(int32)
  Response item count.
• hasMore(optional): boolean
  Default Value: false

  Indicates if there are more results after the current batch.
• items: array items
  The actual response items.
• limit(optional): integer(int32)
  Paging limit.
• links(optional): array links
  HATEOAS links.
• offset(optional): integer(int32)
  Paging offset.
• states(optional): array states
  An optional list for API states. This is null by default.
• time(optional): object TimeMetadata
  Metadata describing the time parameters used for the database query.

{
    "type":"object",
    "required":[
        "items"
    ],
    "properties":{
        "offset":{
            "type":"integer",
            "format":"int32",
            "description":"Paging offset."
        },
        "count":{
            "type":"integer",
            "format":"int32",
            "description":"Response item count."
        },
        "limit":{
            "type":"integer",
            "format":"int32",
            "description":"Paging limit."
        },
        "hasMore":{
            "type":"boolean",
            "description":"Indicates if there are more results after the current batch.",
            "default":false
        },
        "links":{
            "type":"array",
            "description":"HATEOAS links.",
            "items":{
                "$ref":"#/definitions/GenericLink"
            }
        },
        "time":{
            "description":"Metadata describing the time parameters used for the database query.",
            "$ref":"#/definitions/TimeMetadata"
        },
        "items":{
            "type":"array",
            "description":"The actual response items.",
            "items":{
                "$ref":"#/definitions/A response summary data item."
            }
        },
        "states":{
            "type":"array",
            "description":"An optional list for API states. This is null by default.",
            "items":{
                "type":"string"
            }
        }
    },
    "description":"Collection of http response metrics."
}

Nested Schema : items

Type: array

The actual response items.

Show Source

• Array of: object A response summary data item.
  Contains http response code

{
    "type":"array",
    "description":"The actual response items.",
    "items":{
        "$ref":"#/definitions/A response summary data item."
    }
}

Nested Schema : links

Type: array

HATEOAS links.

Show Source

• Array of: object GenericLink
  HATEOAS generic link representation.

{
    "type":"array",
    "description":"HATEOAS links.",
    "items":{
        "$ref":"#/definitions/GenericLink"
    }
}

Nested Schema : states

Type: array

An optional list for API states. This is null by default.

Show Source

• Array of: string

{
    "type":"array",
    "description":"An optional list for API states. This is null by default.",
    "items":{
        "type":"string"
    }
}

Nested Schema : TimeMetadata

Type: object

Metadata describing the time parameters used for the database query.

Show Source

• timeEnd(optional): string
  The calculated timeEnd used in the database query.
• timeOffsetId(optional): string
  The calculated timeOffsetId used in the database query.
• timeSetting(optional): string
  Value of the timeSetting query parameter.
• timeStart(optional): string
  The calculated timeStart used in the database query.

{
    "type":"object",
    "properties":{
        "timeEnd":{
            "type":"string",
            "description":"The calculated <code>timeEnd</code> used in the database query."
        },
        "timeSetting":{
            "type":"string",
            "description":"Value of the <code>timeSetting</code> query parameter."
        },
        "timeStart":{
            "type":"string",
            "description":" The calculated <code>timeStart</code> used in the database query."
        },
        "timeOffsetId":{
            "type":"string",
            "description":"The calculated <code>timeOffsetId</code> used in the database query."
        }
    },
    "description":"Metadata describing the time parameters used for the database query."
}

Nested Schema : A response summary data item.

Type: object

Contains http response code

Show Source

• api_id(optional): number
  The API's Id.
• api_name(optional): string
  The API's name.
• measure: number
  Value of the measure.
• response_code: string
  The http response code. Example: HTTP 400

{
    "type":"object",
    "required":[
        "measure",
        "response_code"
    ],
    "properties":{
        "api_id":{
            "type":"number",
            "description":"The API's Id."
        },
        "response_code":{
            "type":"string",
            "description":"The http response code. Example: <code>HTTP 400</code>"
        },
        "measure":{
            "type":"number",
            "description":"Value of the measure."
        },
        "api_name":{
            "type":"string",
            "description":"The API's name."
        }
    },
    "description":"Contains http response code"
}

Nested Schema : GenericLink

Type: object

HATEOAS generic link representation.

Show Source

• href: string
  Link reference string.
• method(optional): string
  HTTP method used with the link.
• rel: string
  Link relation string Value is either canonical or a specific string value.
• templated(optional): string
  Allowed Values: [ "true", "false" ]

  Indicates if the link has templated parts.

{
    "type":"object",
    "required":[
        "href",
        "rel"
    ],
    "properties":{
        "templated":{
            "type":"string",
            "description":"Indicates if the link has templated parts.",
            "enum":[
                "true",
                "false"
            ]
        },
        "method":{
            "type":"string",
            "description":"HTTP method used with the link."
        },
        "rel":{
            "type":"string",
            "description":"Link relation string Value is either <code>canonical</code> or a specific string value."
        },
        "href":{
            "type":"string",
            "description":"Link reference string."
        }
    },
    "description":"HATEOAS generic link representation."
}

400 Response

Bad Request

401 Response

Unauthorized

500 Response

Internal Server Error

Back to Top

Examples

The following example shows how to retrieve the total number of failed requests by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL

curl -i -X GET 
-u apicsadmin:password
https://example.com/developers/services/v1/analytics/categorical/failures

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200 OK
Server: Oracle-Traffic-Director/12.2.1.3.0
Date: Fri, 05 Jan 2018 05:38:18 GMT
Content-length: 171
Content-type: application/json
X-oracle-dms-ecid: lN6_M1qdX00000000
X-oracle-dms-rid: 0:1 
Via: 1.1 otd_opc
Proxy-agent: Oracle-Traffic-Director/12.2.1.3.0

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
  "count": 6,
  "time": {
    "timeEnd": "2017-12-31T00:00:00-07:00",
    "timeSetting": "custom",
    "timeGroupSize": 1,
    "timeStart": "2017-01-01T00:00:00-07:00",
    "timeOffsetId": "-07:00",
    "timeUnit": "MINUTE"
  },
  "items": [
    {
      "response_code": "HTTP 403",
      "measure": 162
    },
    {
      "response_code": "HTTP 401",
      "measure": 59
    },
    {
      "response_code": "HTTP 405",
      "measure": 53
    },
    {
      "response_code": "HTTP 400",
      "measure": 38
    },
    {
      "response_code": "HTTP 500",
      "measure": 27
    },
    {
      "response_code": "HTTP 404",
      "measure": 20
    }
  ]
}

Back to Top