FinSpace User Environment Management service

2023/08/21 - FinSpace User Environment Management service - 5 updated api methods

Changes  Allow customers to manage outbound traffic from their Kx Environment when attaching a transit gateway by providing network acl entries. Allow the customer to choose how they want to update the databases on a cluster allowing updates to possibly be faster than usual.

GetKxEnvironment (updated) Link ¶
Changes (response)
{'transitGatewayConfiguration': {'attachmentNetworkAclConfiguration': [{'cidrBlock': 'string',
                                                                        'icmpTypeCode': {'code': 'integer',
                                                                                         'type': 'integer'},
                                                                        'portRange': {'from': 'integer',
                                                                                      'to': 'integer'},
                                                                        'protocol': 'string',
                                                                        'ruleAction': 'allow '
                                                                                      '| '
                                                                                      'deny',
                                                                        'ruleNumber': 'integer'}]}}

Retrieves all the information for the specified kdb environment.

See also: AWS API Documentation

Request Syntax

client.get_kx_environment(
    environmentId='string'
)
type environmentId:

string

param environmentId:

[REQUIRED]

A unique identifier for the kdb environment.

rtype:

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',
        'attachmentNetworkAclConfiguration': [
            {
                'ruleNumber': 123,
                'protocol': 'string',
                'ruleAction': 'allow'|'deny',
                'portRange': {
                    'from': 123,
                    'to': 123
                },
                'icmpTypeCode': {
                    'type': 123,
                    'code': 123
                },
                'cidrBlock': '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.

      • attachmentNetworkAclConfiguration (list) --

        The rules that define how you manage the outbound traffic from kdb network to your internal network.

        • (dict) --

          The network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. The entry is a set of numbered ingress and egress rules that determine whether a packet should be allowed in or out of a subnet associated with the ACL. We process the entries in the ACL according to the rule numbers, in ascending order.

          • ruleNumber (integer) --

            The rule number for the entry. For example 100. All the network ACL entries are processed in ascending order by rule number.

          • protocol (string) --

            The protocol number. A value of -1 means all the protocols.

          • ruleAction (string) --

            Indicates whether to allow or deny the traffic that matches the rule.

          • portRange (dict) --

            The range of ports the rule applies to.

            • from (integer) --

              The first port in the range.

            • to (integer) --

              The last port in the range.

          • icmpTypeCode (dict) --

            Defines the ICMP protocol that consists of the ICMP type and code.

            • type (integer) --

              The ICMP type. A value of -1 means all types.

            • code (integer) --

              The ICMP code. A value of -1 means all codes for the specified ICMP type.

          • cidrBlock (string) --

            The IPv4 network range to allow or deny, in CIDR notation. For example, 172.16.0.0/24. We modify the specified CIDR block to its canonical form. For example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

    • 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.

ListKxEnvironments (updated) Link ¶
Changes (response)
{'environments': {'transitGatewayConfiguration': {'attachmentNetworkAclConfiguration': [{'cidrBlock': 'string',
                                                                                         'icmpTypeCode': {'code': 'integer',
                                                                                                          'type': 'integer'},
                                                                                         'portRange': {'from': 'integer',
                                                                                                       'to': 'integer'},
                                                                                         'protocol': 'string',
                                                                                         'ruleAction': 'allow '
                                                                                                       '| '
                                                                                                       'deny',
                                                                                         'ruleNumber': 'integer'}]}}}

Returns a list of kdb environments created in an account.

See also: AWS API Documentation

Request Syntax

client.list_kx_environments(
    nextToken='string',
    maxResults=123
)
type nextToken:

string

param nextToken:

A token that indicates where a results page should begin.

type maxResults:

integer

param maxResults:

The maximum number of results to return in this request.

rtype:

dict

returns:

Response Syntax

{
    'environments': [
        {
            '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',
                'attachmentNetworkAclConfiguration': [
                    {
                        'ruleNumber': 123,
                        'protocol': 'string',
                        'ruleAction': 'allow'|'deny',
                        'portRange': {
                            'from': 123,
                            'to': 123
                        },
                        'icmpTypeCode': {
                            'type': 123,
                            'code': 123
                        },
                        'cidrBlock': 'string'
                    },
                ]
            },
            'customDNSConfiguration': [
                {
                    'customDNSServerName': 'string',
                    'customDNSServerIP': 'string'
                },
            ],
            'creationTimestamp': datetime(2015, 1, 1),
            'updateTimestamp': datetime(2015, 1, 1),
            'availabilityZoneIds': [
                'string',
            ],
            'certificateAuthorityArn': 'string'
        },
    ],
    'nextToken': 'string'
}

Response Structure

  • (dict) --

    • environments (list) --

      A list of environments in an account.

      • (dict) --

        The details of a kdb environment.

        • 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 in which you create the kdb environment.

        • status (string) --

          The status of the environment creation.

          • CREATE_REQUESTED – Environment creation has been requested.

          • CREATING – Environment is in the process of being created.

          • FAILED_CREATION – Environment creation has failed.

          • CREATED – Environment is successfully created and is currently active.

          • DELETE REQUESTED – Environment deletion has been requested.

          • DELETING – Environment is in the process of being deleted.

          • RETRY_DELETION – Initial environment deletion failed, system is reattempting delete.

          • DELETED – Environment has been deleted.

          • FAILED_DELETION – Environment deletion has failed.

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

        • environmentArn (string) --

          The Amazon Resource Name (ARN) of your kdb environment.

        • kmsKeyId (string) --

          The unique identifier of the KMS key.

        • dedicatedServiceAccountId (string) --

          A unique identifier for the AWS environment infrastructure account.

        • transitGatewayConfiguration (dict) --

          Specifies the transit gateway and network configuration 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.

          • attachmentNetworkAclConfiguration (list) --

            The rules that define how you manage the outbound traffic from kdb network to your internal network.

            • (dict) --

              The network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. The entry is a set of numbered ingress and egress rules that determine whether a packet should be allowed in or out of a subnet associated with the ACL. We process the entries in the ACL according to the rule numbers, in ascending order.

              • ruleNumber (integer) --

                The rule number for the entry. For example 100. All the network ACL entries are processed in ascending order by rule number.

              • protocol (string) --

                The protocol number. A value of -1 means all the protocols.

              • ruleAction (string) --

                Indicates whether to allow or deny the traffic that matches the rule.

              • portRange (dict) --

                The range of ports the rule applies to.

                • from (integer) --

                  The first port in the range.

                • to (integer) --

                  The last port in the range.

              • icmpTypeCode (dict) --

                Defines the ICMP protocol that consists of the ICMP type and code.

                • type (integer) --

                  The ICMP type. A value of -1 means all types.

                • code (integer) --

                  The ICMP code. A value of -1 means all codes for the specified ICMP type.

              • cidrBlock (string) --

                The IPv4 network range to allow or deny, in CIDR notation. For example, 172.16.0.0/24. We modify the specified CIDR block to its canonical form. For example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

        • 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. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

        • updateTimestamp (datetime) --

          The timestamp at which the kdb environment was modified in FinSpace. The value is determined as epoch time in milliseconds. For example, the value for Monday, November 1, 2021 12:00:00 PM UTC is specified as 1635768000000.

        • 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:

    • nextToken (string) --

      A token that indicates where a results page should begin.

UpdateKxClusterDatabases (updated) Link ¶
Changes (request)
{'deploymentConfiguration': {'deploymentStrategy': 'NO_RESTART | ROLLING'}}

Updates the databases mounted on a kdb cluster, which includes the changesetId and all the dbPaths to be cached. This API does not allow you to change a database name or add a database if you created a cluster without one.

Using this API you can point a cluster to a different changeset and modify a list of partitions being cached.

See also: AWS API Documentation

Request Syntax

client.update_kx_cluster_databases(
    environmentId='string',
    clusterName='string',
    clientToken='string',
    databases=[
        {
            'databaseName': 'string',
            'cacheConfigurations': [
                {
                    'cacheType': 'string',
                    'dbPaths': [
                        'string',
                    ]
                },
            ],
            'changesetId': 'string'
        },
    ],
    deploymentConfiguration={
        'deploymentStrategy': 'NO_RESTART'|'ROLLING'
    }
)
type environmentId:

string

param environmentId:

[REQUIRED]

The unique identifier of a kdb environment.

type clusterName:

string

param clusterName:

[REQUIRED]

A unique name for the cluster that you want to modify.

type clientToken:

string

param clientToken:

A token that ensures idempotency. This token expires in 10 minutes.

This field is autopopulated if not provided.

type databases:

list

param databases:

[REQUIRED]

The structure of databases mounted on the cluster.

  • (dict) --

    The configuration of data that is available for querying from this database.

    • databaseName (string) -- [REQUIRED]

      The name of the kdb database. When this parameter is specified in the structure, S3 with the whole database is included by default.

    • cacheConfigurations (list) --

      Configuration details for the disk cache used to increase performance reading from a kdb database mounted to the cluster.

      • (dict) --

        The structure of database cache configuration that is used for mapping database paths to cache types in clusters.

        • cacheType (string) -- [REQUIRED]

          The type of disk cache. This parameter is used to map the database path to cache storage. The valid values are:

          • CACHE_1000 – This type provides at least 1000 MB/s disk access throughput.

        • dbPaths (list) -- [REQUIRED]

          Specifies the portions of database that will be loaded into the cache for access.

          • (string) --

    • changesetId (string) --

      A unique identifier of the changeset that is associated with the cluster.

type deploymentConfiguration:

dict

param deploymentConfiguration:

The configuration that allows you to choose how you want to update the databases on a cluster.

  • deploymentStrategy (string) -- [REQUIRED]

    The type of deployment that you want on a cluster.

    • ROLLING – This options loads the updated database by stopping the exiting q process and starting a new q process with updated configuration.

    • NO_RESTART – This option loads the updated database on the running q process without stopping it. This option is quicker as it reduces the turn around time to update a kdb database changeset configuration on a cluster.

rtype:

dict

returns:

Response Syntax

{}

Response Structure

  • (dict) --

UpdateKxEnvironment (updated) Link ¶
Changes (response)
{'transitGatewayConfiguration': {'attachmentNetworkAclConfiguration': [{'cidrBlock': 'string',
                                                                        'icmpTypeCode': {'code': 'integer',
                                                                                         'type': 'integer'},
                                                                        'portRange': {'from': 'integer',
                                                                                      'to': 'integer'},
                                                                        'protocol': 'string',
                                                                        'ruleAction': 'allow '
                                                                                      '| '
                                                                                      'deny',
                                                                        'ruleNumber': 'integer'}]}}

Updates information for the given kdb environment.

See also: AWS API Documentation

Request Syntax

client.update_kx_environment(
    environmentId='string',
    name='string',
    description='string',
    clientToken='string'
)
type environmentId:

string

param environmentId:

[REQUIRED]

A unique identifier for the kdb environment.

type name:

string

param name:

The name of the kdb environment.

type description:

string

param description:

A description of the kdb environment.

type clientToken:

string

param clientToken:

A token that ensures idempotency. This token expires in 10 minutes.

rtype:

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',
        'attachmentNetworkAclConfiguration': [
            {
                'ruleNumber': 123,
                'protocol': 'string',
                'ruleAction': 'allow'|'deny',
                'portRange': {
                    'from': 123,
                    'to': 123
                },
                'icmpTypeCode': {
                    'type': 123,
                    'code': 123
                },
                'cidrBlock': 'string'
            },
        ]
    },
    'customDNSConfiguration': [
        {
            'customDNSServerName': 'string',
            'customDNSServerIP': 'string'
        },
    ],
    'creationTimestamp': datetime(2015, 1, 1),
    'updateTimestamp': datetime(2015, 1, 1),
    'availabilityZoneIds': [
        '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) --

      The description of the 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.

      • attachmentNetworkAclConfiguration (list) --

        The rules that define how you manage the outbound traffic from kdb network to your internal network.

        • (dict) --

          The network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. The entry is a set of numbered ingress and egress rules that determine whether a packet should be allowed in or out of a subnet associated with the ACL. We process the entries in the ACL according to the rule numbers, in ascending order.

          • ruleNumber (integer) --

            The rule number for the entry. For example 100. All the network ACL entries are processed in ascending order by rule number.

          • protocol (string) --

            The protocol number. A value of -1 means all the protocols.

          • ruleAction (string) --

            Indicates whether to allow or deny the traffic that matches the rule.

          • portRange (dict) --

            The range of ports the rule applies to.

            • from (integer) --

              The first port in the range.

            • to (integer) --

              The last port in the range.

          • icmpTypeCode (dict) --

            Defines the ICMP protocol that consists of the ICMP type and code.

            • type (integer) --

              The ICMP type. A value of -1 means all types.

            • code (integer) --

              The ICMP code. A value of -1 means all codes for the specified ICMP type.

          • cidrBlock (string) --

            The IPv4 network range to allow or deny, in CIDR notation. For example, 172.16.0.0/24. We modify the specified CIDR block to its canonical form. For example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

    • 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) --

UpdateKxEnvironmentNetwork (updated) Link ¶
Changes (both)
{'transitGatewayConfiguration': {'attachmentNetworkAclConfiguration': [{'cidrBlock': 'string',
                                                                        'icmpTypeCode': {'code': 'integer',
                                                                                         'type': 'integer'},
                                                                        'portRange': {'from': 'integer',
                                                                                      'to': 'integer'},
                                                                        'protocol': 'string',
                                                                        'ruleAction': 'allow '
                                                                                      '| '
                                                                                      'deny',
                                                                        'ruleNumber': 'integer'}]}}

Updates environment network to connect to your internal network by using a transit gateway. This API supports request to create a transit gateway attachment from FinSpace VPC to your transit gateway ID and create a custom Route-53 outbound resolvers.

Once you send a request to update a network, you cannot change it again. Network update might require termination of any clusters that are running in the existing network.

See also: AWS API Documentation

Request Syntax

client.update_kx_environment_network(
    environmentId='string',
    transitGatewayConfiguration={
        'transitGatewayID': 'string',
        'routableCIDRSpace': 'string',
        'attachmentNetworkAclConfiguration': [
            {
                'ruleNumber': 123,
                'protocol': 'string',
                'ruleAction': 'allow'|'deny',
                'portRange': {
                    'from': 123,
                    'to': 123
                },
                'icmpTypeCode': {
                    'type': 123,
                    'code': 123
                },
                'cidrBlock': 'string'
            },
        ]
    },
    customDNSConfiguration=[
        {
            'customDNSServerName': 'string',
            'customDNSServerIP': 'string'
        },
    ],
    clientToken='string'
)
type environmentId:

string

param environmentId:

[REQUIRED]

A unique identifier for the kdb environment.

type transitGatewayConfiguration:

dict

param transitGatewayConfiguration:

Specifies the transit gateway and network configuration to connect the kdb environment to an internal network.

  • transitGatewayID (string) -- [REQUIRED]

    The identifier of the transit gateway created by the customer to connect outbound traffics from kdb network to your internal network.

  • routableCIDRSpace (string) -- [REQUIRED]

    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.

  • attachmentNetworkAclConfiguration (list) --

    The rules that define how you manage the outbound traffic from kdb network to your internal network.

    • (dict) --

      The network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. The entry is a set of numbered ingress and egress rules that determine whether a packet should be allowed in or out of a subnet associated with the ACL. We process the entries in the ACL according to the rule numbers, in ascending order.

      • ruleNumber (integer) -- [REQUIRED]

        The rule number for the entry. For example 100. All the network ACL entries are processed in ascending order by rule number.

      • protocol (string) -- [REQUIRED]

        The protocol number. A value of -1 means all the protocols.

      • ruleAction (string) -- [REQUIRED]

        Indicates whether to allow or deny the traffic that matches the rule.

      • portRange (dict) --

        The range of ports the rule applies to.

        • from (integer) -- [REQUIRED]

          The first port in the range.

        • to (integer) -- [REQUIRED]

          The last port in the range.

      • icmpTypeCode (dict) --

        Defines the ICMP protocol that consists of the ICMP type and code.

        • type (integer) -- [REQUIRED]

          The ICMP type. A value of -1 means all types.

        • code (integer) -- [REQUIRED]

          The ICMP code. A value of -1 means all codes for the specified ICMP type.

      • cidrBlock (string) -- [REQUIRED]

        The IPv4 network range to allow or deny, in CIDR notation. For example, 172.16.0.0/24. We modify the specified CIDR block to its canonical form. For example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

type customDNSConfiguration:

list

param customDNSConfiguration:

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) -- [REQUIRED]

      The name of the DNS server.

    • customDNSServerIP (string) -- [REQUIRED]

      The IP address of the DNS server.

type clientToken:

string

param clientToken:

A token that ensures idempotency. This token expires in 10 minutes.

rtype:

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',
        'attachmentNetworkAclConfiguration': [
            {
                'ruleNumber': 123,
                'protocol': 'string',
                'ruleAction': 'allow'|'deny',
                'portRange': {
                    'from': 123,
                    'to': 123
                },
                'icmpTypeCode': {
                    'type': 123,
                    'code': 123
                },
                'cidrBlock': 'string'
            },
        ]
    },
    'customDNSConfiguration': [
        {
            'customDNSServerName': 'string',
            'customDNSServerIP': 'string'
        },
    ],
    'creationTimestamp': datetime(2015, 1, 1),
    'updateTimestamp': datetime(2015, 1, 1),
    'availabilityZoneIds': [
        '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) --

      The description of the 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.

      • attachmentNetworkAclConfiguration (list) --

        The rules that define how you manage the outbound traffic from kdb network to your internal network.

        • (dict) --

          The network access control list (ACL) is an optional layer of security for your VPC that acts as a firewall for controlling traffic in and out of one or more subnets. The entry is a set of numbered ingress and egress rules that determine whether a packet should be allowed in or out of a subnet associated with the ACL. We process the entries in the ACL according to the rule numbers, in ascending order.

          • ruleNumber (integer) --

            The rule number for the entry. For example 100. All the network ACL entries are processed in ascending order by rule number.

          • protocol (string) --

            The protocol number. A value of -1 means all the protocols.

          • ruleAction (string) --

            Indicates whether to allow or deny the traffic that matches the rule.

          • portRange (dict) --

            The range of ports the rule applies to.

            • from (integer) --

              The first port in the range.

            • to (integer) --

              The last port in the range.

          • icmpTypeCode (dict) --

            Defines the ICMP protocol that consists of the ICMP type and code.

            • type (integer) --

              The ICMP type. A value of -1 means all types.

            • code (integer) --

              The ICMP code. A value of -1 means all codes for the specified ICMP type.

          • cidrBlock (string) --

            The IPv4 network range to allow or deny, in CIDR notation. For example, 172.16.0.0/24. We modify the specified CIDR block to its canonical form. For example, if you specify 100.68.0.18/18, we modify it to 100.68.0.0/18.

    • 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) --