SMS / Client / get_app

get_app#

SMS.Client.get_app(**kwargs)#

Retrieve information about the specified application.

See also: AWS API Documentation

Request Syntax

response = client.get_app(
    appId='string'
)
Parameters:

appId (string) – The ID of the application.

Return type:

dict

Returns:

Response Syntax

{
    'appSummary': {
        'appId': 'string',
        'importedAppId': 'string',
        'name': 'string',
        'description': 'string',
        'status': 'CREATING'|'ACTIVE'|'UPDATING'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'statusMessage': 'string',
        'replicationConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
        'replicationStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_REPLICATION'|'VALIDATION_IN_PROGRESS'|'REPLICATION_PENDING'|'REPLICATION_IN_PROGRESS'|'REPLICATED'|'PARTIALLY_REPLICATED'|'DELTA_REPLICATION_IN_PROGRESS'|'DELTA_REPLICATED'|'DELTA_REPLICATION_FAILED'|'REPLICATION_FAILED'|'REPLICATION_STOPPING'|'REPLICATION_STOP_FAILED'|'REPLICATION_STOPPED',
        'replicationStatusMessage': 'string',
        'latestReplicationTime': datetime(2015, 1, 1),
        'launchConfigurationStatus': 'NOT_CONFIGURED'|'CONFIGURED',
        'launchStatus': 'READY_FOR_CONFIGURATION'|'CONFIGURATION_IN_PROGRESS'|'CONFIGURATION_INVALID'|'READY_FOR_LAUNCH'|'VALIDATION_IN_PROGRESS'|'LAUNCH_PENDING'|'LAUNCH_IN_PROGRESS'|'LAUNCHED'|'PARTIALLY_LAUNCHED'|'DELTA_LAUNCH_IN_PROGRESS'|'DELTA_LAUNCH_FAILED'|'LAUNCH_FAILED'|'TERMINATE_IN_PROGRESS'|'TERMINATE_FAILED'|'TERMINATED',
        'launchStatusMessage': 'string',
        'launchDetails': {
            'latestLaunchTime': datetime(2015, 1, 1),
            'stackName': 'string',
            'stackId': 'string'
        },
        'creationTime': datetime(2015, 1, 1),
        'lastModified': datetime(2015, 1, 1),
        'roleName': 'string',
        'totalServerGroups': 123,
        'totalServers': 123
    },
    'serverGroups': [
        {
            'serverGroupId': 'string',
            'name': 'string',
            'serverList': [
                {
                    'serverId': 'string',
                    'serverType': 'VIRTUAL_MACHINE',
                    'vmServer': {
                        'vmServerAddress': {
                            'vmManagerId': 'string',
                            'vmId': 'string'
                        },
                        'vmName': 'string',
                        'vmManagerName': 'string',
                        'vmManagerType': 'VSPHERE'|'SCVMM'|'HYPERV-MANAGER',
                        'vmPath': 'string'
                    },
                    'replicationJobId': 'string',
                    'replicationJobTerminated': True|False
                },
            ]
        },
    ],
    'tags': [
        {
            'key': 'string',
            'value': 'string'
        },
    ]
}

Response Structure

  • (dict) –

    • appSummary (dict) –

      Information about the application.

      • appId (string) –

        The unique ID of the application.

      • importedAppId (string) –

        The ID of the application.

      • name (string) –

        The name of the application.

      • description (string) –

        The description of the application.

      • status (string) –

        Status of the application.

      • statusMessage (string) –

        A message related to the status of the application

      • replicationConfigurationStatus (string) –

        Status of the replication configuration.

      • replicationStatus (string) –

        The replication status of the application.

      • replicationStatusMessage (string) –

        A message related to the replication status of the application.

      • latestReplicationTime (datetime) –

        The timestamp of the application’s most recent successful replication.

      • launchConfigurationStatus (string) –

        Status of the launch configuration.

      • launchStatus (string) –

        The launch status of the application.

      • launchStatusMessage (string) –

        A message related to the launch status of the application.

      • launchDetails (dict) –

        Details about the latest launch of the application.

        • latestLaunchTime (datetime) –

          The latest time that this application was launched successfully.

        • stackName (string) –

          The name of the latest stack launched for this application.

        • stackId (string) –

          The ID of the latest stack launched for this application.

      • creationTime (datetime) –

        The creation time of the application.

      • lastModified (datetime) –

        The last modified time of the application.

      • roleName (string) –

        The name of the service role in the customer’s account used by Server Migration Service.

      • totalServerGroups (integer) –

        The number of server groups present in the application.

      • totalServers (integer) –

        The number of servers present in the application.

    • serverGroups (list) –

      The server groups that belong to the application.

      • (dict) –

        Logical grouping of servers.

        • serverGroupId (string) –

          The ID of a server group.

        • name (string) –

          The name of a server group.

        • serverList (list) –

          The servers that belong to a server group.

          • (dict) –

            Represents a server.

            • serverId (string) –

              The ID of the server.

            • serverType (string) –

              The type of server.

            • vmServer (dict) –

              Information about the VM server.

              • vmServerAddress (dict) –

                The VM server location.

                • vmManagerId (string) –

                  The ID of the VM manager.

                • vmId (string) –

                  The ID of the VM.

              • vmName (string) –

                The name of the VM.

              • vmManagerName (string) –

                The name of the VM manager.

              • vmManagerType (string) –

                The type of VM management product.

              • vmPath (string) –

                The VM folder path in the vCenter Server virtual machine inventory tree.

            • replicationJobId (string) –

              The ID of the replication job.

            • replicationJobTerminated (boolean) –

              Indicates whether the replication job is deleted or failed.

    • tags (list) –

      The tags associated with the application.

      • (dict) –

        Key/value pair that can be assigned to an application.

        • key (string) –

          The tag key.

        • value (string) –

          The tag value.

Exceptions

  • SMS.Client.exceptions.UnauthorizedOperationException

  • SMS.Client.exceptions.InvalidParameterException

  • SMS.Client.exceptions.MissingRequiredParameterException

  • SMS.Client.exceptions.InternalError

  • SMS.Client.exceptions.OperationNotPermittedException