Retrieve Details of a Specific Metric Threshold
get
/monitoring/monitoring/{idDomainName}/.customer/api/v1/metricThresholds/{thresholdId}
Request
Path Parameters
-
idDomainName: string
Identity domain ID for the Oracle Monitoring Cloud Service account.
-
thresholdId: string
ID of the Threshold object.
Header Parameters
-
Authorization: string
Basic Authentication credentials. The user must be located in the identity domain name specified by the header X-ID-TENANT-NAME.
-
X-ID-TENANT-NAME: string
Set to the identity domain ID where the user specified in the Authorization header resides.
Response
Supported Media Types
- application/json
200 Response
successful operation
Root Schema : MetricThreshold
Type:
Show Source
object
-
alertAction(optional):
object MetricThresholdAlertAction
-
canonicalLink(optional):
string(uri)
Read Only:
true
Relative path to the resource. -
condition(optional):
object MetricThresholdCondition
-
id(optional):
string(uuid)
Read Only:
true
Unique ID of the metric threshold. -
name(optional):
string
Specify a name for the metric threshold.
-
target(optional):
object MetricTarget
Nested Schema : MetricThresholdAlertAction
Type:
Show Source
object
-
channelType(optional):
string
Specify the type of alert notification to be sent. By default, the
channelType
attribute is set toNOTIFICATION_MESSAGE
. In this case, an email notification is sent to the service administrator of the requested resource when an event occurs.
ThechannelType
attribute can also be set toPUSH_TO_CLIENT
. In this case, notification messages are delivered to the process polling for state changes. -
type(optional):
string
Specify the alert action type.
Nested Schema : MetricThresholdCondition
Type:
Show Source
object
-
operation(optional):
string
Specify the operation (>, <, <=, >=, =).
-
periodCountToSatisfy(optional):
integer(int32)
Enter the number of consecutive times the metric must meet the criteria specified by you to trigger an alert.
-
periodCountToUnsatisfy(optional):
integer(int32)
Enter the number of consecutive times that the metric must be within the threshold limit to trigger an alert.
-
periodDuration(optional):
string
Specify the time period for which you want to monitor the metric.
Note: You must use the iCalendar Duration format. For example,PT10M
.
By defaultperiodDuration
is set toPT5M
. The minimum accepted value forperiodDuration
isPT5M
. -
stats(optional):
string
Specify the statistic to monitor (avg, count, min, max, sum).
-
value(optional):
number(double)
Specify the threshold value.
Nested Schema : MetricSeries
Type:
Show Source
object
-
canonicalLink(optional):
string(uri)
Relative path to the resource.
-
id(optional):
string(uuid)
A unique ID representing a metric type for a specific metric subject. For example, 821ce631-691e-494e-ba69-526739e086e2.
-
isDeleted(optional):
boolean
Default Value:
false
Indicates whether the referenced object has been deleted. -
metricType(optional):
object MetricType
-
subject(optional):
object MetricSubject
Nested Schema : MetricType
Type:
Show Source
object
-
canonicalLink(optional):
string(uri)
Relative path to the resource.
-
description(optional):
string
Description of the metric type.
-
displayName(optional):
string
Display name of the metric type.
-
id(optional):
string
Unique ID of the metric type. For example, compute.CPU.PERCENT.
-
name(optional):
string
Short name of the metric type. For example, cpuPercent.
-
shortDisplayName(optional):
string
Short display name for the metric type.
-
subjectType(optional):
object MetricSubjectType
-
unit(optional):
object MetricUnit
Nested Schema : MetricSubject
Type:
Show Source
object
-
canonicalLink(optional):
string(uri)
Relative path to the resource.
-
displayName(optional):
string
Display name of the metric subject.
-
id(optional):
string(uuid)
Unique ID of the metric subject. For example, bbdce636-691e-494e-ba69-526739e086e0.
-
isDeleted(optional):
boolean
Default Value:
false
Indicates whether the referenced object has been deleted. -
properties(optional):
array properties
Properties of the subject.
-
subjectType(optional):
object MetricSubjectType
Nested Schema : MetricSubjectType
Type:
Show Source
object
-
id(optional):
string
Unique ID of the metric unit. For example, compute.vm.
Nested Schema : MetricUnit
Type:
Show Source
object
-
canonicalLink(optional):
string(uri)
Relative path to the resource.
-
displayName(optional):
string
Display name of the metric unit.
-
id(optional):
string
Unique ID of the metric unit. For example, BYTES.
-
shortDisplayName(optional):
string
Short display name for the metric unit.
Nested Schema : MetricProperty
Type:
Show Source
object
-
name(optional):
string
The name of the metric property. For example, vmUuid.
-
value(optional):
string
The value of the metric property. For example, 11da4f96-e95e-4998-810c-198d5df034c4 for the vmUuid property.
Examples
The following example shows how to retrieve details of a specific metric threshold by submitting a GET request on the REST resource using cURL. See Use cURL.
curl -X GET -H "Authorization: Basic d2VibG9naWM6V2VsY29tZTE=" -H "X-ID-TENANT-NAME:mydomain" https://monitoring.us.oraclecloud.com/monitoring/mydomain/.customer/api/v1/metricThresholds/b9068caa-83d6-467b-8bb8-354e40767573
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Date: Fri, 29 Apr 2016 08:40:06 GMT Content-Type: application/json
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "id": "b9068caa-83d6-467b-8bb8-354e40767573", "target": { "series": { "id": "2b0af13a-e497-6bec-e053-caa0f90a8a24", "metricType": { "id": "compute.CPU.PERCENT", "canonicalLink": "/monitoring/mydomain/.customer/api/v1/metricTypes/compute.CPU.PERCENT" }, "subject": { "id": "2b0af13a-e496-6bec-e053-caa0f90a8a24", "canonicalLink": "/monitoring/mydomain/.customer/api/v1/metricSubjects/2b0af13a-e496-6bec-e053-caa0f90a8a24" }, "canonicalLink": "/monitoring/mydomain/.customer/api/v1/metricSeries/2b0af13a-e497-6bec-e053-caa0f90a8a24" } }, "name": "VM1 High Cpu", "condition": { "stats": "avg", "operation": ">=", "value": 70, "periodDuration": "PT10M", "periodCountToSatisfy": 3, "periodCountToUnsatisfy": 2 }, "alertAction": { "type": "notification", "channelType": "notificationMessage" }, "canonicalLink": "/monitoring/mydomain/.customer/api/v1/metricThresholds/b9068caa-83d6-467b-8bb8-354e40767573" },