Health Checks Functions
Package: DBMS_CLOUD_OCI_HC_HEALTH_CHECKS
CHANGE_HTTP_MONITOR_COMPARTMENT Function
Moves a monitor into a different compartment. When provided, `If-Match` is checked against ETag values of the resource.
Syntax
FUNCTION change_http_monitor_compartment (
monitor_id varchar2,
change_http_monitor_compartment_details dbms_cloud_oci_healthchecks_change_http_monitor_compartment_details_t,
if_match varchar2 DEFAULT NULL,
opc_request_id varchar2 DEFAULT NULL,
opc_retry_token varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_change_http_monitor_compartment_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(required) The details needed to move the monitor. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) A token that uniquely identifies a request that can be retried in case of a timeout or server error without risk of executing the same action again. Retry tokens expire after 24 hours. *Note:* Retry tokens can be invalidated before the 24 hour time limit due to conflicting operations, such as a resource being deleted or purged from the system. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CHANGE_PING_MONITOR_COMPARTMENT Function
Moves a monitor into a different compartment. When provided, `If-Match` is checked against ETag values of the resource.
Syntax
FUNCTION change_ping_monitor_compartment (
monitor_id varchar2,
change_ping_monitor_compartment_details dbms_cloud_oci_healthchecks_change_ping_monitor_compartment_details_t,
if_match varchar2 DEFAULT NULL,
opc_request_id varchar2 DEFAULT NULL,
opc_retry_token varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_change_ping_monitor_compartment_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(required) The details needed to move the monitor. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) A token that uniquely identifies a request that can be retried in case of a timeout or server error without risk of executing the same action again. Retry tokens expire after 24 hours. *Note:* Retry tokens can be invalidated before the 24 hour time limit due to conflicting operations, such as a resource being deleted or purged from the system. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CREATE_HTTP_MONITOR Function
Creates an HTTP monitor. Vantage points will be automatically selected if not specified, and probes will be initiated from each vantage point to each of the targets at the frequency specified by `intervalInSeconds`.
Syntax
FUNCTION create_http_monitor (
create_http_monitor_details dbms_cloud_oci_healthchecks_create_http_monitor_details_t,
opc_request_id varchar2 DEFAULT NULL,
opc_retry_token varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_create_http_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The configuration details for creating an HTTP monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) A token that uniquely identifies a request that can be retried in case of a timeout or server error without risk of executing the same action again. Retry tokens expire after 24 hours. *Note:* Retry tokens can be invalidated before the 24 hour time limit due to conflicting operations, such as a resource being deleted or purged from the system. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CREATE_ON_DEMAND_HTTP_PROBE Function
Creates an on-demand HTTP probe. The location response header contains the URL for fetching the probe results. *Note:* On-demand probe configurations are not saved.
Syntax
FUNCTION create_on_demand_http_probe (
create_on_demand_http_probe_details dbms_cloud_oci_healthchecks_create_on_demand_http_probe_details_t,
opc_request_id varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_create_on_demand_http_probe_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The configuration of the HTTP probe. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CREATE_ON_DEMAND_PING_PROBE Function
Creates an on-demand ping probe. The location response header contains the URL for fetching probe results. *Note:* The on-demand probe configuration is not saved.
Syntax
FUNCTION create_on_demand_ping_probe (
create_on_demand_ping_probe_details dbms_cloud_oci_healthchecks_create_on_demand_ping_probe_details_t,
opc_request_id varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_create_on_demand_ping_probe_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) Configuration details for creating an on-demand ping probe. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
CREATE_PING_MONITOR Function
Creates a ping monitor. Vantage points will be automatically selected if not specified, and probes will be initiated from each vantage point to each of the targets at the frequency specified by `intervalInSeconds`.
Syntax
FUNCTION create_ping_monitor (
create_ping_monitor_details dbms_cloud_oci_healthchecks_create_ping_monitor_details_t,
opc_request_id varchar2 DEFAULT NULL,
opc_retry_token varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_create_ping_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The configuration details for creating a ping monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) A token that uniquely identifies a request that can be retried in case of a timeout or server error without risk of executing the same action again. Retry tokens expire after 24 hours. *Note:* Retry tokens can be invalidated before the 24 hour time limit due to conflicting operations, such as a resource being deleted or purged from the system. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
DELETE_HTTP_MONITOR Function
Deletes the HTTP monitor and its configuration. All future probes of this monitor are stopped. Results associated with the monitor are not deleted.
Syntax
FUNCTION delete_http_monitor (
monitor_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_delete_http_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
DELETE_PING_MONITOR Function
Deletes the ping monitor and its configuration. All future probes of this monitor are stopped. Results associated with the monitor are not deleted.
Syntax
FUNCTION delete_ping_monitor (
monitor_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_delete_ping_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
GET_HTTP_MONITOR Function
Gets the configuration for the specified monitor.
Syntax
FUNCTION get_http_monitor (
monitor_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
if_none_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_get_http_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The `If-None-Match` header field makes the request method conditional on the absence of any current representation of the target resource, when the field-value is `*`, or having a selected representation with an entity-tag that does not match any of those listed in the field-value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
GET_PING_MONITOR Function
Gets the configuration for the specified ping monitor.
Syntax
FUNCTION get_ping_monitor (
monitor_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
if_none_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_get_ping_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The `If-None-Match` header field makes the request method conditional on the absence of any current representation of the target resource, when the field-value is `*`, or having a selected representation with an entity-tag that does not match any of those listed in the field-value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_HEALTH_CHECKS_VANTAGE_POINTS Function
Gets information about all vantage points available to the user.
Syntax
FUNCTION list_health_checks_vantage_points (
opc_request_id varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
page varchar2 DEFAULT NULL,
sort_by varchar2 DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
name varchar2 DEFAULT NULL,
display_name varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_list_health_checks_vantage_points_response_t;
Parameters
Parameter | Description |
---|---|
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) The field to sort by when listing vantage points. Allowed values are: 'name', 'displayName' |
|
(optional) Controls the sort order of results. Allowed values are: 'ASC', 'DESC' |
|
(optional) Filters results that exactly match the `name` field. |
|
(optional) Filters results that exactly match the `displayName` field. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_HTTP_MONITORS Function
Gets a list of HTTP monitors.
Syntax
FUNCTION list_http_monitors (
compartment_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
page varchar2 DEFAULT NULL,
sort_by varchar2 DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
display_name varchar2 DEFAULT NULL,
home_region varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_list_http_monitors_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) Filters results by compartment. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) The field to sort by when listing monitors. Allowed values are: 'id', 'displayName', 'timeCreated' |
|
(optional) Controls the sort order of results. Allowed values are: 'ASC', 'DESC' |
|
(optional) Filters results that exactly match the `displayName` field. |
|
(optional) Filters results that match the `homeRegion`. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_HTTP_PROBE_RESULTS Function
Gets the HTTP probe results for the specified probe or monitor, where the `probeConfigurationId` is the OCID of either a monitor or an on-demand probe.
Syntax
FUNCTION list_http_probe_results (
probe_configuration_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
page varchar2 DEFAULT NULL,
start_time_greater_than_or_equal_to number DEFAULT NULL,
start_time_less_than_or_equal_to number DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
target varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_list_http_probe_results_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor or on-demand probe. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) Returns results with a `startTime` equal to or greater than the specified value. |
|
(optional) Returns results with a `startTime` equal to or less than the specified value. |
|
(optional) Controls the sort order of results. Allowed values are: 'ASC', 'DESC' |
|
(optional) Filters results that match the `target`. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_PING_MONITORS Function
Gets a list of configured ping monitors. Results are paginated based on `page` and `limit`. The `opc-next-page` header provides a URL for fetching the next page.
Syntax
FUNCTION list_ping_monitors (
compartment_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
page varchar2 DEFAULT NULL,
sort_by varchar2 DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
display_name varchar2 DEFAULT NULL,
home_region varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_list_ping_monitors_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) Filters results by compartment. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) The field to sort by when listing monitors. Allowed values are: 'id', 'displayName', 'timeCreated' |
|
(optional) Controls the sort order of results. Allowed values are: 'ASC', 'DESC' |
|
(optional) Filters results that exactly match the `displayName` field. |
|
(optional) Filters results that match the `homeRegion`. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
LIST_PING_PROBE_RESULTS Function
Returns the results for the specified probe, where the `probeConfigurationId` is the OCID of either a monitor or an on-demand probe. Results are paginated based on `page` and `limit`. The `opc-next-page` header provides a URL for fetching the next page. Use `sortOrder` to set the order of the results. If `sortOrder` is unspecified, results are sorted in ascending order by `startTime`.
Syntax
FUNCTION list_ping_probe_results (
probe_configuration_id varchar2,
opc_request_id varchar2 DEFAULT NULL,
limit number DEFAULT NULL,
page varchar2 DEFAULT NULL,
start_time_greater_than_or_equal_to number DEFAULT NULL,
start_time_less_than_or_equal_to number DEFAULT NULL,
sort_order varchar2 DEFAULT NULL,
target varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_list_ping_probe_results_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor or on-demand probe. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) The maximum number of items to return in a paginated \"List\" call. |
|
(optional) The value of the `opc-next-page` response header from the previous \"List\" call. |
|
(optional) Returns results with a `startTime` equal to or greater than the specified value. |
|
(optional) Returns results with a `startTime` equal to or less than the specified value. |
|
(optional) Controls the sort order of results. Allowed values are: 'ASC', 'DESC' |
|
(optional) Filters results that match the `target`. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
UPDATE_HTTP_MONITOR Function
Updates the configuration of the specified HTTP monitor. Only the fields specified in the request body will be updated; all other configuration properties will remain unchanged.
Syntax
FUNCTION update_http_monitor (
monitor_id varchar2,
update_http_monitor_details dbms_cloud_oci_healthchecks_update_http_monitor_details_t,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_update_http_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(required) The configuration details to update for the HTTP monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |
UPDATE_PING_MONITOR Function
Updates the configuration of the specified ping monitor. Only the fields specified in the request body will be updated; all other configuration properties will remain unchanged.
Syntax
FUNCTION update_ping_monitor (
monitor_id varchar2,
update_ping_monitor_details dbms_cloud_oci_healthchecks_update_ping_monitor_details_t,
opc_request_id varchar2 DEFAULT NULL,
if_match varchar2 DEFAULT NULL,
region varchar2 DEFAULT NULL,
endpoint varchar2 DEFAULT NULL,
credential_name varchar2 DEFAULT NULL
) RETURN dbms_cloud_oci_hc_health_checks_update_ping_monitor_response_t;
Parameters
Parameter | Description |
---|---|
|
(required) The OCID of a monitor. |
|
(required) Details for updating a Ping monitor. |
|
(optional) Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. |
|
(optional) For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value. |
|
(optional) OCI region id. e.g us-phoenix-1 for US West (Phoenix). |
|
(optional) The endpoint of the service to call using this function. e.g https://healthchecks.{region}.oci.{secondLevelDomain}.If both endpoint and region are given, then endpoint takes precedence. |
|
(optional) The name of the credential for authenticating with the corresponding cloud native API. |