Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

create_outbound_cross_cluster_search_connection

create_outbound_cross_cluster_search_connection(**kwargs)

Creates a new cross-cluster search connection from a source domain to a destination domain.

See also: AWS API Documentation

Request Syntax

response = client.create_outbound_cross_cluster_search_connection(
    SourceDomainInfo={
        'OwnerId': 'string',
        'DomainName': 'string',
        'Region': 'string'
    },
    DestinationDomainInfo={
        'OwnerId': 'string',
        'DomainName': 'string',
        'Region': 'string'
    },
    ConnectionAlias='string'
)
Parameters
  • SourceDomainInfo (dict) --

    [REQUIRED]

    Specifies the DomainInformation for the source Elasticsearch domain.

    • OwnerId (string) --
    • DomainName (string) -- [REQUIRED]

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

    [REQUIRED]

    Specifies the DomainInformation for the destination Elasticsearch domain.

    • OwnerId (string) --
    • DomainName (string) -- [REQUIRED]

      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) --
  • ConnectionAlias (string) --

    [REQUIRED]

    Specifies the connection alias that will be used by the customer for this connection.

Return type

dict

Returns

Response Syntax

{
    'SourceDomainInfo': {
        'OwnerId': 'string',
        'DomainName': 'string',
        'Region': 'string'
    },
    'DestinationDomainInfo': {
        'OwnerId': 'string',
        'DomainName': 'string',
        'Region': 'string'
    },
    'ConnectionAlias': 'string',
    'ConnectionStatus': {
        'StatusCode': 'PENDING_ACCEPTANCE'|'VALIDATING'|'VALIDATION_FAILED'|'PROVISIONING'|'ACTIVE'|'REJECTED'|'DELETING'|'DELETED',
        'Message': 'string'
    },
    'CrossClusterSearchConnectionId': 'string'
}

Response Structure

  • (dict) --

    The result of a CreateOutboundCrossClusterSearchConnection request. Contains the details of the newly created cross-cluster search 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) --

    • ConnectionAlias (string) --

      Specifies the connection alias provided during the create connection request.

    • ConnectionStatus (dict) --

      Specifies the OutboundCrossClusterSearchConnectionStatus for the newly created connection.

      • StatusCode (string) --

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

        • VALIDATING: The outbound connection request is being validated.
        • VALIDATION_FAILED: Validation failed for the connection request.
        • PENDING_ACCEPTANCE: Outbound connection request is validated and is not yet accepted by destination domain owner.
        • PROVISIONING: Outbound connection request is in process.
        • ACTIVE: Outbound connection is active and ready to use.
        • REJECTED: Outbound connection request is rejected by destination domain owner.
        • DELETING: Outbound connection deletion is in progress.
        • DELETED: Outbound connection is deleted and cannot be used further.
      • Message (string) --

        Specifies verbose information for the outbound connection status.

    • CrossClusterSearchConnectionId (string) --

      Unique id for the created outbound connection, which is used for subsequent operations on connection.

Exceptions

  • ElasticsearchService.Client.exceptions.LimitExceededException
  • ElasticsearchService.Client.exceptions.InternalException
  • ElasticsearchService.Client.exceptions.ResourceAlreadyExistsException
  • ElasticsearchService.Client.exceptions.DisabledOperationException