Amazon RDS - Create session

Declaration

Description:

Creates a unique session which can be used to associate subsequent Amazon RDS steps. This provides a single task the ability to execute numerous RDS operations simultaneously.

IMPORTANT: RDS activities are performed using Amazon's Relational Database Service engine, therefore, administering Amazon RDS through requires a valid Access Key ID and Secret Access Key.

Practical Usage

Ideally used to create a session to be used in correlation with other RDS activities. To end a session, use the End session activity.

Parameters

Credentials

Property	Type	Required	Default	Markup	Description
Access Key	Text	Yes	(Empty)	ACCESSKEY="MyAccessKey"	Specifies the alphanumeric text string that uniquely identifies a user who owns an Amazon RDS account. This along with a Secret Access Key forms a secure information set that RDS uses to confirm a valid user's identity.
Secret Access Key	Text	Yes	(Empty)	SECRETKEY="SecretKey"	Serves the role as password to access Amazon RDS. This along with an associated Access Key forms a secure information set that Amazon Web Service uses to confirm a valid user's identity.
Session	Text	Yes	RDSession1	SESSION="mySession"	Specifies the session name to create for this activity. Subsequent S3 activities can be linked to this session allowing several S3 operations (that may contain multiple activities) to be performed within a single task. The default session name is 'RDSSession1'.
User Agent	Text	Yes	AutoMate	USERAGENT="AutoMate"	The User-Agent request-header field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. The default value is AutoMate.
Service URL	Text	No	(Empty)	SERVICEURL= "https://eu-west-1.ec2.amazonaws.com"	The Service URL used to make requests to the RDS service. The Service URL provides the service endpoint.
Maximum retry on error	Number	No	(Empty)	MAXERRORRETRY="4"	Indicates how many times the Amazon RDS Engine should retry the request before generating an error.
Proxy Host	Text	No	(Empty)	PROXYHOST="proxy.host.com"	The hostname (server.domain.com) or IP address (xxx.xxx.xxx.xxx) of the proxy server.
Proxy Port	Number	No	(Empty)	PROXYPORT="1028"	The port that should be used to connect to the proxy server.
Signature Method	Text	No	(Empty)	SIGNMETHOD="HmacSHA256"	The Signature Method for signing the request.
Signature Version	Number	No	(Empty)	SIGNVERSION="2"	The Signature Version for signing the request. The version refers to the particular algorithm for signing the request.
Session Name	Text	Yes	RDSession1	SESSION="mySession"	Specifies the session name to create for this activity. Subsequent S3 activities can be linked to this session allowing several S3 operations (that may contain multiple activities) to be performed within a single task. The default session name is RDSSession1.

Advanced

Property	Type	Required	Default	Markup	Description
User agent	Text	Yes	AutoMate	USERAGENT="AutoMate"	The user agent request header field contains information about the user agent originating the request. This is for statistical purposes, the tracing of protocol violations, and automated recognition of user agents for the sake of tailoring responses to avoid particular user agent limitations. The default value is AutoMate.
Service URL	Text	No	(Empty)	SERVICEURL= "https://eu-west-1.ec2.amazonaws.com"	The Service URL used to make requests to the RDS service. The Service URL provides the service endpoint.
Maximum retries on error	Number	No	(Empty)	MAXERRORRETRY="4"	Indicates how many times the Amazon RDS Engine should retry the request before generating an error.
Proxy host	Text	No	(Empty)	PROXYHOST="proxy.host.com"	The hostname (server.domain.com) or IP address (xxx.xxx.xxx.xxx) of the proxy server.
Proxy port	Number	No	(Empty)	PROXYPORT="1028"	The port that should be used to connect to the proxy server.
Signature method	Text	No	(Empty)	SIGNMETHOD="HmacSHA256"	The Signature Method for signing the request.
Signature version	Number	No	(Empty)	SIGNVERSION="2"	The Signature Version for signing the request. The version refers to the particular algorithm for signing the request.

Description

Error Causes

On Error

RDS Endpoints and Regions

This table contains a complete list of Amazon Relational Database Service endpoints, along with their corresponding regions and supported protocols.

Endpoint	Region	Protocol
rds.us-east-1.amazonaws.com	US East (Northern Virginia) Region	HTTP and HTTPS
rds.us-west-2.amazonaws.com	US West (Oregon) Region	HTTP and HTTPS
rds.us-west-1.amazonaws.com	US West (Northern California) Region	HTTP and HTTPS
rds.eu-west-1.amazonaws.com	EU (Ireland) Region	HTTP and HTTPS
rds.ap-southeast-1.amazonaws.com	Asia Pacific (Singapore) Region	HTTP and HTTPS
rds.ap-southeast-2.amazonaws.com	Asia Pacific (Sydney) Region	HTTP and HTTPS
rds.ap-northeast-1.amazonaws.com	Asia Pacific (Tokyo) Region	HTTP and HTTPS
rds.sa-east-1.amazonaws.com	South America (Sao Paulo) Region	HTTP and HTTPS

Example

NOTE: The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.

Description: This session-based task demonstrate's some of RDS activities. It creates a database instance and performs some modifications onto the new instance. Thereafter, it creates a snapshot of the newly modified instance then reboots. The last step ends the session.

This help file is for the Advanced Workflow Engine v10. For other versions, please refer to http://help.globalscape.com/help/index.html

(If the Index and Contents are hidden, click the icon in the top left corner.)

If this help topic did not help you, try searching the Knowledgebase.
For the most up-to-date information, to view version history, updates, and activation instructions, visit the Support Center at http://www.globalscape.com/support-home.
For information about Globalscape, visit www.globalscape.com.

Last modified: 28-Jun-19 at 14:01:32