AWS Systems Manager for SAP

2024/08/19 - AWS Systems Manager for SAP - 3 updated api methods

Changes  Add new attributes to the outputs of GetApplication and GetDatabase APIs.

GetApplication (updated) Link ¶
Changes (response)
{'Application': {'AssociatedApplicationArns': ['string']}}

Gets an application registered with AWS Systems Manager for SAP. It also returns the components of the application.

See also: AWS API Documentation

Request Syntax

client.get_application(
    ApplicationId='string',
    ApplicationArn='string',
    AppRegistryArn='string'
)
type ApplicationId

string

param ApplicationId

The ID of the application.

type ApplicationArn

string

param ApplicationArn

The Amazon Resource Name (ARN) of the application.

type AppRegistryArn

string

param AppRegistryArn

The Amazon Resource Name (ARN) of the application registry.

rtype

dict

returns

Response Syntax

{
    'Application': {
        'Id': 'string',
        'Type': 'HANA'|'SAP_ABAP',
        'Arn': 'string',
        'AppRegistryArn': 'string',
        'Status': 'ACTIVATED'|'STARTING'|'STOPPED'|'STOPPING'|'FAILED'|'REGISTERING'|'DELETING'|'UNKNOWN',
        'DiscoveryStatus': 'SUCCESS'|'REGISTRATION_FAILED'|'REFRESH_FAILED'|'REGISTERING'|'DELETING',
        'Components': [
            'string',
        ],
        'LastUpdated': datetime(2015, 1, 1),
        'StatusMessage': 'string',
        'AssociatedApplicationArns': [
            'string',
        ]
    },
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Application (dict) --

      Returns all of the metadata of an application registered with AWS Systems Manager for SAP.

      • Id (string) --

        The ID of the application.

      • Type (string) --

        The type of the application.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the application.

      • AppRegistryArn (string) --

        The Amazon Resource Name (ARN) of the Application Registry.

      • Status (string) --

        The status of the application.

      • DiscoveryStatus (string) --

        The latest discovery result for the application.

      • Components (list) --

        The components of the application.

        • (string) --

      • LastUpdated (datetime) --

        The time at which the application was last updated.

      • StatusMessage (string) --

        The status message.

      • AssociatedApplicationArns (list) --

        The Amazon Resource Names of the associated AWS Systems Manager for SAP applications.

        • (string) --

    • Tags (dict) --

      The tags of a registered application.

      • (string) --

        • (string) --

GetDatabase (updated) Link ¶
Changes (response)
{'Database': {'ConnectedComponentArns': ['string']}}

Gets the SAP HANA database of an application registered with AWS Systems Manager for SAP.

See also: AWS API Documentation

Request Syntax

client.get_database(
    ApplicationId='string',
    ComponentId='string',
    DatabaseId='string',
    DatabaseArn='string'
)
type ApplicationId

string

param ApplicationId

The ID of the application.

type ComponentId

string

param ComponentId

The ID of the component.

type DatabaseId

string

param DatabaseId

The ID of the database.

type DatabaseArn

string

param DatabaseArn

The Amazon Resource Name (ARN) of the database.

rtype

dict

returns

Response Syntax

{
    'Database': {
        'ApplicationId': 'string',
        'ComponentId': 'string',
        'Credentials': [
            {
                'DatabaseName': 'string',
                'CredentialType': 'ADMIN',
                'SecretId': 'string'
            },
        ],
        'DatabaseId': 'string',
        'DatabaseName': 'string',
        'DatabaseType': 'SYSTEM'|'TENANT',
        'Arn': 'string',
        'Status': 'RUNNING'|'STARTING'|'STOPPED'|'WARNING'|'UNKNOWN'|'ERROR',
        'PrimaryHost': 'string',
        'SQLPort': 123,
        'LastUpdated': datetime(2015, 1, 1),
        'ConnectedComponentArns': [
            'string',
        ]
    },
    'Tags': {
        'string': 'string'
    }
}

Response Structure

  • (dict) --

    • Database (dict) --

      The SAP HANA database of an application registered with AWS Systems Manager for SAP.

      • ApplicationId (string) --

        The ID of the application.

      • ComponentId (string) --

        The ID of the component.

      • Credentials (list) --

        The credentials of the database.

        • (dict) --

          The credentials of your SAP application.

          • DatabaseName (string) --

            The name of the SAP HANA database.

          • CredentialType (string) --

            The type of the application credentials.

          • SecretId (string) --

            The secret ID created in AWS Secrets Manager to store the credentials of the SAP application.

      • DatabaseId (string) --

        The ID of the SAP HANA database.

      • DatabaseName (string) --

        The name of the database.

      • DatabaseType (string) --

        The type of the database.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the database.

      • Status (string) --

        The status of the database.

      • PrimaryHost (string) --

        The primary host of the database.

      • SQLPort (integer) --

        The SQL port of the database.

      • LastUpdated (datetime) --

        The time at which the database was last updated.

      • ConnectedComponentArns (list) --

        The Amazon Resource Names of the connected AWS Systems Manager for SAP components.

        • (string) --

    • Tags (dict) --

      The tags of a database.

      • (string) --

        • (string) --

RegisterApplication (updated) Link ¶
Changes (response)
{'Application': {'AssociatedApplicationArns': ['string']}}

Register an SAP application with AWS Systems Manager for SAP. You must meet the following requirements before registering.

The SAP application you want to register with AWS Systems Manager for SAP is running on Amazon EC2.

AWS Systems Manager Agent must be setup on an Amazon EC2 instance along with the required IAM permissions.

Amazon EC2 instance(s) must have access to the secrets created in AWS Secrets Manager to manage SAP applications and components.

See also: AWS API Documentation

Request Syntax

client.register_application(
    ApplicationId='string',
    ApplicationType='HANA'|'SAP_ABAP',
    Instances=[
        'string',
    ],
    SapInstanceNumber='string',
    Sid='string',
    Tags={
        'string': 'string'
    },
    Credentials=[
        {
            'DatabaseName': 'string',
            'CredentialType': 'ADMIN',
            'SecretId': 'string'
        },
    ],
    DatabaseArn='string'
)
type ApplicationId

string

param ApplicationId

[REQUIRED]

The ID of the application.

type ApplicationType

string

param ApplicationType

[REQUIRED]

The type of the application.

type Instances

list

param Instances

[REQUIRED]

The Amazon EC2 instances on which your SAP application is running.

  • (string) --

type SapInstanceNumber

string

param SapInstanceNumber

The SAP instance number of the application.

type Sid

string

param Sid

The System ID of the application.

type Tags

dict

param Tags

The tags to be attached to the SAP application.

  • (string) --

    • (string) --

type Credentials

list

param Credentials

The credentials of the SAP application.

  • (dict) --

    The credentials of your SAP application.

    • DatabaseName (string) -- [REQUIRED]

      The name of the SAP HANA database.

    • CredentialType (string) -- [REQUIRED]

      The type of the application credentials.

    • SecretId (string) -- [REQUIRED]

      The secret ID created in AWS Secrets Manager to store the credentials of the SAP application.

type DatabaseArn

string

param DatabaseArn

The Amazon Resource Name of the SAP HANA database.

rtype

dict

returns

Response Syntax

{
    'Application': {
        'Id': 'string',
        'Type': 'HANA'|'SAP_ABAP',
        'Arn': 'string',
        'AppRegistryArn': 'string',
        'Status': 'ACTIVATED'|'STARTING'|'STOPPED'|'STOPPING'|'FAILED'|'REGISTERING'|'DELETING'|'UNKNOWN',
        'DiscoveryStatus': 'SUCCESS'|'REGISTRATION_FAILED'|'REFRESH_FAILED'|'REGISTERING'|'DELETING',
        'Components': [
            'string',
        ],
        'LastUpdated': datetime(2015, 1, 1),
        'StatusMessage': 'string',
        'AssociatedApplicationArns': [
            'string',
        ]
    },
    'OperationId': 'string'
}

Response Structure

  • (dict) --

    • Application (dict) --

      The application registered with AWS Systems Manager for SAP.

      • Id (string) --

        The ID of the application.

      • Type (string) --

        The type of the application.

      • Arn (string) --

        The Amazon Resource Name (ARN) of the application.

      • AppRegistryArn (string) --

        The Amazon Resource Name (ARN) of the Application Registry.

      • Status (string) --

        The status of the application.

      • DiscoveryStatus (string) --

        The latest discovery result for the application.

      • Components (list) --

        The components of the application.

        • (string) --

      • LastUpdated (datetime) --

        The time at which the application was last updated.

      • StatusMessage (string) --

        The status message.

      • AssociatedApplicationArns (list) --

        The Amazon Resource Names of the associated AWS Systems Manager for SAP applications.

        • (string) --

    • OperationId (string) --

      The ID of the operation.