get_servers

SMS.Client.get_servers(**kwargs)

Describes the servers in your server catalog.

Before you can describe your servers, you must import them using ImportServerCatalog.

See also: AWS API Documentation

Request Syntax

response = client.get_servers(
    nextToken='string',
    maxResults=123,
    vmServerAddressList=[
        {
            'vmManagerId': 'string',
            'vmId': 'string'
        },
    ]
)

Parameters

• nextToken (string) -- The token for the next set of results.
• maxResults (integer) -- The maximum number of results to return in a single call. The default value is 50. To retrieve the remaining results, make another call with the returned NextToken value.
• vmServerAddressList (list) --

  The server addresses.

  • (dict) --

    Represents a VM server location.

    • vmManagerId (string) --

      The ID of the VM manager.

    • vmId (string) --

      The ID of the VM.

Return type

dict

Returns

Response Syntax

{
    'lastModifiedOn': datetime(2015, 1, 1),
    'serverCatalogStatus': 'NOT_IMPORTED'|'IMPORTING'|'AVAILABLE'|'DELETED'|'EXPIRED',
    '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
        },
    ],
    'nextToken': 'string'
}

Response Structure

• (dict) --

  • lastModifiedOn (datetime) --

    The time when the server was last modified.

  • serverCatalogStatus (string) --

    The status of the server catalog.

  • serverList (list) --

    Information about the servers.

    • (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.

  • nextToken (string) --

    The token required to retrieve the next set of results. This value is null when there are no more results to return.

Exceptions

• SMS.Client.exceptions.UnauthorizedOperationException
• SMS.Client.exceptions.InvalidParameterException
• SMS.Client.exceptions.MissingRequiredParameterException
• SMS.Client.exceptions.InternalError