finspace / Client / get_kx_environment

get_kx_environment#

finspace.Client.get_kx_environment(**kwargs)#

Retrieves all the information for the specified kdb environment.

See also: AWS API Documentation

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