ElasticsearchService / Client / describe_inbound_cross_cluster_search_connections

describe_inbound_cross_cluster_search_connections#

ElasticsearchService.Client.describe_inbound_cross_cluster_search_connections(**kwargs)#

Lists all the inbound cross-cluster search connections for a destination domain.

See also: AWS API Documentation

Request Syntax

response = client.describe_inbound_cross_cluster_search_connections(
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • Filters (list) –

    A list of filters used to match properties for inbound cross-cluster search connection. Available Filter names for this operation are:

    • cross-cluster-search-connection-id

    • source-domain-info.domain-name

    • source-domain-info.owner-id

    • source-domain-info.region

    • destination-domain-info.domain-name

    • (dict) –

      A filter used to limit results when describing inbound or outbound cross-cluster search connections. Multiple values can be specified per filter. A cross-cluster search connection must match at least one of the specified values for it to be returned from an operation.

      • Name (string) –

        Specifies the name of the filter.

      • Values (list) –

        Contains one or more values for the filter.

        • (string) –

  • MaxResults (integer) – Set this value to limit the number of results returned. If not specified, defaults to 100.

  • NextToken (string) – NextToken is sent in case the earlier API call results contain the NextToken. It is used for pagination.

Return type:

dict

Returns:

Response Syntax

{
    'CrossClusterSearchConnections': [
        {
            'SourceDomainInfo': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            },
            'DestinationDomainInfo': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            },
            'CrossClusterSearchConnectionId': 'string',
            'ConnectionStatus': {
                'StatusCode': 'PENDING_ACCEPTANCE'|'APPROVED'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
                'Message': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    The result of a DescribeInboundCrossClusterSearchConnections request. Contains the list of connections matching the filter criteria.

    • CrossClusterSearchConnections (list) –

      Consists of list of InboundCrossClusterSearchConnection matching the specified filter criteria.

      • (dict) –

        Specifies details of an inbound connection.

        • SourceDomainInfo (dict) –

          Specifies the DomainInformation for the source Elasticsearch domain.

          • OwnerId (string) –

          • DomainName (string) –

            The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

          • Region (string) –

        • DestinationDomainInfo (dict) –

          Specifies the DomainInformation for the destination Elasticsearch domain.

          • OwnerId (string) –

          • DomainName (string) –

            The name of an Elasticsearch domain. Domain names are unique across the domains owned by an account within an AWS region. Domain names start with a letter or number and can contain the following characters: a-z (lowercase), 0-9, and - (hyphen).

          • Region (string) –

        • CrossClusterSearchConnectionId (string) –

          Specifies the connection id for the inbound cross-cluster search connection.

        • ConnectionStatus (dict) –

          Specifies the InboundCrossClusterSearchConnectionStatus for the outbound connection.

          • StatusCode (string) –

            The state code for inbound connection. This can be one of the following:

            • PENDING_ACCEPTANCE: Inbound connection is not yet accepted by destination domain owner.

            • APPROVED: Inbound connection is pending acceptance by destination domain owner.

            • REJECTING: Inbound connection rejection is in process.

            • REJECTED: Inbound connection is rejected.

            • DELETING: Inbound connection deletion is in progress.

            • DELETED: Inbound connection is deleted and cannot be used further.

          • Message (string) –

            Specifies verbose information for the inbound connection status.

    • NextToken (string) –

      If more results are available and NextToken is present, make the next request to the same API with the received NextToken to paginate the remaining results.

Exceptions

  • ElasticsearchService.Client.exceptions.InvalidPaginationTokenException

  • ElasticsearchService.Client.exceptions.DisabledOperationException