create_outbound_connection

create_outbound_connection(**kwargs)

Creates a new cross-cluster search connection from a source Amazon OpenSearch Service domain to a destination domain. For more information, see Cross-cluster search for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.create_outbound_connection(
    LocalDomainInfo={
        'AWSDomainInformation': {
            'OwnerId': 'string',
            'DomainName': 'string',
            'Region': 'string'
        }
    },
    RemoteDomainInfo={
        'AWSDomainInformation': {
            'OwnerId': 'string',
            'DomainName': 'string',
            'Region': 'string'
        }
    },
    ConnectionAlias='string',
    ConnectionMode='DIRECT'|'VPC_ENDPOINT'
)
Parameters
  • LocalDomainInfo (dict) --

    [REQUIRED]

    Name and Region of the source (local) domain.

    • AWSDomainInformation (dict) --

      Information about an Amazon OpenSearch Service domain.

      • OwnerId (string) --

        The Amazon Web Services account ID of the domain owner.

      • DomainName (string) -- [REQUIRED]

        Name of the domain.

      • Region (string) --

        The Amazon Web Services Region in which the domain is located.

  • RemoteDomainInfo (dict) --

    [REQUIRED]

    Name and Region of the destination (remote) domain.

    • AWSDomainInformation (dict) --

      Information about an Amazon OpenSearch Service domain.

      • OwnerId (string) --

        The Amazon Web Services account ID of the domain owner.

      • DomainName (string) -- [REQUIRED]

        Name of the domain.

      • Region (string) --

        The Amazon Web Services Region in which the domain is located.

  • ConnectionAlias (string) --

    [REQUIRED]

    Name of the connection.

  • ConnectionMode (string) -- The connection mode.
Return type

dict

Returns

Response Syntax

{
    'LocalDomainInfo': {
        'AWSDomainInformation': {
            'OwnerId': 'string',
            'DomainName': 'string',
            'Region': 'string'
        }
    },
    'RemoteDomainInfo': {
        'AWSDomainInformation': {
            'OwnerId': 'string',
            'DomainName': 'string',
            'Region': 'string'
        }
    },
    'ConnectionAlias': 'string',
    'ConnectionStatus': {
        'StatusCode': 'VALIDATING'|'VALIDATION_FAILED'|'PENDING_ACCEPTANCE'|'APPROVED'|'PROVISIONING'|'ACTIVE'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
        'Message': 'string'
    },
    'ConnectionId': 'string',
    'ConnectionMode': 'DIRECT'|'VPC_ENDPOINT',
    'ConnectionProperties': {
        'Endpoint': 'string'
    }
}

Response Structure

  • (dict) --

    The result of a CreateOutboundConnection request. Contains details about the newly created cross-cluster connection.

    • LocalDomainInfo (dict) --

      Information about the source (local) domain.

      • AWSDomainInformation (dict) --

        Information about an Amazon OpenSearch Service domain.

        • OwnerId (string) --

          The Amazon Web Services account ID of the domain owner.

        • DomainName (string) --

          Name of the domain.

        • Region (string) --

          The Amazon Web Services Region in which the domain is located.

    • RemoteDomainInfo (dict) --

      Information about the destination (remote) domain.

      • AWSDomainInformation (dict) --

        Information about an Amazon OpenSearch Service domain.

        • OwnerId (string) --

          The Amazon Web Services account ID of the domain owner.

        • DomainName (string) --

          Name of the domain.

        • Region (string) --

          The Amazon Web Services Region in which the domain is located.

    • ConnectionAlias (string) --

      Name of the connection.

    • ConnectionStatus (dict) --

      The status of the connection.

      • StatusCode (string) --

        The status code for the outbound connection. 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 the remote domain owner.
        • APPROVED - Outbound connection has been approved by the remote domain owner for getting provisioned.
        • PROVISIONING - Outbound connection request is in process.
        • ACTIVE - Outbound connection is active and ready to use.
        • REJECTING - Outbound connection rejection by remote domain owner is in progress.
        • REJECTED - Outbound connection request is rejected by remote domain owner.
        • DELETING - Outbound connection deletion is in progress.
        • DELETED - Outbound connection is deleted and can no longer be used.
      • Message (string) --

        Verbose information for the outbound connection.

    • ConnectionId (string) --

      The unique identifier for the created outbound connection, which is used for subsequent operations on the connection.

    • ConnectionMode (string) --

      The connection mode.

    • ConnectionProperties (dict) --

      The ConnectionProperties for the newly created connection.

      • Endpoint (string) --

        The endpoint of the remote domain.

Exceptions

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