Create a DeliveryEndpoint
post
/20180828/deliveryEndpoints
This path creates a DeliveryEndpoint.
Request
Header Parameters
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
-
opc-retry-token: string
Minimum Length:
1
Maximum Length:64
A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of running that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations. For example, if a resource has been deleted and removed from the system, then a retry of the original creation request might be rejected.
The details for the new DeliveryEndpoint.
Root Schema : CreateDeliveryEndpointDetails
Type:
object
The data to create a DeliveryEndpoint.
Show Source
-
adtEventType:
array adtEventType
Maximum Number of Items:
512
The type or types of ADT events to deliver to this endpoint, for example, ADT01 or ADT08. -
caBundleId(required):
string
Minimum Length:
1
Maximum Length:255
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the delivery endpoint CA bundle. -
compartmentId(required):
string
Minimum Length:
1
Maximum Length:255
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment in which you create the DeliveryEndpoint. -
definedTags:
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}`
-
description:
string
Minimum Length:
1
Maximum Length:2048
A detailed description of the delivery endpoint. This description can be changed. -
displayName:
string
Minimum Length:
1
Maximum Length:255
A user-friendly name. This name does not have to be unique, and it can be changed. Avoid entering confidential information. -
freeformTags:
object freeformTags
Additional Properties Allowed: additionalPropertiesFree-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}`
-
messageType(required):
string
The type of message to deliver to the payer at this endpoint.
-
oauth2Info(required):
object DeliveryEndpointOauth2Info
The OAuth 2.0 information that is used by a delivery endpoint.
-
payerId(required):
string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the payer using this endpoint.
-
requestHeaders(required):
object requestHeaders
Minimum Number of Properties:
1
Maximum Number of Properties:50
Additional Properties Allowed: additionalPropertiesThe request headers (that is, the key-value pairs) that the delivery endpoint requires. -
url(required):
string
A fully-formed https URL to which messages should be delivered.
Nested Schema : adtEventType
Type:
array
Maximum Number of Items:
512
The type or types of ADT events to deliver to this endpoint, for example, ADT01 or ADT08.
Show Source
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Defined tags for this resource. Each key is predefined and scoped to a namespace.
For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).
Example: `{"Operations": {"CostCenter": "42"}}`
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace.
For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).
Example: `{"Department": "Finance"}`
Nested Schema : DeliveryEndpointOauth2Info
Type:
object
The OAuth 2.0 information that is used by a delivery endpoint.
Show Source
-
clientId(required):
string
The client identifier for OAuth 2.0 authentication.
-
clientSecretId(required):
string
The OCID for the secret that is associated with the client identifier.
-
grantType(required):
string
Default Value:
CLIENT_CREDENTIALS
Allowed Values:[ "CLIENT_CREDENTIALS" ]
The OAuth 2.0 grant type that is to be used. -
scope(required):
string
The scopes of the OAuth 2.0 authorization. The scopes are displayed as comma-separated values.
-
tokenUri(required):
string
The URI that is used to request the OAuth 2.0 token.
Nested Schema : requestHeaders
Type:
object
Minimum Number of Properties:
1
Maximum Number of Properties:
50
Additional Properties Allowed
Show Source
The request headers (that is, the key-value pairs) that the delivery endpoint requires.
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a defined tag key and value, scoped to a namespace.
Example: `{"CostCenter": "42"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
Response
Supported Media Types
- application/json
201 Response
The request was accepted. The DeliveryEndpoint will be created.
Headers
-
content-location: string(uri-reference)
See the location description above.
-
etag: string
For optimistic concurrency control. See `if-match`.
-
location: string(uri-reference)
The URL for the created constraints object. The object's Oracle Cloud Identifier (OCID) is generated after this request is sent.
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
-
opc-work-request-id: string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the asynchronous work request. Use GetWorkRequest with this ID to track the status of the request.
Root Schema : DeliveryEndpoint
Type:
object
A DeliveryEndpoint specifies how and where to deliver data of a particular type to a payer, and the information that is necessary
to authenticate with the receiver.
Show Source
-
adtEventType:
array adtEventType
Maximum Number of Items:
512
The type or types of admission, discharge, transfer (ADT) events to deliver to this endpoint, for example, ADT01 or ADT08. -
caBundleId(required):
string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the delivery endpoint CA bundle.
-
compartmentId(required):
string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the compartment.
-
definedTags:
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}`
-
description:
string
A detailed description of the delivery endpoint. This description can be changed.
-
displayName:
string
A user-friendly name. This name does not have to be unique, and it can be changed.
-
freeformTags:
object freeformTags
Additional Properties Allowed: additionalPropertiesFree-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}`
-
id(required):
string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the DeliveryEndpoint.
-
lifecycleDetails:
string
A message that describes the current state of the DeliveryEndpoint in more detail. For example, this message can be used to provide actionable information for a resource in a Failed state.
-
lifecycleState(required):
string
Allowed Values:
[ "CREATING", "UPDATING", "ACTIVE", "DELETING", "DELETED", "FAILED" ]
The current state of the DeliveryEndpoint. -
messageType(required):
string
Allowed Values:
[ "ADT" ]
The type of message to deliver to the payer at this endpoint. -
oauth2Info(required):
object DeliveryEndpointOauth2Info
The OAuth 2.0 information that is used by a delivery endpoint.
-
payerId(required):
string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the payer who uses this endpoint.
-
requestHeaders(required):
object requestHeaders
Minimum Number of Properties:
1
Maximum Number of Properties:50
Additional Properties Allowed: additionalPropertiesThe request headers (that is, the key-value pairs) that the delivery endpoint requires. -
systemTags:
object systemTags
Additional Properties Allowed: additionalPropertiesSystem tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}`
-
timeCreated(required):
string(date-time)
The date and time that the DeliveryEndpoint was created, in the format defined by [RFC 3339](https://tools.ietf.org/html/rfc3339). For example, `2016-08-25T21:10:29.600Z`
-
timeUpdated:
string(date-time)
The date and time that the DeliveryEndpoint was updated, in the format defined by [RFC 3339](https://tools.ietf.org/html/rfc3339). For example, `2016-08-25T21:10:29.600Z`
-
url(required):
string
A fully-formed https URL to which the system sends data.
Nested Schema : adtEventType
Type:
array
Maximum Number of Items:
512
The type or types of admission, discharge, transfer (ADT) events to deliver to this endpoint, for example, ADT01 or ADT08.
Show Source
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Defined tags for this resource. Each key is predefined and scoped to a namespace.
For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).
Example: `{"Operations": {"CostCenter": "42"}}`
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace.
For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm).
Example: `{"Department": "Finance"}`
Nested Schema : DeliveryEndpointOauth2Info
Type:
object
The OAuth 2.0 information that is used by a delivery endpoint.
Show Source
-
clientId(required):
string
The client identifier for OAuth 2.0 authentication.
-
clientSecretId(required):
string
The OCID for the secret that is associated with the client identifier.
-
grantType(required):
string
Default Value:
CLIENT_CREDENTIALS
Allowed Values:[ "CLIENT_CREDENTIALS" ]
The OAuth 2.0 grant type that is to be used. -
scope(required):
string
The scopes of the OAuth 2.0 authorization. The scopes are displayed as comma-separated values.
-
tokenUri(required):
string
The URI that is used to request the OAuth 2.0 token.
Nested Schema : requestHeaders
Type:
object
Minimum Number of Properties:
1
Maximum Number of Properties:
50
Additional Properties Allowed
Show Source
The request headers (that is, the key-value pairs) that the delivery endpoint requires.
Nested Schema : systemTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained": "true"}`
System tags for this resource. Each key is predefined and scoped to a namespace.
Example: `{"orcl-cloud": {"free-tier-retained": "true"}}`
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a defined tag key and value, scoped to a namespace.
Example: `{"CostCenter": "42"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a system tag key and value, scoped to a namespace.
Example: `{"free-tier-retained": "true"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
409 Response
Conflict
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
Default Response
An error has occurred.
Headers
-
opc-request-id: string
Unique identifier for the request
Root Schema : Error
Type:
object
Error information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.