Hierarchy

  • AllService

Constructors

Methods

createCertAuthority createCertAuthorityOcspTlsTrustedCommonName createClientCertAuthority createClientCertAuthorityOcspTlsTrustedCommonName createDmrCluster createDmrClusterCertMatchingRule createDmrClusterCertMatchingRuleAttributeFilter createDmrClusterCertMatchingRuleCondition createDmrClusterLink createDmrClusterLinkAttribute createDmrClusterLinkRemoteAddress createDmrClusterLinkTlsTrustedCommonName createDomainCertAuthority createMsgVpn createMsgVpnAclProfile createMsgVpnAclProfileClientConnectException createMsgVpnAclProfilePublishException createMsgVpnAclProfilePublishTopicException createMsgVpnAclProfileSubscribeException createMsgVpnAclProfileSubscribeShareNameException createMsgVpnAclProfileSubscribeTopicException createMsgVpnAuthenticationOauthProfile createMsgVpnAuthenticationOauthProfileClientRequiredClaim createMsgVpnAuthenticationOauthProfileResourceServerRequiredClaim createMsgVpnAuthenticationOauthProvider createMsgVpnAuthorizationGroup createMsgVpnBridge createMsgVpnBridgeRemoteMsgVpn createMsgVpnBridgeRemoteSubscription createMsgVpnBridgeTlsTrustedCommonName createMsgVpnCertMatchingRule createMsgVpnCertMatchingRuleAttributeFilter createMsgVpnCertMatchingRuleCondition createMsgVpnClientProfile createMsgVpnClientUsername createMsgVpnClientUsernameAttribute createMsgVpnDistributedCache createMsgVpnDistributedCacheCluster createMsgVpnDistributedCacheClusterGlobalCachingHomeCluster createMsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefix createMsgVpnDistributedCacheClusterInstance createMsgVpnDistributedCacheClusterTopic createMsgVpnDmrBridge createMsgVpnJndiConnectionFactory createMsgVpnJndiQueue createMsgVpnJndiTopic createMsgVpnMqttRetainCache createMsgVpnMqttSession createMsgVpnMqttSessionSubscription createMsgVpnQueue createMsgVpnQueueSubscription createMsgVpnQueueTemplate createMsgVpnReplayLog createMsgVpnReplayLogTopicFilterSubscription createMsgVpnReplicatedTopic createMsgVpnRestDeliveryPoint createMsgVpnRestDeliveryPointQueueBinding createMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader createMsgVpnRestDeliveryPointQueueBindingRequestHeader createMsgVpnRestDeliveryPointRestConsumer createMsgVpnRestDeliveryPointRestConsumerOauthJwtClaim createMsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonName createMsgVpnSequencedTopic createMsgVpnTopicEndpoint createMsgVpnTopicEndpointTemplate createOauthProfile createOauthProfileAccessLevelGroup createOauthProfileAccessLevelGroupMsgVpnAccessLevelException createOauthProfileClientAllowedHost createOauthProfileClientAuthorizationParameter createOauthProfileClientRequiredClaim createOauthProfileDefaultMsgVpnAccessLevelException createOauthProfileResourceServerRequiredClaim createVirtualHostname deleteCertAuthority deleteCertAuthorityOcspTlsTrustedCommonName deleteClientCertAuthority deleteClientCertAuthorityOcspTlsTrustedCommonName deleteDmrCluster deleteDmrClusterCertMatchingRule deleteDmrClusterCertMatchingRuleAttributeFilter deleteDmrClusterCertMatchingRuleCondition deleteDmrClusterLink deleteDmrClusterLinkAttribute deleteDmrClusterLinkRemoteAddress deleteDmrClusterLinkTlsTrustedCommonName deleteDomainCertAuthority deleteMsgVpn deleteMsgVpnAclProfile deleteMsgVpnAclProfileClientConnectException deleteMsgVpnAclProfilePublishException deleteMsgVpnAclProfilePublishTopicException deleteMsgVpnAclProfileSubscribeException deleteMsgVpnAclProfileSubscribeShareNameException deleteMsgVpnAclProfileSubscribeTopicException deleteMsgVpnAuthenticationOauthProfile deleteMsgVpnAuthenticationOauthProfileClientRequiredClaim deleteMsgVpnAuthenticationOauthProfileResourceServerRequiredClaim deleteMsgVpnAuthenticationOauthProvider deleteMsgVpnAuthorizationGroup deleteMsgVpnBridge deleteMsgVpnBridgeRemoteMsgVpn deleteMsgVpnBridgeRemoteSubscription deleteMsgVpnBridgeTlsTrustedCommonName deleteMsgVpnCertMatchingRule deleteMsgVpnCertMatchingRuleAttributeFilter deleteMsgVpnCertMatchingRuleCondition deleteMsgVpnClientProfile deleteMsgVpnClientUsername deleteMsgVpnClientUsernameAttribute deleteMsgVpnDistributedCache deleteMsgVpnDistributedCacheCluster deleteMsgVpnDistributedCacheClusterGlobalCachingHomeCluster deleteMsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefix deleteMsgVpnDistributedCacheClusterInstance deleteMsgVpnDistributedCacheClusterTopic deleteMsgVpnDmrBridge deleteMsgVpnJndiConnectionFactory deleteMsgVpnJndiQueue deleteMsgVpnJndiTopic deleteMsgVpnMqttRetainCache deleteMsgVpnMqttSession deleteMsgVpnMqttSessionSubscription deleteMsgVpnQueue deleteMsgVpnQueueSubscription deleteMsgVpnQueueTemplate deleteMsgVpnReplayLog deleteMsgVpnReplayLogTopicFilterSubscription deleteMsgVpnReplicatedTopic deleteMsgVpnRestDeliveryPoint deleteMsgVpnRestDeliveryPointQueueBinding deleteMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader deleteMsgVpnRestDeliveryPointQueueBindingRequestHeader deleteMsgVpnRestDeliveryPointRestConsumer deleteMsgVpnRestDeliveryPointRestConsumerOauthJwtClaim deleteMsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonName deleteMsgVpnSequencedTopic deleteMsgVpnTopicEndpoint deleteMsgVpnTopicEndpointTemplate deleteOauthProfile deleteOauthProfileAccessLevelGroup deleteOauthProfileAccessLevelGroupMsgVpnAccessLevelException deleteOauthProfileClientAllowedHost deleteOauthProfileClientAuthorizationParameter deleteOauthProfileClientRequiredClaim deleteOauthProfileDefaultMsgVpnAccessLevelException deleteOauthProfileResourceServerRequiredClaim deleteVirtualHostname getAbout getAboutApi getAboutUser getAboutUserMsgVpn getAboutUserMsgVpns getBroker getCertAuthorities getCertAuthority getCertAuthorityOcspTlsTrustedCommonName getCertAuthorityOcspTlsTrustedCommonNames getClientCertAuthorities getClientCertAuthority getClientCertAuthorityOcspTlsTrustedCommonName getClientCertAuthorityOcspTlsTrustedCommonNames getDmrCluster getDmrClusterCertMatchingRule getDmrClusterCertMatchingRuleAttributeFilter getDmrClusterCertMatchingRuleAttributeFilters getDmrClusterCertMatchingRuleCondition getDmrClusterCertMatchingRuleConditions getDmrClusterCertMatchingRules getDmrClusterLink getDmrClusterLinkAttribute getDmrClusterLinkAttributes getDmrClusterLinkRemoteAddress getDmrClusterLinkRemoteAddresses getDmrClusterLinkTlsTrustedCommonName getDmrClusterLinkTlsTrustedCommonNames getDmrClusterLinks getDmrClusters getDomainCertAuthorities getDomainCertAuthority getMsgVpn getMsgVpnAclProfile getMsgVpnAclProfileClientConnectException getMsgVpnAclProfileClientConnectExceptions getMsgVpnAclProfilePublishException getMsgVpnAclProfilePublishExceptions getMsgVpnAclProfilePublishTopicException getMsgVpnAclProfilePublishTopicExceptions getMsgVpnAclProfileSubscribeException getMsgVpnAclProfileSubscribeExceptions getMsgVpnAclProfileSubscribeShareNameException getMsgVpnAclProfileSubscribeShareNameExceptions getMsgVpnAclProfileSubscribeTopicException getMsgVpnAclProfileSubscribeTopicExceptions getMsgVpnAclProfiles getMsgVpnAuthenticationOauthProfile getMsgVpnAuthenticationOauthProfileClientRequiredClaim getMsgVpnAuthenticationOauthProfileClientRequiredClaims getMsgVpnAuthenticationOauthProfileResourceServerRequiredClaim getMsgVpnAuthenticationOauthProfileResourceServerRequiredClaims getMsgVpnAuthenticationOauthProfiles getMsgVpnAuthenticationOauthProvider getMsgVpnAuthenticationOauthProviders getMsgVpnAuthorizationGroup getMsgVpnAuthorizationGroups getMsgVpnBridge getMsgVpnBridgeRemoteMsgVpn getMsgVpnBridgeRemoteMsgVpns getMsgVpnBridgeRemoteSubscription getMsgVpnBridgeRemoteSubscriptions getMsgVpnBridgeTlsTrustedCommonName getMsgVpnBridgeTlsTrustedCommonNames getMsgVpnBridges getMsgVpnCertMatchingRule getMsgVpnCertMatchingRuleAttributeFilter getMsgVpnCertMatchingRuleAttributeFilters getMsgVpnCertMatchingRuleCondition getMsgVpnCertMatchingRuleConditions getMsgVpnCertMatchingRules getMsgVpnClientProfile getMsgVpnClientProfiles getMsgVpnClientUsername getMsgVpnClientUsernameAttribute getMsgVpnClientUsernameAttributes getMsgVpnClientUsernames getMsgVpnDistributedCache getMsgVpnDistributedCacheCluster getMsgVpnDistributedCacheClusterGlobalCachingHomeCluster getMsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefix getMsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixes getMsgVpnDistributedCacheClusterGlobalCachingHomeClusters getMsgVpnDistributedCacheClusterInstance getMsgVpnDistributedCacheClusterInstances getMsgVpnDistributedCacheClusterTopic getMsgVpnDistributedCacheClusterTopics getMsgVpnDistributedCacheClusters getMsgVpnDistributedCaches getMsgVpnDmrBridge getMsgVpnDmrBridges getMsgVpnJndiConnectionFactories getMsgVpnJndiConnectionFactory getMsgVpnJndiQueue getMsgVpnJndiQueues getMsgVpnJndiTopic getMsgVpnJndiTopics getMsgVpnMqttRetainCache getMsgVpnMqttRetainCaches getMsgVpnMqttSession getMsgVpnMqttSessionSubscription getMsgVpnMqttSessionSubscriptions getMsgVpnMqttSessions getMsgVpnQueue getMsgVpnQueueSubscription getMsgVpnQueueSubscriptions getMsgVpnQueueTemplate getMsgVpnQueueTemplates getMsgVpnQueues getMsgVpnReplayLog getMsgVpnReplayLogTopicFilterSubscription getMsgVpnReplayLogTopicFilterSubscriptions getMsgVpnReplayLogs getMsgVpnReplicatedTopic getMsgVpnReplicatedTopics getMsgVpnRestDeliveryPoint getMsgVpnRestDeliveryPointQueueBinding getMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader getMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaders getMsgVpnRestDeliveryPointQueueBindingRequestHeader getMsgVpnRestDeliveryPointQueueBindingRequestHeaders getMsgVpnRestDeliveryPointQueueBindings getMsgVpnRestDeliveryPointRestConsumer getMsgVpnRestDeliveryPointRestConsumerOauthJwtClaim getMsgVpnRestDeliveryPointRestConsumerOauthJwtClaims getMsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonName getMsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNames getMsgVpnRestDeliveryPointRestConsumers getMsgVpnRestDeliveryPoints getMsgVpnSequencedTopic getMsgVpnSequencedTopics getMsgVpnTopicEndpoint getMsgVpnTopicEndpointTemplate getMsgVpnTopicEndpointTemplates getMsgVpnTopicEndpoints getMsgVpns getOauthProfile getOauthProfileAccessLevelGroup getOauthProfileAccessLevelGroupMsgVpnAccessLevelException getOauthProfileAccessLevelGroupMsgVpnAccessLevelExceptions getOauthProfileAccessLevelGroups getOauthProfileClientAllowedHost getOauthProfileClientAllowedHosts getOauthProfileClientAuthorizationParameter getOauthProfileClientAuthorizationParameters getOauthProfileClientRequiredClaim getOauthProfileClientRequiredClaims getOauthProfileDefaultMsgVpnAccessLevelException getOauthProfileDefaultMsgVpnAccessLevelExceptions getOauthProfileResourceServerRequiredClaim getOauthProfileResourceServerRequiredClaims getOauthProfiles getSystemInformation getVirtualHostname getVirtualHostnames replaceCertAuthority replaceClientCertAuthority replaceDmrCluster replaceDmrClusterCertMatchingRule replaceDmrClusterCertMatchingRuleAttributeFilter replaceDmrClusterLink replaceDomainCertAuthority replaceMsgVpn replaceMsgVpnAclProfile replaceMsgVpnAuthenticationOauthProfile replaceMsgVpnAuthenticationOauthProvider replaceMsgVpnAuthorizationGroup replaceMsgVpnBridge replaceMsgVpnBridgeRemoteMsgVpn replaceMsgVpnCertMatchingRule replaceMsgVpnCertMatchingRuleAttributeFilter replaceMsgVpnClientProfile replaceMsgVpnClientUsername replaceMsgVpnDistributedCache replaceMsgVpnDistributedCacheCluster replaceMsgVpnDistributedCacheClusterInstance replaceMsgVpnDmrBridge replaceMsgVpnJndiConnectionFactory replaceMsgVpnJndiQueue replaceMsgVpnJndiTopic replaceMsgVpnMqttRetainCache replaceMsgVpnMqttSession replaceMsgVpnMqttSessionSubscription replaceMsgVpnQueue replaceMsgVpnQueueTemplate replaceMsgVpnReplayLog replaceMsgVpnReplicatedTopic replaceMsgVpnRestDeliveryPoint replaceMsgVpnRestDeliveryPointQueueBinding replaceMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader replaceMsgVpnRestDeliveryPointQueueBindingRequestHeader replaceMsgVpnRestDeliveryPointRestConsumer replaceMsgVpnTopicEndpoint replaceMsgVpnTopicEndpointTemplate replaceOauthProfile replaceOauthProfileAccessLevelGroup replaceOauthProfileAccessLevelGroupMsgVpnAccessLevelException replaceOauthProfileClientAuthorizationParameter replaceOauthProfileDefaultMsgVpnAccessLevelException replaceVirtualHostname updateBroker updateCertAuthority updateClientCertAuthority updateDmrCluster updateDmrClusterCertMatchingRule updateDmrClusterCertMatchingRuleAttributeFilter updateDmrClusterLink updateDomainCertAuthority updateMsgVpn updateMsgVpnAclProfile updateMsgVpnAuthenticationOauthProfile updateMsgVpnAuthenticationOauthProvider updateMsgVpnAuthorizationGroup updateMsgVpnBridge updateMsgVpnBridgeRemoteMsgVpn updateMsgVpnCertMatchingRule updateMsgVpnCertMatchingRuleAttributeFilter updateMsgVpnClientProfile updateMsgVpnClientUsername updateMsgVpnDistributedCache updateMsgVpnDistributedCacheCluster updateMsgVpnDistributedCacheClusterInstance updateMsgVpnDmrBridge updateMsgVpnJndiConnectionFactory updateMsgVpnJndiQueue updateMsgVpnJndiTopic updateMsgVpnMqttRetainCache updateMsgVpnMqttSession updateMsgVpnMqttSessionSubscription updateMsgVpnQueue updateMsgVpnQueueTemplate updateMsgVpnReplayLog updateMsgVpnReplicatedTopic updateMsgVpnRestDeliveryPoint updateMsgVpnRestDeliveryPointQueueBinding updateMsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader updateMsgVpnRestDeliveryPointQueueBindingRequestHeader updateMsgVpnRestDeliveryPointRestConsumer updateMsgVpnTopicEndpoint updateMsgVpnTopicEndpointTemplate updateOauthProfile updateOauthProfileAccessLevelGroup updateOauthProfileAccessLevelGroupMsgVpnAccessLevelException updateOauthProfileClientAuthorizationParameter updateOauthProfileDefaultMsgVpnAccessLevelException updateVirtualHostname

Constructors

Methods

  • 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.

    Attribute Identifying Required Read-Only Write-Only Deprecated Opaque
    certAuthorityName x x x
    certContent x
    crlDayList x
    crlTimeList x
    crlUrl 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.

    Returns

    CertAuthorityResponse The Certificate Authority object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: CertAuthority;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: CertAuthority

        The Certificate Authority object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    CertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: CertAuthorityOcspTlsTrustedCommonName;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: CertAuthorityOcspTlsTrustedCommonName

        The OCSP Responder Trusted Common Name object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityOcspTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: ClientCertAuthority;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: ClientCertAuthority

        The Client Certificate Authority object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    ClientCertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: ClientCertAuthorityOcspTlsTrustedCommonName;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: ClientCertAuthorityOcspTlsTrustedCommonName

        The OCSP Responder Trusted Common Name object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityOcspTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterResponse The Cluster object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrCluster;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrCluster

        The Cluster object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRule;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRuleAttributeFilter;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRuleCondition;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRuleCondition

        The Certificate Matching Rule Condition object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleConditionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterLinkResponse The Link object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLink;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLink

        The Link object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterLinkAttributeResponse The Link Attribute object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLinkAttribute;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLinkAttribute

        The Link Attribute object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkAttributeResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DmrClusterLinkRemoteAddressResponse The Remote Address object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLinkRemoteAddress;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLinkRemoteAddress

        The Remote Address object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkRemoteAddressResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    DmrClusterLinkTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLinkTlsTrustedCommonName;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLinkTlsTrustedCommonName

        The Trusted Common Name object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DomainCertAuthority;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DomainCertAuthority

        The Domain Certificate Authority object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DomainCertAuthorityResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnResponse The Message VPN object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpn;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpn

        The Message VPN object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAclProfileResponse The ACL Profile object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAclProfile;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAclProfile

        The ACL Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAclProfileClientConnectExceptionResponse The Client Connect Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfileClientConnectException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfileClientConnectException

        The Client Connect Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileClientConnectExceptionResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    MsgVpnAclProfilePublishExceptionResponse The Publish Topic Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfilePublishException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfilePublishException

        The Publish Topic Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAclProfilePublishTopicExceptionResponse The Publish Topic Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfilePublishTopicException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfilePublishTopicException

        The Publish Topic Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishTopicExceptionResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    MsgVpnAclProfileSubscribeExceptionResponse The Subscribe Topic Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfileSubscribeException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfileSubscribeException

        The Subscribe Topic Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAclProfileSubscribeShareNameExceptionResponse The Subscribe Share Name Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfileSubscribeShareNameException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfileSubscribeShareNameException

        The Subscribe Share Name Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeShareNameExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAclProfileSubscribeTopicExceptionResponse The Subscribe Topic Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfileSubscribeTopicException;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfileSubscribeTopicException

        The Subscribe Topic Exception object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeTopicExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProfile;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProfile

        The OAuth Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProfileClientRequiredClaim;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProfileClientRequiredClaim

        The Required Claim object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProfileResourceServerRequiredClaim;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProfileResourceServerRequiredClaim

        The Required Claim object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProvider;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProvider

        The OAuth Provider object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProviderResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthorizationGroup;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthorizationGroup

        The Authorization Group object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthorizationGroupResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnBridgeResponse The Bridge object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridge;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridge

        The Bridge object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridgeRemoteMsgVpn;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridgeRemoteMsgVpn

        The Remote Message VPN object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteMsgVpnResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnBridgeRemoteSubscriptionResponse The Remote Subscription object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridgeRemoteSubscription;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridgeRemoteSubscription

        The Remote Subscription object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteSubscriptionResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    MsgVpnBridgeTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridgeTlsTrustedCommonName;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridgeTlsTrustedCommonName

        The Trusted Common Name object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRule;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRuleAttributeFilter;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRuleCondition;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRuleCondition

        The Certificate Matching Rule Condition object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleConditionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnClientProfileResponse The Client Profile object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientProfile;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientProfile

        The Client Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientProfileResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnClientUsernameResponse The Client Username object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientUsername;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientUsername

        The Client Username object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnClientUsernameAttributeResponse The Client Username Attribute object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientUsernameAttribute;
          clientUsername: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientUsernameAttribute

        The Client Username Attribute object's attributes. *

      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameAttributeResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCache;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCache

        The Distributed Cache object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheCluster;
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheCluster

        The Cache Cluster object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse The Home Cache Cluster object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterGlobalCachingHomeCluster;
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterGlobalCachingHomeCluster

        The Home Cache Cluster object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse The Topic Prefix object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefix;
          cacheName: string;
          clusterName: string;
          homeClusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefix

        The Topic Prefix object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterInstance;
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterInstance

        The Cache Instance object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterInstanceResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDistributedCacheClusterTopicResponse The Topic object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterTopic;
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterTopic

        The Topic object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterTopicResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDmrBridge;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDmrBridge

        The DMR Bridge object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDmrBridgeResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiConnectionFactory;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiConnectionFactory

        The JNDI Connection Factory object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiConnectionFactoryResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiQueue;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiQueue

        The JNDI Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiQueueResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiTopic;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiTopic

        The JNDI Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiTopicResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttRetainCache;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttRetainCache

        The MQTT Retain Cache object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttRetainCacheResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnMqttSessionResponse The MQTT Session object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSession;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttSession

        The MQTT Session object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSessionSubscription;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttSessionSubscription

        The Subscription object's attributes. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionSubscriptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnQueueResponse The Queue object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueue;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueue

        The Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnQueueSubscriptionResponse The Queue Subscription object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueueSubscription;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueueSubscription

        The Queue Subscription object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueSubscriptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnQueueTemplateResponse The Queue Template object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueueTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueueTemplate

        The Queue Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueTemplateResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnReplayLogResponse The Replay Log object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplayLog;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplayLog

        The Replay Log object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnReplayLogTopicFilterSubscriptionResponse The Topic Filter Subscription object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplayLogTopicFilterSubscription;
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplayLogTopicFilterSubscription

        The Topic Filter Subscription object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogTopicFilterSubscriptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplicatedTopic;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplicatedTopic

        The Replicated Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplicatedTopicResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPoint;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPoint

        The REST Delivery Point object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBinding;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBinding

        The Queue Binding object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader

        The Protected Request Header object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingRequestHeader;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingRequestHeader

        The Request Header object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointRestConsumer;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointRestConsumer

        The REST Consumer object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse The Claim object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointRestConsumerOauthJwtClaim;
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointRestConsumerOauthJwtClaim

        The Claim object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse | SempMetaOnlyResponse>

  • Deprecated

    Create 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse The Trusted Common Name object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonName;
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonName

        The Trusted Common Name object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnSequencedTopicResponse The Sequenced Topic object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnSequencedTopic;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnSequencedTopic

        The Sequenced Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnSequencedTopicResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpoint;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpoint

        The Topic Endpoint object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpointTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpointTemplate

        The Topic Endpoint Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointTemplateResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileResponse The OAuth Profile object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfile;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfile

        The OAuth Profile object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroup;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroup

        The Group Access Level object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException;
          groupName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileClientAllowedHostResponse The Allowed Host Value object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileClientAllowedHost;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileClientAllowedHost

        The Allowed Host Value object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAllowedHostResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileClientAuthorizationParameter;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileClientAuthorizationParameter

        The Authorization Parameter object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAuthorizationParameterResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileClientRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileClientRequiredClaim;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileClientRequiredClaim

        The Required Claim object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientRequiredClaimResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileDefaultMsgVpnAccessLevelException;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileDefaultMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileDefaultMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    OauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileResourceServerRequiredClaim;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileResourceServerRequiredClaim

        The Required Claim object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResourceServerRequiredClaimResponse | SempMetaOnlyResponse>

  • Create 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.

    Returns

    VirtualHostnameResponse The Virtual Hostname object's attributes after being created, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: VirtualHostname;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: VirtualHostname

        The Virtual Hostname object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | VirtualHostnameResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          ocspTlsTrustedCommonName: string;
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • ocspTlsTrustedCommonName: string

        The expected Trusted Common Name of the OCSP responder remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          ocspTlsTrustedCommonName: string;
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • ocspTlsTrustedCommonName: string

        The expected Trusted Common Name of the OCSP responder remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          ruleName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • ruleName: string

        The name of the rule. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          filterName: string;
          ruleName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • filterName: string

        The name of the filter. *

      • ruleName: string

        The name of the rule. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          ruleName: string;
          source: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • ruleName: string

        The name of the rule. *

      • source: string

        Certificate field to be compared with the Attribute. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          remoteNodeName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • remoteNodeName: string

        The name of the node at the remote end of the Link. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          attributeName: string;
          attributeValue: string;
          dmrClusterName: string;
          remoteNodeName: string;
          xContextId?: string;
      }
      • attributeName: string

        The name of the Attribute. *

      • attributeValue: string

        The value of the Attribute. *

      • dmrClusterName: string

        The name of the Cluster. *

      • remoteNodeName: string

        The name of the node at the remote end of the Link. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          remoteAddress: string;
          remoteNodeName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • remoteAddress: string

        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). *

      • remoteNodeName: string

        The name of the node at the remote end of the Link. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          remoteNodeName: string;
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • remoteNodeName: string

        The name of the node at the remote end of the Link. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          clientConnectExceptionAddress: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • clientConnectExceptionAddress: string

        The IP address/netmask of the client connect exception in CIDR form. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          publishExceptionTopic: string;
          topicSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • publishExceptionTopic: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • topicSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          publishTopicException: string;
          publishTopicExceptionSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • publishTopicException: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • publishTopicExceptionSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          subscribeExceptionTopic: string;
          topicSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • subscribeExceptionTopic: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • topicSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          subscribeShareNameException: string;
          subscribeShareNameExceptionSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • subscribeShareNameException: string

        The subscribe share name exception to the default action taken. May include wildcard characters. *

      • subscribeShareNameExceptionSyntax: string

        The syntax of the subscribe share name for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          subscribeTopicException: string;
          subscribeTopicExceptionSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • subscribeTopicException: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • subscribeTopicExceptionSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientRequiredClaimName: string;
          msgVpnName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • clientRequiredClaimName: string

        The name of the ID token claim to verify. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          resourceServerRequiredClaimName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • resourceServerRequiredClaimName: string

        The name of the access token claim to verify. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProviderName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProviderName: string

        The name of the OAuth Provider. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationGroupName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • authorizationGroupName: string

        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'. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          remoteMsgVpnInterface: string;
          remoteMsgVpnLocation: string;
          remoteMsgVpnName: string;
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • remoteMsgVpnInterface: string

        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. *

      • remoteMsgVpnLocation: string

        The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *

      • remoteMsgVpnName: string

        The name of the remote Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          remoteSubscriptionTopic: string;
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • remoteSubscriptionTopic: string

        The topic of the Bridge remote subscription. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          ruleName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • ruleName: string

        The name of the rule. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          filterName: string;
          msgVpnName: string;
          ruleName: string;
          xContextId?: string;
      }
      • filterName: string

        The name of the filter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • ruleName: string

        The name of the rule. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          ruleName: string;
          source: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • ruleName: string

        The name of the rule. *

      • source: string

        Certificate field to be compared with the Attribute. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientProfileName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • clientProfileName: string

        The name of the Client Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientUsername: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          attributeName: string;
          attributeValue: string;
          clientUsername: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • attributeName: string

        The name of the Attribute. *

      • attributeValue: string

        The value of the Attribute. *

      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          homeClusterName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          homeClusterName: string;
          msgVpnName: string;
          topicPrefix: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • topicPrefix: string

        A topic prefix for global topics available from the remote Home Cache Cluster. A wildcard (/>) is implied at the end of the prefix. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          instanceName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • instanceName: string

        The name of the Cache Instance. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          topic: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • topic: string

        The value of the Topic in the form a/b/c. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          remoteNodeName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • remoteNodeName: string

        The name of the node at the remote end of the DMR Bridge. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          connectionFactoryName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • connectionFactoryName: string

        The name of the JMS Connection Factory. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          queueName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • queueName: string

        The JNDI name of the JMS Queue. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          topicName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • topicName: string

        The JNDI name of the JMS Topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the MQTT Retain Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          xContextId?: string;
      }
      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          subscriptionTopic: string;
          xContextId?: string;
      }
      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • subscriptionTopic: string

        The MQTT subscription topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          queueName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • queueName: string

        The name of the Queue. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          queueName: string;
          subscriptionTopic: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • queueName: string

        The name of the Queue. *

      • subscriptionTopic: string

        The topic of the Subscription. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          queueTemplateName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • queueTemplateName: string

        The name of the Queue Template. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          replayLogName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • replayLogName: string

        The name of the Replay Log. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          replayLogName: string;
          topicFilterSubscription: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • replayLogName: string

        The name of the Replay Log. *

      • topicFilterSubscription: string

        The topic of the Subscription. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          replicatedTopic: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • replicatedTopic: string

        The topic for applying replication. Published messages matching this topic will be replicated to the standby site. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          headerName: string;
          msgVpnName: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • headerName: string

        The name of the protected HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          headerName: string;
          msgVpnName: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • headerName: string

        The name of the HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthJwtClaimName: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthJwtClaimName: string

        The name of the additional claim. Cannot be "exp", "iat", or "jti". *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Deprecated

    Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        The name of the REST Delivery Point. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          sequencedTopic: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • sequencedTopic: string

        Topic for applying sequence numbers. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          topicEndpointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • topicEndpointName: string

        The name of the Topic Endpoint. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          topicEndpointTemplateName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • topicEndpointTemplateName: string

        The name of the Topic Endpoint Template. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          oauthProfileName: string;
          xContextId?: string;
      }
      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          groupName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          groupName: string;
          msgVpnName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • groupName: string

        The name of the group. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          allowedHost: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • allowedHost: string

        An allowed value for the Host header. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationParameterName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • authorizationParameterName: string

        The name of the authorization parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientRequiredClaimName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • clientRequiredClaimName: string

        The name of the ID token claim to verify. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          oauthProfileName: string;
          resourceServerRequiredClaimName: string;
          xContextId?: string;
      }
      • oauthProfileName: string

        The name of the OAuth profile. *

      • resourceServerRequiredClaimName: string

        The name of the access token claim to verify. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Delete 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.

    Returns

    SempMetaOnlyResponse The request metadata.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          virtualHostname: string;
          xContextId?: string;
      }
      • virtualHostname: string

        The virtual hostname. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse>

  • Get 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.

    Returns

    AboutResponse The About object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<AboutResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    AboutApiResponse The API Description object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<AboutApiResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    AboutUserResponse The User object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<AboutUserResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    AboutUserMsgVpnResponse The User Message VPN object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<AboutUserMsgVpnResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    AboutUserMsgVpnsResponse The list of User Message VPN objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<AboutUserMsgVpnsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    BrokerResponse The Broker object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<BrokerResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    CertAuthoritiesResponse The list of Certificate Authority objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthoritiesResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    CertAuthorityResponse The Certificate Authority object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    CertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          ocspTlsTrustedCommonName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • ocspTlsTrustedCommonName: string

        The expected Trusted Common Name of the OCSP responder remote certificate. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityOcspTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    CertAuthorityOcspTlsTrustedCommonNamesResponse The list of OCSP Responder Trusted Common Name objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityOcspTlsTrustedCommonNamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    ClientCertAuthoritiesResponse The list of Client Certificate Authority objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthoritiesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    ClientCertAuthorityResponse The Client Certificate Authority object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    ClientCertAuthorityOcspTlsTrustedCommonNameResponse The OCSP Responder Trusted Common Name object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          ocspTlsTrustedCommonName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • ocspTlsTrustedCommonName: string

        The expected Trusted Common Name of the OCSP responder remote certificate. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityOcspTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    ClientCertAuthorityOcspTlsTrustedCommonNamesResponse The list of OCSP Responder Trusted Common Name objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityOcspTlsTrustedCommonNamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterResponse The Cluster object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          filterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • filterName: string

        The name of the filter. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRuleAttributeFiltersResponse The list of Certificate Matching Rule Attribute Filter objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleAttributeFiltersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          source: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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. *

      • source: string

        Certificate field to be compared with the Attribute. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleConditionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRuleConditionsResponse The list of Certificate Matching Rule Condition objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleConditionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterCertMatchingRulesResponse The list of Certificate Matching Rule objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRulesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinkResponse The Link object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinkAttributeResponse The Link Attribute object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          attributeName: string;
          attributeValue: string;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • attributeName: string

        The name of the Attribute. *

      • attributeValue: string

        The value of the Attribute. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkAttributeResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinkAttributesResponse The list of Link Attribute objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkAttributesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinkRemoteAddressResponse The Remote Address object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          remoteAddress: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteAddress: string

        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). *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkRemoteAddressResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinkRemoteAddressesResponse The list of Remote Address objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkRemoteAddressesResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    DmrClusterLinkTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    DmrClusterLinkTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkTlsTrustedCommonNamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClusterLinksResponse The list of Link objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinksResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DmrClustersResponse The list of Cluster objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClustersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DomainCertAuthoritiesResponse The list of Domain Certificate Authority objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DomainCertAuthoritiesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    DomainCertAuthorityResponse The Domain Certificate Authority object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DomainCertAuthorityResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnResponse The Message VPN object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileResponse The ACL Profile object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileClientConnectExceptionResponse The Client Connect Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          clientConnectExceptionAddress: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • clientConnectExceptionAddress: string

        The IP address/netmask of the client connect exception in CIDR form. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileClientConnectExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileClientConnectExceptionsResponse The list of Client Connect Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileClientConnectExceptionsResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAclProfilePublishExceptionResponse The Publish Topic Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          publishExceptionTopic: string;
          select?: string[];
          topicSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • publishExceptionTopic: string

        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. *

      • topicSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishExceptionResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAclProfilePublishExceptionsResponse The list of Publish Topic Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfilePublishTopicExceptionResponse The Publish Topic Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          publishTopicException: string;
          publishTopicExceptionSyntax: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • publishTopicException: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • publishTopicExceptionSyntax: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishTopicExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfilePublishTopicExceptionsResponse The list of Publish Topic Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilePublishTopicExceptionsResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAclProfileSubscribeExceptionResponse The Subscribe Topic Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscribeExceptionTopic: string;
          topicSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscribeExceptionTopic: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • topicSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeExceptionResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAclProfileSubscribeExceptionsResponse The list of Subscribe Topic Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileSubscribeShareNameExceptionResponse The Subscribe Share Name Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscribeShareNameException: string;
          subscribeShareNameExceptionSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscribeShareNameException: string

        The subscribe share name exception to the default action taken. May include wildcard characters. *

      • subscribeShareNameExceptionSyntax: string

        The syntax of the subscribe share name for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeShareNameExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileSubscribeShareNameExceptionsResponse The list of Subscribe Share Name Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeShareNameExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileSubscribeTopicExceptionResponse The Subscribe Topic Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscribeTopicException: string;
          subscribeTopicExceptionSyntax: string;
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscribeTopicException: string

        The topic for the exception to the default action taken. May include wildcard characters. *

      • subscribeTopicExceptionSyntax: string

        The syntax of the topic for the exception to the default action taken. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeTopicExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfileSubscribeTopicExceptionsResponse The list of Subscribe Topic Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileSubscribeTopicExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAclProfilesResponse The list of ACL Profile objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfilesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse The Required Claim object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientRequiredClaimName: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • clientRequiredClaimName: string

        The name of the ID token claim to verify. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileClientRequiredClaimResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfileClientRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileClientRequiredClaimsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          resourceServerRequiredClaimName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • resourceServerRequiredClaimName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResourceServerRequiredClaimsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthenticationOauthProfilesResponse The list of OAuth Profile objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfilesResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProviderName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProviderName: string

        The name of the OAuth Provider. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProviderResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnAuthenticationOauthProvidersResponse The list of OAuth Provider objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProvidersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationGroupName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationGroupName: string

        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'. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthorizationGroupResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnAuthorizationGroupsResponse The list of Authorization Group objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthorizationGroupsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgeResponse The Bridge object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          remoteMsgVpnInterface: string;
          remoteMsgVpnLocation: string;
          remoteMsgVpnName: string;
          select?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteMsgVpnInterface: string

        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. *

      • remoteMsgVpnLocation: string

        The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *

      • remoteMsgVpnName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteMsgVpnResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgeRemoteMsgVpnsResponse The list of Remote Message VPN objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteMsgVpnsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgeRemoteSubscriptionResponse The Remote Subscription object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          remoteSubscriptionTopic: string;
          select?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteSubscriptionTopic: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteSubscriptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgeRemoteSubscriptionsResponse The list of Remote Subscription objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteSubscriptionsResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnBridgeTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnBridgeTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeTlsTrustedCommonNamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnBridgesResponse The list of Bridge objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          filterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • filterName: string

        The name of the filter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRuleAttributeFiltersResponse The list of Certificate Matching Rule Attribute Filter objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleAttributeFiltersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRuleConditionResponse The Certificate Matching Rule Condition object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          source: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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. *

      • source: string

        Certificate field to be compared with the Attribute. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleConditionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRuleConditionsResponse The list of Certificate Matching Rule Condition objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleConditionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnCertMatchingRulesResponse The list of Certificate Matching Rule objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRulesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientProfileResponse The Client Profile object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • clientProfileName: string

        The name of the Client Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientProfileResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientProfilesResponse The list of Client Profile objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientProfilesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientUsernameResponse The Client Username object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientUsername: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientUsernameAttributeResponse The Client Username Attribute object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          attributeName: string;
          attributeValue: string;
          clientUsername: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • attributeName: string

        The name of the Attribute. *

      • attributeValue: string

        The value of the Attribute. *

      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameAttributeResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientUsernameAttributesResponse The list of Client Username Attribute objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientUsername: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • clientUsername: string

        The name of the Client Username. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameAttributesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnClientUsernamesResponse The list of Client Username objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheResponse The Distributed Cache object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse The Home Cache Cluster object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          homeClusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClusterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse The Topic Prefix object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          homeClusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicPrefix: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicPrefix: string

        A topic prefix for global topics available from the remote Home Cache Cluster. A wildcard (/>) is implied at the end of the prefix. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixesResponse The list of Topic Prefix objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          count?: number;
          cursor?: string;
          homeClusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • homeClusterName: string

        The name of the remote Home Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClusterTopicPrefixesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterGlobalCachingHomeClustersResponse The list of Home Cache Cluster objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterGlobalCachingHomeClustersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          instanceName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • instanceName: string

        The name of the Cache Instance. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterInstanceResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterInstancesResponse The list of Cache Instance objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterInstancesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterTopicResponse The Topic object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topic: string;
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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: string

        The value of the Topic in the form a/b/c. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterTopicResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClusterTopicsResponse The list of Topic objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          clusterName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterTopicsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCacheClustersResponse The list of Cache Cluster objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the Distributed Cache. *

      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClustersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDistributedCachesResponse The list of Distributed Cache objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCachesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDmrBridgeResponse The DMR Bridge object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDmrBridgeResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnDmrBridgesResponse The list of DMR Bridge objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDmrBridgesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiConnectionFactoriesResponse The list of JNDI Connection Factory objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiConnectionFactoriesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          connectionFactoryName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • connectionFactoryName: string

        The name of the JMS Connection Factory. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiConnectionFactoryResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiQueueResponse The JNDI Queue object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiQueueResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiQueuesResponse The list of JNDI Queue objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiQueuesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiTopicResponse The JNDI Topic object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicName: string

        The JNDI name of the JMS Topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiTopicResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnJndiTopicsResponse The list of JNDI Topic objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiTopicsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • cacheName: string

        The name of the MQTT Retain Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttRetainCacheResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttRetainCachesResponse The list of MQTT Retain Cache objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttRetainCachesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttSessionResponse The MQTT Session object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscriptionTopic: string;
          xContextId?: string;
      }
      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscriptionTopic: string

        The MQTT subscription topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionSubscriptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttSessionSubscriptionsResponse The list of Subscription objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionSubscriptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnMqttSessionsResponse The list of MQTT Session objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueueResponse The Queue object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueueSubscriptionResponse The Queue Subscription object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          subscriptionTopic: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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. *

      • subscriptionTopic: string

        The topic of the Subscription. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueSubscriptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueueSubscriptionsResponse The list of Queue Subscription objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueSubscriptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueueTemplateResponse The Queue Template object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          queueTemplateName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueTemplateName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueTemplateResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueueTemplatesResponse The list of Queue Template objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueTemplatesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnQueuesResponse The list of Queue objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueuesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplayLogResponse The Replay Log object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplayLogTopicFilterSubscriptionResponse The Topic Filter Subscription object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          topicFilterSubscription: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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. *

      • topicFilterSubscription: string

        The topic of the Subscription. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogTopicFilterSubscriptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplayLogTopicFilterSubscriptionsResponse The list of Topic Filter Subscription objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogTopicFilterSubscriptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplayLogsResponse The list of Replay Log objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          replicatedTopic: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replicatedTopic: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplicatedTopicResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnReplicatedTopicsResponse The list of Replicated Topic objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplicatedTopicsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • headerName: string

        The name of the protected HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeadersResponse The list of Protected Request Header objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeadersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • headerName: string

        The name of the HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingRequestHeadersResponse The list of Request Header objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingRequestHeadersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingsResponse The list of Queue Binding objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse The Claim object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthJwtClaimName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • oauthJwtClaimName: string

        The name of the additional claim. Cannot be "exp", "iat", or "jti". *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimsResponse The list of Claim objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerOauthJwtClaimsResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse The Trusted Common Name object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          tlsTrustedCommonName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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. *

      • tlsTrustedCommonName: string

        The expected trusted common name of the remote certificate. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNameResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNamesResponse The list of Trusted Common Name objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerTlsTrustedCommonNamesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumersResponse The list of REST Consumer objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnRestDeliveryPointsResponse The list of REST Delivery Point objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnSequencedTopicResponse The Sequenced Topic object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          sequencedTopic: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • sequencedTopic: string

        Topic for applying sequence numbers. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnSequencedTopicResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnSequencedTopicsResponse The list of Sequenced Topic objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnSequencedTopicsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointName: string

        The name of the Topic Endpoint. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointTemplateName: string;
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointTemplateName: string

        The name of the Topic Endpoint Template. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointTemplateResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnTopicEndpointTemplatesResponse The list of Topic Endpoint Template objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointTemplatesResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnTopicEndpointsResponse The list of Topic Endpoint objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    MsgVpnsResponse The list of Message VPN objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileResponse The OAuth Profile object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          groupName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          groupName: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • groupName: string

        The name of the group. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionsResponse The list of Message VPN Access-Level Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          groupName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileAccessLevelGroupsResponse The list of Group Access Level objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientAllowedHostResponse The Allowed Host Value object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          allowedHost: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • allowedHost: string

        An allowed value for the Host header. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAllowedHostResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientAllowedHostsResponse The list of Allowed Host Value objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAllowedHostsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationParameterName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationParameterName: string

        The name of the authorization parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAuthorizationParameterResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientAuthorizationParametersResponse The list of Authorization Parameter objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAuthorizationParametersResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientRequiredClaimResponse The Required Claim object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          clientRequiredClaimName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • clientRequiredClaimName: string

        The name of the ID token claim to verify. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientRequiredClaimResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileClientRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientRequiredClaimsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileDefaultMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileDefaultMsgVpnAccessLevelExceptionsResponse The list of Message VPN Access-Level Exception objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileDefaultMsgVpnAccessLevelExceptionsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileResourceServerRequiredClaimResponse The Required Claim object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          oauthProfileName: string;
          opaquePassword?: string;
          resourceServerRequiredClaimName: string;
          select?: string[];
          xContextId?: string;
      }
      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • resourceServerRequiredClaimName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResourceServerRequiredClaimResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfileResourceServerRequiredClaimsResponse The list of Required Claim objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResourceServerRequiredClaimsResponse | SempMetaOnlyResponse>

  • Get 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.

    Returns

    OauthProfilesResponse The list of OAuth Profile objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfilesResponse | SempMetaOnlyResponse>

  • Deprecated

    Get 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.

    Returns

    SystemInformationResponse The System Information object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | SystemInformationResponse>

  • Get 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.

    Returns

    VirtualHostnameResponse The Virtual Hostname object's attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          opaquePassword?: string;
          select?: string[];
          virtualHostname: string;
          xContextId?: string;
      }
      • Optional opaquePassword?: string

        Accept 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. *

      • virtualHostname: string

        The virtual hostname. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | VirtualHostnameResponse>

  • Get 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.

    Returns

    VirtualHostnamesResponse The list of Virtual Hostname objects' attributes, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          count?: number;
          cursor?: string;
          opaquePassword?: string;
          select?: string[];
          where?: string[];
          xContextId?: string;
      }
      • Optional count?: number

        Limit the count of objects in the response. See the documentation for the count parameter. *

      • Optional cursor?: string

        The cursor, or position, for the next page of objects. See the documentation for the cursor parameter. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | VirtualHostnamesResponse>

  • Deprecated

    Replace 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.

    Returns

    CertAuthorityResponse The Certificate Authority object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: CertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: CertAuthority

        The Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: ClientCertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: ClientCertAuthority

        The Client Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    DmrClusterResponse The Cluster object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrCluster;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrCluster

        The Cluster object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRule;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRuleAttributeFilter;
          dmrClusterName: string;
          filterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • filterName: string

        The name of the filter. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    DmrClusterLinkResponse The Link object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLink;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLink

        The Link object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DomainCertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DomainCertAuthority

        The Domain Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DomainCertAuthorityResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnResponse The Message VPN object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpn;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpn

        The Message VPN object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnAclProfileResponse The ACL Profile object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfile;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfile

        The ACL Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProfile;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProfile

        The OAuth Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResponse | SempMetaOnlyResponse>

  • Deprecated

    Replace 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.

    Returns

    MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProvider;
          msgVpnName: string;
          oauthProviderName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProvider

        The OAuth Provider object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProviderName: string

        The name of the OAuth Provider. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProviderResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationGroupName: string;
          body: MsgVpnAuthorizationGroup;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationGroupName: string

        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'. *

      • body: MsgVpnAuthorizationGroup

        The Authorization Group object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthorizationGroupResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnBridgeResponse The Bridge object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridge;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridge

        The Bridge object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridgeRemoteMsgVpn;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          remoteMsgVpnInterface: string;
          remoteMsgVpnLocation: string;
          remoteMsgVpnName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridgeRemoteMsgVpn

        The Remote Message VPN object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteMsgVpnInterface: string

        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. *

      • remoteMsgVpnLocation: string

        The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *

      • remoteMsgVpnName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteMsgVpnResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRule;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRuleAttributeFilter;
          filterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • filterName: string

        The name of the filter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnClientProfileResponse The Client Profile object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientProfile;
          clientProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientProfile

        The Client Profile object's attributes. *

      • clientProfileName: string

        The name of the Client Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientProfileResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnClientUsernameResponse The Client Username object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientUsername;
          clientUsername: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientUsername

        The Client Username object's attributes. *

      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCache;
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCache

        The Distributed Cache object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheCluster;
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheCluster

        The Cache Cluster object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterInstance;
          cacheName: string;
          clusterName: string;
          instanceName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterInstance

        The Cache Instance object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • instanceName: string

        The name of the Cache Instance. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterInstanceResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDmrBridge;
          msgVpnName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDmrBridge

        The DMR Bridge object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDmrBridgeResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiConnectionFactory;
          connectionFactoryName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiConnectionFactory

        The JNDI Connection Factory object's attributes. *

      • connectionFactoryName: string

        The name of the JMS Connection Factory. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiConnectionFactoryResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiQueue;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiQueue

        The JNDI Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiQueueResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiTopic;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicName: string;
          xContextId?: string;
      }
      • body: MsgVpnJndiTopic

        The JNDI Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicName: string

        The JNDI name of the JMS Topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiTopicResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttRetainCache;
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttRetainCache

        The MQTT Retain Cache object's attributes. *

      • cacheName: string

        The name of the MQTT Retain Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttRetainCacheResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnMqttSessionResponse The MQTT Session object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSession;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttSession

        The MQTT Session object's attributes. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSessionSubscription;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscriptionTopic: string;
          xContextId?: string;
      }
      • body: MsgVpnMqttSessionSubscription

        The Subscription object's attributes. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscriptionTopic: string

        The MQTT subscription topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionSubscriptionResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnQueueResponse The Queue object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueue;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueue

        The Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnQueueTemplateResponse The Queue Template object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueueTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          queueTemplateName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueueTemplate

        The Queue Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueTemplateName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueTemplateResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnReplayLogResponse The Replay Log object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplayLog;
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplayLog

        The Replay Log object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplicatedTopic;
          msgVpnName: string;
          opaquePassword?: string;
          replicatedTopic: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplicatedTopic

        The Replicated Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replicatedTopic: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplicatedTopicResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPoint;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPoint

        The REST Delivery Point object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBinding;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBinding

        The Queue Binding object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader;
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader

        The Protected Request Header object's attributes. *

      • headerName: string

        The name of the protected HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingRequestHeader;
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingRequestHeader

        The Request Header object's attributes. *

      • headerName: string

        The name of the HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointRestConsumer;
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointRestConsumer

        The REST Consumer object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpoint;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointName: string;
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpoint

        The Topic Endpoint object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointName: string

        The name of the Topic Endpoint. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpointTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointTemplateName: string;
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpointTemplate

        The Topic Endpoint Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointTemplateName: string

        The name of the Topic Endpoint Template. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointTemplateResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    OauthProfileResponse The OAuth Profile object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfile;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfile

        The OAuth Profile object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroup;
          groupName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroup

        The Group Access Level object's attributes. *

      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException;
          groupName: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • groupName: string

        The name of the group. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationParameterName: string;
          body: OauthProfileClientAuthorizationParameter;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationParameterName: string

        The name of the authorization parameter. *

      • body: OauthProfileClientAuthorizationParameter

        The Authorization Parameter object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAuthorizationParameterResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileDefaultMsgVpnAccessLevelException;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileDefaultMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileDefaultMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Replace 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.

    Returns

    VirtualHostnameResponse The Virtual Hostname object's attributes after being replaced, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: VirtualHostname;
          opaquePassword?: string;
          select?: string[];
          virtualHostname: string;
          xContextId?: string;
      }
      • body: VirtualHostname

        The Virtual Hostname object's attributes. *

      • Optional opaquePassword?: string

        Accept 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. *

      • virtualHostname: string

        The virtual hostname. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | VirtualHostnameResponse>

  • Update 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.

    Returns

    BrokerResponse The Broker object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: Broker;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: Broker

        The Broker object's attributes. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<BrokerResponse | SempMetaOnlyResponse>

  • Deprecated

    Update 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.

    Returns

    CertAuthorityResponse The Certificate Authority object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: CertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: CertAuthority

        The Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<CertAuthorityResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    ClientCertAuthorityResponse The Client Certificate Authority object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: ClientCertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: ClientCertAuthority

        The Client Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<ClientCertAuthorityResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    DmrClusterResponse The Cluster object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrCluster;
          dmrClusterName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrCluster

        The Cluster object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    DmrClusterCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRule;
          dmrClusterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    DmrClusterCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterCertMatchingRuleAttributeFilter;
          dmrClusterName: string;
          filterName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • filterName: string

        The name of the filter. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    DmrClusterLinkResponse The Link object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DmrClusterLink;
          dmrClusterName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DmrClusterLink

        The Link object's attributes. *

      • dmrClusterName: string

        The name of the Cluster. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DmrClusterLinkResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    DomainCertAuthorityResponse The Domain Certificate Authority object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: DomainCertAuthority;
          certAuthorityName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: DomainCertAuthority

        The Domain Certificate Authority object's attributes. *

      • certAuthorityName: string

        The name of the Certificate Authority. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<DomainCertAuthorityResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnResponse The Message VPN object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpn;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpn

        The Message VPN object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnAclProfileResponse The ACL Profile object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          aclProfileName: string;
          body: MsgVpnAclProfile;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • aclProfileName: string

        The name of the ACL Profile. *

      • body: MsgVpnAclProfile

        The ACL Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAclProfileResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnAuthenticationOauthProfileResponse The OAuth Profile object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProfile;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProfile

        The OAuth Profile object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProfileResponse | SempMetaOnlyResponse>

  • Deprecated

    Update 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.

    Returns

    MsgVpnAuthenticationOauthProviderResponse The OAuth Provider object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnAuthenticationOauthProvider;
          msgVpnName: string;
          oauthProviderName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnAuthenticationOauthProvider

        The OAuth Provider object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • oauthProviderName: string

        The name of the OAuth Provider. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthenticationOauthProviderResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnAuthorizationGroupResponse The Authorization Group object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationGroupName: string;
          body: MsgVpnAuthorizationGroup;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationGroupName: string

        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'. *

      • body: MsgVpnAuthorizationGroup

        The Authorization Group object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnAuthorizationGroupResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnBridgeResponse The Bridge object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridge;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridge

        The Bridge object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnBridgeRemoteMsgVpnResponse The Remote Message VPN object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnBridgeRemoteMsgVpn;
          bridgeName: string;
          bridgeVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          remoteMsgVpnInterface: string;
          remoteMsgVpnLocation: string;
          remoteMsgVpnName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnBridgeRemoteMsgVpn

        The Remote Message VPN object's attributes. *

      • bridgeName: string

        The name of the Bridge. *

      • bridgeVirtualRouter: string

        The virtual router of the Bridge. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteMsgVpnInterface: string

        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. *

      • remoteMsgVpnLocation: string

        The location of the remote Message VPN as either an FQDN with port, IP address with port, or virtual router name (starting with "v:"). *

      • remoteMsgVpnName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnBridgeRemoteMsgVpnResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnCertMatchingRuleResponse The Certificate Matching Rule object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRule;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRule

        The Certificate Matching Rule object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnCertMatchingRuleAttributeFilterResponse The Certificate Matching Rule Attribute Filter object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnCertMatchingRuleAttributeFilter;
          filterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          ruleName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnCertMatchingRuleAttributeFilter

        The Certificate Matching Rule Attribute Filter object's attributes. *

      • filterName: string

        The name of the filter. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • ruleName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnCertMatchingRuleAttributeFilterResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnClientProfileResponse The Client Profile object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientProfile;
          clientProfileName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientProfile

        The Client Profile object's attributes. *

      • clientProfileName: string

        The name of the Client Profile. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientProfileResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnClientUsernameResponse The Client Username object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnClientUsername;
          clientUsername: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnClientUsername

        The Client Username object's attributes. *

      • clientUsername: string

        The name of the Client Username. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnClientUsernameResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnDistributedCacheResponse The Distributed Cache object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCache;
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCache

        The Distributed Cache object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnDistributedCacheClusterResponse The Cache Cluster object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheCluster;
          cacheName: string;
          clusterName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheCluster

        The Cache Cluster object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnDistributedCacheClusterInstanceResponse The Cache Instance object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDistributedCacheClusterInstance;
          cacheName: string;
          clusterName: string;
          instanceName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDistributedCacheClusterInstance

        The Cache Instance object's attributes. *

      • cacheName: string

        The name of the Distributed Cache. *

      • clusterName: string

        The name of the Cache Cluster. *

      • instanceName: string

        The name of the Cache Instance. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDistributedCacheClusterInstanceResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnDmrBridgeResponse The DMR Bridge object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnDmrBridge;
          msgVpnName: string;
          opaquePassword?: string;
          remoteNodeName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnDmrBridge

        The DMR Bridge object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • remoteNodeName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnDmrBridgeResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnJndiConnectionFactoryResponse The JNDI Connection Factory object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiConnectionFactory;
          connectionFactoryName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiConnectionFactory

        The JNDI Connection Factory object's attributes. *

      • connectionFactoryName: string

        The name of the JMS Connection Factory. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiConnectionFactoryResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnJndiQueueResponse The JNDI Queue object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiQueue;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnJndiQueue

        The JNDI Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiQueueResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnJndiTopicResponse The JNDI Topic object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnJndiTopic;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicName: string;
          xContextId?: string;
      }
      • body: MsgVpnJndiTopic

        The JNDI Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicName: string

        The JNDI name of the JMS Topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnJndiTopicResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnMqttRetainCacheResponse The MQTT Retain Cache object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttRetainCache;
          cacheName: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttRetainCache

        The MQTT Retain Cache object's attributes. *

      • cacheName: string

        The name of the MQTT Retain Cache. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttRetainCacheResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnMqttSessionResponse The MQTT Session object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSession;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnMqttSession

        The MQTT Session object's attributes. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnMqttSessionSubscriptionResponse The Subscription object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnMqttSessionSubscription;
          mqttSessionClientId: string;
          mqttSessionVirtualRouter: string;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          subscriptionTopic: string;
          xContextId?: string;
      }
      • body: MsgVpnMqttSessionSubscription

        The Subscription object's attributes. *

      • mqttSessionClientId: string

        The Client ID of the MQTT Session, which corresponds to the ClientId provided in the MQTT CONNECT packet. *

      • mqttSessionVirtualRouter: string

        The virtual router of the MQTT Session. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • subscriptionTopic: string

        The MQTT subscription topic. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnMqttSessionSubscriptionResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnQueueResponse The Queue object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueue;
          msgVpnName: string;
          opaquePassword?: string;
          queueName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueue

        The Queue object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnQueueTemplateResponse The Queue Template object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnQueueTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          queueTemplateName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnQueueTemplate

        The Queue Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueTemplateName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnQueueTemplateResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnReplayLogResponse The Replay Log object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplayLog;
          msgVpnName: string;
          opaquePassword?: string;
          replayLogName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplayLog

        The Replay Log object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replayLogName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplayLogResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnReplicatedTopicResponse The Replicated Topic object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnReplicatedTopic;
          msgVpnName: string;
          opaquePassword?: string;
          replicatedTopic: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnReplicatedTopic

        The Replicated Topic object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • replicatedTopic: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnReplicatedTopicResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnRestDeliveryPointResponse The REST Delivery Point object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPoint;
          msgVpnName: string;
          opaquePassword?: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPoint

        The REST Delivery Point object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingResponse The Queue Binding object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBinding;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBinding

        The Queue Binding object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse The Protected Request Header object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader;
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeader

        The Protected Request Header object's attributes. *

      • headerName: string

        The name of the protected HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingProtectedRequestHeaderResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse The Request Header object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointQueueBindingRequestHeader;
          headerName: string;
          msgVpnName: string;
          opaquePassword?: string;
          queueBindingName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointQueueBindingRequestHeader

        The Request Header object's attributes. *

      • headerName: string

        The name of the HTTP request header. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • queueBindingName: string

        The name of a queue in the Message VPN. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointQueueBindingRequestHeaderResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnRestDeliveryPointRestConsumerResponse The REST Consumer object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnRestDeliveryPointRestConsumer;
          msgVpnName: string;
          opaquePassword?: string;
          restConsumerName: string;
          restDeliveryPointName: string;
          select?: string[];
          xContextId?: string;
      }
      • body: MsgVpnRestDeliveryPointRestConsumer

        The REST Consumer object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept opaque attributes in the request or return opaque attributes in the response, encrypted with the specified password. See the documentation for the opaquePassword parameter. *

      • restConsumerName: string

        The name of the REST Consumer. *

      • restDeliveryPointName: string

        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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnRestDeliveryPointRestConsumerResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnTopicEndpointResponse The Topic Endpoint object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpoint;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointName: string;
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpoint

        The Topic Endpoint object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointName: string

        The name of the Topic Endpoint. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    MsgVpnTopicEndpointTemplateResponse The Topic Endpoint Template object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: MsgVpnTopicEndpointTemplate;
          msgVpnName: string;
          opaquePassword?: string;
          select?: string[];
          topicEndpointTemplateName: string;
          xContextId?: string;
      }
      • body: MsgVpnTopicEndpointTemplate

        The Topic Endpoint Template object's attributes. *

      • msgVpnName: string

        The name of the Message VPN. *

      • Optional opaquePassword?: string

        Accept 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. *

      • topicEndpointTemplateName: string

        The name of the Topic Endpoint Template. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<MsgVpnTopicEndpointTemplateResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    OauthProfileResponse The OAuth Profile object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfile;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfile

        The OAuth Profile object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    OauthProfileAccessLevelGroupResponse The Group Access Level object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroup;
          groupName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroup

        The Group Access Level object's attributes. *

      • groupName: string

        The name of the group. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException;
          groupName: string;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileAccessLevelGroupMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • groupName: string

        The name of the group. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileAccessLevelGroupMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    OauthProfileClientAuthorizationParameterResponse The Authorization Parameter object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          authorizationParameterName: string;
          body: OauthProfileClientAuthorizationParameter;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • authorizationParameterName: string

        The name of the authorization parameter. *

      • body: OauthProfileClientAuthorizationParameter

        The Authorization Parameter object's attributes. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileClientAuthorizationParameterResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    OauthProfileDefaultMsgVpnAccessLevelExceptionResponse The Message VPN Access-Level Exception object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: OauthProfileDefaultMsgVpnAccessLevelException;
          msgVpnName: string;
          oauthProfileName: string;
          opaquePassword?: string;
          select?: string[];
          xContextId?: string;
      }
      • body: OauthProfileDefaultMsgVpnAccessLevelException

        The Message VPN Access-Level Exception object's attributes. *

      • msgVpnName: string

        The name of the message VPN. *

      • oauthProfileName: string

        The name of the OAuth profile. *

      • Optional opaquePassword?: string

        Accept 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 xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<OauthProfileDefaultMsgVpnAccessLevelExceptionResponse | SempMetaOnlyResponse>

  • Update 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.

    Returns

    VirtualHostnameResponse The Virtual Hostname object's attributes after being updated, and the request metadata.

    Returns

    SempMetaOnlyResponse The error response.

    Throws

    ApiError

    Parameters

    • __namedParameters: {
          body: VirtualHostname;
          opaquePassword?: string;
          select?: string[];
          virtualHostname: string;
          xContextId?: string;
      }
      • body: VirtualHostname

        The Virtual Hostname object's attributes. *

      • Optional opaquePassword?: string

        Accept 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. *

      • virtualHostname: string

        The virtual hostname. *

      • Optional xContextId?: string

        Optional context id the request is running. *

    Returns CancelablePromise<SempMetaOnlyResponse | VirtualHostnameResponse>