notification:rest:endpoint : The notification RESTful endpoint object.

The notification REST endpoint object represents settings of particular REST API endpoint.

Object Reference

References to notification:rest:endpoint are object references.

The name part of the notification:rest:endpoint object reference has the following components:

  • The name of an endpoint.
Example:
notification:rest:endpoint/b25lLmVuZHBvaW50JDMzOQ:wintermute

Restrictions

The object does not support the following operations:

The object cannot be managed on Cloud Platform members.

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): name, outbound_member_type, uri.

The following fields are required to create this object:

Field Notes
name  
outbound_member_type  
uri  

client_certificate_subject

client_certificate_subject

The client certificate subject of a notification REST endpoint.

Type

String.

Search

The field is not available for search.

Notes

The client_certificate_subject cannot be updated.

client_certificate_subject cannot be written.

client_certificate_token

client_certificate_token

The token returned by the uploadinit function call in object fileop for a notification REST endpoit client certificate.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

Notes

client_certificate_token is not readable.

client_certificate_valid_from

client_certificate_valid_from

The timestamp when client certificate for a notification REST endpoint was created.

Type

Timestamp.

Search

The field is not available for search.

Notes

The client_certificate_valid_from cannot be updated.

client_certificate_valid_from cannot be written.

client_certificate_valid_to

client_certificate_valid_to

The timestamp when client certificate for a notification REST endpoint expires.

Type

Timestamp.

Search

The field is not available for search.

Notes

The client_certificate_valid_to cannot be updated.

client_certificate_valid_to cannot be written.

comment

comment

The comment of a notification REST endpoint.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

extattrs

extattrs

Extensible attributes associated with the object.

For valid values for extensible attributes, see the following information.

Type

Extensible attributes.

This field allows +/- to be specified as part of the field name when updating the object, see the following information.

Create

The default value is empty.

Search

For how to search extensible attributes, see the following information.

log_level

log_level

The log level for a notification REST endpoint.

Type

String.

Valid values are:
  • DEBUG
  • ERROR
  • INFO
  • WARNING

Create

The default value is WARNING.

Search

The field is available for search via

  • ‘=’ (exact equality)

name

name

The name of a notification REST endpoint.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The field is required on creation.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The name is part of the base object.

outbound_member_type

outbound_member_type

The outbound member which will generate an event.

Type

String.

Valid values are:
  • GM
  • MEMBER

Create

The field is required on creation.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The outbound_member_type is part of the base object.

outbound_members

outbound_members

The list of members for outbound events.

Type

String array.

Create

The default value is empty.

Search

The field is not available for search.

password

password

The password of the user that can log into a notification REST endpoint.

Type

String.

Create

The default value is undefined.

Search

The field is not available for search.

Notes

password is not readable.

server_cert_validation

server_cert_validation

The server certificate validation type.

Type

String.

Valid values are:
  • CA_CERT
  • CA_CERT_NO_HOSTNAME
  • NO_VALIDATION

Create

The default value is CA_CERT.

Search

The field is not available for search.

sync_disabled

sync_disabled

Determines if the sync process is disabled for a notification REST endpoint.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

template_instance

template_instance

The notification REST template instance. The parameters of REST API endpoint template instance are prohibited to change.

Type

A/An Notification REST template instance struct.

Create

The default value is empty.

Search

The field is not available for search.

timeout

timeout

The timeout of session management (in seconds).

Type

Unsigned integer.

Create

The default value is 30.

Search

The field is not available for search.

uri

uri

The URI of a notification REST endpoint.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The field is required on creation.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The uri is part of the base object.

username

username

The username of the user that can log into a notification REST endpoint.

Type

String.

Values with leading or trailing white space are not valid for this field.

Create

The default value is empty.

Search

The field is not available for search.

vendor_identifier

vendor_identifier

The vendor identifier.

Type

String.

Create

The default value is empty.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

wapi_user_name

wapi_user_name

The user name for WAPI integration.

Type

String.

Create

The default value is empty.

Search

The field is not available for search.

wapi_user_password

wapi_user_password

The user password for WAPI integration.

Type

String.

Create

The default value is undefined.

Search

The field is not available for search.

Notes

wapi_user_password is not readable.

Function Calls

clear_outbound_worker_log

Use this function to clear the outbound worker log for the endpoint.

This function does not support multiple object matches when called as part of an atomic insertion operation.

Input fields

None

Output fields

error_message ( String. ) The error message.

overall_status ( String. Valid values are: “FAILED”, “SUCCESS” ) The overall status of clearing procedure.

test_connection

Test connectivity to the REST API endpoint.

This function does not support multiple object matches when called as part of an atomic insertion operation.

Input fields

None

Output fields

error_message ( String. ) The test connectivity failed error message.

overall_status ( String. Valid values are: “FAILED”, “SUCCESS” ) The overall status of connectivity test.

Fields List

Field Type Req R/O Base Search
client_certificate_subject String N Y N N/A
client_certificate_token String N N N N/A
client_certificate_valid_from Timestamp N Y N N/A
client_certificate_valid_to Timestamp N Y N N/A
comment String N N N N/A
extattrs Extattr N N N ext
log_level String N N N =
name String Y N Y : = ~
outbound_member_type String Y N Y =
outbound_members [String] N N N N/A
password String N N N N/A
server_cert_validation String N N N N/A
sync_disabled Bool N N N N/A
template_instance struct N N N N/A
timeout Unsigned int N N N N/A
uri String Y N Y : = ~
username String N N N N/A
vendor_identifier String N N N : = ~
wapi_user_name String N N N N/A
wapi_user_password String N N N N/A