Static
createThe Certificate Authority object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an OCSP Responder Trusted Common Name object. Create an OCSP Responder Trusted Common Name object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x | x | |||
ocspTlsTrustedCommonName | x | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities.
CertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OCSP Responder Trusted Common Name object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Client Certificate Authority object. Create a Client Certificate Authority object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
ClientCertAuthority | crlDayList | crlTimeList | |
ClientCertAuthority | crlTimeList | crlDayList |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Certificate Authority object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an OCSP Responder Trusted Common Name object. Create an OCSP Responder Trusted Common Name object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x | ||||
ocspTlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OCSP Responder Trusted Common Name object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Cluster object. Create a Cluster object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | ||||
authenticationClientCertContent | x | x | ||||
authenticationClientCertPassword | x | |||||
dmrClusterName | x | x | ||||
nodeName | x | |||||
tlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
DmrCluster | authenticationClientCertPassword | authenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterResponse The Cluster object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cluster object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule object. Create a Certificate Matching Rule object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule Attribute Filter object. Create a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
filterName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule Condition object. Create a Certificate Matching Rule Condition object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule Condition compares data extracted from a certificate to a link attribute or an expression.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
ruleName | x | x | ||||
source | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Condition object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Link object. Create a Link object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | ||||
dmrClusterName | x | x | ||||
remoteNodeName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkResponse The Link object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Link object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Link Attribute object. Create a Link Attribute object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Link Attribute is a key+value pair that can be used to locate a DMR Cluster Link, for example when using client certificate mapping.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
attributeName | x | x | ||||
attributeValue | x | x | ||||
dmrClusterName | x | x | ||||
remoteNodeName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterLinkAttributeResponse The Link Attribute object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Link Attribute object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Remote Address object. Create a Remote Address object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Each Remote Address, consisting of a FQDN or IP address and optional port, is used to connect to the remote node for this Link. Up to 4 addresses may be provided for each Link, and will be tried on a round-robin basis.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
remoteAddress | x | x | ||||
remoteNodeName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkRemoteAddressResponse The Remote Address object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Remote Address object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Trusted Common Name object. Create a Trusted Common Name object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
The Trusted Common Names for the Link are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | x | |||
remoteNodeName | x | x | x | |||
tlsTrustedCommonName | x | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
DmrClusterLinkTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Trusted Common Name object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Domain Certificate Authority object. Create a Domain Certificate Authority object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Certificate Authorities trusted for domain verification.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Domain Certificate Authority object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Message VPN object. Create a Message VPN object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationOauthDefaultProviderName | x | |||||
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | x | |||||
distributedCacheManagementEnabled | x | |||||
msgVpnName | x | x | ||||
replicationBridgeAuthenticationBasicPassword | x | x | ||||
replicationBridgeAuthenticationClientCertContent | x | x | ||||
replicationBridgeAuthenticationClientCertPassword | x | |||||
replicationEnabledQueueBehavior | x | |||||
restTlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue | |
MsgVpn | authenticationBasicProfileName | authenticationBasicType | |
MsgVpn | authorizationProfileName | authorizationType | |
MsgVpn | eventPublishTopicFormatMqttEnabled | eventPublishTopicFormatSmfEnabled | |
MsgVpn | eventPublishTopicFormatSmfEnabled | eventPublishTopicFormatMqttEnabled | |
MsgVpn | replicationBridgeAuthenticationBasicClientUsername | replicationBridgeAuthenticationBasicPassword | |
MsgVpn | replicationBridgeAuthenticationBasicPassword | replicationBridgeAuthenticationBasicClientUsername | |
MsgVpn | replicationBridgeAuthenticationClientCertPassword | replicationBridgeAuthenticationClientCertContent | |
MsgVpn | replicationEnabledQueueBehavior | replicationEnabled |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnResponse The Message VPN object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an ACL Profile object. Create an ACL Profile object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileResponse The ACL Profile object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The ACL Profile object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Client Connect Exception object. Create a Client Connect Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Client Connect Exception is an exception to the default action to take when a client using the ACL Profile connects to the Message VPN. Exceptions must be expressed as an IP address/netmask in CIDR form.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
clientConnectExceptionAddress | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileClientConnectExceptionResponse The Client Connect Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Client Connect Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Publish Topic Exception object. Create a Publish Topic Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | x | |||
msgVpnName | x | x | x | |||
publishExceptionTopic | x | x | x | |||
topicSyntax | x | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.14. Replaced by publishTopicExceptions.
MsgVpnAclProfilePublishExceptionResponse The Publish Topic Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Publish Topic Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Publish Topic Exception object. Create a Publish Topic Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
msgVpnName | x | x | ||||
publishTopicException | x | x | ||||
publishTopicExceptionSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfilePublishTopicExceptionResponse The Publish Topic Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Publish Topic Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Subscribe Topic Exception object. Create a Subscribe Topic Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | x | |||
msgVpnName | x | x | x | |||
subscribeExceptionTopic | x | x | x | |||
topicSyntax | x | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.14. Replaced by subscribeTopicExceptions.
MsgVpnAclProfileSubscribeExceptionResponse The Subscribe Topic Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Subscribe Topic Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Subscribe Share Name Exception object. Create a Subscribe Share Name Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Share Name Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a share-name subscription in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
msgVpnName | x | x | ||||
subscribeShareNameException | x | x | ||||
subscribeShareNameExceptionSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeShareNameExceptionResponse The Subscribe Share Name Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Subscribe Share Name Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Subscribe Topic Exception object. Create a Subscribe Topic Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
msgVpnName | x | x | ||||
subscribeTopicException | x | x | ||||
subscribeTopicExceptionSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeTopicExceptionResponse The Subscribe Topic Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The Subscribe Topic Exception object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an OAuth Profile object. Create an OAuth Profile object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientSecret | x | x | ||||
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Required Claim object. Create a Required Claim object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
Additional claims to be verified in the ID token.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientRequiredClaimName | x | x | ||||
clientRequiredClaimValue | x | |||||
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Required Claim object's attributes. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Required Claim object. Create a Required Claim object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
Additional claims to be verified in the access token.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
oauthProfileName | x | x | ||||
resourceServerRequiredClaimName | x | x | ||||
resourceServerRequiredClaimValue | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Required Claim object's attributes. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an OAuth Provider object. Create an OAuth Provider object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
audienceClaimName | x | |||||
audienceClaimSource | x | |||||
audienceClaimValue | x | |||||
audienceValidationEnabled | x | |||||
authorizationGroupClaimName | x | |||||
authorizationGroupClaimSource | x | |||||
authorizationGroupEnabled | x | |||||
disconnectOnTokenExpirationEnabled | x | |||||
enabled | x | |||||
jwksRefreshInterval | x | |||||
jwksUri | x | |||||
msgVpnName | x | x | x | |||
oauthProviderName | x | x | x | |||
tokenIgnoreTimeLimitsEnabled | x | |||||
tokenIntrospectionParameterName | x | |||||
tokenIntrospectionPassword | x | x | x | |||
tokenIntrospectionTimeout | x | |||||
tokenIntrospectionUri | x | |||||
tokenIntrospectionUsername | x | |||||
usernameClaimName | x | |||||
usernameClaimSource | x | |||||
usernameValidateEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Provider object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an Authorization Group object. Create an Authorization Group object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authorizationGroupName | x | x | ||||
msgVpnName | x | x | ||||
orderAfterAuthorizationGroupName | x | |||||
orderBeforeAuthorizationGroupName | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnAuthorizationGroup | orderAfterAuthorizationGroupName | orderBeforeAuthorizationGroupName | |
MsgVpnAuthorizationGroup | orderBeforeAuthorizationGroupName | orderAfterAuthorizationGroupName |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Authorization Group object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Bridge object. Create a Bridge object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | ||||
bridgeVirtualRouter | x | x | ||||
msgVpnName | x | x | ||||
remoteAuthenticationBasicPassword | x | x | ||||
remoteAuthenticationClientCertContent | x | x | ||||
remoteAuthenticationClientCertPassword | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridge | remoteAuthenticationBasicClientUsername | remoteAuthenticationBasicPassword | |
MsgVpnBridge | remoteAuthenticationBasicPassword | remoteAuthenticationBasicClientUsername | |
MsgVpnBridge | remoteAuthenticationClientCertPassword | remoteAuthenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeResponse The Bridge object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Bridge object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Remote Message VPN object. Create a Remote Message VPN object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Remote Message VPN is the Message VPN that the Bridge connects to.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | ||||
bridgeVirtualRouter | x | x | ||||
msgVpnName | x | x | ||||
password | x | x | ||||
remoteMsgVpnInterface | x | |||||
remoteMsgVpnLocation | x | x | ||||
remoteMsgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridgeRemoteMsgVpn | clientUsername | password | |
MsgVpnBridgeRemoteMsgVpn | password | clientUsername |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Remote Message VPN object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Remote Subscription object. Create a Remote Subscription object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Remote Subscription is a topic subscription used by the Message VPN Bridge to attract messages from the remote message broker.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | ||||
bridgeVirtualRouter | x | x | ||||
deliverAlwaysEnabled | x | |||||
msgVpnName | x | x | ||||
remoteSubscriptionTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteSubscriptionResponse The Remote Subscription object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Remote Subscription object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Trusted Common Name object. Create a Trusted Common Name object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Trusted Common Names for the Bridge are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | x | |||
bridgeVirtualRouter | x | x | x | |||
msgVpnName | x | x | x | |||
tlsTrustedCommonName | x | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnBridgeTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Trusted Common Name object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule object. Create a Certificate Matching Rule object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule Attribute Filter object. Create a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
filterName | x | x | ||||
msgVpnName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Certificate Matching Rule Condition object. Create a Certificate Matching Rule Condition object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule Condition compares data extracted from a certificate to a username attribute or an expression.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
ruleName | x | x | ||||
source | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Condition object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Client Profile object. Create a Client Profile object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
allowCutThroughForwardingEnabled | x | |||||
apiQueueManagementCopyFromOnCreateName | x | |||||
apiTopicEndpointManagementCopyFromOnCreateName | x | |||||
clientProfileName | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientProfileResponse The Client Profile object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Profile object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Client Username object. Create a Client Username object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientUsername | x | x | ||||
msgVpnName | x | x | ||||
password | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientUsernameResponse The Client Username object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Username object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Client Username Attribute object. Create a Client Username Attribute object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A ClientUsername Attribute is a key+value pair that can be used to locate a client username, for example when using client certificate mapping.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
attributeName | x | x | ||||
attributeValue | x | x | ||||
clientUsername | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnClientUsernameAttributeResponse The Client Username Attribute object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Username Attribute object's attributes. *
The name of the Client Username. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Distributed Cache object. Create a Distributed Cache object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnDistributedCache | scheduledDeleteMsgDayList | scheduledDeleteMsgTimeList | |
MsgVpnDistributedCache | scheduledDeleteMsgTimeList | scheduledDeleteMsgDayList |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Distributed Cache object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Cache Cluster object. Create a Cache Cluster object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent | |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Cluster object's attributes. *
The name of the Distributed Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Home Cache Cluster object. Create a Home Cache Cluster object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Home Cache Cluster is a Cache Cluster that is the "definitive" Cache Cluster for a given topic in the context of the Global Caching feature.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
homeClusterName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse The Home Cache Cluster object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Home Cache Cluster object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Topic Prefix object. Create a Topic Prefix object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Prefix is a prefix for a global topic that is available from the containing Home Cache Cluster.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
homeClusterName | x | x | ||||
msgVpnName | x | x | ||||
topicPrefix | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse The Topic Prefix object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Prefix object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Cache Instance object. Create a Cache Instance object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
instanceName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Instance object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Topic object. Create a Topic object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Cache Instances that belong to the containing Cache Cluster will cache any messages published to topics that match a Topic Subscription.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
msgVpnName | x | x | ||||
topic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterTopicResponse The Topic object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a DMR Bridge object. Create a DMR Bridge object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
remoteNodeName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The DMR Bridge object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a JNDI Connection Factory object. Create a JNDI Connection Factory object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
connectionFactoryName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Connection Factory object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a JNDI Queue object. Create a JNDI Queue object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a JNDI Topic object. Create a JNDI Topic object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
topicName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an MQTT Retain Cache object. Create an MQTT Retain Cache object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Retain Cache object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an MQTT Session object. Create an MQTT Session object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
mqttSessionClientId | x | x | ||||
mqttSessionVirtualRouter | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionResponse The MQTT Session object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Session object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Subscription object. Create a Subscription object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
mqttSessionClientId | x | x | ||||
mqttSessionVirtualRouter | x | x | ||||
msgVpnName | x | x | ||||
subscriptionTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Subscription object's attributes. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Queue object. Create a Queue object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueResponse The Queue object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Queue Subscription object. Create a Queue Subscription object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
One or more Queue Subscriptions can be added to a durable queue so that Guaranteed messages published to matching topics are also delivered to and spooled by the queue.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueName | x | x | ||||
subscriptionTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueSubscriptionResponse The Queue Subscription object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Subscription object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Queue Template object. Create a Queue Template object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnQueueTemplateResponse The Queue Template object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Replay Log object. Create a Replay Log object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
replayLogName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.10.
MsgVpnReplayLogResponse The Replay Log object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replay Log object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Topic Filter Subscription object. Create a Topic Filter Subscription object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
One or more Subscriptions can be added to a replay-log so that only guaranteed messages published to matching topics are stored in the Replay Log.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
replayLogName | x | x | ||||
topicFilterSubscription | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnReplayLogTopicFilterSubscriptionResponse The Topic Filter Subscription object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Filter Subscription object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Replicated Topic object. Create a Replicated Topic object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
replicatedTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replicated Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a REST Delivery Point object. Create a REST Delivery Point object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Delivery Point object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Queue Binding object. Create a Queue Binding object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Binding object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Protected Request Header object. Create a Protected Request Header object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
headerName | x | x | ||||
headerValue | x | x | ||||
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.30.
MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Protected Request Header object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Request Header object. Create a Request Header object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A request header to be added to the HTTP request.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
headerName | x | x | ||||
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.23.
MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Request Header object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a REST Consumer object. Create a REST Consumer object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationAwsSecretAccessKey | x | x | ||||
authenticationClientCertContent | x | x | ||||
authenticationClientCertPassword | x | |||||
authenticationHttpBasicPassword | x | x | ||||
authenticationHttpHeaderValue | x | x | ||||
authenticationOauthClientSecret | x | x | ||||
authenticationOauthJwtSecretKey | x | x | ||||
msgVpnName | x | x | ||||
restConsumerName | x | x | ||||
restDeliveryPointName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnRestDeliveryPointRestConsumer | authenticationClientCertPassword | authenticationClientCertContent | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicPassword | authenticationHttpBasicUsername | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicUsername | authenticationHttpBasicPassword | |
MsgVpnRestDeliveryPointRestConsumer | remotePort | tlsEnabled | |
MsgVpnRestDeliveryPointRestConsumer | tlsEnabled | remotePort |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Consumer object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Claim object. Create a Claim object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Claim is added to the JWT sent to the OAuth token request endpoint.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
oauthJwtClaimName | x | x | ||||
oauthJwtClaimValue | x | |||||
restConsumerName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.21.
MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse The Claim object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Claim object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Trusted Common Name object. Create a Trusted Common Name object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Trusted Common Names for the REST Consumer are used by encrypted transports to verify the name in the certificate presented by the remote REST consumer. They must include the common name of the remote REST consumer's server certificate.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | x | |||
restConsumerName | x | x | x | |||
restDeliveryPointName | x | x | x | |||
tlsTrustedCommonName | x | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since (will be deprecated in next SEMP version). Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Trusted Common Name object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Sequenced Topic object. Create a Sequenced Topic object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Sequenced Topic is a topic subscription for which any matching messages received on the Message VPN are assigned a sequence number that is monotonically increased by a value of one per message.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
sequencedTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnSequencedTopicResponse The Sequenced Topic object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Sequenced Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Topic Endpoint object. Create a Topic Endpoint object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
topicEndpointName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Topic Endpoint Template object. Create a Topic Endpoint Template object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
topicEndpointTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an OAuth Profile object. Create an OAuth Profile object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientSecret | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileResponse The OAuth Profile object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Group Access Level object. Create a Group Access Level object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
groupName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
globalAccessLevel | global/admin |
This has been available since 2.24.
OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Group Access Level object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Message VPN Access-Level Exception object. Create a Message VPN Access-Level Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Message VPN access-level exceptions for members of this group.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
groupName | x | x | ||||
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the group. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an Allowed Host Value object. Create an Allowed Host Value object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A valid hostname for this broker in OAuth redirects.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
allowedHost | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAllowedHostResponse The Allowed Host Value object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Allowed Host Value object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate an Authorization Parameter object. Create an Authorization Parameter object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Additional parameters to be passed to the OAuth authorization endpoint.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
authorizationParameterName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Authorization Parameter object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Required Claim object. Create a Required Claim object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Additional claims to be verified in the ID token.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientRequiredClaimName | x | x | ||||
clientRequiredClaimValue | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Required Claim object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Message VPN Access-Level Exception object. Create a Message VPN Access-Level Exception object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Default message VPN access-level exceptions.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Required Claim object. Create a Required Claim object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Additional claims to be verified in the access token.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
oauthProfileName | x | x | ||||
resourceServerRequiredClaimName | x | x | ||||
resourceServerRequiredClaimValue | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Required Claim object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
createCreate a Virtual Hostname object. Create a Virtual Hostname object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
Attribute | Identifying | Required | Read-Only | Write-Only | Deprecated | Opaque |
---|---|---|---|---|---|---|
virtualHostname | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.17.
VirtualHostnameResponse The Virtual Hostname object's attributes after being created, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Virtual Hostname object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Authority object. Delete a Certificate Authority object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Certificate Authority. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an OCSP Responder Trusted Common Name object. Delete an OCSP Responder Trusted Common Name object. The deletion of instances of this object are synchronized to HA mates via config-sync.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Certificate Authority. *
The expected Trusted Common Name of the OCSP responder remote certificate. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Client Certificate Authority object. Delete a Client Certificate Authority object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Certificate Authority. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an OCSP Responder Trusted Common Name object. Delete an OCSP Responder Trusted Common Name object. The deletion of instances of this object are synchronized to HA mates via config-sync.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Certificate Authority. *
The expected Trusted Common Name of the OCSP responder remote certificate. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Cluster object. Delete a Cluster object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule object. Delete a Certificate Matching Rule object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The name of the rule. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule Attribute Filter object. Delete a Certificate Matching Rule Attribute Filter object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The name of the filter. *
The name of the rule. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule Condition object. Delete a Certificate Matching Rule Condition object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Cert Matching Rule Condition compares data extracted from a certificate to a link attribute or an expression.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The name of the rule. *
Certificate field to be compared with the Attribute. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Link object. Delete a Link object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The name of the node at the remote end of the Link. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Link Attribute object. Delete a Link Attribute object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Link Attribute is a key+value pair that can be used to locate a DMR Cluster Link, for example when using client certificate mapping.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Attribute. *
The value of the Attribute. *
The name of the Cluster. *
The name of the node at the remote end of the Link. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Remote Address object. Delete a Remote Address object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Each Remote Address, consisting of a FQDN or IP address and optional port, is used to connect to the remote node for this Link. Up to 4 addresses may be provided for each Link, and will be tried on a round-robin basis.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The FQDN or IP address (and optional port) of the remote node. If a port is not provided, it will vary based on the transport encoding: 55555 (plain-text), 55443 (encrypted), or 55003 (compressed). *
The name of the node at the remote end of the Link. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Trusted Common Name object. Delete a Trusted Common Name object. The deletion of instances of this object are synchronized to HA mates via config-sync.
The Trusted Common Names for the Link are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Cluster. *
The name of the node at the remote end of the Link. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Domain Certificate Authority object. Delete a Domain Certificate Authority object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Certificate Authorities trusted for domain verification.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Certificate Authority. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Message VPN object. Delete a Message VPN object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an ACL Profile object. Delete an ACL Profile object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Client Connect Exception object. Delete a Client Connect Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Client Connect Exception is an exception to the default action to take when a client using the ACL Profile connects to the Message VPN. Exceptions must be expressed as an IP address/netmask in CIDR form.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The IP address/netmask of the client connect exception in CIDR form. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Publish Topic Exception object. Delete a Publish Topic Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.14. Replaced by publishTopicExceptions.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Publish Topic Exception object. Delete a Publish Topic Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Subscribe Topic Exception object. Delete a Subscribe Topic Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.14. Replaced by subscribeTopicExceptions.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Subscribe Share Name Exception object. Delete a Subscribe Share Name Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Share Name Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a share-name subscription in the Message VPN. Exceptions must be expressed as a topic.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
The subscribe share name exception to the default action taken. May include wildcard characters. *
The syntax of the subscribe share name for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Subscribe Topic Exception object. Delete a Subscribe Topic Exception object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an OAuth Profile object. Delete an OAuth Profile object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
OAuth profiles specify how to securely authenticate to an OAuth provider.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Required Claim object. Delete a Required Claim object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
Additional claims to be verified in the ID token.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ID token claim to verify. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Required Claim object. Delete a Required Claim object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
Additional claims to be verified in the access token.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the OAuth profile. *
The name of the access token claim to verify. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an OAuth Provider object. Delete an OAuth Provider object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the OAuth Provider. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Authorization Group object. Delete an Authorization Group object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Authorization Group. For LDAP groups, special care is needed if the group name contains special characters such as '#', '+', ';', '=' as the value of the group name returned from the LDAP server might prepend those characters with ''. For example a group name called 'test#,lab,com' will be returned from the LDAP server as 'test#,lab,com'. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Bridge object. Delete a Bridge object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Remote Message VPN object. Delete a Remote Message VPN object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Remote Message VPN is the Message VPN that the Bridge connects to.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
The physical interface on the local Message VPN host for connecting to the remote Message VPN. By default, an interface is chosen automatically (recommended), but if specified, remoteMsgVpnLocation
must not be a virtual router name. *
The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *
The name of the remote Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Remote Subscription object. Delete a Remote Subscription object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Remote Subscription is a topic subscription used by the Message VPN Bridge to attract messages from the remote message broker.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
The topic of the Bridge remote subscription. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Trusted Common Name object. Delete a Trusted Common Name object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Trusted Common Names for the Bridge are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule object. Delete a Certificate Matching Rule object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the rule. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule Attribute Filter object. Delete a Certificate Matching Rule Attribute Filter object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the filter. *
The name of the Message VPN. *
The name of the rule. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Certificate Matching Rule Condition object. Delete a Certificate Matching Rule Condition object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cert Matching Rule Condition compares data extracted from a certificate to a username attribute or an expression.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the rule. *
Certificate field to be compared with the Attribute. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Client Profile object. Delete a Client Profile object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Client Profile. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Client Username object. Delete a Client Username object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Client Username. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Client Username Attribute object. Delete a Client Username Attribute object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A ClientUsername Attribute is a key+value pair that can be used to locate a client username, for example when using client certificate mapping.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.27.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Attribute. *
The value of the Attribute. *
The name of the Client Username. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Distributed Cache object. Delete a Distributed Cache object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Cache Cluster object. Delete a Cache Cluster object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Home Cache Cluster object. Delete a Home Cache Cluster object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Home Cache Cluster is a Cache Cluster that is the "definitive" Cache Cluster for a given topic in the context of the Global Caching feature.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Topic Prefix object. Delete a Topic Prefix object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Prefix is a prefix for a global topic that is available from the containing Home Cache Cluster.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
A topic prefix for global topics available from the remote Home Cache Cluster. A wildcard (/>) is implied at the end of the prefix. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Cache Instance object. Delete a Cache Instance object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Cache Instance. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Topic object. Delete a Topic object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Cache Instances that belong to the containing Cache Cluster will cache any messages published to topics that match a Topic Subscription.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
The value of the Topic in the form a/b/c. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a DMR Bridge object. Delete a DMR Bridge object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the node at the remote end of the DMR Bridge. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a JNDI Connection Factory object. Delete a JNDI Connection Factory object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the JMS Connection Factory. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a JNDI Queue object. Delete a JNDI Queue object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The JNDI name of the JMS Queue. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a JNDI Topic object. Delete a JNDI Topic object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The JNDI name of the JMS Topic. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an MQTT Retain Cache object. Delete an MQTT Retain Cache object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the MQTT Retain Cache. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an MQTT Session object. Delete an MQTT Session object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
SempMetaOnlyResponse The request metadata.
ApiError
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Subscription object. Delete a Subscription object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
SempMetaOnlyResponse The request metadata.
ApiError
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
The MQTT subscription topic. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Queue object. Delete a Queue object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Queue. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Queue Subscription object. Delete a Queue Subscription object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
One or more Queue Subscriptions can be added to a durable queue so that Guaranteed messages published to matching topics are also delivered to and spooled by the queue.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Queue. *
The topic of the Subscription. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Queue Template object. Delete a Queue Template object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Queue Template. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Replay Log object. Delete a Replay Log object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.10.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Replay Log. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Topic Filter Subscription object. Delete a Topic Filter Subscription object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
One or more Subscriptions can be added to a replay-log so that only guaranteed messages published to matching topics are stored in the Replay Log.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.27.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Replay Log. *
The topic of the Subscription. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Replicated Topic object. Delete a Replicated Topic object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The topic for applying replication. Published messages matching this topic will be replicated to the standby site. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a REST Delivery Point object. Delete a REST Delivery Point object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Queue Binding object. Delete a Queue Binding object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Protected Request Header object. Delete a Protected Request Header object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.30.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the protected HTTP request header. *
The name of the Message VPN. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Request Header object. Delete a Request Header object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A request header to be added to the HTTP request.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.23.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the HTTP request header. *
The name of the Message VPN. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a REST Consumer object. Delete a REST Consumer object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Claim object. Delete a Claim object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Claim is added to the JWT sent to the OAuth token request endpoint.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.21.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the additional claim. Cannot be "exp", "iat", or "jti". *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Trusted Common Name object. Delete a Trusted Common Name object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
The Trusted Common Names for the REST Consumer are used by encrypted transports to verify the name in the certificate presented by the remote REST consumer. They must include the common name of the remote REST consumer's server certificate.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since (will be deprecated in next SEMP version). Common Name validation has been replaced by Server Certificate Name validation.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Sequenced Topic object. Delete a Sequenced Topic object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Sequenced Topic is a topic subscription for which any matching messages received on the Message VPN are assigned a sequence number that is monotonically increased by a value of one per message.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
Topic for applying sequence numbers. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Topic Endpoint object. Delete a Topic Endpoint object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Topic Endpoint. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Topic Endpoint Template object. Delete a Topic Endpoint Template object. The deletion of instances of this object are synchronized to HA mates and replication sites via config-sync.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the Message VPN. *
The name of the Topic Endpoint Template. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an OAuth Profile object. Delete an OAuth Profile object. The deletion of instances of this object are synchronized to HA mates via config-sync.
OAuth profiles specify how to securely authenticate to an OAuth provider.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Group Access Level object. Delete a Group Access Level object. The deletion of instances of this object are synchronized to HA mates via config-sync.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the group. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Message VPN Access-Level Exception object. Delete a Message VPN Access-Level Exception object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Message VPN access-level exceptions for members of this group.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the group. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Allowed Host Value object. Delete an Allowed Host Value object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A valid hostname for this broker in OAuth redirects.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
An allowed value for the Host header. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete an Authorization Parameter object. Delete an Authorization Parameter object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Additional parameters to be passed to the OAuth authorization endpoint.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the authorization parameter. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Required Claim object. Delete a Required Claim object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Additional claims to be verified in the ID token.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the ID token claim to verify. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Message VPN Access-Level Exception object. Delete a Message VPN Access-Level Exception object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Default message VPN access-level exceptions.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the message VPN. *
The name of the OAuth profile. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Required Claim object. Delete a Required Claim object. The deletion of instances of this object are synchronized to HA mates via config-sync.
Additional claims to be verified in the access token.
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
SempMetaOnlyResponse The request metadata.
ApiError
The name of the OAuth profile. *
The name of the access token claim to verify. *
Optional
xOptional context id the request is running. *
Static
deleteDelete a Virtual Hostname object. Delete a Virtual Hostname object. The deletion of instances of this object are synchronized to HA mates via config-sync.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.17.
SempMetaOnlyResponse The request metadata.
ApiError
The virtual hostname. *
Optional
xOptional context id the request is running. *
Static
getGet an About object. Get an About object.
This provides metadata about the SEMP API, such as the version of the API supported by the broker.
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been available since 2.13.
AboutResponse The About object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an API Description object. Get an API Description object.
The API Description object provides metadata about the SEMP API.
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been available since 2.2.
AboutApiResponse The API Description object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a User object. Get a User object.
Session and access level information about the user accessing the SEMP API.
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been available since 2.2.
AboutUserResponse The User object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a User Message VPN object. Get a User Message VPN object.
This provides information about the Message VPN access level for the username used to access the SEMP API.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been available since 2.2.
AboutUserMsgVpnResponse The User Message VPN object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of User Message VPN objects. Get a list of User Message VPN objects.
This provides information about the Message VPN access level for the username used to access the SEMP API.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been available since 2.2.
AboutUserMsgVpnsResponse The list of User Message VPN objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Broker object. Get a Broker object.
This object contains global configuration for the message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
tlsServerCertContent | x | x | ||
tlsServerCertPassword | x |
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
configSyncAuthenticationClientCertMaxChainDepth | global/read-only |
configSyncAuthenticationClientCertValidateDateEnabled | global/read-only |
configSyncClientProfileTcpInitialCongestionWindow | global/read-only |
configSyncClientProfileTcpKeepaliveCount | global/read-only |
configSyncClientProfileTcpKeepaliveIdle | global/read-only |
configSyncClientProfileTcpKeepaliveInterval | global/read-only |
configSyncClientProfileTcpMaxWindow | global/read-only |
configSyncClientProfileTcpMss | global/read-only |
configSyncEnabled | global/read-only |
configSyncSynchronizeUsernameEnabled | global/read-only |
configSyncTlsEnabled | global/read-only |
guaranteedMsgingDefragmentationScheduleDayList | global/read-only |
guaranteedMsgingDefragmentationScheduleEnabled | global/read-only |
guaranteedMsgingDefragmentationScheduleTimeList | global/read-only |
guaranteedMsgingDefragmentationThresholdEnabled | global/read-only |
guaranteedMsgingDefragmentationThresholdFragmentationPercentage | global/read-only |
guaranteedMsgingDefragmentationThresholdMinInterval | global/read-only |
guaranteedMsgingDefragmentationThresholdUsagePercentage | global/read-only |
guaranteedMsgingEnabled | global/read-only |
guaranteedMsgingEventCacheUsageThreshold.clearPercent | global/read-only |
guaranteedMsgingEventCacheUsageThreshold.clearValue | global/read-only |
guaranteedMsgingEventCacheUsageThreshold.setPercent | global/read-only |
guaranteedMsgingEventCacheUsageThreshold.setValue | global/read-only |
guaranteedMsgingEventDeliveredUnackedThreshold.clearPercent | global/read-only |
guaranteedMsgingEventDeliveredUnackedThreshold.setPercent | global/read-only |
guaranteedMsgingEventDiskUsageThreshold.clearPercent | global/read-only |
guaranteedMsgingEventDiskUsageThreshold.setPercent | global/read-only |
guaranteedMsgingEventEgressFlowCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventEgressFlowCountThreshold.clearValue | global/read-only |
guaranteedMsgingEventEgressFlowCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventEgressFlowCountThreshold.setValue | global/read-only |
guaranteedMsgingEventEndpointCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventEndpointCountThreshold.clearValue | global/read-only |
guaranteedMsgingEventEndpointCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventEndpointCountThreshold.setValue | global/read-only |
guaranteedMsgingEventIngressFlowCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventIngressFlowCountThreshold.clearValue | global/read-only |
guaranteedMsgingEventIngressFlowCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventIngressFlowCountThreshold.setValue | global/read-only |
guaranteedMsgingEventMsgCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventMsgCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventMsgSpoolFileCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventMsgSpoolFileCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventMsgSpoolUsageThreshold.clearPercent | global/read-only |
guaranteedMsgingEventMsgSpoolUsageThreshold.clearValue | global/read-only |
guaranteedMsgingEventMsgSpoolUsageThreshold.setPercent | global/read-only |
guaranteedMsgingEventMsgSpoolUsageThreshold.setValue | global/read-only |
guaranteedMsgingEventTransactedSessionCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventTransactedSessionCountThreshold.clearValue | global/read-only |
guaranteedMsgingEventTransactedSessionCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventTransactedSessionCountThreshold.setValue | global/read-only |
guaranteedMsgingEventTransactedSessionResourceCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventTransactedSessionResourceCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventTransactionCountThreshold.clearPercent | global/read-only |
guaranteedMsgingEventTransactionCountThreshold.clearValue | global/read-only |
guaranteedMsgingEventTransactionCountThreshold.setPercent | global/read-only |
guaranteedMsgingEventTransactionCountThreshold.setValue | global/read-only |
guaranteedMsgingMaxCacheUsage | global/read-only |
guaranteedMsgingMaxMsgSpoolUsage | global/read-only |
guaranteedMsgingMsgSpoolSyncMirroredMsgAckTimeout | global/read-only |
guaranteedMsgingMsgSpoolSyncMirroredSpoolFileAckTimeout | global/read-only |
guaranteedMsgingTransactionReplicationCompatibilityMode | global/read-only |
oauthProfileDefault | global/read-only |
serviceAmqpEnabled | global/read-only |
serviceAmqpTlsListenPort | global/read-only |
serviceEventConnectionCountThreshold.clearPercent | global/read-only |
serviceEventConnectionCountThreshold.clearValue | global/read-only |
serviceEventConnectionCountThreshold.setPercent | global/read-only |
serviceEventConnectionCountThreshold.setValue | global/read-only |
serviceHealthCheckEnabled | global/read-only |
serviceHealthCheckListenPort | global/read-only |
serviceMateLinkEnabled | global/read-only |
serviceMateLinkListenPort | global/read-only |
serviceMqttEnabled | global/read-only |
serviceMsgBackboneEnabled | global/read-only |
serviceRedundancyEnabled | global/read-only |
serviceRedundancyFirstListenPort | global/read-only |
serviceRestEventOutgoingConnectionCountThreshold.clearPercent | global/read-only |
serviceRestEventOutgoingConnectionCountThreshold.clearValue | global/read-only |
serviceRestEventOutgoingConnectionCountThreshold.setPercent | global/read-only |
serviceRestEventOutgoingConnectionCountThreshold.setValue | global/read-only |
serviceRestIncomingEnabled | global/read-only |
serviceRestOutgoingEnabled | global/read-only |
serviceSempCorsAllowAnyHostEnabled | global/read-only |
serviceSempLegacyTimeoutEnabled | global/read-only |
serviceSempPlainTextEnabled | global/read-only |
serviceSempPlainTextListenPort | global/read-only |
serviceSempSessionIdleTimeout | global/read-only |
serviceSempSessionMaxLifetime | global/read-only |
serviceSempTlsEnabled | global/read-only |
serviceSempTlsListenPort | global/read-only |
serviceSmfCompressionListenPort | global/read-only |
serviceSmfEnabled | global/read-only |
serviceSmfEventConnectionCountThreshold.clearPercent | global/read-only |
serviceSmfEventConnectionCountThreshold.clearValue | global/read-only |
serviceSmfEventConnectionCountThreshold.setPercent | global/read-only |
serviceSmfEventConnectionCountThreshold.setValue | global/read-only |
serviceSmfPlainTextListenPort | global/read-only |
serviceSmfRoutingControlListenPort | global/read-only |
serviceSmfTlsListenPort | global/read-only |
serviceTlsEventConnectionCountThreshold.clearPercent | global/read-only |
serviceTlsEventConnectionCountThreshold.clearValue | global/read-only |
serviceTlsEventConnectionCountThreshold.setPercent | global/read-only |
serviceTlsEventConnectionCountThreshold.setValue | global/read-only |
serviceWebTransportEnabled | global/read-only |
serviceWebTransportPlainTextListenPort | global/read-only |
serviceWebTransportTlsListenPort | global/read-only |
serviceWebTransportWebUrlSuffix | global/read-only |
tlsBlockVersion11Enabled | global/read-only |
tlsCipherSuiteManagementList | global/read-only |
tlsCipherSuiteMsgBackboneList | global/read-only |
tlsCipherSuiteSecureShellList | global/read-only |
tlsCrimeExploitProtectionEnabled | global/read-only |
tlsServerCertContent | global/read-only |
tlsStandardDomainCertificateAuthoritiesEnabled | vpn/read-only |
tlsTicketLifetime | global/read-only |
webManagerAllowUnencryptedWizardsEnabled | vpn/read-only |
webManagerCustomization | vpn/read-only |
webManagerRedirectHttpEnabled | vpn/read-only |
webManagerRedirectHttpOverrideTlsPort | vpn/read-only |
This has been available since 2.13.
BrokerResponse The Broker object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Authority objects. Get a list of Certificate Authority objects.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | x | ||
certContent | x | |||
crlDayList | x | |||
crlTimeList | x | |||
crlUrl | x | |||
ocspNonResponderCertEnabled | x | |||
ocspOverrideUrl | x | |||
ocspTimeout | x | |||
revocationCheckEnabled | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
CertAuthoritiesResponse The list of Certificate Authority objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Authority object. Get a Certificate Authority object.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | x | ||
certContent | x | |||
crlDayList | x | |||
crlTimeList | x | |||
crlUrl | x | |||
ocspNonResponderCertEnabled | x | |||
ocspOverrideUrl | x | |||
ocspTimeout | x | |||
revocationCheckEnabled | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
CertAuthorityResponse The Certificate Authority object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an OCSP Responder Trusted Common Name object. Get an OCSP Responder Trusted Common Name object.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | x | ||
ocspTlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities.
CertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
The expected Trusted Common Name of the OCSP responder remote certificate. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of OCSP Responder Trusted Common Name objects. Get a list of OCSP Responder Trusted Common Name objects.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | x | ||
ocspTlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities.
CertAuthorityOcspTlsTrustedCommonNamesResponse The list of OCSP Responder Trusted Common Name objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Client Certificate Authority objects. Get a list of Client Certificate Authority objects.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthoritiesResponse The list of Client Certificate Authority objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Client Certificate Authority object. Get a Client Certificate Authority object.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityResponse The Client Certificate Authority object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an OCSP Responder Trusted Common Name object. Get an OCSP Responder Trusted Common Name object.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | |||
ocspTlsTrustedCommonName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
The expected Trusted Common Name of the OCSP responder remote certificate. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of OCSP Responder Trusted Common Name objects. Get a list of OCSP Responder Trusted Common Name objects.
When an OCSP override URL is configured, the OCSP responder will be required to sign the OCSP responses with certificates issued to these Trusted Common Names. A maximum of 8 common names can be configured as valid response signers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x | |||
ocspTlsTrustedCommonName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityOcspTlsTrustedCommonNamesResponse The list of OCSP Responder Trusted Common Name objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Cluster object. Get a Cluster object.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationBasicPassword | x | x | ||
authenticationClientCertContent | x | x | ||
authenticationClientCertPassword | x | |||
dmrClusterName | x | |||
tlsServerCertEnforceTrustedCommonNameEnabled | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClusterResponse The Cluster object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule object. Get a Certificate Matching Rule object.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule Attribute Filter object. Get a Certificate Matching Rule Attribute Filter object.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
filterName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
The name of the filter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule Attribute Filter objects. Get a list of Certificate Matching Rule Attribute Filter objects.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
filterName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleAttributeFiltersResponse The list of Certificate Matching Rule Attribute Filter objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule Condition object. Get a Certificate Matching Rule Condition object.
A Cert Matching Rule Condition compares data extracted from a certificate to a link attribute or an expression.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
ruleName | x | |||
source | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Certificate field to be compared with the Attribute. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule Condition objects. Get a list of Certificate Matching Rule Condition objects.
A Cert Matching Rule Condition compares data extracted from a certificate to a link attribute or an expression.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
ruleName | x | |||
source | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleConditionsResponse The list of Certificate Matching Rule Condition objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule objects. Get a list of Certificate Matching Rule objects.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRulesResponse The list of Certificate Matching Rule objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Link object. Get a Link object.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationBasicPassword | x | x | ||
dmrClusterName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkResponse The Link object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Link Attribute object. Get a Link Attribute object.
A Link Attribute is a key+value pair that can be used to locate a DMR Cluster Link, for example when using client certificate mapping.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
attributeName | x | |||
attributeValue | x | |||
dmrClusterName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterLinkAttributeResponse The Link Attribute object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Attribute. *
The value of the Attribute. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Link Attribute objects. Get a list of Link Attribute objects.
A Link Attribute is a key+value pair that can be used to locate a DMR Cluster Link, for example when using client certificate mapping.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
attributeName | x | |||
attributeValue | x | |||
dmrClusterName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.28.
DmrClusterLinkAttributesResponse The list of Link Attribute objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Remote Address object. Get a Remote Address object.
Each Remote Address, consisting of a FQDN or IP address and optional port, is used to connect to the remote node for this Link. Up to 4 addresses may be provided for each Link, and will be tried on a round-robin basis.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
remoteAddress | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkRemoteAddressResponse The Remote Address object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The FQDN or IP address (and optional port) of the remote node. If a port is not provided, it will vary based on the transport encoding: 55555 (plain-text), 55443 (encrypted), or 55003 (compressed). *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Remote Address objects. Get a list of Remote Address objects.
Each Remote Address, consisting of a FQDN or IP address and optional port, is used to connect to the remote node for this Link. Up to 4 addresses may be provided for each Link, and will be tried on a round-robin basis.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | |||
remoteAddress | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkRemoteAddressesResponse The list of Remote Address objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Trusted Common Name object. Get a Trusted Common Name object.
The Trusted Common Names for the Link are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | x | ||
remoteNodeName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
DmrClusterLinkTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Trusted Common Name objects. Get a list of Trusted Common Name objects.
The Trusted Common Names for the Link are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
dmrClusterName | x | x | ||
remoteNodeName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
DmrClusterLinkTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Link objects. Get a list of Link objects.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationBasicPassword | x | x | ||
dmrClusterName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinksResponse The list of Link objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Cluster objects. Get a list of Cluster objects.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationBasicPassword | x | x | ||
authenticationClientCertContent | x | x | ||
authenticationClientCertPassword | x | |||
dmrClusterName | x | |||
tlsServerCertEnforceTrustedCommonNameEnabled | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.11.
DmrClustersResponse The list of Cluster objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Domain Certificate Authority objects. Get a list of Domain Certificate Authority objects.
Certificate Authorities trusted for domain verification.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
DomainCertAuthoritiesResponse The list of Domain Certificate Authority objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Domain Certificate Authority object. Get a Domain Certificate Authority object.
Certificate Authorities trusted for domain verification.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
certAuthorityName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.19.
DomainCertAuthorityResponse The Domain Certificate Authority object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Message VPN object. Get a Message VPN object.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationOauthDefaultProviderName | x | |||
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | x | |||
distributedCacheManagementEnabled | x | |||
msgVpnName | x | |||
replicationBridgeAuthenticationBasicPassword | x | x | ||
replicationBridgeAuthenticationClientCertContent | x | x | ||
replicationBridgeAuthenticationClientCertPassword | x | |||
replicationEnabledQueueBehavior | x | |||
restTlsServerCertEnforceTrustedCommonNameEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnResponse The Message VPN object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an ACL Profile object. Get an ACL Profile object.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileResponse The ACL Profile object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Client Connect Exception object. Get a Client Connect Exception object.
A Client Connect Exception is an exception to the default action to take when a client using the ACL Profile connects to the Message VPN. Exceptions must be expressed as an IP address/netmask in CIDR form.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
clientConnectExceptionAddress | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileClientConnectExceptionResponse The Client Connect Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The IP address/netmask of the client connect exception in CIDR form. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Client Connect Exception objects. Get a list of Client Connect Exception objects.
A Client Connect Exception is an exception to the default action to take when a client using the ACL Profile connects to the Message VPN. Exceptions must be expressed as an IP address/netmask in CIDR form.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
clientConnectExceptionAddress | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileClientConnectExceptionsResponse The list of Client Connect Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Publish Topic Exception object. Get a Publish Topic Exception object.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | x | ||
msgVpnName | x | x | ||
publishExceptionTopic | x | x | ||
topicSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.14. Replaced by publishTopicExceptions.
MsgVpnAclProfilePublishExceptionResponse The Publish Topic Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic for the exception to the default action taken. May include wildcard characters. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Publish Topic Exception objects. Get a list of Publish Topic Exception objects.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | x | ||
msgVpnName | x | x | ||
publishExceptionTopic | x | x | ||
topicSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.14. Replaced by publishTopicExceptions.
MsgVpnAclProfilePublishExceptionsResponse The list of Publish Topic Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Publish Topic Exception object. Get a Publish Topic Exception object.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
publishTopicException | x | |||
publishTopicExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfilePublishTopicExceptionResponse The Publish Topic Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Publish Topic Exception objects. Get a list of Publish Topic Exception objects.
A Publish Topic Exception is an exception to the default action to take when a client using the ACL Profile publishes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
publishTopicException | x | |||
publishTopicExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfilePublishTopicExceptionsResponse The list of Publish Topic Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Subscribe Topic Exception object. Get a Subscribe Topic Exception object.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | x | ||
msgVpnName | x | x | ||
subscribeExceptionTopic | x | x | ||
topicSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.14. Replaced by subscribeTopicExceptions.
MsgVpnAclProfileSubscribeExceptionResponse The Subscribe Topic Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Subscribe Topic Exception objects. Get a list of Subscribe Topic Exception objects.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | x | ||
msgVpnName | x | x | ||
subscribeExceptionTopic | x | x | ||
topicSyntax | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.14. Replaced by subscribeTopicExceptions.
MsgVpnAclProfileSubscribeExceptionsResponse The list of Subscribe Topic Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Subscribe Share Name Exception object. Get a Subscribe Share Name Exception object.
A Subscribe Share Name Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a share-name subscription in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
subscribeShareNameException | x | |||
subscribeShareNameExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeShareNameExceptionResponse The Subscribe Share Name Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The subscribe share name exception to the default action taken. May include wildcard characters. *
The syntax of the subscribe share name for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Subscribe Share Name Exception objects. Get a list of Subscribe Share Name Exception objects.
A Subscribe Share Name Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a share-name subscription in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
subscribeShareNameException | x | |||
subscribeShareNameExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeShareNameExceptionsResponse The list of Subscribe Share Name Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Subscribe Topic Exception object. Get a Subscribe Topic Exception object.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
subscribeTopicException | x | |||
subscribeTopicExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeTopicExceptionResponse The Subscribe Topic Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The topic for the exception to the default action taken. May include wildcard characters. *
The syntax of the topic for the exception to the default action taken. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Subscribe Topic Exception objects. Get a list of Subscribe Topic Exception objects.
A Subscribe Topic Exception is an exception to the default action to take when a client using the ACL Profile subscribes to a topic in the Message VPN. Exceptions must be expressed as a topic.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x | |||
subscribeTopicException | x | |||
subscribeTopicExceptionSyntax | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnAclProfileSubscribeTopicExceptionsResponse The list of Subscribe Topic Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of ACL Profile objects. Get a list of ACL Profile objects.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
aclProfileName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfilesResponse The list of ACL Profile objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an OAuth Profile object. Get an OAuth Profile object.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientSecret | x | x | ||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Required Claim object. Get a Required Claim object.
Additional claims to be verified in the ID token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientRequiredClaimName | x | |||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse The Required Claim object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ID token claim to verify. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Required Claim objects. Get a list of Required Claim objects.
Additional claims to be verified in the ID token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientRequiredClaimName | x | |||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileClientRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Required Claim object. Get a Required Claim object.
Additional claims to be verified in the access token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthProfileName | x | |||
resourceServerRequiredClaimName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the access token claim to verify. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Required Claim objects. Get a list of Required Claim objects.
Additional claims to be verified in the access token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthProfileName | x | |||
resourceServerRequiredClaimName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of OAuth Profile objects. Get a list of OAuth Profile objects.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientSecret | x | x | ||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfilesResponse The list of OAuth Profile objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an OAuth Provider object. Get an OAuth Provider object.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
audienceClaimName | x | |||
audienceClaimSource | x | |||
audienceClaimValue | x | |||
audienceValidationEnabled | x | |||
authorizationGroupClaimName | x | |||
authorizationGroupClaimSource | x | |||
authorizationGroupEnabled | x | |||
disconnectOnTokenExpirationEnabled | x | |||
enabled | x | |||
jwksRefreshInterval | x | |||
jwksUri | x | |||
msgVpnName | x | x | ||
oauthProviderName | x | x | ||
tokenIgnoreTimeLimitsEnabled | x | |||
tokenIntrospectionParameterName | x | |||
tokenIntrospectionPassword | x | x | x | |
tokenIntrospectionTimeout | x | |||
tokenIntrospectionUri | x | |||
tokenIntrospectionUsername | x | |||
usernameClaimName | x | |||
usernameClaimSource | x | |||
usernameValidateEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
The name of the OAuth Provider. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of OAuth Provider objects. Get a list of OAuth Provider objects.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
audienceClaimName | x | |||
audienceClaimSource | x | |||
audienceClaimValue | x | |||
audienceValidationEnabled | x | |||
authorizationGroupClaimName | x | |||
authorizationGroupClaimSource | x | |||
authorizationGroupEnabled | x | |||
disconnectOnTokenExpirationEnabled | x | |||
enabled | x | |||
jwksRefreshInterval | x | |||
jwksUri | x | |||
msgVpnName | x | x | ||
oauthProviderName | x | x | ||
tokenIgnoreTimeLimitsEnabled | x | |||
tokenIntrospectionParameterName | x | |||
tokenIntrospectionPassword | x | x | x | |
tokenIntrospectionTimeout | x | |||
tokenIntrospectionUri | x | |||
tokenIntrospectionUsername | x | |||
usernameClaimName | x | |||
usernameClaimSource | x | |||
usernameValidateEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
MsgVpnAuthenticationOauthProvidersResponse The list of OAuth Provider objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an Authorization Group object. Get an Authorization Group object.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authorizationGroupName | x | |||
msgVpnName | x | |||
orderAfterAuthorizationGroupName | x | |||
orderBeforeAuthorizationGroupName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Authorization Group. For LDAP groups, special care is needed if the group name contains special characters such as '#', '+', ';', '=' as the value of the group name returned from the LDAP server might prepend those characters with ''. For example a group name called 'test#,lab,com' will be returned from the LDAP server as 'test#,lab,com'. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Authorization Group objects. Get a list of Authorization Group objects.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authorizationGroupName | x | |||
msgVpnName | x | |||
orderAfterAuthorizationGroupName | x | |||
orderBeforeAuthorizationGroupName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnAuthorizationGroupsResponse The list of Authorization Group objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Bridge object. Get a Bridge object.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
remoteAuthenticationBasicPassword | x | x | ||
remoteAuthenticationClientCertContent | x | x | ||
remoteAuthenticationClientCertPassword | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeResponse The Bridge object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Remote Message VPN object. Get a Remote Message VPN object.
The Remote Message VPN is the Message VPN that the Bridge connects to.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
password | x | x | ||
remoteMsgVpnInterface | x | |||
remoteMsgVpnLocation | x | |||
remoteMsgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The physical interface on the local Message VPN host for connecting to the remote Message VPN. By default, an interface is chosen automatically (recommended), but if specified, remoteMsgVpnLocation
must not be a virtual router name. *
The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *
The name of the remote Message VPN. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Remote Message VPN objects. Get a list of Remote Message VPN objects.
The Remote Message VPN is the Message VPN that the Bridge connects to.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
password | x | x | ||
remoteMsgVpnInterface | x | |||
remoteMsgVpnLocation | x | |||
remoteMsgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteMsgVpnsResponse The list of Remote Message VPN objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Remote Subscription object. Get a Remote Subscription object.
A Remote Subscription is a topic subscription used by the Message VPN Bridge to attract messages from the remote message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
remoteSubscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteSubscriptionResponse The Remote Subscription object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic of the Bridge remote subscription. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Remote Subscription objects. Get a list of Remote Subscription objects.
A Remote Subscription is a topic subscription used by the Message VPN Bridge to attract messages from the remote message broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
remoteSubscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteSubscriptionsResponse The list of Remote Subscription objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Trusted Common Name object. Get a Trusted Common Name object.
The Trusted Common Names for the Bridge are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | x | ||
bridgeVirtualRouter | x | x | ||
msgVpnName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnBridgeTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Trusted Common Name objects. Get a list of Trusted Common Name objects.
The Trusted Common Names for the Bridge are used by encrypted transports to verify the name in the certificate presented by the remote node. They must include the common name of the remote node's server certificate or client certificate, depending upon the initiator of the connection.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | x | ||
bridgeVirtualRouter | x | x | ||
msgVpnName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since 2.18. Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnBridgeTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Bridge objects. Get a list of Bridge objects.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
bridgeName | x | |||
bridgeVirtualRouter | x | |||
msgVpnName | x | |||
remoteAuthenticationBasicPassword | x | x | ||
remoteAuthenticationClientCertContent | x | x | ||
remoteAuthenticationClientCertPassword | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgesResponse The list of Bridge objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule object. Get a Certificate Matching Rule object.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule Attribute Filter object. Get a Certificate Matching Rule Attribute Filter object.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
filterName | x | |||
msgVpnName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.28.
MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the filter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule Attribute Filter objects. Get a list of Certificate Matching Rule Attribute Filter objects.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
filterName | x | |||
msgVpnName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.28.
MsgVpnCertMatchingRuleAttributeFiltersResponse The list of Certificate Matching Rule Attribute Filter objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Certificate Matching Rule Condition object. Get a Certificate Matching Rule Condition object.
A Cert Matching Rule Condition compares data extracted from a certificate to a username attribute or an expression.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
ruleName | x | |||
source | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Certificate field to be compared with the Attribute. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule Condition objects. Get a list of Certificate Matching Rule Condition objects.
A Cert Matching Rule Condition compares data extracted from a certificate to a username attribute or an expression.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
ruleName | x | |||
source | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleConditionsResponse The list of Certificate Matching Rule Condition objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Certificate Matching Rule objects. Get a list of Certificate Matching Rule objects.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
ruleName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRulesResponse The list of Certificate Matching Rule objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Client Profile object. Get a Client Profile object.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
allowCutThroughForwardingEnabled | x | |||
apiQueueManagementCopyFromOnCreateName | x | |||
apiTopicEndpointManagementCopyFromOnCreateName | x | |||
clientProfileName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientProfileResponse The Client Profile object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Client Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Client Profile objects. Get a list of Client Profile objects.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
allowCutThroughForwardingEnabled | x | |||
apiQueueManagementCopyFromOnCreateName | x | |||
apiTopicEndpointManagementCopyFromOnCreateName | x | |||
clientProfileName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientProfilesResponse The list of Client Profile objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Client Username object. Get a Client Username object.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientUsername | x | |||
msgVpnName | x | |||
password | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientUsernameResponse The Client Username object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Client Username. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Client Username Attribute object. Get a Client Username Attribute object.
A ClientUsername Attribute is a key+value pair that can be used to locate a client username, for example when using client certificate mapping.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
attributeName | x | |||
attributeValue | x | |||
clientUsername | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnClientUsernameAttributeResponse The Client Username Attribute object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Attribute. *
The value of the Attribute. *
The name of the Client Username. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Client Username Attribute objects. Get a list of Client Username Attribute objects.
A ClientUsername Attribute is a key+value pair that can be used to locate a client username, for example when using client certificate mapping.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
attributeName | x | |||
attributeValue | x | |||
clientUsername | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnClientUsernameAttributesResponse The list of Client Username Attribute objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Client Username. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Client Username objects. Get a list of Client Username objects.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientUsername | x | |||
msgVpnName | x | |||
password | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientUsernamesResponse The list of Client Username objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Distributed Cache object. Get a Distributed Cache object.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheResponse The Distributed Cache object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Cache Cluster object. Get a Cache Cluster object.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Home Cache Cluster object. Get a Home Cache Cluster object.
A Home Cache Cluster is a Cache Cluster that is the "definitive" Cache Cluster for a given topic in the context of the Global Caching feature.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
homeClusterName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse The Home Cache Cluster object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Topic Prefix object. Get a Topic Prefix object.
A Topic Prefix is a prefix for a global topic that is available from the containing Home Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
homeClusterName | x | |||
msgVpnName | x | |||
topicPrefix | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse The Topic Prefix object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
A topic prefix for global topics available from the remote Home Cache Cluster. A wildcard (/>) is implied at the end of the prefix. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Topic Prefix objects. Get a list of Topic Prefix objects.
A Topic Prefix is a prefix for a global topic that is available from the containing Home Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
homeClusterName | x | |||
msgVpnName | x | |||
topicPrefix | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixesResponse The list of Topic Prefix objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the remote Home Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Home Cache Cluster objects. Get a list of Home Cache Cluster objects.
A Home Cache Cluster is a Cache Cluster that is the "definitive" Cache Cluster for a given topic in the context of the Global Caching feature.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
homeClusterName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterGlobalCachingHomeClustersResponse The list of Home Cache Cluster objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Cache Instance object. Get a Cache Instance object.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
instanceName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Cache Instance. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Cache Instance objects. Get a list of Cache Instance objects.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
instanceName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterInstancesResponse The list of Cache Instance objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Topic object. Get a Topic object.
The Cache Instances that belong to the containing Cache Cluster will cache any messages published to topics that match a Topic Subscription.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
msgVpnName | x | |||
topic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterTopicResponse The Topic object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The value of the Topic in the form a/b/c. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Topic objects. Get a list of Topic objects.
The Cache Instances that belong to the containing Cache Cluster will cache any messages published to topics that match a Topic Subscription.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
msgVpnName | x | |||
topic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterTopicsResponse The list of Topic objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
The name of the Cache Cluster. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Cache Cluster objects. Get a list of Cache Cluster objects.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
clusterName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClustersResponse The list of Cache Cluster objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Distributed Cache. *
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Distributed Cache objects. Get a list of Distributed Cache objects.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCachesResponse The list of Distributed Cache objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a DMR Bridge object. Get a DMR Bridge object.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDmrBridgeResponse The DMR Bridge object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the DMR Bridge. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of DMR Bridge objects. Get a list of DMR Bridge objects.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
remoteNodeName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnDmrBridgesResponse The list of DMR Bridge objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of JNDI Connection Factory objects. Get a list of JNDI Connection Factory objects.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
connectionFactoryName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiConnectionFactoriesResponse The list of JNDI Connection Factory objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a JNDI Connection Factory object. Get a JNDI Connection Factory object.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
connectionFactoryName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the JMS Connection Factory. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a JNDI Queue object. Get a JNDI Queue object.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiQueueResponse The JNDI Queue object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The JNDI name of the JMS Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of JNDI Queue objects. Get a list of JNDI Queue objects.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiQueuesResponse The list of JNDI Queue objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a JNDI Topic object. Get a JNDI Topic object.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiTopicResponse The JNDI Topic object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The JNDI name of the JMS Topic. *
Optional
xOptional context id the request is running. *
Static
getGet a list of JNDI Topic objects. Get a list of JNDI Topic objects.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiTopicsResponse The list of JNDI Topic objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an MQTT Retain Cache object. Get an MQTT Retain Cache object.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the MQTT Retain Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of MQTT Retain Cache objects. Get a list of MQTT Retain Cache objects.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
cacheName | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.11.
MsgVpnMqttRetainCachesResponse The list of MQTT Retain Cache objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an MQTT Session object. Get an MQTT Session object.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
mqttSessionClientId | x | |||
mqttSessionVirtualRouter | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionResponse The MQTT Session object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Subscription object. Get a Subscription object.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
mqttSessionClientId | x | |||
mqttSessionVirtualRouter | x | |||
msgVpnName | x | |||
subscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The MQTT subscription topic. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Subscription objects. Get a list of Subscription objects.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
mqttSessionClientId | x | |||
mqttSessionVirtualRouter | x | |||
msgVpnName | x | |||
subscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionSubscriptionsResponse The list of Subscription objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of MQTT Session objects. Get a list of MQTT Session objects.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
mqttSessionClientId | x | |||
mqttSessionVirtualRouter | x | |||
msgVpnName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionsResponse The list of MQTT Session objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Queue object. Get a Queue object.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueResponse The Queue object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Queue Subscription object. Get a Queue Subscription object.
One or more Queue Subscriptions can be added to a durable queue so that Guaranteed messages published to matching topics are also delivered to and spooled by the queue.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x | |||
subscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueSubscriptionResponse The Queue Subscription object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The topic of the Subscription. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Queue Subscription objects. Get a list of Queue Subscription objects.
One or more Queue Subscriptions can be added to a durable queue so that Guaranteed messages published to matching topics are also delivered to and spooled by the queue.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x | |||
subscriptionTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueSubscriptionsResponse The list of Queue Subscription objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Queue Template object. Get a Queue Template object.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueTemplateName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnQueueTemplateResponse The Queue Template object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue Template. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Queue Template objects. Get a list of Queue Template objects.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueTemplateName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnQueueTemplatesResponse The list of Queue Template objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Queue objects. Get a list of Queue objects.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueuesResponse The list of Queue objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Replay Log object. Get a Replay Log object.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replayLogName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.10.
MsgVpnReplayLogResponse The Replay Log object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Topic Filter Subscription object. Get a Topic Filter Subscription object.
One or more Subscriptions can be added to a replay-log so that only guaranteed messages published to matching topics are stored in the Replay Log.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replayLogName | x | |||
topicFilterSubscription | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnReplayLogTopicFilterSubscriptionResponse The Topic Filter Subscription object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The topic of the Subscription. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Topic Filter Subscription objects. Get a list of Topic Filter Subscription objects.
One or more Subscriptions can be added to a replay-log so that only guaranteed messages published to matching topics are stored in the Replay Log.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replayLogName | x | |||
topicFilterSubscription | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.27.
MsgVpnReplayLogTopicFilterSubscriptionsResponse The list of Topic Filter Subscription objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Replay Log objects. Get a list of Replay Log objects.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replayLogName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.10.
MsgVpnReplayLogsResponse The list of Replay Log objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Replicated Topic object. Get a Replicated Topic object.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replicatedTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic for applying replication. Published messages matching this topic will be replicated to the standby site. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Replicated Topic objects. Get a list of Replicated Topic objects.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
replicatedTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnReplicatedTopicsResponse The list of Replicated Topic objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a REST Delivery Point object. Get a REST Delivery Point object.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Queue Binding object. Get a Queue Binding object.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Protected Request Header object. Get a Protected Request Header object.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
headerName | x | |||
headerValue | x | x | ||
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.30.
MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the protected HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Protected Request Header objects. Get a list of Protected Request Header objects.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
headerName | x | |||
headerValue | x | x | ||
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.30.
MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeadersResponse The list of Protected Request Header objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Request Header object. Get a Request Header object.
A request header to be added to the HTTP request.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
headerName | x | |||
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.23.
MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Request Header objects. Get a list of Request Header objects.
A request header to be added to the HTTP request.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
headerName | x | |||
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.23.
MsgVpnRestDeliveryPointQueueBindingRequestHeadersResponse The list of Request Header objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Queue Binding objects. Get a list of Queue Binding objects.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
queueBindingName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointQueueBindingsResponse The list of Queue Binding objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a REST Consumer object. Get a REST Consumer object.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationAwsSecretAccessKey | x | x | ||
authenticationClientCertContent | x | x | ||
authenticationClientCertPassword | x | |||
authenticationHttpBasicPassword | x | x | ||
authenticationHttpHeaderValue | x | x | ||
authenticationOauthClientSecret | x | x | ||
authenticationOauthJwtSecretKey | x | x | ||
msgVpnName | x | |||
restConsumerName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Claim object. Get a Claim object.
A Claim is added to the JWT sent to the OAuth token request endpoint.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthJwtClaimName | x | |||
restConsumerName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.21.
MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse The Claim object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
The name of the additional claim. Cannot be "exp", "iat", or "jti". *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Claim objects. Get a list of Claim objects.
A Claim is added to the JWT sent to the OAuth token request endpoint.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthJwtClaimName | x | |||
restConsumerName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.21.
MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimsResponse The list of Claim objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Trusted Common Name object. Get a Trusted Common Name object.
The Trusted Common Names for the REST Consumer are used by encrypted transports to verify the name in the certificate presented by the remote REST consumer. They must include the common name of the remote REST consumer's server certificate.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | x | ||
restConsumerName | x | x | ||
restDeliveryPointName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since (will be deprecated in next SEMP version). Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The expected trusted common name of the remote certificate. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Trusted Common Name objects. Get a list of Trusted Common Name objects.
The Trusted Common Names for the REST Consumer are used by encrypted transports to verify the name in the certificate presented by the remote REST consumer. They must include the common name of the remote REST consumer's server certificate.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | x | ||
restConsumerName | x | x | ||
restDeliveryPointName | x | x | ||
tlsTrustedCommonName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been deprecated since (will be deprecated in next SEMP version). Common Name validation has been replaced by Server Certificate Name validation.
MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of REST Consumer objects. Get a list of REST Consumer objects.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationAwsSecretAccessKey | x | x | ||
authenticationClientCertContent | x | x | ||
authenticationClientCertPassword | x | |||
authenticationHttpBasicPassword | x | x | ||
authenticationHttpHeaderValue | x | x | ||
authenticationOauthClientSecret | x | x | ||
authenticationOauthJwtSecretKey | x | x | ||
msgVpnName | x | |||
restConsumerName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointRestConsumersResponse The list of REST Consumer objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of REST Delivery Point objects. Get a list of REST Delivery Point objects.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
restDeliveryPointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointsResponse The list of REST Delivery Point objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Sequenced Topic object. Get a Sequenced Topic object.
A Sequenced Topic is a topic subscription for which any matching messages received on the Message VPN are assigned a sequence number that is monotonically increased by a value of one per message.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
sequencedTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnSequencedTopicResponse The Sequenced Topic object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Topic for applying sequence numbers. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Sequenced Topic objects. Get a list of Sequenced Topic objects.
A Sequenced Topic is a topic subscription for which any matching messages received on the Message VPN are assigned a sequence number that is monotonically increased by a value of one per message.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
sequencedTopic | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnSequencedTopicsResponse The list of Sequenced Topic objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Topic Endpoint object. Get a Topic Endpoint object.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicEndpointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint. *
Optional
xOptional context id the request is running. *
Static
getGet a Topic Endpoint Template object. Get a Topic Endpoint Template object.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicEndpointTemplateName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint Template. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Topic Endpoint Template objects. Get a list of Topic Endpoint Template objects.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicEndpointTemplateName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.14.
MsgVpnTopicEndpointTemplatesResponse The list of Topic Endpoint Template objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Topic Endpoint objects. Get a list of Topic Endpoint objects.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
topicEndpointName | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.1.
MsgVpnTopicEndpointsResponse The list of Topic Endpoint objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Message VPN objects. Get a list of Message VPN objects.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authenticationOauthDefaultProviderName | x | |||
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | x | |||
distributedCacheManagementEnabled | x | |||
msgVpnName | x | |||
replicationBridgeAuthenticationBasicPassword | x | x | ||
replicationBridgeAuthenticationClientCertContent | x | x | ||
replicationBridgeAuthenticationClientCertPassword | x | |||
replicationEnabledQueueBehavior | x | |||
restTlsServerCertEnforceTrustedCommonNameEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-only" is required to perform this operation.
This has been available since 2.0.
MsgVpnsResponse The list of Message VPN objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an OAuth Profile object. Get an OAuth Profile object.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientSecret | x | x | ||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileResponse The OAuth Profile object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Group Access Level object. Get a Group Access Level object.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
groupName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the group. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Message VPN Access-Level Exception object. Get a Message VPN Access-Level Exception object.
Message VPN access-level exceptions for members of this group.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
groupName | x | |||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the group. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Message VPN Access-Level Exception objects. Get a list of Message VPN Access-Level Exception objects.
Message VPN access-level exceptions for members of this group.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
groupName | x | |||
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionsResponse The list of Message VPN Access-Level Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the group. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Group Access Level objects. Get a list of Group Access Level objects.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
groupName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupsResponse The list of Group Access Level objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an Allowed Host Value object. Get an Allowed Host Value object.
A valid hostname for this broker in OAuth redirects.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
allowedHost | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAllowedHostResponse The Allowed Host Value object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
An allowed value for the Host header. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Allowed Host Value objects. Get a list of Allowed Host Value objects.
A valid hostname for this broker in OAuth redirects.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
allowedHost | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAllowedHostsResponse The list of Allowed Host Value objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet an Authorization Parameter object. Get an Authorization Parameter object.
Additional parameters to be passed to the OAuth authorization endpoint.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authorizationParameterName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the authorization parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Authorization Parameter objects. Get a list of Authorization Parameter objects.
Additional parameters to be passed to the OAuth authorization endpoint.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
authorizationParameterName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAuthorizationParametersResponse The list of Authorization Parameter objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Required Claim object. Get a Required Claim object.
Additional claims to be verified in the ID token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientRequiredClaimName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientRequiredClaimResponse The Required Claim object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ID token claim to verify. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Required Claim objects. Get a list of Required Claim objects.
Additional claims to be verified in the ID token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientRequiredClaimName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Message VPN Access-Level Exception object. Get a Message VPN Access-Level Exception object.
Default message VPN access-level exceptions.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Message VPN Access-Level Exception objects. Get a list of Message VPN Access-Level Exception objects.
Default message VPN access-level exceptions.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
msgVpnName | x | |||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileDefaultMsgVpnAccessLevelExceptionsResponse The list of Message VPN Access-Level Exception objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Required Claim object. Get a Required Claim object.
Additional claims to be verified in the access token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
oauthProfileName | x | |||
resourceServerRequiredClaimName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the access token claim to verify. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Required Claim objects. Get a list of Required Claim objects.
Additional claims to be verified in the access token.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
oauthProfileName | x | |||
resourceServerRequiredClaimName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfileResourceServerRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a list of OAuth Profile objects. Get a list of OAuth Profile objects.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
clientSecret | x | x | ||
oauthProfileName | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.24.
OauthProfilesResponse The list of OAuth Profile objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a System Information object. Get a System Information object.
The System Information object provides metadata about the SEMP API.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
platform | x | |||
sempVersion | x |
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation.
This has been deprecated since 2.2. /systemInformation was replaced by /about/api.
SystemInformationResponse The System Information object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
getGet a Virtual Hostname object. Get a Virtual Hostname object.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
virtualHostname | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.17.
VirtualHostnameResponse The Virtual Hostname object's attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The virtual hostname. *
Optional
xOptional context id the request is running. *
Static
getGet a list of Virtual Hostname objects. Get a list of Virtual Hostname objects.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
Attribute | Identifying | Write-Only | Deprecated | Opaque |
---|---|---|---|---|
virtualHostname | x |
A SEMP client authorized with a minimum access scope/level of "global/read-only" is required to perform this operation.
This has been available since 2.17.
VirtualHostnamesResponse The list of Virtual Hostname objects' attributes, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
Optional
count?: numberLimit the count of objects in the response. See the documentation for the count
parameter. *
Optional
cursor?: stringThe cursor, or position, for the next page of objects. See the documentation for the cursor
parameter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
where?: string[]Include in the response only objects where certain conditions are true. See the the documentation for the where
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Certificate Authority object. Replace a Certificate Authority object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
certAuthorityName | x | x | x | ||||
certContent | x | ||||||
crlDayList | x | ||||||
crlTimeList | x | ||||||
crlUrl | x | x | |||||
ocspNonResponderCertEnabled | x | ||||||
ocspOverrideUrl | x | ||||||
ocspTimeout | x | ||||||
revocationCheckEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
CertAuthority | crlDayList | crlTimeList | |
CertAuthority | crlTimeList | crlDayList |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
CertAuthorityResponse The Certificate Authority object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Client Certificate Authority object. Replace a Client Certificate Authority object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
certAuthorityName | x | x | |||||
crlUrl | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
ClientCertAuthority | crlDayList | crlTimeList | |
ClientCertAuthority | crlTimeList | crlDayList |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Cluster object. Replace a Cluster object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | x | ||||
authenticationClientCertContent | x | x | x | ||||
authenticationClientCertPassword | x | x | |||||
directOnlyEnabled | x | ||||||
dmrClusterName | x | x | |||||
nodeName | x | ||||||
tlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
DmrCluster | authenticationClientCertPassword | authenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterResponse The Cluster object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cluster object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Certificate Matching Rule object. Replace a Certificate Matching Rule object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
dmrClusterName | x | x | |||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Certificate Matching Rule Attribute Filter object. Replace a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
dmrClusterName | x | x | |||||
filterName | x | x | |||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the Cluster. *
The name of the filter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Link object. Replace a Link object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | x | ||||
authenticationScheme | x | ||||||
dmrClusterName | x | x | |||||
egressFlowWindowSize | x | ||||||
initiator | x | ||||||
remoteNodeName | x | x | |||||
span | x | ||||||
transportCompressedEnabled | x | ||||||
transportTlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkResponse The Link object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Link object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Domain Certificate Authority object. Replace a Domain Certificate Authority object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Certificate Authorities trusted for domain verification.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
certAuthorityName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Domain Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Message VPN object. Replace a Message VPN object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
authenticationOauthDefaultProviderName | x | ||||||
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | x | ||||||
distributedCacheManagementEnabled | x | ||||||
msgVpnName | x | x | |||||
replicationBridgeAuthenticationBasicPassword | x | x | |||||
replicationBridgeAuthenticationClientCertContent | x | x | |||||
replicationBridgeAuthenticationClientCertPassword | x | ||||||
replicationEnabledQueueBehavior | x | ||||||
restTlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue | |
MsgVpn | authenticationBasicProfileName | authenticationBasicType | |
MsgVpn | authorizationProfileName | authorizationType | |
MsgVpn | eventPublishTopicFormatMqttEnabled | eventPublishTopicFormatSmfEnabled | |
MsgVpn | eventPublishTopicFormatSmfEnabled | eventPublishTopicFormatMqttEnabled | |
MsgVpn | replicationBridgeAuthenticationBasicClientUsername | replicationBridgeAuthenticationBasicPassword | |
MsgVpn | replicationBridgeAuthenticationBasicPassword | replicationBridgeAuthenticationBasicClientUsername | |
MsgVpn | replicationBridgeAuthenticationClientCertPassword | replicationBridgeAuthenticationClientCertContent | |
MsgVpn | replicationEnabledQueueBehavior | replicationEnabled |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
alias | global/read-write |
authenticationBasicEnabled | global/read-write |
authenticationBasicProfileName | global/read-write |
authenticationBasicRadiusDomain | global/read-write |
authenticationBasicType | global/read-write |
authenticationClientCertAllowApiProvidedUsernameEnabled | global/read-write |
authenticationClientCertCertificateMatchingRulesEnabled | global/read-write |
authenticationClientCertEnabled | global/read-write |
authenticationClientCertMaxChainDepth | global/read-write |
authenticationClientCertRevocationCheckMode | global/read-write |
authenticationClientCertUsernameSource | global/read-write |
authenticationClientCertValidateDateEnabled | global/read-write |
authenticationKerberosAllowApiProvidedUsernameEnabled | global/read-write |
authenticationKerberosEnabled | global/read-write |
authenticationOauthEnabled | global/read-write |
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | global/read-write |
bridgingTlsServerCertMaxChainDepth | global/read-write |
bridgingTlsServerCertValidateDateEnabled | global/read-write |
bridgingTlsServerCertValidateNameEnabled | global/read-write |
dmrEnabled | global/read-write |
exportSubscriptionsEnabled | global/read-write |
maxConnectionCount | global/read-write |
maxEgressFlowCount | global/read-write |
maxEndpointCount | global/read-write |
maxIngressFlowCount | global/read-write |
maxMsgSpoolUsage | global/read-write |
maxSubscriptionCount | global/read-write |
maxTransactedSessionCount | global/read-write |
maxTransactionCount | global/read-write |
mqttRetainMaxMemory | global/read-write |
replicationBridgeAuthenticationBasicClientUsername | global/read-write |
replicationBridgeAuthenticationBasicPassword | global/read-write |
replicationBridgeAuthenticationClientCertContent | global/read-write |
replicationBridgeAuthenticationClientCertPassword | global/read-write |
replicationBridgeAuthenticationScheme | global/read-write |
replicationBridgeCompressedDataEnabled | global/read-write |
replicationBridgeEgressFlowWindowSize | global/read-write |
replicationBridgeRetryDelay | global/read-write |
replicationBridgeTlsEnabled | global/read-write |
replicationBridgeUnidirectionalClientProfileName | global/read-write |
replicationEnabled | global/read-write |
replicationEnabledQueueBehavior | global/read-write |
replicationQueueMaxMsgSpoolUsage | global/read-write |
replicationRole | global/read-write |
restTlsServerCertEnforceTrustedCommonNameEnabled | global/read-write |
restTlsServerCertMaxChainDepth | global/read-write |
restTlsServerCertValidateDateEnabled | global/read-write |
restTlsServerCertValidateNameEnabled | global/read-write |
sempOverMsgBusAdminClientEnabled | global/read-write |
sempOverMsgBusAdminDistributedCacheEnabled | global/read-write |
sempOverMsgBusAdminEnabled | global/read-write |
sempOverMsgBusEnabled | global/read-write |
sempOverMsgBusShowEnabled | global/read-write |
serviceAmqpMaxConnectionCount | global/read-write |
serviceAmqpPlainTextListenPort | global/read-write |
serviceAmqpTlsListenPort | global/read-write |
serviceMqttMaxConnectionCount | global/read-write |
serviceMqttPlainTextListenPort | global/read-write |
serviceMqttTlsListenPort | global/read-write |
serviceMqttTlsWebSocketListenPort | global/read-write |
serviceMqttWebSocketListenPort | global/read-write |
serviceRestIncomingMaxConnectionCount | global/read-write |
serviceRestIncomingPlainTextListenPort | global/read-write |
serviceRestIncomingTlsListenPort | global/read-write |
serviceRestOutgoingMaxConnectionCount | global/read-write |
serviceSmfMaxConnectionCount | global/read-write |
serviceWebMaxConnectionCount | global/read-write |
This has been available since 2.0.
MsgVpnResponse The Message VPN object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an ACL Profile object. Replace an ACL Profile object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
aclProfileName | x | x | |||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileResponse The ACL Profile object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The ACL Profile object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an OAuth Profile object. Replace an OAuth Profile object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
clientSecret | x | x | |||||
msgVpnName | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an OAuth Provider object. Replace an OAuth Provider object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
audienceClaimName | x | ||||||
audienceClaimSource | x | ||||||
audienceClaimValue | x | ||||||
audienceValidationEnabled | x | ||||||
authorizationGroupClaimName | x | ||||||
authorizationGroupClaimSource | x | ||||||
authorizationGroupEnabled | x | ||||||
disconnectOnTokenExpirationEnabled | x | ||||||
enabled | x | ||||||
jwksRefreshInterval | x | ||||||
jwksUri | x | ||||||
msgVpnName | x | x | x | ||||
oauthProviderName | x | x | x | ||||
tokenIgnoreTimeLimitsEnabled | x | ||||||
tokenIntrospectionParameterName | x | ||||||
tokenIntrospectionPassword | x | x | x | ||||
tokenIntrospectionTimeout | x | ||||||
tokenIntrospectionUri | x | ||||||
tokenIntrospectionUsername | x | ||||||
usernameClaimName | x | ||||||
usernameClaimSource | x | ||||||
usernameValidateEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Provider object's attributes. *
The name of the Message VPN. *
The name of the OAuth Provider. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an Authorization Group object. Replace an Authorization Group object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
aclProfileName | x | ||||||
authorizationGroupName | x | x | |||||
clientProfileName | x | ||||||
msgVpnName | x | x | |||||
orderAfterAuthorizationGroupName | x | ||||||
orderBeforeAuthorizationGroupName | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnAuthorizationGroup | orderAfterAuthorizationGroupName | orderBeforeAuthorizationGroupName | |
MsgVpnAuthorizationGroup | orderBeforeAuthorizationGroupName | orderAfterAuthorizationGroupName |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Authorization Group. For LDAP groups, special care is needed if the group name contains special characters such as '#', '+', ';', '=' as the value of the group name returned from the LDAP server might prepend those characters with ''. For example a group name called 'test#,lab,com' will be returned from the LDAP server as 'test#,lab,com'. *
The Authorization Group object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Bridge object. Replace a Bridge object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
bridgeName | x | x | |||||
bridgeVirtualRouter | x | x | |||||
maxTtl | x | ||||||
msgVpnName | x | x | |||||
remoteAuthenticationBasicClientUsername | x | ||||||
remoteAuthenticationBasicPassword | x | x | x | ||||
remoteAuthenticationClientCertContent | x | x | x | ||||
remoteAuthenticationClientCertPassword | x | x | |||||
remoteAuthenticationScheme | x | ||||||
remoteDeliverToOnePriority | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridge | remoteAuthenticationBasicClientUsername | remoteAuthenticationBasicPassword | |
MsgVpnBridge | remoteAuthenticationBasicPassword | remoteAuthenticationBasicClientUsername | |
MsgVpnBridge | remoteAuthenticationClientCertPassword | remoteAuthenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeResponse The Bridge object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Bridge object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Remote Message VPN object. Replace a Remote Message VPN object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
The Remote Message VPN is the Message VPN that the Bridge connects to.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
bridgeName | x | x | |||||
bridgeVirtualRouter | x | x | |||||
clientUsername | x | ||||||
compressedDataEnabled | x | ||||||
egressFlowWindowSize | x | ||||||
msgVpnName | x | x | |||||
password | x | x | x | ||||
remoteMsgVpnInterface | x | x | |||||
remoteMsgVpnLocation | x | x | |||||
remoteMsgVpnName | x | x | |||||
tlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridgeRemoteMsgVpn | clientUsername | password | |
MsgVpnBridgeRemoteMsgVpn | password | clientUsername |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Remote Message VPN object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The physical interface on the local Message VPN host for connecting to the remote Message VPN. By default, an interface is chosen automatically (recommended), but if specified, remoteMsgVpnLocation
must not be a virtual router name. *
The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *
The name of the remote Message VPN. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Certificate Matching Rule object. Replace a Certificate Matching Rule object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Certificate Matching Rule Attribute Filter object. Replace a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
filterName | x | x | |||||
msgVpnName | x | x | |||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the filter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Client Profile object. Replace a Client Profile object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
allowCutThroughForwardingEnabled | x | ||||||
apiQueueManagementCopyFromOnCreateName | x | ||||||
apiTopicEndpointManagementCopyFromOnCreateName | x | ||||||
clientProfileName | x | x | |||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientProfileResponse The Client Profile object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Profile object's attributes. *
The name of the Client Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Client Username object. Replace a Client Username object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
aclProfileName | x | ||||||
clientProfileName | x | ||||||
clientUsername | x | x | |||||
msgVpnName | x | x | |||||
password | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientUsernameResponse The Client Username object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Username object's attributes. *
The name of the Client Username. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Distributed Cache object. Replace a Distributed Cache object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
cacheName | x | x | |||||
cacheVirtualRouter | x | ||||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnDistributedCache | scheduledDeleteMsgDayList | scheduledDeleteMsgTimeList | |
MsgVpnDistributedCache | scheduledDeleteMsgTimeList | scheduledDeleteMsgDayList |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Distributed Cache object's attributes. *
The name of the Distributed Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Cache Cluster object. Replace a Cache Cluster object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
cacheName | x | x | |||||
clusterName | x | x | |||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent | |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Cluster object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Cache Instance object. Replace a Cache Instance object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
cacheName | x | x | |||||
clusterName | x | x | |||||
instanceName | x | x | |||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Instance object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Cache Instance. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a DMR Bridge object. Replace a DMR Bridge object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
remoteNodeName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The DMR Bridge object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the DMR Bridge. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a JNDI Connection Factory object. Replace a JNDI Connection Factory object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
connectionFactoryName | x | x | |||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Connection Factory object's attributes. *
The name of the JMS Connection Factory. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a JNDI Queue object. Replace a JNDI Queue object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
queueName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The JNDI name of the JMS Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a JNDI Topic object. Replace a JNDI Topic object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
topicName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The JNDI name of the JMS Topic. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an MQTT Retain Cache object. Replace an MQTT Retain Cache object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
cacheName | x | x | |||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Retain Cache object's attributes. *
The name of the MQTT Retain Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an MQTT Session object. Replace an MQTT Session object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
mqttSessionClientId | x | x | |||||
mqttSessionVirtualRouter | x | x | |||||
msgVpnName | x | x | |||||
owner | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionResponse The MQTT Session object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Session object's attributes. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Subscription object. Replace a Subscription object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
mqttSessionClientId | x | x | |||||
mqttSessionVirtualRouter | x | x | |||||
msgVpnName | x | x | |||||
subscriptionTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Subscription object's attributes. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The MQTT subscription topic. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Queue object. Replace a Queue object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
accessType | x | ||||||
msgVpnName | x | x | |||||
owner | x | ||||||
permission | x | ||||||
queueName | x | x | |||||
respectMsgPriorityEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueResponse The Queue object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Queue Template object. Replace a Queue Template object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
queueTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnQueueTemplateResponse The Queue Template object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue Template. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Replay Log object. Replace a Replay Log object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
replayLogName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.10.
MsgVpnReplayLogResponse The Replay Log object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replay Log object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Replicated Topic object. Replace a Replicated Topic object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
replicatedTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replicated Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic for applying replication. Published messages matching this topic will be replicated to the standby site. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a REST Delivery Point object. Replace a REST Delivery Point object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
clientProfileName | x | ||||||
msgVpnName | x | x | |||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Delivery Point object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Queue Binding object. Replace a Queue Binding object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
queueBindingName | x | x | |||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Binding object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Protected Request Header object. Replace a Protected Request Header object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
headerName | x | x | |||||
headerValue | x | x | |||||
msgVpnName | x | x | |||||
queueBindingName | x | x | |||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.30.
MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Protected Request Header object's attributes. *
The name of the protected HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Request Header object. Replace a Request Header object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A request header to be added to the HTTP request.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
headerName | x | x | |||||
msgVpnName | x | x | |||||
queueBindingName | x | x | |||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.23.
MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Request Header object's attributes. *
The name of the HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a REST Consumer object. Replace a REST Consumer object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
authenticationAwsSecretAccessKey | x | x | |||||
authenticationClientCertContent | x | x | x | ||||
authenticationClientCertPassword | x | x | |||||
authenticationHttpBasicPassword | x | x | x | ||||
authenticationHttpBasicUsername | x | ||||||
authenticationHttpHeaderValue | x | x | |||||
authenticationOauthClientId | x | ||||||
authenticationOauthClientScope | x | ||||||
authenticationOauthClientSecret | x | x | x | ||||
authenticationOauthClientTokenEndpoint | x | ||||||
authenticationOauthClientTokenExpiryDefault | x | ||||||
authenticationOauthJwtSecretKey | x | x | x | ||||
authenticationOauthJwtTokenEndpoint | x | ||||||
authenticationOauthJwtTokenExpiryDefault | x | ||||||
authenticationScheme | x | ||||||
msgVpnName | x | x | |||||
outgoingConnectionCount | x | ||||||
remoteHost | x | ||||||
remotePort | x | ||||||
restConsumerName | x | x | |||||
restDeliveryPointName | x | x | |||||
tlsCipherSuiteList | x | ||||||
tlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnRestDeliveryPointRestConsumer | authenticationClientCertPassword | authenticationClientCertContent | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicPassword | authenticationHttpBasicUsername | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicUsername | authenticationHttpBasicPassword | |
MsgVpnRestDeliveryPointRestConsumer | remotePort | tlsEnabled | |
MsgVpnRestDeliveryPointRestConsumer | tlsEnabled | remotePort |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Consumer object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Topic Endpoint object. Replace a Topic Endpoint object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
accessType | x | ||||||
msgVpnName | x | x | |||||
owner | x | ||||||
permission | x | ||||||
respectMsgPriorityEnabled | x | ||||||
topicEndpointName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Topic Endpoint Template object. Replace a Topic Endpoint Template object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
topicEndpointTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint Template. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an OAuth Profile object. Replace an OAuth Profile object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
clientSecret | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
accessLevelGroupsClaimName | global/admin |
clientId | global/admin |
clientRedirectUri | global/admin |
clientRequiredType | global/admin |
clientScope | global/admin |
clientSecret | global/admin |
clientValidateTypeEnabled | global/admin |
defaultGlobalAccessLevel | global/admin |
displayName | global/admin |
enabled | global/admin |
endpointAuthorization | global/admin |
endpointDiscovery | global/admin |
endpointDiscoveryRefreshInterval | global/admin |
endpointIntrospection | global/admin |
endpointIntrospectionTimeout | global/admin |
endpointJwks | global/admin |
endpointJwksRefreshInterval | global/admin |
endpointToken | global/admin |
endpointTokenTimeout | global/admin |
endpointUserinfo | global/admin |
endpointUserinfoTimeout | global/admin |
interactiveEnabled | global/admin |
interactivePromptForExpiredSession | global/admin |
interactivePromptForNewSession | global/admin |
issuer | global/admin |
oauthRole | global/admin |
resourceServerParseAccessTokenEnabled | global/admin |
resourceServerRequiredAudience | global/admin |
resourceServerRequiredIssuer | global/admin |
resourceServerRequiredScope | global/admin |
resourceServerRequiredType | global/admin |
resourceServerValidateAudienceEnabled | global/admin |
resourceServerValidateIssuerEnabled | global/admin |
resourceServerValidateScopeEnabled | global/admin |
resourceServerValidateTypeEnabled | global/admin |
sempEnabled | global/admin |
usernameClaimName | global/admin |
This has been available since 2.24.
OauthProfileResponse The OAuth Profile object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Group Access Level object. Replace a Group Access Level object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
groupName | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
globalAccessLevel | global/admin |
This has been available since 2.24.
OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Group Access Level object's attributes. *
The name of the group. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Message VPN Access-Level Exception object. Replace a Message VPN Access-Level Exception object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Message VPN access-level exceptions for members of this group.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
groupName | x | x | |||||
msgVpnName | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the group. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace an Authorization Parameter object. Replace an Authorization Parameter object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Additional parameters to be passed to the OAuth authorization endpoint.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
authorizationParameterName | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the authorization parameter. *
The Authorization Parameter object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Message VPN Access-Level Exception object. Replace a Message VPN Access-Level Exception object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
Default message VPN access-level exceptions.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
msgVpnName | x | x | |||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
replaceReplace a Virtual Hostname object. Replace a Virtual Hostname object. Any attribute missing from the request will be set to its default value, subject to the exceptions in note 4.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
Attribute | Identifying | Const | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|---|
virtualHostname | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.17.
VirtualHostnameResponse The Virtual Hostname object's attributes after being replaced, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Virtual Hostname object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The virtual hostname. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Broker object. Update a Broker object. Any attribute missing from the request will be left unchanged.
This object contains global configuration for the message broker.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
serviceAmqpTlsListenPort | x | |||||
serviceHealthCheckListenPort | x | |||||
serviceMateLinkListenPort | x | |||||
serviceRedundancyFirstListenPort | x | |||||
serviceSempPlainTextListenPort | x | |||||
serviceSempTlsListenPort | x | |||||
serviceSmfCompressionListenPort | x | |||||
serviceSmfPlainTextListenPort | x | |||||
serviceSmfRoutingControlListenPort | x | |||||
serviceSmfTlsListenPort | x | |||||
serviceWebTransportPlainTextListenPort | x | |||||
serviceWebTransportTlsListenPort | x | |||||
serviceWebTransportWebUrlSuffix | x | |||||
tlsServerCertContent | x | x | ||||
tlsServerCertPassword | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
Broker | tlsServerCertPassword | tlsServerCertContent | |
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent |
A SEMP client authorized with a minimum access scope/level of "global/none" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
authClientCertRevocationCheckMode | global/admin |
configSyncAuthenticationClientCertMaxChainDepth | global/read-write |
configSyncAuthenticationClientCertValidateDateEnabled | global/read-write |
configSyncClientProfileTcpInitialCongestionWindow | global/read-write |
configSyncClientProfileTcpKeepaliveCount | global/read-write |
configSyncClientProfileTcpKeepaliveIdle | global/read-write |
configSyncClientProfileTcpKeepaliveInterval | global/read-write |
configSyncClientProfileTcpMaxWindow | global/read-write |
configSyncClientProfileTcpMss | global/read-write |
configSyncEnabled | global/read-write |
configSyncSynchronizeUsernameEnabled | global/read-write |
configSyncTlsEnabled | global/read-write |
guaranteedMsgingDefragmentationScheduleDayList | global/read-write |
guaranteedMsgingDefragmentationScheduleEnabled | global/read-write |
guaranteedMsgingDefragmentationScheduleTimeList | global/read-write |
guaranteedMsgingDefragmentationThresholdEnabled | global/read-write |
guaranteedMsgingDefragmentationThresholdFragmentationPercentage | global/read-write |
guaranteedMsgingDefragmentationThresholdMinInterval | global/read-write |
guaranteedMsgingDefragmentationThresholdUsagePercentage | global/read-write |
guaranteedMsgingEnabled | global/read-write |
guaranteedMsgingEventCacheUsageThreshold.clearPercent | global/read-write |
guaranteedMsgingEventCacheUsageThreshold.clearValue | global/read-write |
guaranteedMsgingEventCacheUsageThreshold.setPercent | global/read-write |
guaranteedMsgingEventCacheUsageThreshold.setValue | global/read-write |
guaranteedMsgingEventDeliveredUnackedThreshold.clearPercent | global/read-write |
guaranteedMsgingEventDeliveredUnackedThreshold.setPercent | global/read-write |
guaranteedMsgingEventDiskUsageThreshold.clearPercent | global/read-write |
guaranteedMsgingEventDiskUsageThreshold.setPercent | global/read-write |
guaranteedMsgingEventEgressFlowCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventEgressFlowCountThreshold.clearValue | global/read-write |
guaranteedMsgingEventEgressFlowCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventEgressFlowCountThreshold.setValue | global/read-write |
guaranteedMsgingEventEndpointCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventEndpointCountThreshold.clearValue | global/read-write |
guaranteedMsgingEventEndpointCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventEndpointCountThreshold.setValue | global/read-write |
guaranteedMsgingEventIngressFlowCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventIngressFlowCountThreshold.clearValue | global/read-write |
guaranteedMsgingEventIngressFlowCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventIngressFlowCountThreshold.setValue | global/read-write |
guaranteedMsgingEventMsgCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventMsgCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventMsgSpoolFileCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventMsgSpoolFileCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventMsgSpoolUsageThreshold.clearPercent | global/read-write |
guaranteedMsgingEventMsgSpoolUsageThreshold.clearValue | global/read-write |
guaranteedMsgingEventMsgSpoolUsageThreshold.setPercent | global/read-write |
guaranteedMsgingEventMsgSpoolUsageThreshold.setValue | global/read-write |
guaranteedMsgingEventTransactedSessionCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventTransactedSessionCountThreshold.clearValue | global/read-write |
guaranteedMsgingEventTransactedSessionCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventTransactedSessionCountThreshold.setValue | global/read-write |
guaranteedMsgingEventTransactedSessionResourceCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventTransactedSessionResourceCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventTransactionCountThreshold.clearPercent | global/read-write |
guaranteedMsgingEventTransactionCountThreshold.clearValue | global/read-write |
guaranteedMsgingEventTransactionCountThreshold.setPercent | global/read-write |
guaranteedMsgingEventTransactionCountThreshold.setValue | global/read-write |
guaranteedMsgingMaxCacheUsage | global/read-write |
guaranteedMsgingMaxMsgSpoolUsage | global/read-write |
guaranteedMsgingMsgSpoolSyncMirroredMsgAckTimeout | global/read-write |
guaranteedMsgingMsgSpoolSyncMirroredSpoolFileAckTimeout | global/read-write |
guaranteedMsgingTransactionReplicationCompatibilityMode | global/read-write |
oauthProfileDefault | global/admin |
serviceAmqpEnabled | global/read-write |
serviceAmqpTlsListenPort | global/read-write |
serviceEventConnectionCountThreshold.clearPercent | global/read-write |
serviceEventConnectionCountThreshold.clearValue | global/read-write |
serviceEventConnectionCountThreshold.setPercent | global/read-write |
serviceEventConnectionCountThreshold.setValue | global/read-write |
serviceHealthCheckEnabled | global/read-write |
serviceHealthCheckListenPort | global/read-write |
serviceMateLinkEnabled | global/read-write |
serviceMateLinkListenPort | global/read-write |
serviceMqttEnabled | global/read-write |
serviceMsgBackboneEnabled | global/read-write |
serviceRedundancyEnabled | global/read-write |
serviceRedundancyFirstListenPort | global/read-write |
serviceRestEventOutgoingConnectionCountThreshold.clearPercent | global/read-write |
serviceRestEventOutgoingConnectionCountThreshold.clearValue | global/read-write |
serviceRestEventOutgoingConnectionCountThreshold.setPercent | global/read-write |
serviceRestEventOutgoingConnectionCountThreshold.setValue | global/read-write |
serviceRestIncomingEnabled | global/read-write |
serviceRestOutgoingEnabled | global/read-write |
serviceSempCorsAllowAnyHostEnabled | global/read-write |
serviceSempLegacyTimeoutEnabled | global/read-write |
serviceSempPlainTextEnabled | global/read-write |
serviceSempPlainTextListenPort | global/read-write |
serviceSempSessionIdleTimeout | global/read-write |
serviceSempSessionMaxLifetime | global/read-write |
serviceSempTlsEnabled | global/read-write |
serviceSempTlsListenPort | global/read-write |
serviceSmfCompressionListenPort | global/read-write |
serviceSmfEnabled | global/read-write |
serviceSmfEventConnectionCountThreshold.clearPercent | global/read-write |
serviceSmfEventConnectionCountThreshold.clearValue | global/read-write |
serviceSmfEventConnectionCountThreshold.setPercent | global/read-write |
serviceSmfEventConnectionCountThreshold.setValue | global/read-write |
serviceSmfPlainTextListenPort | global/read-write |
serviceSmfRoutingControlListenPort | global/read-write |
serviceSmfTlsListenPort | global/read-write |
serviceTlsEventConnectionCountThreshold.clearPercent | global/read-write |
serviceTlsEventConnectionCountThreshold.clearValue | global/read-write |
serviceTlsEventConnectionCountThreshold.setPercent | global/read-write |
serviceTlsEventConnectionCountThreshold.setValue | global/read-write |
serviceWebTransportEnabled | global/read-write |
serviceWebTransportPlainTextListenPort | global/read-write |
serviceWebTransportTlsListenPort | global/read-write |
serviceWebTransportWebUrlSuffix | global/read-write |
tlsBlockVersion11Enabled | global/read-write |
tlsCipherSuiteManagementList | global/read-write |
tlsCipherSuiteMsgBackboneList | global/read-write |
tlsCipherSuiteSecureShellList | global/read-write |
tlsCrimeExploitProtectionEnabled | global/read-write |
tlsServerCertContent | global/read-write |
tlsServerCertPassword | global/read-write |
tlsStandardDomainCertificateAuthoritiesEnabled | global/read-write |
tlsTicketLifetime | global/read-write |
webManagerAllowUnencryptedWizardsEnabled | global/read-write |
webManagerCustomization | vpn/read-write |
webManagerRedirectHttpEnabled | global/read-write |
webManagerRedirectHttpOverrideTlsPort | global/read-write |
This has been available since 2.13.
BrokerResponse The Broker object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Broker object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Certificate Authority object. Update a Certificate Authority object. Any attribute missing from the request will be left unchanged.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x | x | |||
certContent | x | |||||
crlDayList | x | |||||
crlTimeList | x | |||||
crlUrl | x | x | ||||
ocspNonResponderCertEnabled | x | |||||
ocspOverrideUrl | x | |||||
ocspTimeout | x | |||||
revocationCheckEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
CertAuthority | crlDayList | crlTimeList | |
CertAuthority | crlTimeList | crlDayList |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
CertAuthorityResponse The Certificate Authority object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Client Certificate Authority object. Update a Client Certificate Authority object. Any attribute missing from the request will be left unchanged.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x | ||||
crlUrl | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
ClientCertAuthority | crlDayList | crlTimeList | |
ClientCertAuthority | crlTimeList | crlDayList |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Cluster object. Update a Cluster object. Any attribute missing from the request will be left unchanged.
A Cluster is a provisioned object on a message broker that contains global DMR configuration parameters.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | x | |||
authenticationClientCertContent | x | x | x | |||
authenticationClientCertPassword | x | x | ||||
directOnlyEnabled | x | |||||
dmrClusterName | x | x | ||||
nodeName | x | |||||
tlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
DmrCluster | authenticationClientCertPassword | authenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterResponse The Cluster object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cluster object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Certificate Matching Rule object. Update a Certificate Matching Rule object. Any attribute missing from the request will be left unchanged.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given link.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Certificate Matching Rule Attribute Filter object. Update a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be left unchanged.
A Cert Matching Rule Attribute Filter compares a link attribute to a string.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
dmrClusterName | x | x | ||||
filterName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the Cluster. *
The name of the filter. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Link object. Update a Link object. Any attribute missing from the request will be left unchanged.
A Link connects nodes (either within a Cluster or between two different Clusters) and allows them to exchange topology information, subscriptions and data.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationBasicPassword | x | x | x | |||
authenticationScheme | x | |||||
dmrClusterName | x | x | ||||
egressFlowWindowSize | x | |||||
initiator | x | |||||
remoteNodeName | x | x | ||||
span | x | |||||
transportCompressedEnabled | x | |||||
transportTlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
DmrClusterLinkResponse The Link object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Link object's attributes. *
The name of the Cluster. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the Link. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Domain Certificate Authority object. Update a Domain Certificate Authority object. Any attribute missing from the request will be left unchanged.
Certificate Authorities trusted for domain verification.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
certAuthorityName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.19.
DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Domain Certificate Authority object's attributes. *
The name of the Certificate Authority. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Message VPN object. Update a Message VPN object. Any attribute missing from the request will be left unchanged.
Message VPNs (Virtual Private Networks) allow for the segregation of topic space and clients. They also group clients connecting to a network of message brokers, such that messages published within a particular group are only visible to that group's clients.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationOauthDefaultProviderName | x | |||||
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | x | |||||
distributedCacheManagementEnabled | x | |||||
msgVpnName | x | x | ||||
replicationBridgeAuthenticationBasicPassword | x | x | ||||
replicationBridgeAuthenticationClientCertContent | x | x | ||||
replicationBridgeAuthenticationClientCertPassword | x | |||||
replicationEnabledQueueBehavior | x | |||||
restTlsServerCertEnforceTrustedCommonNameEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue | |
MsgVpn | authenticationBasicProfileName | authenticationBasicType | |
MsgVpn | authorizationProfileName | authorizationType | |
MsgVpn | eventPublishTopicFormatMqttEnabled | eventPublishTopicFormatSmfEnabled | |
MsgVpn | eventPublishTopicFormatSmfEnabled | eventPublishTopicFormatMqttEnabled | |
MsgVpn | replicationBridgeAuthenticationBasicClientUsername | replicationBridgeAuthenticationBasicPassword | |
MsgVpn | replicationBridgeAuthenticationBasicPassword | replicationBridgeAuthenticationBasicClientUsername | |
MsgVpn | replicationBridgeAuthenticationClientCertPassword | replicationBridgeAuthenticationClientCertContent | |
MsgVpn | replicationEnabledQueueBehavior | replicationEnabled |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
alias | global/read-write |
authenticationBasicEnabled | global/read-write |
authenticationBasicProfileName | global/read-write |
authenticationBasicRadiusDomain | global/read-write |
authenticationBasicType | global/read-write |
authenticationClientCertAllowApiProvidedUsernameEnabled | global/read-write |
authenticationClientCertCertificateMatchingRulesEnabled | global/read-write |
authenticationClientCertEnabled | global/read-write |
authenticationClientCertMaxChainDepth | global/read-write |
authenticationClientCertRevocationCheckMode | global/read-write |
authenticationClientCertUsernameSource | global/read-write |
authenticationClientCertValidateDateEnabled | global/read-write |
authenticationKerberosAllowApiProvidedUsernameEnabled | global/read-write |
authenticationKerberosEnabled | global/read-write |
authenticationOauthEnabled | global/read-write |
bridgingTlsServerCertEnforceTrustedCommonNameEnabled | global/read-write |
bridgingTlsServerCertMaxChainDepth | global/read-write |
bridgingTlsServerCertValidateDateEnabled | global/read-write |
bridgingTlsServerCertValidateNameEnabled | global/read-write |
dmrEnabled | global/read-write |
exportSubscriptionsEnabled | global/read-write |
maxConnectionCount | global/read-write |
maxEgressFlowCount | global/read-write |
maxEndpointCount | global/read-write |
maxIngressFlowCount | global/read-write |
maxMsgSpoolUsage | global/read-write |
maxSubscriptionCount | global/read-write |
maxTransactedSessionCount | global/read-write |
maxTransactionCount | global/read-write |
mqttRetainMaxMemory | global/read-write |
replicationBridgeAuthenticationBasicClientUsername | global/read-write |
replicationBridgeAuthenticationBasicPassword | global/read-write |
replicationBridgeAuthenticationClientCertContent | global/read-write |
replicationBridgeAuthenticationClientCertPassword | global/read-write |
replicationBridgeAuthenticationScheme | global/read-write |
replicationBridgeCompressedDataEnabled | global/read-write |
replicationBridgeEgressFlowWindowSize | global/read-write |
replicationBridgeRetryDelay | global/read-write |
replicationBridgeTlsEnabled | global/read-write |
replicationBridgeUnidirectionalClientProfileName | global/read-write |
replicationEnabled | global/read-write |
replicationEnabledQueueBehavior | global/read-write |
replicationQueueMaxMsgSpoolUsage | global/read-write |
replicationRole | global/read-write |
restTlsServerCertEnforceTrustedCommonNameEnabled | global/read-write |
restTlsServerCertMaxChainDepth | global/read-write |
restTlsServerCertValidateDateEnabled | global/read-write |
restTlsServerCertValidateNameEnabled | global/read-write |
sempOverMsgBusAdminClientEnabled | global/read-write |
sempOverMsgBusAdminDistributedCacheEnabled | global/read-write |
sempOverMsgBusAdminEnabled | global/read-write |
sempOverMsgBusEnabled | global/read-write |
sempOverMsgBusShowEnabled | global/read-write |
serviceAmqpMaxConnectionCount | global/read-write |
serviceAmqpPlainTextListenPort | global/read-write |
serviceAmqpTlsListenPort | global/read-write |
serviceMqttMaxConnectionCount | global/read-write |
serviceMqttPlainTextListenPort | global/read-write |
serviceMqttTlsListenPort | global/read-write |
serviceMqttTlsWebSocketListenPort | global/read-write |
serviceMqttWebSocketListenPort | global/read-write |
serviceRestIncomingMaxConnectionCount | global/read-write |
serviceRestIncomingPlainTextListenPort | global/read-write |
serviceRestIncomingTlsListenPort | global/read-write |
serviceRestOutgoingMaxConnectionCount | global/read-write |
serviceSmfMaxConnectionCount | global/read-write |
serviceWebMaxConnectionCount | global/read-write |
This has been available since 2.0.
MsgVpnResponse The Message VPN object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an ACL Profile object. Update an ACL Profile object. Any attribute missing from the request will be left unchanged.
An ACL Profile controls whether an authenticated client is permitted to establish a connection with the message broker or permitted to publish and subscribe to specific topics.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAclProfileResponse The ACL Profile object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the ACL Profile. *
The ACL Profile object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an OAuth Profile object. Update an OAuth Profile object. Any attribute missing from the request will be left unchanged.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientSecret | x | x | ||||
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.25.
MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
The name of the Message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an OAuth Provider object. Update an OAuth Provider object. Any attribute missing from the request will be left unchanged.
OAuth Providers contain information about the issuer of an OAuth token that is needed to validate the token and derive a client username from it.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
audienceClaimName | x | |||||
audienceClaimSource | x | |||||
audienceClaimValue | x | |||||
audienceValidationEnabled | x | |||||
authorizationGroupClaimName | x | |||||
authorizationGroupClaimSource | x | |||||
authorizationGroupEnabled | x | |||||
disconnectOnTokenExpirationEnabled | x | |||||
enabled | x | |||||
jwksRefreshInterval | x | |||||
jwksUri | x | |||||
msgVpnName | x | x | x | |||
oauthProviderName | x | x | x | |||
tokenIgnoreTimeLimitsEnabled | x | |||||
tokenIntrospectionParameterName | x | |||||
tokenIntrospectionPassword | x | x | x | |||
tokenIntrospectionTimeout | x | |||||
tokenIntrospectionUri | x | |||||
tokenIntrospectionUsername | x | |||||
usernameClaimName | x | |||||
usernameClaimSource | x | |||||
usernameValidateEnabled | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been deprecated since 2.25. Replaced by authenticationOauthProfiles.
MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Provider object's attributes. *
The name of the Message VPN. *
The name of the OAuth Provider. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an Authorization Group object. Update an Authorization Group object. Any attribute missing from the request will be left unchanged.
To use client authorization groups configured on an external server to provide client authorizations, Authorization Group objects must be created on the Message VPN that match the authorization groups provisioned on the external server. These objects must be configured with the client profiles and ACL profiles that will be assigned to the clients that belong to those authorization groups. A newly created group is placed at the end of the group list which is the lowest priority.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | |||||
authorizationGroupName | x | x | ||||
clientProfileName | x | |||||
msgVpnName | x | x | ||||
orderAfterAuthorizationGroupName | x | |||||
orderBeforeAuthorizationGroupName | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnAuthorizationGroup | orderAfterAuthorizationGroupName | orderBeforeAuthorizationGroupName | |
MsgVpnAuthorizationGroup | orderBeforeAuthorizationGroupName | orderAfterAuthorizationGroupName |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the Authorization Group. For LDAP groups, special care is needed if the group name contains special characters such as '#', '+', ';', '=' as the value of the group name returned from the LDAP server might prepend those characters with ''. For example a group name called 'test#,lab,com' will be returned from the LDAP server as 'test#,lab,com'. *
The Authorization Group object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Bridge object. Update a Bridge object. Any attribute missing from the request will be left unchanged.
Bridges can be used to link two Message VPNs so that messages published to one Message VPN that match the topic subscriptions set for the bridge are also delivered to the linked Message VPN.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | ||||
bridgeVirtualRouter | x | x | ||||
maxTtl | x | |||||
msgVpnName | x | x | ||||
remoteAuthenticationBasicClientUsername | x | |||||
remoteAuthenticationBasicPassword | x | x | x | |||
remoteAuthenticationClientCertContent | x | x | x | |||
remoteAuthenticationClientCertPassword | x | x | ||||
remoteAuthenticationScheme | x | |||||
remoteDeliverToOnePriority | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridge | remoteAuthenticationBasicClientUsername | remoteAuthenticationBasicPassword | |
MsgVpnBridge | remoteAuthenticationBasicPassword | remoteAuthenticationBasicClientUsername | |
MsgVpnBridge | remoteAuthenticationClientCertPassword | remoteAuthenticationClientCertContent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeResponse The Bridge object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Bridge object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Remote Message VPN object. Update a Remote Message VPN object. Any attribute missing from the request will be left unchanged.
The Remote Message VPN is the Message VPN that the Bridge connects to.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
bridgeName | x | x | ||||
bridgeVirtualRouter | x | x | ||||
clientUsername | x | |||||
compressedDataEnabled | x | |||||
egressFlowWindowSize | x | |||||
msgVpnName | x | x | ||||
password | x | x | x | |||
remoteMsgVpnInterface | x | x | ||||
remoteMsgVpnLocation | x | x | ||||
remoteMsgVpnName | x | x | ||||
tlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnBridgeRemoteMsgVpn | clientUsername | password | |
MsgVpnBridgeRemoteMsgVpn | password | clientUsername |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Remote Message VPN object's attributes. *
The name of the Bridge. *
The virtual router of the Bridge. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The physical interface on the local Message VPN host for connecting to the remote Message VPN. By default, an interface is chosen automatically (recommended), but if specified, remoteMsgVpnLocation
must not be a virtual router name. *
The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *
The name of the remote Message VPN. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Certificate Matching Rule object. Update a Certificate Matching Rule object. Any attribute missing from the request will be left unchanged.
A Cert Matching Rule is a collection of conditions and attribute filters that all have to be satisfied for certificate to be acceptable as authentication for a given username.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.27.
MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Certificate Matching Rule Attribute Filter object. Update a Certificate Matching Rule Attribute Filter object. Any attribute missing from the request will be left unchanged.
A Cert Matching Rule Attribute Filter compares a username attribute to a string.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
filterName | x | x | ||||
msgVpnName | x | x | ||||
ruleName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.28.
MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Certificate Matching Rule Attribute Filter object's attributes. *
The name of the filter. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the rule. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Client Profile object. Update a Client Profile object. Any attribute missing from the request will be left unchanged.
Client Profiles are used to assign common configuration properties to clients that have been successfully authorized.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
allowCutThroughForwardingEnabled | x | |||||
apiQueueManagementCopyFromOnCreateName | x | |||||
apiTopicEndpointManagementCopyFromOnCreateName | x | |||||
clientProfileName | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientProfileResponse The Client Profile object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Profile object's attributes. *
The name of the Client Profile. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Client Username object. Update a Client Username object. Any attribute missing from the request will be left unchanged.
A client is only authorized to connect to a Message VPN that is associated with a Client Username that the client has been assigned.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
aclProfileName | x | |||||
clientProfileName | x | |||||
clientUsername | x | x | ||||
msgVpnName | x | x | ||||
password | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnClientUsernameResponse The Client Username object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Client Username object's attributes. *
The name of the Client Username. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Distributed Cache object. Update a Distributed Cache object. Any attribute missing from the request will be left unchanged.
A Distributed Cache is a collection of one or more Cache Clusters that belong to the same Message VPN. Each Cache Cluster in a Distributed Cache is configured to subscribe to a different set of topics. This effectively divides up the configured topic space, to provide scaling to very large topic spaces or very high cached message throughput.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
cacheVirtualRouter | x | |||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnDistributedCache | scheduledDeleteMsgDayList | scheduledDeleteMsgTimeList | |
MsgVpnDistributedCache | scheduledDeleteMsgTimeList | scheduledDeleteMsgDayList |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Distributed Cache object's attributes. *
The name of the Distributed Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Cache Cluster object. Update a Cache Cluster object. Any attribute missing from the request will be left unchanged.
A Cache Cluster is a collection of one or more Cache Instances that subscribe to exactly the same topics. Cache Instances are grouped together in a Cache Cluster for the purpose of fault tolerance and load balancing. As published messages are received, the message broker message bus sends these live data messages to the Cache Instances in the Cache Cluster. This enables client cache requests to be served by any of Cache Instances in the Cache Cluster.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
msgVpnName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThresholdByPercent | clearPercent | setPercent | |
EventThresholdByPercent | setPercent | clearPercent | |
EventThresholdByValue | clearValue | setValue | |
EventThresholdByValue | setValue | clearValue |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Cluster object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Cache Instance object. Update a Cache Instance object. Any attribute missing from the request will be left unchanged.
A Cache Instance is a single Cache process that belongs to a single Cache Cluster. A Cache Instance object provisioned on the broker is used to disseminate configuration information to the Cache process. Cache Instances listen for and cache live data messages that match the topic subscriptions configured for their parent Cache Cluster.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
clusterName | x | x | ||||
instanceName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Cache Instance object's attributes. *
The name of the Distributed Cache. *
The name of the Cache Cluster. *
The name of the Cache Instance. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a DMR Bridge object. Update a DMR Bridge object. Any attribute missing from the request will be left unchanged.
A DMR Bridge is required to establish a data channel over a corresponding external link to the remote node for a given Message VPN. Each DMR Bridge identifies which external link the Message VPN should use, and what the name of the equivalent Message VPN at the remote node is.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
remoteNodeName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The DMR Bridge object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the node at the remote end of the DMR Bridge. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a JNDI Connection Factory object. Update a JNDI Connection Factory object. Any attribute missing from the request will be left unchanged.
The message broker provides an internal JNDI store for provisioned Connection Factory objects that clients can access through JNDI lookups.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
connectionFactoryName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Connection Factory object's attributes. *
The name of the JMS Connection Factory. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a JNDI Queue object. Update a JNDI Queue object. Any attribute missing from the request will be left unchanged.
The message broker provides an internal JNDI store for provisioned Queue objects that clients can access through JNDI lookups.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The JNDI name of the JMS Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a JNDI Topic object. Update a JNDI Topic object. Any attribute missing from the request will be left unchanged.
The message broker provides an internal JNDI store for provisioned Topic objects that clients can access through JNDI lookups.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
topicName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.2.
MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The JNDI Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The JNDI name of the JMS Topic. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an MQTT Retain Cache object. Update an MQTT Retain Cache object. Any attribute missing from the request will be left unchanged.
Using MQTT retained messages allows publishing MQTT clients to indicate that a message must be stored for later delivery to subscribing clients when those subscribing clients add subscriptions matching the retained message's topic. An MQTT Retain Cache processes all retained messages for a Message VPN.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
cacheName | x | x | ||||
msgVpnName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.11.
MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Retain Cache object's attributes. *
The name of the MQTT Retain Cache. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an MQTT Session object. Update an MQTT Session object. Any attribute missing from the request will be left unchanged.
An MQTT Session object is a virtual representation of an MQTT client connection. An MQTT session holds the state of an MQTT client (that is, it is used to contain a client's QoS 0 and QoS 1 subscription sets and any undelivered QoS 1 messages).
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
mqttSessionClientId | x | x | ||||
mqttSessionVirtualRouter | x | x | ||||
msgVpnName | x | x | ||||
owner | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionResponse The MQTT Session object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The MQTT Session object's attributes. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Subscription object. Update a Subscription object. Any attribute missing from the request will be left unchanged.
An MQTT session contains a client's QoS 0 and QoS 1 subscription sets. On creation, a subscription defaults to QoS 0.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
mqttSessionClientId | x | x | ||||
mqttSessionVirtualRouter | x | x | ||||
msgVpnName | x | x | ||||
subscriptionTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Subscription object's attributes. *
The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *
The virtual router of the MQTT Session. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The MQTT subscription topic. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Queue object. Update a Queue object. Any attribute missing from the request will be left unchanged.
A Queue acts as both a destination that clients can publish messages to, and as an endpoint that clients can bind consumers to and consume messages from.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
accessType | x | |||||
msgVpnName | x | x | ||||
owner | x | |||||
permission | x | |||||
queueName | x | x | ||||
respectMsgPriorityEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnQueueResponse The Queue object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Queue Template object. Update a Queue Template object. Any attribute missing from the request will be left unchanged.
A Queue Template provides a mechanism for specifying the initial state for client created queues.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnQueueTemplateResponse The Queue Template object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Queue Template. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Replay Log object. Update a Replay Log object. Any attribute missing from the request will be left unchanged.
When the Message Replay feature is enabled, message brokers store persistent messages in a Replay Log. These messages are kept until the log is full, after which the oldest messages are removed to free up space for new messages.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
replayLogName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.10.
MsgVpnReplayLogResponse The Replay Log object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replay Log object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the Replay Log. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Replicated Topic object. Update a Replicated Topic object. Any attribute missing from the request will be left unchanged.
To indicate which messages should be replicated between the active and standby site, a Replicated Topic subscription must be configured on a Message VPN. If a published message matches both a replicated topic and an endpoint on the active site, then the message is replicated to the standby site.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
replicatedTopic | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Replicated Topic object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The topic for applying replication. Published messages matching this topic will be replicated to the standby site. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a REST Delivery Point object. Update a REST Delivery Point object. Any attribute missing from the request will be left unchanged.
A REST Delivery Point manages delivery of messages from queues to a named list of REST Consumers.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientProfileName | x | |||||
msgVpnName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Delivery Point object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Queue Binding object. Update a Queue Binding object. Any attribute missing from the request will be left unchanged.
A Queue Binding for a REST Delivery Point attracts messages to be delivered to REST consumers. If the queue does not exist it can be created subsequently, and once the queue is operational the broker performs the queue binding. Removing the queue binding does not delete the queue itself. Similarly, removing the queue does not remove the queue binding, which fails until the queue is recreated or the queue binding is deleted.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Queue Binding object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Protected Request Header object. Update a Protected Request Header object. Any attribute missing from the request will be left unchanged.
A protected request header to be added to the HTTP request. Unlike a non-protected request header, the header value cannot be displayed after it is set.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
headerName | x | x | ||||
headerValue | x | x | ||||
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.30.
MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Protected Request Header object's attributes. *
The name of the protected HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Request Header object. Update a Request Header object. Any attribute missing from the request will be left unchanged.
A request header to be added to the HTTP request.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
headerName | x | x | ||||
msgVpnName | x | x | ||||
queueBindingName | x | x | ||||
restDeliveryPointName | x | x |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.23.
MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Request Header object's attributes. *
The name of the HTTP request header. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of a queue in the Message VPN. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a REST Consumer object. Update a REST Consumer object. Any attribute missing from the request will be left unchanged.
REST Consumer objects establish HTTP connectivity to REST consumer applications who wish to receive messages from a broker.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
authenticationAwsSecretAccessKey | x | x | ||||
authenticationClientCertContent | x | x | x | |||
authenticationClientCertPassword | x | x | ||||
authenticationHttpBasicPassword | x | x | x | |||
authenticationHttpBasicUsername | x | |||||
authenticationHttpHeaderValue | x | x | ||||
authenticationOauthClientId | x | |||||
authenticationOauthClientScope | x | |||||
authenticationOauthClientSecret | x | x | x | |||
authenticationOauthClientTokenEndpoint | x | |||||
authenticationOauthClientTokenExpiryDefault | x | |||||
authenticationOauthJwtSecretKey | x | x | x | |||
authenticationOauthJwtTokenEndpoint | x | |||||
authenticationOauthJwtTokenExpiryDefault | x | |||||
authenticationScheme | x | |||||
msgVpnName | x | x | ||||
outgoingConnectionCount | x | |||||
remoteHost | x | |||||
remotePort | x | |||||
restConsumerName | x | x | ||||
restDeliveryPointName | x | x | ||||
tlsCipherSuiteList | x | |||||
tlsEnabled | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
MsgVpnRestDeliveryPointRestConsumer | authenticationClientCertPassword | authenticationClientCertContent | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicPassword | authenticationHttpBasicUsername | |
MsgVpnRestDeliveryPointRestConsumer | authenticationHttpBasicUsername | authenticationHttpBasicPassword | |
MsgVpnRestDeliveryPointRestConsumer | remotePort | tlsEnabled | |
MsgVpnRestDeliveryPointRestConsumer | tlsEnabled | remotePort |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.0.
MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The REST Consumer object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
The name of the REST Consumer. *
The name of the REST Delivery Point. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Topic Endpoint object. Update a Topic Endpoint object. Any attribute missing from the request will be left unchanged.
A Topic Endpoint attracts messages published to a topic for which the Topic Endpoint has a matching topic subscription. The topic subscription for the Topic Endpoint is specified in the client request to bind a Flow to that Topic Endpoint. Queues are significantly more flexible than Topic Endpoints and are the recommended approach for most applications. The use of Topic Endpoints should be restricted to JMS applications.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
accessType | x | |||||
msgVpnName | x | x | ||||
owner | x | |||||
permission | x | |||||
respectMsgPriorityEnabled | x | |||||
topicEndpointName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.1.
MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Topic Endpoint Template object. Update a Topic Endpoint Template object. Any attribute missing from the request will be left unchanged.
A Topic Endpoint Template provides a mechanism for specifying the initial state for client created topic endpoints.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
topicEndpointTemplateName | x | x |
The following attributes in the request may only be provided in certain combinations with other attributes:
Class | Attribute | Requires | Conflicts |
---|---|---|---|
EventThreshold | clearPercent | setPercent | clearValue, setValue |
EventThreshold | clearValue | setValue | clearPercent, setPercent |
EventThreshold | setPercent | clearPercent | clearValue, setValue |
EventThreshold | setValue | clearValue | clearPercent, setPercent |
A SEMP client authorized with a minimum access scope/level of "vpn/read-write" is required to perform this operation.
This has been available since 2.14.
MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Topic Endpoint Template object's attributes. *
The name of the Message VPN. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The name of the Topic Endpoint Template. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an OAuth Profile object. Update an OAuth Profile object. Any attribute missing from the request will be left unchanged.
OAuth profiles specify how to securely authenticate to an OAuth provider.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
clientSecret | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
accessLevelGroupsClaimName | global/admin |
clientId | global/admin |
clientRedirectUri | global/admin |
clientRequiredType | global/admin |
clientScope | global/admin |
clientSecret | global/admin |
clientValidateTypeEnabled | global/admin |
defaultGlobalAccessLevel | global/admin |
displayName | global/admin |
enabled | global/admin |
endpointAuthorization | global/admin |
endpointDiscovery | global/admin |
endpointDiscoveryRefreshInterval | global/admin |
endpointIntrospection | global/admin |
endpointIntrospectionTimeout | global/admin |
endpointJwks | global/admin |
endpointJwksRefreshInterval | global/admin |
endpointToken | global/admin |
endpointTokenTimeout | global/admin |
endpointUserinfo | global/admin |
endpointUserinfoTimeout | global/admin |
interactiveEnabled | global/admin |
interactivePromptForExpiredSession | global/admin |
interactivePromptForNewSession | global/admin |
issuer | global/admin |
oauthRole | global/admin |
resourceServerParseAccessTokenEnabled | global/admin |
resourceServerRequiredAudience | global/admin |
resourceServerRequiredIssuer | global/admin |
resourceServerRequiredScope | global/admin |
resourceServerRequiredType | global/admin |
resourceServerValidateAudienceEnabled | global/admin |
resourceServerValidateIssuerEnabled | global/admin |
resourceServerValidateScopeEnabled | global/admin |
resourceServerValidateTypeEnabled | global/admin |
sempEnabled | global/admin |
usernameClaimName | global/admin |
This has been available since 2.24.
OauthProfileResponse The OAuth Profile object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The OAuth Profile object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Group Access Level object. Update a Group Access Level object. Any attribute missing from the request will be left unchanged.
The name of a group as it exists on the OAuth server being used to authenticate SEMP users.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
groupName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation. Requests which include the following attributes require greater access scope/level:
Attribute | Access Scope/Level |
---|---|
globalAccessLevel | global/admin |
This has been available since 2.24.
OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Group Access Level object's attributes. *
The name of the group. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Message VPN Access-Level Exception object. Update a Message VPN Access-Level Exception object. Any attribute missing from the request will be left unchanged.
Message VPN access-level exceptions for members of this group.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
groupName | x | x | ||||
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the group. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate an Authorization Parameter object. Update an Authorization Parameter object. Any attribute missing from the request will be left unchanged.
Additional parameters to be passed to the OAuth authorization endpoint.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
authorizationParameterName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been available since 2.24.
OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The name of the authorization parameter. *
The Authorization Parameter object's attributes. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Message VPN Access-Level Exception object. Update a Message VPN Access-Level Exception object. Any attribute missing from the request will be left unchanged.
Default message VPN access-level exceptions.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
msgVpnName | x | x | ||||
oauthProfileName | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.24.
OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Message VPN Access-Level Exception object's attributes. *
The name of the message VPN. *
The name of the OAuth profile. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
Optional
xOptional context id the request is running. *
Static
updateUpdate a Virtual Hostname object. Update a Virtual Hostname object. Any attribute missing from the request will be left unchanged.
A Virtual Hostname is a provisioned object on a message broker that contains a Virtual Hostname to Message VPN mapping.
Clients which connect to a global (as opposed to per Message VPN) port and provides this hostname will be directed to its corresponding Message VPN. A case-insentive match is performed on the full client-provided hostname against the configured virtual-hostname.
This mechanism is only supported for hostnames provided through the Server Name Indication (SNI) extension of TLS.
Attribute | Identifying | Read-Only | Write-Only | Requires-Disable | Deprecated | Opaque |
---|---|---|---|---|---|---|
virtualHostname | x | x |
A SEMP client authorized with a minimum access scope/level of "global/read-write" is required to perform this operation.
This has been available since 2.17.
VirtualHostnameResponse The Virtual Hostname object's attributes after being updated, and the request metadata.
SempMetaOnlyResponse The error response.
ApiError
The Virtual Hostname object's attributes. *
Optional
opaqueAccept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword
parameter. *
Optional
select?: string[]Include in the response only selected attributes of the object, or exclude from the response selected attributes of the object. See the documentation for the select
parameter. *
The virtual hostname. *
Optional
xOptional context id the request is running. *
Deprecated
Create a Certificate Authority object. Create a Certificate Authority object. Any attribute missing from the request will be set to its default value. The creation of instances of this object are synchronized to HA mates via config-sync.
Clients can authenticate with the message broker over TLS by presenting a valid client certificate. The message broker authenticates the client certificate by constructing a full certificate chain (from the client certificate to intermediate CAs to a configured root CA). The intermediate CAs in this chain can be provided by the client, or configured in the message broker. The root CA must be configured on the message broker.
The following attributes in the request may only be provided in certain combinations with other attributes:
A SEMP client authorized with a minimum access scope/level of "global/admin" is required to perform this operation.
This has been deprecated since 2.19. Replaced by clientCertAuthorities and domainCertAuthorities.
Returns
CertAuthorityResponse The Certificate Authority object's attributes after being created, and the request metadata.
Returns
SempMetaOnlyResponse The error response.
Throws
ApiError