2024/05/09 - AWS Systems Manager for SAP - 3 new api methods
Changes Added support for application-aware start/stop of SAP applications running on EC2 instances, with SSM for SAP
Request is an operation which starts an application.
Parameter ApplicationId is required.
See also: AWS API Documentation
Request Syntax
client.start_application( ApplicationId='string' )
string
[REQUIRED]
The ID of the application.
dict
Response Syntax
{ 'OperationId': 'string' }
Response Structure
(dict) --
OperationId (string) --
The ID of the operation.
Request is an operation to stop an application.
Parameter ApplicationId is required. Parameters StopConnectedEntity and IncludeEc2InstanceShutdown are optional.
See also: AWS API Documentation
Request Syntax
client.stop_application( ApplicationId='string', StopConnectedEntity='DBMS', IncludeEc2InstanceShutdown=True|False )
string
[REQUIRED]
The ID of the application.
string
Specify the ConnectedEntityType . Accepted type is DBMS .
If this parameter is included, the connected DBMS (Database Management System) will be stopped.
boolean
Boolean. If included and if set to True , the StopApplication operation will shut down the associated Amazon EC2 instance in addition to the application.
dict
Response Syntax
{ 'OperationId': 'string' }
Response Structure
(dict) --
OperationId (string) --
The ID of the operation.
Returns a list of operations events.
Available parameters include OperationID , as well as optional parameters MaxResults , NextToken , and Filters .
See also: AWS API Documentation
Request Syntax
client.list_operation_events( OperationId='string', MaxResults=123, NextToken='string', Filters=[ { 'Name': 'string', 'Value': 'string', 'Operator': 'Equals'|'GreaterThanOrEquals'|'LessThanOrEquals' }, ] )
string
[REQUIRED]
The ID of the operation.
integer
The maximum number of results to return with a single call. To retrieve the remaining results, make another call with the returned nextToken value.
If you do not specify a value for MaxResults , the request returns 50 items per page by default.
string
The token to use to retrieve the next page of results. This value is null when there are no more results to return.
list
Optionally specify filters to narrow the returned operation event items.
Valid filter names include status , resourceID , and resourceType . The valid operator for all three filters is Equals .
(dict) --
A specific result obtained by specifying the name, value, and operator.
Name (string) -- [REQUIRED]
The name of the filter. Filter names are case-sensitive.
Value (string) -- [REQUIRED]
The filter values. Filter values are case-sensitive. If you specify multiple values for a filter, the values are joined with an OR, and the request returns all results that match any of the specified values
Operator (string) -- [REQUIRED]
The operator for the filter.
dict
Response Syntax
{ 'OperationEvents': [ { 'Description': 'string', 'Resource': { 'ResourceArn': 'string', 'ResourceType': 'string' }, 'Status': 'IN_PROGRESS'|'COMPLETED'|'FAILED', 'StatusMessage': 'string', 'Timestamp': datetime(2015, 1, 1) }, ], 'NextToken': 'string' }
Response Structure
(dict) --
OperationEvents (list) --
A returned list of operation events that meet the filter criteria.
(dict) --
An operation event returns details for an operation, including key milestones which can be used to monitor and track operations in progress.
Operation events contain:
Description string
Resource, including its ARN and type
Status
StatusMessage string
TimeStamp
Operation event examples include StartApplication or StopApplication.
Description (string) --
A description of the operation event. For example, "Stop the EC2 instance i-abcdefgh987654321".
Resource (dict) --
The resource involved in the operations event.
Contains ResourceArn ARN and ResourceType .
ResourceArn (string) --
The Amazon Resource Name (ARN) of the source resource.
Example of ResourceArn : " arn:aws:ec2:us-east-1:111111111111:instance/i-abcdefgh987654321 "
ResourceType (string) --
The resource type.
Example of ResourceType : " AWS::SystemsManagerSAP::Component " or " AWS::EC2::Instance ".
Status (string) --
The status of the operation event. The possible statuses are: IN_PROGRESS , COMPLETED , and FAILED .
StatusMessage (string) --
The status message relating to a specific operation event.
Timestamp (datetime) --
The timestamp of the specified operation event.
NextToken (string) --
The token to use to retrieve the next page of results. This value is null when there are no more results to return.