Amazon OpenSearch Service

2023/06/12 - Amazon OpenSearch Service - 3 updated api methods

Changes  This release adds support for SkipUnavailable connection property for cross cluster search

CreateOutboundConnection (updated) Link ¶
Changes (request, response)
Request
{'ConnectionProperties': {'CrossClusterSearch': {'SkipUnavailable': 'ENABLED | '
                                                                    'DISABLED'},
                          'Endpoint': 'string'}}
Response
{'ConnectionProperties': {'CrossClusterSearch': {'SkipUnavailable': 'ENABLED | '
                                                                    'DISABLED'}}}

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

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',
    ConnectionProperties={
        'Endpoint': 'string',
        'CrossClusterSearch': {
            'SkipUnavailable': 'ENABLED'|'DISABLED'
        }
    }
)
type LocalDomainInfo

dict

param LocalDomainInfo

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

type RemoteDomainInfo

dict

param RemoteDomainInfo

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

type ConnectionAlias

string

param ConnectionAlias

[REQUIRED]

Name of the connection.

type ConnectionMode

string

param ConnectionMode

The connection mode.

type ConnectionProperties

dict

param ConnectionProperties

The ConnectionProperties for the outbound connection.

  • Endpoint (string) --

    Warning

    The Endpoint attribute cannot be modified.

    The endpoint of the remote domain. Applicable for VPC_ENDPOINT connection mode.

  • CrossClusterSearch (dict) --

    The connection properties for cross cluster search.

    • SkipUnavailable (string) --

      Status of SkipUnavailable param for outbound connection.

rtype

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',
        'CrossClusterSearch': {
            'SkipUnavailable': 'ENABLED'|'DISABLED'
        }
    }
}

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

        Warning

        The Endpoint attribute cannot be modified.

        The endpoint of the remote domain. Applicable for VPC_ENDPOINT connection mode.

      • CrossClusterSearch (dict) --

        The connection properties for cross cluster search.

        • SkipUnavailable (string) --

          Status of SkipUnavailable param for outbound connection.

DeleteOutboundConnection (updated) Link ¶
Changes (response)
{'Connection': {'ConnectionProperties': {'CrossClusterSearch': {'SkipUnavailable': 'ENABLED '
                                                                                   '| '
                                                                                   'DISABLED'}}}}

Allows the source Amazon OpenSearch Service domain owner to delete an existing outbound cross-cluster search connection. For more information, see Cross-cluster search for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.delete_outbound_connection(
    ConnectionId='string'
)
type ConnectionId

string

param ConnectionId

[REQUIRED]

The ID of the outbound connection you want to permanently delete.

rtype

dict

returns

Response Syntax

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

Response Structure

  • (dict) --

    Details about the deleted outbound connection.

    • Connection (dict) --

      The deleted inbound 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.

      • ConnectionId (string) --

        Unique identifier of the connection.

      • ConnectionAlias (string) --

        Name of the connection.

      • ConnectionStatus (dict) --

        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.

      • ConnectionMode (string) --

        The connection mode.

      • ConnectionProperties (dict) --

        Properties for the outbound connection.

        • Endpoint (string) --

          Warning

          The Endpoint attribute cannot be modified.

          The endpoint of the remote domain. Applicable for VPC_ENDPOINT connection mode.

        • CrossClusterSearch (dict) --

          The connection properties for cross cluster search.

          • SkipUnavailable (string) --

            Status of SkipUnavailable param for outbound connection.

DescribeOutboundConnections (updated) Link ¶
Changes (response)
{'Connections': {'ConnectionProperties': {'CrossClusterSearch': {'SkipUnavailable': 'ENABLED '
                                                                                    '| '
                                                                                    'DISABLED'}}}}

Lists all the outbound cross-cluster connections for a local (source) Amazon OpenSearch Service domain. For more information, see Cross-cluster search for Amazon OpenSearch Service .

See also: AWS API Documentation

Request Syntax

client.describe_outbound_connections(
    Filters=[
        {
            'Name': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)
type Filters

list

param Filters

List of filter names and values that you can use for requests.

  • (dict) --

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

    • Name (string) --

      The name of the filter.

    • Values (list) --

      One or more values for the filter.

      • (string) --

type MaxResults

integer

param MaxResults

An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.

type NextToken

string

param NextToken

If your initial DescribeOutboundConnections operation returns a nextToken , you can include the returned nextToken in subsequent DescribeOutboundConnections operations, which returns results in the next page.

rtype

dict

returns

Response Syntax

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

Response Structure

  • (dict) --

    Contains a list of connections matching the filter criteria.

    • Connections (list) --

      List of outbound connections that match the filter criteria.

      • (dict) --

        Specifies details about an outbound 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.

        • ConnectionId (string) --

          Unique identifier of the connection.

        • ConnectionAlias (string) --

          Name of the connection.

        • ConnectionStatus (dict) --

          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.

        • ConnectionMode (string) --

          The connection mode.

        • ConnectionProperties (dict) --

          Properties for the outbound connection.

          • Endpoint (string) --

            Warning

            The Endpoint attribute cannot be modified.

            The endpoint of the remote domain. Applicable for VPC_ENDPOINT connection mode.

          • CrossClusterSearch (dict) --

            The connection properties for cross cluster search.

            • SkipUnavailable (string) --

              Status of SkipUnavailable param for outbound connection.

    • NextToken (string) --

      When nextToken is returned, there are more results available. The value of nextToken is a unique pagination token for each page. Make the call again using the returned token to retrieve the next page.