CloudHub Connector 1.1 Reference - Mule 4
Anypoint Connector for CloudHub enables you to create and list notifications and to retrieve the status of created applications that are deployed to CloudHub.
Release Notes: CloudHub Connector Release Notes
Configurations
Default Configuration
Default configuration
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
String |
The name for this configuration. Connectors reference the configuration with this name. |
x |
|
Connection |
Connection types for this configuration. |
x |
||
Name |
String |
ID used to reference this configuration. |
x |
|
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate. |
Connection Types
Basic Authentication
Basic connection provider that provides CloudHub connection.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Username |
String |
Username of the Anypoint Platform Account |
x |
|
Password |
String |
Password of the Anypoint Platform Account |
x |
|
Environment |
String |
Optionally specifies the Anypoint Platform environment to use: by default, the environment defined as the default in Anypoint Platform. |
||
Anypoint Platform URL |
String |
Enables you to change between the US Anypoint Platform and the EU Anypoint Platform, if required. |
|
|
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
OAuth Client Credentials
Connection provider that provides CloudHub connection.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Anypoint Platform URL |
String |
Enables you to change between the US Anypoint Platform and the EU Anypoint Platform, if required. |
|
|
Client Id |
String |
OAuth client ID, as registered with the service provider. |
x |
|
Client Secret |
String |
OAuth client secret, as registered with the service provider. |
x |
|
Environment |
String |
Optionally specifies the Anypoint Platform environment to use: by default, the environment defined as the default in Anypoint Platform. |
||
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
Operations
Create Notification
<cloudhub:create-notification>
Creates a new Notification
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Domain |
String |
Name of the application to bind the new notification |
x |
|
Message |
String |
Notification’s message |
#[payload] |
|
Custom Properties |
Object |
Additional properties for the notification |
||
Priority |
Enumeration, one of:
|
Priority of the notification to create. |
||
Transaction Id |
String |
Transaction ID for the Notification |
||
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
Get Application
<cloudhub:get-application>
Retrieves a single application by name.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Domain |
String |
The name of the application |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configure if repeatable streams should be used and their behavior |
||
Target Variable |
String |
The name of a variable on which the operation’s output will be placed |
||
Target Value |
String |
An expression that will be evaluated against the operation’s output and the outcome of that expression will be stored in the target variable |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
List Applications
<cloudhub:list-applications>
Retrieves all applications in the specified environment.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Retrieve Log Levels |
Boolean |
Whether should retrieve Application log levels |
true |
|
Retrieve Tracking Settings |
Boolean |
Whether should retrieve Application tracking settings |
true |
|
Retrieve IP Addresses |
Boolean |
Whether should retrieve Application IP Addresses |
true |
|
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configure if repeatable streams should be used and their behavior |
||
Retrieve Statistics |
Boolean |
Whether should retrieve Application statistics |
false |
|
Period |
Number |
Time of statistics to gather |
1 |
|
Period Time Unit |
Enumeration, one of:
|
Time Unit of the period |
HOURS |
|
Target Variable |
String |
The name of a variable on which the operation’s output will be placed |
||
Target Value |
String |
An expression that will be evaluated against the operation’s output and the outcome of that expression will be stored in the target variable |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
List Notifications
<cloudhub:list-notifications>
Lists all the available notifications for a giver domain.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Domain |
String |
Name of the application to gather notifications from |
x |
|
Limit |
Number |
Number of notifications to retrieve. -1 means everything available. |
-1 |
|
Page Size |
Number |
Size of the page to retrieve per iteration. This only should be changed for performance purposes. |
25 |
|
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Streaming Strategy |
|
Configure if repeatable streams should be used and their behavior |
||
Status |
Enumeration, one of:
|
Filters the notifications by status. Read, Unread or All. |
UNREAD |
|
Search |
String |
If specified, only return notifications where the message contains this string. (Case Insensitive) |
||
Target Variable |
String |
The name of a variable on which the operation’s output will be placed |
||
Target Value |
String |
An expression that will be evaluated against the operation’s output and the outcome of that expression will be stored in the target variable |
#[payload] |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
Output
Type |
Array of Notification |
Mark Notification
<cloudhub:mark-notification>
Marks a notification as Read or Unread.
Parameters
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
The name of the configuration to use. |
x |
|
Notification Id |
String |
ID of the notification |
x |
|
Mark As |
Enumeration, one of:
|
Action to do. Mark as Read or Unread |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration to use to execute this component. |
x |
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
A retry strategy in case of connectivity errors |
Types
Reconnection
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails Deployment |
Boolean |
When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment will fail if the test doesn’t pass after exhausting the associated reconnection strategy |
||
Reconnection Strategy |
The reconnection strategy to use |
Reconnect
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to reconnect (in milliseconds). |
||
Count |
Number |
The number of reconnection attempts to make. |
||
blocking |
Boolean |
If false, the reconnection strategy runs in a separate, non-blocking thread. |
true |
Reconnect Forever
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often in milliseconds to reconnect. |
||
blocking |
Boolean |
If false, the reconnection strategy runs in a separate, non-blocking thread. |
true |
Expiration Policy
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration |
||
Time Unit |
Enumeration, one of:
|
A time unit that qualifies the maxIdleTime attribute |
Error Mapping
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Source |
Enumeration, one of:
|
Source. |
||
Target |
String |
Target. |
x |
Repeatable In Memory Stream
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
This is the amount of memory that will be allocated in order to consume the stream and provide random access to it. If the stream contains more data than can be fit into this buffer, then the buffer expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize. |
||
Buffer Size Increment |
Number |
This is by how much will be buffer size expands if it exceeds its initial size. Setting a value of zero or lower will mean that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error will be raised when the buffer gets full. |
||
Max Buffer Size |
Number |
This is the maximum amount of memory that will be used. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error will be raised. A value lower or equal to zero means no limit. |
||
Buffer Unit |
Enumeration, one of:
|
The unit in which all these attributes are expressed |
Repeatable File Store Stream
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max In Memory Size |
Number |
Defines the maximum memory that the stream should use to keep data in memory. If more than that is consumed then it will start to buffer the content on disk. |
||
Buffer Unit |
Enumeration, one of:
|
The unit in which maxInMemorySize is expressed |
Notification
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Id |
String |
x |
||
Domain |
String |
x |
||
Message |
String |
|||
Priority |
String |
|||
Properties |
Any |
|||
Read |
Boolean |
x |
||
Read On |
DateTime |
|||
Created At |
DateTime |
x |
||
Href |
String |
x |
Repeatable In Memory Iterable
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
This is the amount of instances to be initially allowed to be kept in memory in order to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then it expands according to the bufferSizeIncrement attribute, with an upper limit of maxInMemorySize. Default value is 100 instances. |
||
Buffer Size Increment |
Number |
This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error will be raised when the buffer gets full. Default value is 100 instances. |
||
Max Buffer Size |
Number |
This is the maximum amount of memory that will be used. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error will be raised. A value lower or equal to zero means no limit. |
Repeatable File Store Iterable
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max In Memory Size |
Number |
This is the maximum amount of instances that will be kept in memory. If more than that is required, then it will start to buffer the content on disk. |
||
Buffer Unit |
Enumeration, one of:
|
The unit in which maxInMemorySize is expressed |