finspace / Client / get_kx_environment

get_kx_environment#

finspace.Client.get_kx_environment(**kwargs)#

Retrieves all the information for the specified kdb environment.

Request Syntax

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

Parameters:

environmentId (string) –

[REQUIRED]

A unique identifier for the kdb environment.

Return type:

dict

Returns:

Response Syntax

{
    'name': 'string',
    'environmentId': 'string',
    'awsAccountId': 'string',
    'status': 'CREATE_REQUESTED'|'CREATING'|'CREATED'|'DELETE_REQUESTED'|'DELETING'|'DELETED'|'FAILED_CREATION'|'RETRY_DELETION'|'FAILED_DELETION'|'UPDATE_NETWORK_REQUESTED'|'UPDATING_NETWORK'|'FAILED_UPDATING_NETWORK'|'SUSPENDED',
    'tgwStatus': 'NONE'|'UPDATE_REQUESTED'|'UPDATING'|'FAILED_UPDATE'|'SUCCESSFULLY_UPDATED',
    'dnsStatus': 'NONE'|'UPDATE_REQUESTED'|'UPDATING'|'FAILED_UPDATE'|'SUCCESSFULLY_UPDATED',
    'errorMessage': 'string',
    'description': 'string',
    'environmentArn': 'string',
    'kmsKeyId': 'string',
    'dedicatedServiceAccountId': 'string',
    'transitGatewayConfiguration': {
        'transitGatewayID': 'string',
        'routableCIDRSpace': 'string'
    },
    'customDNSConfiguration': [
        {
            'customDNSServerName': 'string',
            'customDNSServerIP': 'string'
        },
    ],
    'creationTimestamp': datetime(2015, 1, 1),
    'updateTimestamp': datetime(2015, 1, 1),
    'availabilityZoneIds': [
        'string',
    ],
    'certificateAuthorityArn': 'string'
}

Response Structure

(dict) –
- name (string) –
  
  The name of the kdb environment.
- environmentId (string) –
  
  A unique identifier for the kdb environment.
- awsAccountId (string) –
  
  The unique identifier of the AWS account that is used to create the kdb environment.
- status (string) –
  
  The status of the kdb environment.
- tgwStatus (string) –
  
  The status of the network configuration.
- dnsStatus (string) –
  
  The status of DNS configuration.
- errorMessage (string) –
  
  Specifies the error message that appears if a flow fails.
- description (string) –
  
  A description for the kdb environment.
- environmentArn (string) –
  
  The ARN identifier of the environment.
- kmsKeyId (string) –
  
  The KMS key ID to encrypt your data in the FinSpace environment.
- dedicatedServiceAccountId (string) –
  
  A unique identifier for the AWS environment infrastructure account.
- transitGatewayConfiguration (dict) –
  
  The structure of the transit gateway and network configuration that is used to connect the kdb environment to an internal network.
  - transitGatewayID (string) –
    
    The identifier of the transit gateway created by the customer to connect outbound traffics from kdb network to your internal network.
  - routableCIDRSpace (string) –
    
    The routing CIDR on behalf of kdb environment. It could be any “/26 range in the 100.64.0.0 CIDR space. After providing, it will be added to the customer’s transit gateway routing table so that the traffics could be routed to kdb network.
- customDNSConfiguration (list) –
  
  A list of DNS server name and server IP. This is used to set up Route-53 outbound resolvers.
  - (dict) –
    
    A list of DNS server name and server IP. This is used to set up Route-53 outbound resolvers.
    - customDNSServerName (string) –
      
      The name of the DNS server.
    - customDNSServerIP (string) –
      
      The IP address of the DNS server.
- creationTimestamp (datetime) –
  
  The timestamp at which the kdb environment was created in FinSpace.
- updateTimestamp (datetime) –
  
  The timestamp at which the kdb environment was updated.
- availabilityZoneIds (list) –
  
  The identifier of the availability zones where subnets for the environment are created.
  - (string) –
- certificateAuthorityArn (string) –
  
  The Amazon Resource Name (ARN) of the certificate authority of the kdb environment.

Exceptions

finspace.Client.exceptions.ResourceNotFoundException
finspace.Client.exceptions.InternalServerException
finspace.Client.exceptions.ValidationException
finspace.Client.exceptions.AccessDeniedException