Jump to

• Request
• Response
• Examples

Retrieve Integration Count

get

/iot/api/v2/apps/{app-id}/integrations/count

Retrieve total count of Integrations for the specified Application

Request

Path Parameters

• app-id: string
  Unique identifier of the application

Query Parameters

• limit(optional): integer
  Maximum number of entries to return to end-user
• offset(optional): integer
  The number that the first record of results is starting from
• totalResults(optional): boolean
  Total number of results which suites particular end-user request

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successfully processed

Body ()

Root Schema : RecordsCount_receive

Type: object

Show Source

• count: integer
  Property description was not set

{
    "properties":{
        "count":{
            "description":"Property description was not set",
            "type":"integer"
        }
    },
    "required":[
        "count"
    ],
    "type":"object"
}

401 Response

Unauthorized. The request requires user authentication.

Back to Top

Examples

The following example shows how to retrieve the count of Integration instances for Application 0-RYJQ by submitting a GET request on the REST resource using cURL. For more information about cURL, see Use cURL.

Note:

In the request and response, iotserver will be replaced by name and port of your assigned Oracle IoT Cloud Service instance. The format of the Cloud Service instance is myinstance-myidentitydomain.iot.us.oraclecloud.com and the default port is 443.

curl -X GET -H 'Accept: application/json' -H 'Authorization:Basic aW90OndlbGNvbWUx' "http://iotserver/iot/api/v2/apps/0-RYJQ/integrations/count"

Example of Response Header

The following shows an example of the response header.

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

Example of Response Body

The following example shows the contents of the response as a result of this request. Notice that it just contains a status value.

{   
  "count":1,
  "links":[   
    {   
      "href":"http://iotserver:7001/iot/api/v2/apps/0-RYJQ/integrations/count",
      "rel":"self"
    },
    {   
      "href":"http://iotserver:7001/iot/api/v2/apps/0-RYJQ/integrations/count",
      "rel":"canonical"
    }
  ]
}

Back to Top