create_endpoint_access

create_endpoint_access(**kwargs)

Creates a Redshift-managed VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.create_endpoint_access(
    ClusterIdentifier='string',
    ResourceOwner='string',
    EndpointName='string',
    SubnetGroupName='string',
    VpcSecurityGroupIds=[
        'string',
    ]
)

Parameters

• ClusterIdentifier (string) -- The cluster identifier of the cluster to access.
• ResourceOwner (string) -- The Amazon Web Services account ID of the owner of the cluster. This is only required if the cluster is in another Amazon Web Services account.
• EndpointName (string) --

  [REQUIRED]

  The Redshift-managed VPC endpoint name.

  An endpoint name must contain 1-30 characters. Valid characters are A-Z, a-z, 0-9, and hyphen(-). The first character must be a letter. The name can't contain two consecutive hyphens or end with a hyphen.

• SubnetGroupName (string) --

  [REQUIRED]

  The subnet group from which Amazon Redshift chooses the subnet to deploy the endpoint.

• VpcSecurityGroupIds (list) --

  The security group that defines the ports, protocols, and sources for inbound traffic that you are authorizing into your endpoint.

  • (string) --

Return type

dict

Returns

Response Syntax

{
    'ClusterIdentifier': 'string',
    'ResourceOwner': 'string',
    'SubnetGroupName': 'string',
    'EndpointStatus': 'string',
    'EndpointName': 'string',
    'EndpointCreateTime': datetime(2015, 1, 1),
    'Port': 123,
    'Address': 'string',
    'VpcSecurityGroups': [
        {
            'VpcSecurityGroupId': 'string',
            'Status': 'string'
        },
    ],
    'VpcEndpoint': {
        'VpcEndpointId': 'string',
        'VpcId': 'string',
        'NetworkInterfaces': [
            {
                'NetworkInterfaceId': 'string',
                'SubnetId': 'string',
                'PrivateIpAddress': 'string',
                'AvailabilityZone': 'string'
            },
        ]
    }
}

Response Structure

• (dict) --

  Describes a Redshift-managed VPC endpoint.

  • ClusterIdentifier (string) --

    The cluster identifier of the cluster associated with the endpoint.

  • ResourceOwner (string) --

    The Amazon Web Services account ID of the owner of the cluster.

  • SubnetGroupName (string) --

    The subnet group name where Amazon Redshift chooses to deploy the endpoint.

  • EndpointStatus (string) --

    The status of the endpoint.

  • EndpointName (string) --

    The name of the endpoint.

  • EndpointCreateTime (datetime) --

    The time (UTC) that the endpoint was created.

  • Port (integer) --

    The port number on which the cluster accepts incoming connections.

  • Address (string) --

    The DNS address of the endpoint.

  • VpcSecurityGroups (list) --

    The security groups associated with the endpoint.

    • (dict) --

      Describes the members of a VPC security group.

      • VpcSecurityGroupId (string) --

        The identifier of the VPC security group.

      • Status (string) --

        The status of the VPC security group.

  • VpcEndpoint (dict) --

    The connection endpoint for connecting to an Amazon Redshift cluster through the proxy.

    • VpcEndpointId (string) --

      The connection endpoint ID for connecting an Amazon Redshift cluster through the proxy.

    • VpcId (string) --

      The VPC identifier that the endpoint is associated.

    • NetworkInterfaces (list) --

      One or more network interfaces of the endpoint. Also known as an interface endpoint.

      • (dict) --

        Describes a network interface.

        • NetworkInterfaceId (string) --

          The network interface identifier.

        • SubnetId (string) --

          The subnet identifier.

        • PrivateIpAddress (string) --

          The IPv4 address of the network interface within the subnet.

        • AvailabilityZone (string) --

          The Availability Zone.

Exceptions

• Redshift.Client.exceptions.ClusterNotFoundFault
• Redshift.Client.exceptions.AccessToClusterDeniedFault
• Redshift.Client.exceptions.EndpointsPerClusterLimitExceededFault
• Redshift.Client.exceptions.EndpointsPerAuthorizationLimitExceededFault
• Redshift.Client.exceptions.InvalidClusterSecurityGroupStateFault
• Redshift.Client.exceptions.ClusterSubnetGroupNotFoundFault
• Redshift.Client.exceptions.EndpointAlreadyExistsFault
• Redshift.Client.exceptions.UnsupportedOperationFault
• Redshift.Client.exceptions.InvalidClusterStateFault
• Redshift.Client.exceptions.UnauthorizedOperation