get_environment¶

MainframeModernization.Client.get_environment(**kwargs)¶

Describes a specific runtime environment.

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',
    'pendingMaintenance': {
        'engineVersion': 'string',
        'schedule': {
            'endTime': datetime(2015, 1, 1),
            'startTime': datetime(2015, 1, 1)
        }
    },
    'preferredMaintenanceWindow': 'string',
    'publiclyAccessible': True|False,
    'securityGroupIds': [
        'string',
    ],
    'status': 'Creating'|'Available'|'Deleting'|'Failed'|'Updating',
    '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 maxiumum 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.
- 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.
- 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) --
  Configures the maintenance window you want for the runtime environment. If you do not provide a value, a random system-generated value will be assigned.
- 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.
- 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.ValidationException
MainframeModernization.Client.exceptions.InternalServerException
MainframeModernization.Client.exceptions.AccessDeniedException
MainframeModernization.Client.exceptions.ThrottlingException
MainframeModernization.Client.exceptions.ResourceNotFoundException

Table Of Contents

get_environment¶