Chilkat Online Tools

PowerBuilder / Monitoring API / Get Alarm History

Back to Collection Items

integer li_rc
oleobject loo_Http
integer li_Success
oleobject loo_QueryParams
oleobject loo_Resp
oleobject loo_SbResponseBody
oleobject loo_JResp
integer li_RespStatusCode
string ls_Summary
string ls_Timestamp
string ls_TimestampTriggered
string ls_AlarmId
integer li_IsEnabled
integer i
integer li_Count_i

// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

loo_Http = create oleobject
// Use "Chilkat_9_5_0.Http" for versions of Chilkat < 10.0.0
li_rc = loo_Http.ConnectToNewObject("Chilkat.Http")
if li_rc < 0 then
    destroy loo_Http
    MessageBox("Error","Connecting to COM object failed")
    return
end if

loo_QueryParams = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_QueryParams.ConnectToNewObject("Chilkat.JsonObject")

loo_QueryParams.UpdateString("alarmHistorytype","STATE_HISTORY")
loo_QueryParams.UpdateString("page","")
loo_QueryParams.UpdateInt("limit",576)
loo_QueryParams.UpdateString("timestampGreaterThanOrEqualTo","2021-12-02T08:38:26.979Z")
loo_QueryParams.UpdateString("timestampLessThan","2021-12-02T08:38:26.979Z")

loo_Http.SetRequestHeader("opc-request-id","pariatur nostrud eiusmod")
loo_Http.SetRequestHeader("Authorization","{{signature}}")
loo_Http.SetRequestHeader("Date","{{date}}")

loo_Resp = loo_Http.QuickRequestParams("GET","https://telemetry.{{region}}.oraclecloud.com/20180401/alarms/:alarmId/history",loo_QueryParams)
if loo_Http.LastMethodSuccess = 0 then
    Write-Debug loo_Http.LastErrorText
    destroy loo_Http
    destroy loo_QueryParams
    return
end if

loo_SbResponseBody = create oleobject
// Use "Chilkat_9_5_0.StringBuilder" for versions of Chilkat < 10.0.0
li_rc = loo_SbResponseBody.ConnectToNewObject("Chilkat.StringBuilder")

loo_Resp.GetBodySb(loo_SbResponseBody)

loo_JResp = create oleobject
// Use "Chilkat_9_5_0.JsonObject" for versions of Chilkat < 10.0.0
li_rc = loo_JResp.ConnectToNewObject("Chilkat.JsonObject")

loo_JResp.LoadSb(loo_SbResponseBody)
loo_JResp.EmitCompact = 0

Write-Debug "Response Body:"
Write-Debug loo_JResp.Emit()

li_RespStatusCode = loo_Resp.StatusCode
Write-Debug "Response Status Code = " + string(li_RespStatusCode)
if li_RespStatusCode >= 400 then
    Write-Debug "Response Header:"
    Write-Debug loo_Resp.Header
    Write-Debug "Failed."
    destroy loo_Resp
    destroy loo_Http
    destroy loo_QueryParams
    destroy loo_SbResponseBody
    destroy loo_JResp
    return
end if

destroy loo_Resp

// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)

// {
//   "alarmId": "cupidatat",
//   "entries": [
//     {
//       "summary": "irure esse o",
//       "timestamp": "1989-09-04T12:31:35.740Z",
//       "timestampTriggered": "2011-07-22T15:36:33.587Z"
//     },
//     {
//       "summary": "occaecat irure Lorem tempor",
//       "timestamp": "1946-03-18T08:38:09.867Z",
//       "timestampTriggered": "1971-11-21T14:18:35.074Z"
//     }
//   ],
//   "isEnabled": false
// }

// Sample code for parsing the JSON response...
// Use this online tool to generate parsing code from sample JSON: Generate JSON Parsing Code

ls_AlarmId = loo_JResp.StringOf("alarmId")
li_IsEnabled = loo_JResp.BoolOf("isEnabled")
i = 0
li_Count_i = loo_JResp.SizeOfArray("entries")
do while i < li_Count_i
    loo_JResp.I = i
    ls_Summary = loo_JResp.StringOf("entries[i].summary")
    ls_Timestamp = loo_JResp.StringOf("entries[i].timestamp")
    ls_TimestampTriggered = loo_JResp.StringOf("entries[i].timestampTriggered")
    i = i + 1
loop


destroy loo_Http
destroy loo_QueryParams
destroy loo_SbResponseBody
destroy loo_JResp

Curl Command

curl -G -d "alarmHistorytype=STATE_HISTORY"
	-d "page="
	-d "limit=576"
	-d "timestampGreaterThanOrEqualTo=2021-12-02T08%3A38%3A26.979Z"
	-d "timestampLessThan=2021-12-02T08%3A38%3A26.979Z"
	-H "opc-request-id: pariatur nostrud eiusmod"
	-H "Date: {{date}}"
	-H "Authorization: {{signature}}"
https://telemetry.{{region}}.oraclecloud.com/20180401/alarms/:alarmId/history

Postman Collection Item JSON

{
  "name": "Get Alarm History",
  "request": {
    "method": "GET",
    "header": [
      {
        "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
        "key": "opc-request-id",
        "value": "pariatur nostrud eiusmod"
      },
      {
        "key": "Date",
        "value": "{{date}}",
        "description": "(Required) Current Date",
        "type": "text"
      },
      {
        "key": "Authorization",
        "value": "{{signature}}",
        "description": "(Required) Signature Authentication on Authorization header",
        "type": "text"
      }
    ],
    "url": {
      "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=&limit=576&timestampGreaterThanOrEqualTo=2021-12-02T08:38:26.979Z&timestampLessThan=2021-12-02T08:38:26.979Z",
      "host": [
        "{{baseUrl}}"
      ],
      "path": [
        "alarms",
        ":alarmId",
        "history"
      ],
      "query": [
        {
          "key": "alarmHistorytype",
          "value": "STATE_HISTORY",
          "description": "The type of history entries to retrieve. State history (STATE_HISTORY) or state transition history (STATE_TRANSITION_HISTORY).\nIf not specified, entries of both types are retrieved.\n\nExample: `STATE_HISTORY`\n"
        },
        {
          "key": "page",
          "value": "",
          "description": "For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call.\nFor important details about how pagination works, see [List Pagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).\n"
        },
        {
          "key": "limit",
          "value": "576",
          "description": "For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.\nFor important details about how pagination works, see [List Pagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).\n\nDefault: 1000\n\nExample: 500\n"
        },
        {
          "key": "timestampGreaterThanOrEqualTo",
          "value": "2021-12-02T08:38:26.979Z",
          "description": "A filter to return only alarm history entries with timestamps occurring on or after the specified date and time. Format defined by RFC3339.\n\nExample: `2019-01-01T01:00:00.789Z`\n"
        },
        {
          "key": "timestampLessThan",
          "value": "2021-12-02T08:38:26.979Z",
          "description": "A filter to return only alarm history entries with timestamps occurring before the specified date and time. Format defined by RFC3339.\n\nExample: `2019-01-02T01:00:00.789Z`\n"
        }
      ],
      "variable": [
        {
          "key": "alarmId",
          "value": "mollit in Duis enim",
          "description": "(Required) The [OCID](https://docs.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.\n"
        }
      ]
    },
    "description": "Get the history of the specified alarm.\nFor important limits information, see [Limits on Monitoring](https://docs.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).\n\nThis call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.\nMonitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,\nor transactions, per second (TPS) for a given tenancy.\n"
  },
  "response": [
    {
      "name": "Successfully retrieved alarm history.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "OK",
      "code": 200,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-next-page",
          "value": "pariatur nostrud eiusmod",
          "description": "For list pagination. When this header appears in the response, additional pages of results remain.\nFor important details about how pagination works, see [List Pagination](https://docs.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).\n"
        },
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"alarmId\": \"cupidatat\",\n \"entries\": [\n  {\n   \"summary\": \"irure esse o\",\n   \"timestamp\": \"1989-09-04T12:31:35.740Z\",\n   \"timestampTriggered\": \"2011-07-22T15:36:33.587Z\"\n  },\n  {\n   \"summary\": \"occaecat irure Lorem tempor\",\n   \"timestamp\": \"1946-03-18T08:38:09.867Z\",\n   \"timestampTriggered\": \"1971-11-21T14:18:35.074Z\"\n  }\n ],\n \"isEnabled\": false\n}"
    },
    {
      "name": "Bad Request",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Bad Request",
      "code": 400,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    },
    {
      "name": "Unauthorized",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Unauthorized",
      "code": 401,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    },
    {
      "name": "Not Authorized Or Not Found",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Not Found",
      "code": 404,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    },
    {
      "name": "Client is getting throttled, please retry with backoff.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Too Many Requests",
      "code": 429,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    },
    {
      "name": "Internal Server Error",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Internal Server Error",
      "code": 500,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    },
    {
      "name": "An error has occurred.",
      "originalRequest": {
        "method": "GET",
        "header": [
          {
            "description": "Customer part of the request identifier token. If you need to contact Oracle about a particular\nrequest, please provide the complete request ID.\n",
            "key": "opc-request-id",
            "value": "pariatur nostrud eiusmod"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/alarms/:alarmId/history?alarmHistorytype=STATE_HISTORY&page=do ipsum&limit=576&timestampGreaterThanOrEqualTo=1962-12-02T08:38:26.979Z&timestampLessThan=1962-12-02T08:38:26.979Z",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "alarms",
            ":alarmId",
            "history"
          ],
          "query": [
            {
              "key": "alarmHistorytype",
              "value": "STATE_HISTORY"
            },
            {
              "key": "page",
              "value": "do ipsum"
            },
            {
              "key": "limit",
              "value": "576"
            },
            {
              "key": "timestampGreaterThanOrEqualTo",
              "value": "1962-12-02T08:38:26.979Z"
            },
            {
              "key": "timestampLessThan",
              "value": "1962-12-02T08:38:26.979Z"
            }
          ],
          "variable": [
            {
              "key": "alarmId"
            }
          ]
        }
      },
      "status": "Internal Server Error",
      "code": 500,
      "_postman_previewlanguage": "json",
      "header": [
        {
          "key": "opc-request-id",
          "value": "pariatur nostrud eiusmod",
          "description": "Unique Oracle-assigned identifier for the request. If you need to contact Oracle about\na particular request, please provide the request ID.\n"
        },
        {
          "key": "Content-Type",
          "value": "application/json"
        }
      ],
      "cookie": [
      ],
      "body": "{\n \"code\": \"qui anim ut\",\n \"message\": \"esse proident\"\n}"
    }
  ]
}