MainframeModernization / Client / get_environment

get_environment

MainframeModernization.Client.get_environment(**kwargs)

Describes a specific runtime environment.

See also: AWS API Documentation

Request Syntax

response = client.get_environment(
    environmentId='string'
)

Parameters:

environmentId (string) –

[REQUIRED]

The unique identifier of the runtime environment.

Return type:

dict

Returns:

Response Syntax

{
    'actualCapacity': 123,
    'creationTime': datetime(2015, 1, 1),
    'description': 'string',
    'engineType': 'microfocus'|'bluage',
    'engineVersion': 'string',
    'environmentArn': 'string',
    'environmentId': 'string',
    'highAvailabilityConfig': {
        'desiredCapacity': 123
    },
    'instanceType': 'string',
    'kmsKeyId': 'string',
    'loadBalancerArn': 'string',
    'name': 'string',
    'networkType': 'ipv4'|'dual',
    'pendingMaintenance': {
        'engineVersion': 'string',
        'schedule': {
            'endTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1)
        }
    },
    'preferredMaintenanceWindow': 'string',
    'publiclyAccessible': True|False,
    'securityGroupIds': [
        'string',
    ],
    'status': 'Creating'|'Available'|'Updating'|'Deleting'|'Failed'|'UnHealthy',
    'statusReason': 'string',
    'storageConfigurations': [
        {
            'efs': {
                'fileSystemId': 'string',
                'mountPoint': 'string'
            },
            'fsx': {
                'fileSystemId': 'string',
                'mountPoint': 'string'
            }
        },
    ],
    'subnetIds': [
        'string',
    ],
    'tags': {
        'string': 'string'
    },
    'vpcId': 'string'
}

Response Structure

• (dict) –

  • actualCapacity (integer) –

    The number of instances included in the runtime environment. A standalone runtime environment has a maximum of one instance. Currently, a high availability runtime environment has a maximum of two instances.

  • creationTime (datetime) –

    The timestamp when the runtime environment was created.

  • description (string) –

    The description of the runtime environment.

  • 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 the runtime environment.

  • environmentId (string) –

    The unique identifier of the runtime environment.

  • highAvailabilityConfig (dict) –

    The desired capacity of the high availability configuration for the runtime environment.

    • desiredCapacity (integer) –

      The number of instances in a high availability configuration. The minimum possible value is 1 and the maximum is 100.

  • instanceType (string) –

    The type of instance underlying the runtime environment.

  • kmsKeyId (string) –

    The identifier of a customer managed key.

  • loadBalancerArn (string) –

    The Amazon Resource Name (ARN) for the load balancer used with the runtime environment.

  • name (string) –

    The name of the runtime environment. Must be unique within the account.

  • networkType (string) –

    The network type supported by the runtime environment.

  • pendingMaintenance (dict) –

    Indicates the pending maintenance scheduled on this environment.

    • engineVersion (string) –

      The specific runtime engine that the maintenance schedule applies to.

    • schedule (dict) –

      The maintenance schedule for the runtime engine version.

      • endTime (datetime) –

        The time the scheduled maintenance is to end.

      • startTime (datetime) –

        The time the scheduled maintenance is to start.

  • preferredMaintenanceWindow (string) –

    The maintenance window for the runtime environment. If you don’t provide a value for the maintenance window, the service assigns a random value.

  • publiclyAccessible (boolean) –

    Whether applications running in this runtime environment are publicly accessible.

  • securityGroupIds (list) –

    The unique identifiers of the security groups assigned to this runtime environment.

    • (string) –

  • status (string) –

    The status of the runtime environment. If the Amazon Web Services Mainframe Modernization environment is missing a connection to the customer owned dependent resource, the status will be Unhealthy.

  • statusReason (string) –

    The reason for the reported status.

  • storageConfigurations (list) –

    The storage configurations defined for the runtime environment.

    • (dict) –

      Defines the storage configuration for a runtime environment.

      Note

      This is a Tagged Union structure. Only one of the following top level keys will be set: efs, fsx. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

      'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
      

      • efs (dict) –

        Defines the storage configuration for an Amazon EFS file system.

        • fileSystemId (string) –

          The file system identifier.

        • mountPoint (string) –

          The mount point for the file system.

      • fsx (dict) –

        Defines the storage configuration for an Amazon FSx file system.

        • fileSystemId (string) –

          The file system identifier.

        • mountPoint (string) –

          The mount point for the file system.

  • subnetIds (list) –

    The unique identifiers of the subnets assigned to this runtime environment.

    • (string) –

  • tags (dict) –

    The tags defined for this runtime environment.

    • (string) –

      • (string) –

  • vpcId (string) –

    The unique identifier for the VPC used with this runtime environment.

Exceptions

• MainframeModernization.Client.exceptions.ResourceNotFoundException

• MainframeModernization.Client.exceptions.ThrottlingException

• MainframeModernization.Client.exceptions.AccessDeniedException

• MainframeModernization.Client.exceptions.ValidationException

• MainframeModernization.Client.exceptions.InternalServerException