Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

list_environments

list_environments(**kwargs)

Lists the runtime environments.

See also: AWS API Documentation

Request Syntax

response = client.list_environments(
    engineType='microfocus'|'bluage',
    maxResults=123,
    names=[
        'string',
    ],
    nextToken='string'
)
Parameters
  • engineType (string) -- The engine type for the runtime environment.
  • maxResults (integer) -- The maximum number of runtime environments to return.
  • names (list) --

    The names of the runtime environments. Must be unique within the account.

    • (string) --
  • nextToken (string) -- A pagination token to control the number of runtime environments displayed in the list.
Return type

dict

Returns

Response Syntax

{
    'environments': [
        {
            'creationTime': datetime(2015, 1, 1),
            'engineType': 'microfocus'|'bluage',
            'engineVersion': 'string',
            'environmentArn': 'string',
            'environmentId': 'string',
            'instanceType': 'string',
            'name': 'string',
            'status': 'Creating'|'Available'|'Deleting'|'Failed'|'Updating'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • environments (list) --

      Returns a list of summary details for all the runtime environments in your account.

      • (dict) --

        Contains a subset of the possible runtime environment attributes. Used in the environment list.

        • creationTime (datetime) --

          The timestamp when the runtime environment was created.

        • engineType (string) --

          The target platform for the runtime environment.

        • engineVersion (string) --

          The version of the runtime engine.

        • environmentArn (string) --

          The Amazon Resource Name (ARN) of a particular runtime environment.

        • environmentId (string) --

          The unique identifier of a particular runtime environment.

        • instanceType (string) --

          The instance type of the runtime environment.

        • name (string) --

          The name of the runtime environment.

        • status (string) --

          The status of the runtime environment

    • nextToken (string) --

      A pagination token that's returned when the response doesn't contain all the runtime environments.

Exceptions

  • MainframeModernization.Client.exceptions.ValidationException
  • MainframeModernization.Client.exceptions.InternalServerException
  • MainframeModernization.Client.exceptions.AccessDeniedException
  • MainframeModernization.Client.exceptions.ThrottlingException