OpenSearchService

Client

class OpenSearchService.Client

A low-level client representing Amazon OpenSearch Service

Use the Amazon OpenSearch Service configuration API to create, configure, and manage OpenSearch Service domains.

For sample code that uses the configuration API, see the Amazon OpenSearch Service Developer Guide. The guide also contains sample code for sending signed HTTP requests to the OpenSearch APIs. The endpoint for configuration service requests is Region specific: es.*region* .amazonaws.com. For example, es.us-east-1.amazonaws.com. For a current list of supported Regions and endpoints, see Amazon Web Services service endpoints.

client = session.create_client('opensearch')

These are the available methods:

accept_inbound_connection(**kwargs)

Allows the destination Amazon OpenSearch Service domain owner to accept an inbound cross-cluster search connection request. For more information, see Cross-cluster search for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.accept_inbound_connection(
    ConnectionId='string'
)
Parameters
ConnectionId (string) --

[REQUIRED]

The ID of the inbound connection to accept.

Return type
dict
Returns
Response Syntax
{
    'Connection': {
        'LocalDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'RemoteDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'ConnectionId': 'string',
        'ConnectionStatus': {
            'StatusCode': 'PENDING_ACCEPTANCE'|'APPROVED'|'PROVISIONING'|'ACTIVE'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Contains details about the accepted inbound connection.

    • Connection (dict) --

      Information about the accepted 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) --

        The unique identifier of the connection.

      • ConnectionStatus (dict) --

        The current status of the connection.

        • StatusCode (string) --

          The status code for the connection. Can be one of the following:

          • PENDING_ACCEPTANCE - Inbound connection is not yet accepted by the remote domain owner.
          • APPROVED : Inbound connection is pending acceptance by the remote domain owner.
          • PROVISIONING : Inbound connection is being provisioned.
          • ACTIVE : Inbound connection is active and ready to use.
          • 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 can no longer be used.
        • Message (string) --

          Information about the connection.

Exceptions

add_tags(**kwargs)

Attaches tags to an existing Amazon OpenSearch Service domain. Tags are a set of case-sensitive key-value pairs. An domain can have up to 10 tags. For more information, see Tagging Amazon OpenSearch Service domains.

See also: AWS API Documentation

Request Syntax

response = client.add_tags(
    ARN='string',
    TagList=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • ARN (string) --

    [REQUIRED]

    Amazon Resource Name (ARN) for the OpenSearch Service domain to which you want to attach resource tags.

  • TagList (list) --

    [REQUIRED]

    List of resource tags.

    • (dict) --

      A tag (key-value pair) for an Amazon OpenSearch Service resource.

      • Key (string) -- [REQUIRED]

        The tag key. Tag keys must be unique for the domain to which they are attached.

      • Value (string) -- [REQUIRED]

        The value assigned to the corresponding tag key. Tag values can be null and don't have to be unique in a tag set. For example, you can have a key value pair in a tag set of project : Trinity and cost-center : Trinity

Returns

None

Exceptions

associate_package(**kwargs)

Associates a package with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.associate_package(
    PackageID='string',
    DomainName='string'
)
Parameters
  • PackageID (string) --

    [REQUIRED]

    Internal ID of the package to associate with a domain. Use DescribePackages to find this value.

  • DomainName (string) --

    [REQUIRED]

    Name of the domain to associate the package with.

Return type

dict

Returns

Response Syntax

{
    'DomainPackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY',
        'LastUpdated': datetime(2015, 1, 1),
        'DomainName': 'string',
        'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
        'PackageVersion': 'string',
        'ReferencePath': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the AssociatePackage operation.

    • DomainPackageDetails (dict) --

      Information about a package that is associated with a domain.

      • PackageID (string) --

        Internal ID of the package.

      • PackageName (string) --

        User-specified name of the package.

      • PackageType (string) --

        The type of package.

      • LastUpdated (datetime) --

        Timestamp of the most recent update to the package association status.

      • DomainName (string) --

        Name of the domain that the package is associated with.

      • DomainPackageStatus (string) --

        State of the association.

      • PackageVersion (string) --

        The current version of the package.

      • ReferencePath (string) --

        Denotes the location of the package on the OpenSearch Service cluster nodes. It's the same as synonym_path for dictionary files.

      • ErrorDetails (dict) --

        Additional information if the package is in an error state. Null otherwise.

        • ErrorType (string) --

          The type of error that occurred.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

authorize_vpc_endpoint_access(**kwargs)

Provides access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.authorize_vpc_endpoint_access(
    DomainName='string',
    Account='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the OpenSearch Service domain to provide access to.

  • Account (string) --

    [REQUIRED]

    The Amazon Web Services account ID to grant access to.

Return type

dict

Returns

Response Syntax

{
    'AuthorizedPrincipal': {
        'PrincipalType': 'AWS_ACCOUNT'|'AWS_SERVICE',
        'Principal': 'string'
    }
}

Response Structure

  • (dict) --

    • AuthorizedPrincipal (dict) --

      Information about the Amazon Web Services account or service that was provided access to the domain.

      • PrincipalType (string) --

        The type of principal.

      • Principal (string) --

        The IAM principal that is allowed access to the domain.

Exceptions

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
cancel_service_software_update(**kwargs)

Cancels a scheduled service software update for an Amazon OpenSearch Service domain. You can only perform this operation before the AutomatedUpdateDate and when the domain's UpdateStatus is PENDING_UPDATE . For more information, see Service software updates in Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.cancel_service_software_update(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

Name of the OpenSearch Service domain that you want to cancel the service software update on.

Return type
dict
Returns
Response Syntax
{
    'ServiceSoftwareOptions': {
        'CurrentVersion': 'string',
        'NewVersion': 'string',
        'UpdateAvailable': True|False,
        'Cancellable': True|False,
        'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
        'Description': 'string',
        'AutomatedUpdateDate': datetime(2015, 1, 1),
        'OptionalDeployment': True|False
    }
}

Response Structure

  • (dict) --

    Container for the response to a CancelServiceSoftwareUpdate operation. Contains the status of the update.

    • ServiceSoftwareOptions (dict) --

      Container for the state of your domain relative to the latest service software.

      • CurrentVersion (string) --

        The current service software version present on the domain.

      • NewVersion (string) --

        The new service software version, if one is available.

      • UpdateAvailable (boolean) --

        True if you're able to update your service software version. False if you can't update your service software version.

      • Cancellable (boolean) --

        True if you're able to cancel your service software version update. False if you can't cancel your service software update.

      • UpdateStatus (string) --

        The status of your service software update.

      • Description (string) --

        A description of the service software update status.

      • AutomatedUpdateDate (datetime) --

        The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

      • OptionalDeployment (boolean) --

        True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

Exceptions

close()

Closes underlying endpoint connections.

create_domain(**kwargs)

Creates an Amazon OpenSearch Service domain. For more information, see Creating and managing Amazon OpenSearch Service domains.

See also: AWS API Documentation

Request Syntax

response = client.create_domain(
    DomainName='string',
    EngineVersion='string',
    ClusterConfig={
        'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
        'InstanceCount': 123,
        'DedicatedMasterEnabled': True|False,
        'ZoneAwarenessEnabled': True|False,
        'ZoneAwarenessConfig': {
            'AvailabilityZoneCount': 123
        },
        'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
        'DedicatedMasterCount': 123,
        'WarmEnabled': True|False,
        'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
        'WarmCount': 123,
        'ColdStorageOptions': {
            'Enabled': True|False
        }
    },
    EBSOptions={
        'EBSEnabled': True|False,
        'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
        'VolumeSize': 123,
        'Iops': 123,
        'Throughput': 123
    },
    AccessPolicies='string',
    SnapshotOptions={
        'AutomatedSnapshotStartHour': 123
    },
    VPCOptions={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    CognitoOptions={
        'Enabled': True|False,
        'UserPoolId': 'string',
        'IdentityPoolId': 'string',
        'RoleArn': 'string'
    },
    EncryptionAtRestOptions={
        'Enabled': True|False,
        'KmsKeyId': 'string'
    },
    NodeToNodeEncryptionOptions={
        'Enabled': True|False
    },
    AdvancedOptions={
        'string': 'string'
    },
    LogPublishingOptions={
        'string': {
            'CloudWatchLogsLogGroupArn': 'string',
            'Enabled': True|False
        }
    },
    DomainEndpointOptions={
        'EnforceHTTPS': True|False,
        'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
        'CustomEndpointEnabled': True|False,
        'CustomEndpoint': 'string',
        'CustomEndpointCertificateArn': 'string'
    },
    AdvancedSecurityOptions={
        'Enabled': True|False,
        'InternalUserDatabaseEnabled': True|False,
        'MasterUserOptions': {
            'MasterUserARN': 'string',
            'MasterUserName': 'string',
            'MasterUserPassword': 'string'
        },
        'SAMLOptions': {
            'Enabled': True|False,
            'Idp': {
                'MetadataContent': 'string',
                'EntityId': 'string'
            },
            'MasterUserName': 'string',
            'MasterBackendRole': 'string',
            'SubjectKey': 'string',
            'RolesKey': 'string',
            'SessionTimeoutMinutes': 123
        },
        'AnonymousAuthEnabled': True|False
    },
    TagList=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    AutoTuneOptions={
        'DesiredState': 'ENABLED'|'DISABLED',
        'MaintenanceSchedules': [
            {
                'StartAt': datetime(2015, 1, 1),
                'Duration': {
                    'Value': 123,
                    'Unit': 'HOURS'
                },
                'CronExpressionForRecurrence': 'string'
            },
        ]
    }
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    Name of the OpenSearch Service domain to create. Domain names are unique across the domains owned by an account within an Amazon Web Services Region.

  • EngineVersion (string) -- String of format Elasticsearch_X.Y or OpenSearch_X.Y to specify the engine version for the OpenSearch Service domain. For example, OpenSearch_1.0 or Elasticsearch_7.9 . For more information, see Creating and managing Amazon OpenSearch Service domains.
  • ClusterConfig (dict) --

    Container for the cluster configuration of a domain.

    • InstanceType (string) --

      Instance type of data nodes in the cluster.

    • InstanceCount (integer) --

      Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

    • DedicatedMasterEnabled (boolean) --

      Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

    • ZoneAwarenessEnabled (boolean) --

      Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

    • ZoneAwarenessConfig (dict) --

      Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

      • AvailabilityZoneCount (integer) --

        If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

    • DedicatedMasterType (string) --

      OpenSearch Service instance type of the dedicated master nodes in the cluster.

    • DedicatedMasterCount (integer) --

      Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

    • WarmEnabled (boolean) --

      Whether to enable warm storage for the cluster.

    • WarmType (string) --

      The instance type for the cluster's warm nodes.

    • WarmCount (integer) --

      The number of warm nodes in the cluster.

    • ColdStorageOptions (dict) --

      Container for cold storage configuration options.

      • Enabled (boolean) -- [REQUIRED]

        Whether to enable or disable cold storage on the domain.

  • EBSOptions (dict) --

    Container for the parameters required to enable EBS-based storage for an OpenSearch Service domain.

    • EBSEnabled (boolean) --

      Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

    • VolumeType (string) --

      Specifies the type of EBS volumes attached to data nodes.

    • VolumeSize (integer) --

      Specifies the size (in GiB) of EBS volumes attached to data nodes.

    • Iops (integer) --

      Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

    • Throughput (integer) --

      Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

  • AccessPolicies (string) -- Identity and Access Management (IAM) policy document specifying the access policies for the new domain.
  • SnapshotOptions (dict) --

    DEPRECATED. Container for the parameters required to configure automated snapshots of domain indexes.

    • AutomatedSnapshotStartHour (integer) --

      The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

  • VPCOptions (dict) --

    Container for the values required to configure VPC access domains. If you don't specify these values, OpenSearch Service creates the domain with a public endpoint. For more information, see Launching your Amazon OpenSearch Service domains using a VPC.

    • SubnetIds (list) --

      A list of subnet IDs associated with the VPC endpoints for the domain. If your domain uses multiple Availability Zones, you need to provide two subnet IDs, one per zone. Otherwise, provide only one.

      • (string) --
    • SecurityGroupIds (list) --

      The list of security group IDs associated with the VPC endpoints for the domain. If you do not provide a security group ID, OpenSearch Service uses the default security group for the VPC.

      • (string) --
  • CognitoOptions (dict) --

    Key-value pairs to configure Amazon Cognito authentication. For more information, see Configuring Amazon Cognito authentication for OpenSearch Dashboards.

    • Enabled (boolean) --

      Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

    • UserPoolId (string) --

      The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

    • IdentityPoolId (string) --

      The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

    • RoleArn (string) --

      The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

  • EncryptionAtRestOptions (dict) --

    Key-value pairs to enable encryption at rest.

    • Enabled (boolean) --

      True to enable encryption at rest.

    • KmsKeyId (string) --

      The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

  • NodeToNodeEncryptionOptions (dict) --

    Enables node-to-node encryption.

    • Enabled (boolean) --

      True to enable node-to-node encryption.

  • AdvancedOptions (dict) --

    Key-value pairs to specify advanced configuration options. The following key-value pairs are supported:

    • "rest.action.multi.allow_explicit_index": "true" | "false" - Note the use of a string rather than a boolean. Specifies whether explicit references to indexes are allowed inside the body of HTTP requests. If you want to configure access policies for domain sub-resources, such as specific indexes and domain APIs, you must disable this property. Default is true.
    • "indices.fielddata.cache.size": "80" - Note the use of a string rather than a boolean. Specifies the percentage of heap space allocated to field data. Default is unbounded.
    • "indices.query.bool.max_clause_count": "1024" - Note the use of a string rather than a boolean. Specifies the maximum number of clauses allowed in a Lucene boolean query. Default is 1,024. Queries with more than the permitted number of clauses result in a TooManyClauses error.
    • "override_main_response_version": "true" | "false" - Note the use of a string rather than a boolean. Specifies whether the domain reports its version as 7.10 to allow Elasticsearch OSS clients and plugins to continue working with it. Default is false when creating a domain and true when upgrading a domain.

    For more information, see Advanced cluster parameters.

    • (string) --
      • (string) --
  • LogPublishingOptions (dict) --

    Key-value pairs to configure slow log publishing.

    • (string) --

      The type of log file. Can be one of the following:

      • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
      • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
      • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
      • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
      • (dict) --

        Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

        Note

        After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

        • CloudWatchLogsLogGroupArn (string) --

          The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

        • Enabled (boolean) --

          Whether the log should be published.

  • DomainEndpointOptions (dict) --

    Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

    • EnforceHTTPS (boolean) --

      True to require that all traffic to the domain arrive over HTTPS.

    • TLSSecurityPolicy (string) --

      Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

      Can be one of the following values:

      • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
      • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
    • CustomEndpointEnabled (boolean) --

      Whether to enable a custom endpoint for the domain.

    • CustomEndpoint (string) --

      The fully qualified URL for the custom endpoint.

    • CustomEndpointCertificateArn (string) --

      The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

  • AdvancedSecurityOptions (dict) --

    Options for fine-grained access control.

    • Enabled (boolean) --

      True to enable fine-grained access control.

    • InternalUserDatabaseEnabled (boolean) --

      True to enable the internal user database.

    • MasterUserOptions (dict) --

      Container for information about the master user.

      • MasterUserARN (string) --

        Amazon Resource Name (ARN) for the master user. Only specify if InternalUserDatabaseEnabled is false .

      • MasterUserName (string) --

        User name for the master user. Only specify if InternalUserDatabaseEnabled is true .

      • MasterUserPassword (string) --

        Password for the master user. Only specify if InternalUserDatabaseEnabled is true .

    • SAMLOptions (dict) --

      Container for information about the SAML configuration for OpenSearch Dashboards.

      • Enabled (boolean) --

        True to enable SAML authentication for a domain.

      • Idp (dict) --

        The SAML Identity Provider's information.

        • MetadataContent (string) -- [REQUIRED]

          The metadata of the SAML application, in XML format.

        • EntityId (string) -- [REQUIRED]

          The unique entity ID of the application in the SAML identity provider.

      • MasterUserName (string) --

        The SAML master user name, which is stored in the domain's internal user database.

      • MasterBackendRole (string) --

        The backend role that the SAML master user is mapped to.

      • SubjectKey (string) --

        Element of the SAML assertion to use for the user name. Default is NameID .

      • RolesKey (string) --

        Element of the SAML assertion to use for backend roles. Default is roles .

      • SessionTimeoutMinutes (integer) --

        The duration, in minutes, after which a user session becomes inactive. Acceptable values are between 1 and 1440, and the default value is 60.

    • AnonymousAuthEnabled (boolean) --

      True to enable a 30-day migration period during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

  • TagList (list) --

    List of tags to add to the domain upon creation.

    • (dict) --

      A tag (key-value pair) for an Amazon OpenSearch Service resource.

      • Key (string) -- [REQUIRED]

        The tag key. Tag keys must be unique for the domain to which they are attached.

      • Value (string) -- [REQUIRED]

        The value assigned to the corresponding tag key. Tag values can be null and don't have to be unique in a tag set. For example, you can have a key value pair in a tag set of project : Trinity and cost-center : Trinity

  • AutoTuneOptions (dict) --

    Options for Auto-Tune.

    • DesiredState (string) --

      Whether Auto-Tune is enabled or disabled.

    • MaintenanceSchedules (list) --

      A list of maintenance schedules during which Auto-Tune can deploy changes. Maintenance schedules are overwrite, not append. If your request includes no schedules, the request deletes all existing schedules. To preserve existing schedules, make a call to DescribeDomainConfig first and use the MaintenanceSchedules portion of the response as the basis for this section.

      • (dict) --

        The Auto-Tune maintenance schedule. For more information, see Auto-Tune for Amazon OpenSearch Service.

        • StartAt (datetime) --

          The Epoch timestamp at which the Auto-Tune maintenance schedule starts.

        • Duration (dict) --

          The duration of the maintenance schedule. For example, "Duration": {"Value": 2, "Unit": "HOURS"} .

          • Value (integer) --

            Integer to specify the value of a maintenance schedule duration.

          • Unit (string) --

            The unit of measurement for the duration of a maintenance schedule.

        • CronExpressionForRecurrence (string) --

          A cron expression for a recurring maintenance schedule during which Auto-Tune can deploy changes.

Return type

dict

Returns

Response Syntax

{
    'DomainStatus': {
        'DomainId': 'string',
        'DomainName': 'string',
        'ARN': 'string',
        'Created': True|False,
        'Deleted': True|False,
        'Endpoint': 'string',
        'Endpoints': {
            'string': 'string'
        },
        'Processing': True|False,
        'UpgradeProcessing': True|False,
        'EngineVersion': 'string',
        'ClusterConfig': {
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'InstanceCount': 123,
            'DedicatedMasterEnabled': True|False,
            'ZoneAwarenessEnabled': True|False,
            'ZoneAwarenessConfig': {
                'AvailabilityZoneCount': 123
            },
            'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'DedicatedMasterCount': 123,
            'WarmEnabled': True|False,
            'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
            'WarmCount': 123,
            'ColdStorageOptions': {
                'Enabled': True|False
            }
        },
        'EBSOptions': {
            'EBSEnabled': True|False,
            'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
            'VolumeSize': 123,
            'Iops': 123,
            'Throughput': 123
        },
        'AccessPolicies': 'string',
        'SnapshotOptions': {
            'AutomatedSnapshotStartHour': 123
        },
        'VPCOptions': {
            'VPCId': 'string',
            'SubnetIds': [
                'string',
            ],
            'AvailabilityZones': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'CognitoOptions': {
            'Enabled': True|False,
            'UserPoolId': 'string',
            'IdentityPoolId': 'string',
            'RoleArn': 'string'
        },
        'EncryptionAtRestOptions': {
            'Enabled': True|False,
            'KmsKeyId': 'string'
        },
        'NodeToNodeEncryptionOptions': {
            'Enabled': True|False
        },
        'AdvancedOptions': {
            'string': 'string'
        },
        'LogPublishingOptions': {
            'string': {
                'CloudWatchLogsLogGroupArn': 'string',
                'Enabled': True|False
            }
        },
        'ServiceSoftwareOptions': {
            'CurrentVersion': 'string',
            'NewVersion': 'string',
            'UpdateAvailable': True|False,
            'Cancellable': True|False,
            'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
            'Description': 'string',
            'AutomatedUpdateDate': datetime(2015, 1, 1),
            'OptionalDeployment': True|False
        },
        'DomainEndpointOptions': {
            'EnforceHTTPS': True|False,
            'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
            'CustomEndpointEnabled': True|False,
            'CustomEndpoint': 'string',
            'CustomEndpointCertificateArn': 'string'
        },
        'AdvancedSecurityOptions': {
            'Enabled': True|False,
            'InternalUserDatabaseEnabled': True|False,
            'SAMLOptions': {
                'Enabled': True|False,
                'Idp': {
                    'MetadataContent': 'string',
                    'EntityId': 'string'
                },
                'SubjectKey': 'string',
                'RolesKey': 'string',
                'SessionTimeoutMinutes': 123
            },
            'AnonymousAuthDisableDate': datetime(2015, 1, 1),
            'AnonymousAuthEnabled': True|False
        },
        'AutoTuneOptions': {
            'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
            'ErrorMessage': 'string'
        },
        'ChangeProgressDetails': {
            'ChangeId': 'string',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The result of a CreateDomain operation. Contains the status of the newly created domain.

    • DomainStatus (dict) --

      The status of the newly created domain.

      • DomainId (string) --

        Unique identifier for the domain.

      • DomainName (string) --

        Name of the domain. Domain names are unique across all domains owned by the same account within an Amazon Web Services Region.

      • ARN (string) --

        The Amazon Resource Name (ARN) of the domain. For more information, see IAM identifiers in the AWS Identity and Access Management User Guide .

      • Created (boolean) --

        Creation status of an OpenSearch Service domain. True if domain creation is complete. False if domain creation is still in progress.

      • Deleted (boolean) --

        Deletion status of an OpenSearch Service domain. True if domain deletion is complete. False if domain deletion is still in progress. Once deletion is complete, the status of the domain is no longer returned.

      • Endpoint (string) --

        Domain-specific endpoint used to submit index, search, and data upload requests to the domain.

      • Endpoints (dict) --

        The key-value pair that exists if the OpenSearch Service domain uses VPC endpoints.. Example key, value : 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com' .

        • (string) --

          • (string) --

            The domain endpoint to which index and search requests are submitted. For example, search-imdb-movies-oopcnjfn6ugo.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6u.eu-west-1.es.amazonaws.com .

      • Processing (boolean) --

        The status of the domain configuration. True if OpenSearch Service is processing configuration changes. False if the configuration is active.

      • UpgradeProcessing (boolean) --

        The status of a domain version upgrade to a new version of OpenSearch or Elasticsearch. True if OpenSearch Service is in the process of a version upgrade. False if the configuration is active.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch that the domain is running, in the format Elasticsearch_X.Y or OpenSearch_X.Y .

      • ClusterConfig (dict) --

        Container for the cluster configuration of the domain.

        • InstanceType (string) --

          Instance type of data nodes in the cluster.

        • InstanceCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • DedicatedMasterEnabled (boolean) --

          Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

        • ZoneAwarenessEnabled (boolean) --

          Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

        • ZoneAwarenessConfig (dict) --

          Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

          • AvailabilityZoneCount (integer) --

            If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

        • DedicatedMasterType (string) --

          OpenSearch Service instance type of the dedicated master nodes in the cluster.

        • DedicatedMasterCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • WarmEnabled (boolean) --

          Whether to enable warm storage for the cluster.

        • WarmType (string) --

          The instance type for the cluster's warm nodes.

        • WarmCount (integer) --

          The number of warm nodes in the cluster.

        • ColdStorageOptions (dict) --

          Container for cold storage configuration options.

          • Enabled (boolean) --

            Whether to enable or disable cold storage on the domain.

      • EBSOptions (dict) --

        Container for EBS-based storage settings for the domain.

        • EBSEnabled (boolean) --

          Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

        • VolumeType (string) --

          Specifies the type of EBS volumes attached to data nodes.

        • VolumeSize (integer) --

          Specifies the size (in GiB) of EBS volumes attached to data nodes.

        • Iops (integer) --

          Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

        • Throughput (integer) --

          Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

      • AccessPolicies (string) --

        Identity and Access Management (IAM) policy document specifying the access policies for the domain.

      • SnapshotOptions (dict) --

        DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

        • AutomatedSnapshotStartHour (integer) --

          The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

      • VPCOptions (dict) --

        The VPC configuration for the domain.

        • VPCId (string) --

          The ID for your VPC. Amazon VPC generates this value when you create a VPC.

        • SubnetIds (list) --

          A list of subnet IDs associated with the VPC endpoints for the domain.

          • (string) --
        • AvailabilityZones (list) --

          The list of Availability Zones associated with the VPC subnets.

          • (string) --
        • SecurityGroupIds (list) --

          The list of security group IDs associated with the VPC endpoints for the domain.

          • (string) --
      • CognitoOptions (dict) --

        Key-value pairs to configure Amazon Cognito authentication for OpenSearch Dashboards.

        • Enabled (boolean) --

          Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

        • UserPoolId (string) --

          The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • IdentityPoolId (string) --

          The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • RoleArn (string) --

          The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

      • EncryptionAtRestOptions (dict) --

        Encryption at rest settings for the domain.

        • Enabled (boolean) --

          True to enable encryption at rest.

        • KmsKeyId (string) --

          The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

      • NodeToNodeEncryptionOptions (dict) --

        Whether node-to-node encryption is enabled or disabled.

        • Enabled (boolean) --

          True to enable node-to-node encryption.

      • AdvancedOptions (dict) --

        Key-value pairs that specify advanced configuration options.

        • (string) --
          • (string) --
      • LogPublishingOptions (dict) --

        Log publishing options for the domain.

        • (string) --

          The type of log file. Can be one of the following:

          • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
          • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
          • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
          • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
          • (dict) --

            Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

            Note

            After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

            • CloudWatchLogsLogGroupArn (string) --

              The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

            • Enabled (boolean) --

              Whether the log should be published.

      • ServiceSoftwareOptions (dict) --

        The current status of the domain's service software.

        • CurrentVersion (string) --

          The current service software version present on the domain.

        • NewVersion (string) --

          The new service software version, if one is available.

        • UpdateAvailable (boolean) --

          True if you're able to update your service software version. False if you can't update your service software version.

        • Cancellable (boolean) --

          True if you're able to cancel your service software version update. False if you can't cancel your service software update.

        • UpdateStatus (string) --

          The status of your service software update.

        • Description (string) --

          A description of the service software update status.

        • AutomatedUpdateDate (datetime) --

          The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

        • OptionalDeployment (boolean) --

          True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

      • DomainEndpointOptions (dict) --

        Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

        • EnforceHTTPS (boolean) --

          True to require that all traffic to the domain arrive over HTTPS.

        • TLSSecurityPolicy (string) --

          Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

          Can be one of the following values:

          • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
          • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
        • CustomEndpointEnabled (boolean) --

          Whether to enable a custom endpoint for the domain.

        • CustomEndpoint (string) --

          The fully qualified URL for the custom endpoint.

        • CustomEndpointCertificateArn (string) --

          The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

      • AdvancedSecurityOptions (dict) --

        Settings for fine-grained access control.

        • Enabled (boolean) --

          True if fine-grained access control is enabled.

        • InternalUserDatabaseEnabled (boolean) --

          True if the internal user database is enabled.

        • SAMLOptions (dict) --

          Container for information about the SAML configuration for OpenSearch Dashboards.

          • Enabled (boolean) --

            True if SAML is enabled.

          • Idp (dict) --

            Describes the SAML identity provider's information.

            • MetadataContent (string) --

              The metadata of the SAML application, in XML format.

            • EntityId (string) --

              The unique entity ID of the application in the SAML identity provider.

          • SubjectKey (string) --

            The key used for matching the SAML subject attribute.

          • RolesKey (string) --

            The key used for matching the SAML roles attribute.

          • SessionTimeoutMinutes (integer) --

            The duration, in minutes, after which a user session becomes inactive.

        • AnonymousAuthDisableDate (datetime) --

          Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

        • AnonymousAuthEnabled (boolean) --

          True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

      • AutoTuneOptions (dict) --

        Auto-Tune settings for the domain.

        • State (string) --

          The current state of Auto-Tune on the domain.

        • ErrorMessage (string) --

          Any errors that occurred while enabling or disabling Auto-Tune.

      • ChangeProgressDetails (dict) --

        Information about a configuration change happening on the domain.

        • ChangeId (string) --

          The ID of the configuration change.

        • Message (string) --

          A message corresponding to the status of the configuration change.

Exceptions

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

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'
}

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.

Exceptions

create_package(**kwargs)

Creates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.create_package(
    PackageName='string',
    PackageType='TXT-DICTIONARY',
    PackageDescription='string',
    PackageSource={
        'S3BucketName': 'string',
        'S3Key': 'string'
    }
)
Parameters
  • PackageName (string) --

    [REQUIRED]

    Unique name for the package.

  • PackageType (string) --

    [REQUIRED]

    Type of package.

  • PackageDescription (string) -- Description of the package.
  • PackageSource (dict) --

    [REQUIRED]

    The Amazon S3 location from which to import the package.

    • S3BucketName (string) --

      The name of the Amazon S3 bucket containing the package.

    • S3Key (string) --

      Key (file name) of the package.

Return type

dict

Returns

Response Syntax

{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the CreatePackage operation.

    • PackageDetails (dict) --

      Basic information about an OpenSearch Service package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        User-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        Current status of the package.

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • ErrorDetails (dict) --

        Additional information if the package is in an error state. Null otherwise.

        • ErrorType (string) --

          The type of error that occurred.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

create_vpc_endpoint(**kwargs)

Creates an Amazon OpenSearch Service-managed VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.create_vpc_endpoint(
    DomainArn='string',
    VpcOptions={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    ClientToken='string'
)
Parameters
  • DomainArn (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the domain to grant access to.

  • VpcOptions (dict) --

    [REQUIRED]

    Options to specify the subnets and security groups for the endpoint.

    • SubnetIds (list) --

      A list of subnet IDs associated with the VPC endpoints for the domain. If your domain uses multiple Availability Zones, you need to provide two subnet IDs, one per zone. Otherwise, provide only one.

      • (string) --
    • SecurityGroupIds (list) --

      The list of security group IDs associated with the VPC endpoints for the domain. If you do not provide a security group ID, OpenSearch Service uses the default security group for the VPC.

      • (string) --
  • ClientToken (string) -- Unique, case-sensitive identifier to ensure idempotency of the request.
Return type

dict

Returns

Response Syntax

{
    'VpcEndpoint': {
        'VpcEndpointId': 'string',
        'VpcEndpointOwner': 'string',
        'DomainArn': 'string',
        'VpcOptions': {
            'VPCId': 'string',
            'SubnetIds': [
                'string',
            ],
            'AvailabilityZones': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED',
        'Endpoint': 'string'
    }
}

Response Structure

  • (dict) --

    • VpcEndpoint (dict) --

      Information about the newly created VPC endpoint.

      • VpcEndpointId (string) --

        The unique identifier of the endpoint.

      • VpcEndpointOwner (string) --

        The creator of the endpoint.

      • DomainArn (string) --

        The Amazon Resource Name (ARN) of the domain associated with the endpoint.

      • VpcOptions (dict) --

        Options to specify the subnets and security groups for an Amazon OpenSearch Service VPC endpoint.

        • VPCId (string) --

          The ID for your VPC. Amazon VPC generates this value when you create a VPC.

        • SubnetIds (list) --

          A list of subnet IDs associated with the VPC endpoints for the domain.

          • (string) --
        • AvailabilityZones (list) --

          The list of Availability Zones associated with the VPC subnets.

          • (string) --
        • SecurityGroupIds (list) --

          The list of security group IDs associated with the VPC endpoints for the domain.

          • (string) --
      • Status (string) --

        The current status of the endpoint.

      • Endpoint (string) --

        The connection endpoint ID for connecting to the domain.

Exceptions

delete_domain(**kwargs)

Deletes an Amazon OpenSearch Service domain and all of its data. You can't recover a domain after you delete it.

See also: AWS API Documentation

Request Syntax

response = client.delete_domain(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

The name of the domain you want to permanently delete.

Return type
dict
Returns
Response Syntax
{
    'DomainStatus': {
        'DomainId': 'string',
        'DomainName': 'string',
        'ARN': 'string',
        'Created': True|False,
        'Deleted': True|False,
        'Endpoint': 'string',
        'Endpoints': {
            'string': 'string'
        },
        'Processing': True|False,
        'UpgradeProcessing': True|False,
        'EngineVersion': 'string',
        'ClusterConfig': {
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'InstanceCount': 123,
            'DedicatedMasterEnabled': True|False,
            'ZoneAwarenessEnabled': True|False,
            'ZoneAwarenessConfig': {
                'AvailabilityZoneCount': 123
            },
            'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'DedicatedMasterCount': 123,
            'WarmEnabled': True|False,
            'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
            'WarmCount': 123,
            'ColdStorageOptions': {
                'Enabled': True|False
            }
        },
        'EBSOptions': {
            'EBSEnabled': True|False,
            'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
            'VolumeSize': 123,
            'Iops': 123,
            'Throughput': 123
        },
        'AccessPolicies': 'string',
        'SnapshotOptions': {
            'AutomatedSnapshotStartHour': 123
        },
        'VPCOptions': {
            'VPCId': 'string',
            'SubnetIds': [
                'string',
            ],
            'AvailabilityZones': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'CognitoOptions': {
            'Enabled': True|False,
            'UserPoolId': 'string',
            'IdentityPoolId': 'string',
            'RoleArn': 'string'
        },
        'EncryptionAtRestOptions': {
            'Enabled': True|False,
            'KmsKeyId': 'string'
        },
        'NodeToNodeEncryptionOptions': {
            'Enabled': True|False
        },
        'AdvancedOptions': {
            'string': 'string'
        },
        'LogPublishingOptions': {
            'string': {
                'CloudWatchLogsLogGroupArn': 'string',
                'Enabled': True|False
            }
        },
        'ServiceSoftwareOptions': {
            'CurrentVersion': 'string',
            'NewVersion': 'string',
            'UpdateAvailable': True|False,
            'Cancellable': True|False,
            'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
            'Description': 'string',
            'AutomatedUpdateDate': datetime(2015, 1, 1),
            'OptionalDeployment': True|False
        },
        'DomainEndpointOptions': {
            'EnforceHTTPS': True|False,
            'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
            'CustomEndpointEnabled': True|False,
            'CustomEndpoint': 'string',
            'CustomEndpointCertificateArn': 'string'
        },
        'AdvancedSecurityOptions': {
            'Enabled': True|False,
            'InternalUserDatabaseEnabled': True|False,
            'SAMLOptions': {
                'Enabled': True|False,
                'Idp': {
                    'MetadataContent': 'string',
                    'EntityId': 'string'
                },
                'SubjectKey': 'string',
                'RolesKey': 'string',
                'SessionTimeoutMinutes': 123
            },
            'AnonymousAuthDisableDate': datetime(2015, 1, 1),
            'AnonymousAuthEnabled': True|False
        },
        'AutoTuneOptions': {
            'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
            'ErrorMessage': 'string'
        },
        'ChangeProgressDetails': {
            'ChangeId': 'string',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The results of a DeleteDomain request. Contains the status of the pending deletion, or a "domain not found" error if the domain and all of its resources have been deleted.

    • DomainStatus (dict) --

      The status of the domain being deleted.

      • DomainId (string) --

        Unique identifier for the domain.

      • DomainName (string) --

        Name of the domain. Domain names are unique across all domains owned by the same account within an Amazon Web Services Region.

      • ARN (string) --

        The Amazon Resource Name (ARN) of the domain. For more information, see IAM identifiers in the AWS Identity and Access Management User Guide .

      • Created (boolean) --

        Creation status of an OpenSearch Service domain. True if domain creation is complete. False if domain creation is still in progress.

      • Deleted (boolean) --

        Deletion status of an OpenSearch Service domain. True if domain deletion is complete. False if domain deletion is still in progress. Once deletion is complete, the status of the domain is no longer returned.

      • Endpoint (string) --

        Domain-specific endpoint used to submit index, search, and data upload requests to the domain.

      • Endpoints (dict) --

        The key-value pair that exists if the OpenSearch Service domain uses VPC endpoints.. Example key, value : 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com' .

        • (string) --
          • (string) --

            The domain endpoint to which index and search requests are submitted. For example, search-imdb-movies-oopcnjfn6ugo.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6u.eu-west-1.es.amazonaws.com .

      • Processing (boolean) --

        The status of the domain configuration. True if OpenSearch Service is processing configuration changes. False if the configuration is active.

      • UpgradeProcessing (boolean) --

        The status of a domain version upgrade to a new version of OpenSearch or Elasticsearch. True if OpenSearch Service is in the process of a version upgrade. False if the configuration is active.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch that the domain is running, in the format Elasticsearch_X.Y or OpenSearch_X.Y .

      • ClusterConfig (dict) --

        Container for the cluster configuration of the domain.

        • InstanceType (string) --

          Instance type of data nodes in the cluster.

        • InstanceCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • DedicatedMasterEnabled (boolean) --

          Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

        • ZoneAwarenessEnabled (boolean) --

          Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

        • ZoneAwarenessConfig (dict) --

          Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

          • AvailabilityZoneCount (integer) --

            If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

        • DedicatedMasterType (string) --

          OpenSearch Service instance type of the dedicated master nodes in the cluster.

        • DedicatedMasterCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • WarmEnabled (boolean) --

          Whether to enable warm storage for the cluster.

        • WarmType (string) --

          The instance type for the cluster's warm nodes.

        • WarmCount (integer) --

          The number of warm nodes in the cluster.

        • ColdStorageOptions (dict) --

          Container for cold storage configuration options.

          • Enabled (boolean) --

            Whether to enable or disable cold storage on the domain.

      • EBSOptions (dict) --

        Container for EBS-based storage settings for the domain.

        • EBSEnabled (boolean) --

          Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

        • VolumeType (string) --

          Specifies the type of EBS volumes attached to data nodes.

        • VolumeSize (integer) --

          Specifies the size (in GiB) of EBS volumes attached to data nodes.

        • Iops (integer) --

          Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

        • Throughput (integer) --

          Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

      • AccessPolicies (string) --

        Identity and Access Management (IAM) policy document specifying the access policies for the domain.

      • SnapshotOptions (dict) --

        DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

        • AutomatedSnapshotStartHour (integer) --

          The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

      • VPCOptions (dict) --

        The VPC configuration for the domain.

        • VPCId (string) --

          The ID for your VPC. Amazon VPC generates this value when you create a VPC.

        • SubnetIds (list) --

          A list of subnet IDs associated with the VPC endpoints for the domain.

          • (string) --
        • AvailabilityZones (list) --

          The list of Availability Zones associated with the VPC subnets.

          • (string) --
        • SecurityGroupIds (list) --

          The list of security group IDs associated with the VPC endpoints for the domain.

          • (string) --
      • CognitoOptions (dict) --

        Key-value pairs to configure Amazon Cognito authentication for OpenSearch Dashboards.

        • Enabled (boolean) --

          Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

        • UserPoolId (string) --

          The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • IdentityPoolId (string) --

          The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • RoleArn (string) --

          The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

      • EncryptionAtRestOptions (dict) --

        Encryption at rest settings for the domain.

        • Enabled (boolean) --

          True to enable encryption at rest.

        • KmsKeyId (string) --

          The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

      • NodeToNodeEncryptionOptions (dict) --

        Whether node-to-node encryption is enabled or disabled.

        • Enabled (boolean) --

          True to enable node-to-node encryption.

      • AdvancedOptions (dict) --

        Key-value pairs that specify advanced configuration options.

        • (string) --
          • (string) --
      • LogPublishingOptions (dict) --

        Log publishing options for the domain.

        • (string) --

          The type of log file. Can be one of the following:

          • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
          • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
          • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
          • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
          • (dict) --

            Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

            Note

            After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

            • CloudWatchLogsLogGroupArn (string) --

              The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

            • Enabled (boolean) --

              Whether the log should be published.

      • ServiceSoftwareOptions (dict) --

        The current status of the domain's service software.

        • CurrentVersion (string) --

          The current service software version present on the domain.

        • NewVersion (string) --

          The new service software version, if one is available.

        • UpdateAvailable (boolean) --

          True if you're able to update your service software version. False if you can't update your service software version.

        • Cancellable (boolean) --

          True if you're able to cancel your service software version update. False if you can't cancel your service software update.

        • UpdateStatus (string) --

          The status of your service software update.

        • Description (string) --

          A description of the service software update status.

        • AutomatedUpdateDate (datetime) --

          The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

        • OptionalDeployment (boolean) --

          True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

      • DomainEndpointOptions (dict) --

        Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

        • EnforceHTTPS (boolean) --

          True to require that all traffic to the domain arrive over HTTPS.

        • TLSSecurityPolicy (string) --

          Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

          Can be one of the following values:

          • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
          • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
        • CustomEndpointEnabled (boolean) --

          Whether to enable a custom endpoint for the domain.

        • CustomEndpoint (string) --

          The fully qualified URL for the custom endpoint.

        • CustomEndpointCertificateArn (string) --

          The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

      • AdvancedSecurityOptions (dict) --

        Settings for fine-grained access control.

        • Enabled (boolean) --

          True if fine-grained access control is enabled.

        • InternalUserDatabaseEnabled (boolean) --

          True if the internal user database is enabled.

        • SAMLOptions (dict) --

          Container for information about the SAML configuration for OpenSearch Dashboards.

          • Enabled (boolean) --

            True if SAML is enabled.

          • Idp (dict) --

            Describes the SAML identity provider's information.

            • MetadataContent (string) --

              The metadata of the SAML application, in XML format.

            • EntityId (string) --

              The unique entity ID of the application in the SAML identity provider.

          • SubjectKey (string) --

            The key used for matching the SAML subject attribute.

          • RolesKey (string) --

            The key used for matching the SAML roles attribute.

          • SessionTimeoutMinutes (integer) --

            The duration, in minutes, after which a user session becomes inactive.

        • AnonymousAuthDisableDate (datetime) --

          Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

        • AnonymousAuthEnabled (boolean) --

          True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

      • AutoTuneOptions (dict) --

        Auto-Tune settings for the domain.

        • State (string) --

          The current state of Auto-Tune on the domain.

        • ErrorMessage (string) --

          Any errors that occurred while enabling or disabling Auto-Tune.

      • ChangeProgressDetails (dict) --

        Information about a configuration change happening on the domain.

        • ChangeId (string) --

          The ID of the configuration change.

        • Message (string) --

          A message corresponding to the status of the configuration change.

Exceptions

delete_inbound_connection(**kwargs)

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

See also: AWS API Documentation

Request Syntax

response = client.delete_inbound_connection(
    ConnectionId='string'
)
Parameters
ConnectionId (string) --

[REQUIRED]

The ID of the inbound connection to permanently delete.

Return type
dict
Returns
Response Syntax
{
    'Connection': {
        'LocalDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'RemoteDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'ConnectionId': 'string',
        'ConnectionStatus': {
            'StatusCode': 'PENDING_ACCEPTANCE'|'APPROVED'|'PROVISIONING'|'ACTIVE'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    The results of a DeleteInboundConnection operation. Contains details about the deleted inbound 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) --

        The unique identifier of the connection.

      • ConnectionStatus (dict) --

        The current status of the connection.

        • StatusCode (string) --

          The status code for the connection. Can be one of the following:

          • PENDING_ACCEPTANCE - Inbound connection is not yet accepted by the remote domain owner.
          • APPROVED : Inbound connection is pending acceptance by the remote domain owner.
          • PROVISIONING : Inbound connection is being provisioned.
          • ACTIVE : Inbound connection is active and ready to use.
          • 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 can no longer be used.
        • Message (string) --

          Information about the connection.

Exceptions

delete_outbound_connection(**kwargs)

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

response = client.delete_outbound_connection(
    ConnectionId='string'
)
Parameters
ConnectionId (string) --

[REQUIRED]

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

Return type
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'
        }
    }
}

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.

Exceptions

delete_package(**kwargs)

Deletes an Amazon OpenSearch Service package. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.delete_package(
    PackageID='string'
)
Parameters
PackageID (string) --

[REQUIRED]

The internal ID of the package you want to delete. Use DescribePackages to find this value.

Return type
dict
Returns
Response Syntax
{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response parameters to the DeletePackage operation.

    • PackageDetails (dict) --

      Information about the deleted package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        User-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        Current status of the package.

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • ErrorDetails (dict) --

        Additional information if the package is in an error state. Null otherwise.

        • ErrorType (string) --

          The type of error that occurred.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

delete_vpc_endpoint(**kwargs)

Deletes an Amazon OpenSearch Service-managed interface VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.delete_vpc_endpoint(
    VpcEndpointId='string'
)
Parameters
VpcEndpointId (string) --

[REQUIRED]

The unique identifier of the endpoint.

Return type
dict
Returns
Response Syntax
{
    'VpcEndpointSummary': {
        'VpcEndpointId': 'string',
        'VpcEndpointOwner': 'string',
        'DomainArn': 'string',
        'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED'
    }
}

Response Structure

  • (dict) --
    • VpcEndpointSummary (dict) --

      Information about the deleted endpoint, including its current status ( DELETING or DELETE_FAILED ).

      • VpcEndpointId (string) --

        The unique identifier of the endpoint.

      • VpcEndpointOwner (string) --

        The creator of the endpoint.

      • DomainArn (string) --

        The Amazon Resource Name (ARN) of the domain associated with the endpoint.

      • Status (string) --

        The current status of the endpoint.

Exceptions

describe_domain(**kwargs)

Describes the domain configuration for the specified Amazon OpenSearch Service domain, including the domain ID, domain service endpoint, and domain ARN.

See also: AWS API Documentation

Request Syntax

response = client.describe_domain(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

The name of the domain that you want information about.

Return type
dict
Returns
Response Syntax
{
    'DomainStatus': {
        'DomainId': 'string',
        'DomainName': 'string',
        'ARN': 'string',
        'Created': True|False,
        'Deleted': True|False,
        'Endpoint': 'string',
        'Endpoints': {
            'string': 'string'
        },
        'Processing': True|False,
        'UpgradeProcessing': True|False,
        'EngineVersion': 'string',
        'ClusterConfig': {
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'InstanceCount': 123,
            'DedicatedMasterEnabled': True|False,
            'ZoneAwarenessEnabled': True|False,
            'ZoneAwarenessConfig': {
                'AvailabilityZoneCount': 123
            },
            'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'DedicatedMasterCount': 123,
            'WarmEnabled': True|False,
            'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
            'WarmCount': 123,
            'ColdStorageOptions': {
                'Enabled': True|False
            }
        },
        'EBSOptions': {
            'EBSEnabled': True|False,
            'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
            'VolumeSize': 123,
            'Iops': 123,
            'Throughput': 123
        },
        'AccessPolicies': 'string',
        'SnapshotOptions': {
            'AutomatedSnapshotStartHour': 123
        },
        'VPCOptions': {
            'VPCId': 'string',
            'SubnetIds': [
                'string',
            ],
            'AvailabilityZones': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'CognitoOptions': {
            'Enabled': True|False,
            'UserPoolId': 'string',
            'IdentityPoolId': 'string',
            'RoleArn': 'string'
        },
        'EncryptionAtRestOptions': {
            'Enabled': True|False,
            'KmsKeyId': 'string'
        },
        'NodeToNodeEncryptionOptions': {
            'Enabled': True|False
        },
        'AdvancedOptions': {
            'string': 'string'
        },
        'LogPublishingOptions': {
            'string': {
                'CloudWatchLogsLogGroupArn': 'string',
                'Enabled': True|False
            }
        },
        'ServiceSoftwareOptions': {
            'CurrentVersion': 'string',
            'NewVersion': 'string',
            'UpdateAvailable': True|False,
            'Cancellable': True|False,
            'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
            'Description': 'string',
            'AutomatedUpdateDate': datetime(2015, 1, 1),
            'OptionalDeployment': True|False
        },
        'DomainEndpointOptions': {
            'EnforceHTTPS': True|False,
            'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
            'CustomEndpointEnabled': True|False,
            'CustomEndpoint': 'string',
            'CustomEndpointCertificateArn': 'string'
        },
        'AdvancedSecurityOptions': {
            'Enabled': True|False,
            'InternalUserDatabaseEnabled': True|False,
            'SAMLOptions': {
                'Enabled': True|False,
                'Idp': {
                    'MetadataContent': 'string',
                    'EntityId': 'string'
                },
                'SubjectKey': 'string',
                'RolesKey': 'string',
                'SessionTimeoutMinutes': 123
            },
            'AnonymousAuthDisableDate': datetime(2015, 1, 1),
            'AnonymousAuthEnabled': True|False
        },
        'AutoTuneOptions': {
            'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
            'ErrorMessage': 'string'
        },
        'ChangeProgressDetails': {
            'ChangeId': 'string',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Contains the status of the domain specified in the request.

    • DomainStatus (dict) --

      List that contains the status of each specified OpenSearch Service domain.

      • DomainId (string) --

        Unique identifier for the domain.

      • DomainName (string) --

        Name of the domain. Domain names are unique across all domains owned by the same account within an Amazon Web Services Region.

      • ARN (string) --

        The Amazon Resource Name (ARN) of the domain. For more information, see IAM identifiers in the AWS Identity and Access Management User Guide .

      • Created (boolean) --

        Creation status of an OpenSearch Service domain. True if domain creation is complete. False if domain creation is still in progress.

      • Deleted (boolean) --

        Deletion status of an OpenSearch Service domain. True if domain deletion is complete. False if domain deletion is still in progress. Once deletion is complete, the status of the domain is no longer returned.

      • Endpoint (string) --

        Domain-specific endpoint used to submit index, search, and data upload requests to the domain.

      • Endpoints (dict) --

        The key-value pair that exists if the OpenSearch Service domain uses VPC endpoints.. Example key, value : 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com' .

        • (string) --
          • (string) --

            The domain endpoint to which index and search requests are submitted. For example, search-imdb-movies-oopcnjfn6ugo.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6u.eu-west-1.es.amazonaws.com .

      • Processing (boolean) --

        The status of the domain configuration. True if OpenSearch Service is processing configuration changes. False if the configuration is active.

      • UpgradeProcessing (boolean) --

        The status of a domain version upgrade to a new version of OpenSearch or Elasticsearch. True if OpenSearch Service is in the process of a version upgrade. False if the configuration is active.

      • EngineVersion (string) --

        Version of OpenSearch or Elasticsearch that the domain is running, in the format Elasticsearch_X.Y or OpenSearch_X.Y .

      • ClusterConfig (dict) --

        Container for the cluster configuration of the domain.

        • InstanceType (string) --

          Instance type of data nodes in the cluster.

        • InstanceCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • DedicatedMasterEnabled (boolean) --

          Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

        • ZoneAwarenessEnabled (boolean) --

          Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

        • ZoneAwarenessConfig (dict) --

          Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

          • AvailabilityZoneCount (integer) --

            If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

        • DedicatedMasterType (string) --

          OpenSearch Service instance type of the dedicated master nodes in the cluster.

        • DedicatedMasterCount (integer) --

          Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

        • WarmEnabled (boolean) --

          Whether to enable warm storage for the cluster.

        • WarmType (string) --

          The instance type for the cluster's warm nodes.

        • WarmCount (integer) --

          The number of warm nodes in the cluster.

        • ColdStorageOptions (dict) --

          Container for cold storage configuration options.

          • Enabled (boolean) --

            Whether to enable or disable cold storage on the domain.

      • EBSOptions (dict) --

        Container for EBS-based storage settings for the domain.

        • EBSEnabled (boolean) --

          Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

        • VolumeType (string) --

          Specifies the type of EBS volumes attached to data nodes.

        • VolumeSize (integer) --

          Specifies the size (in GiB) of EBS volumes attached to data nodes.

        • Iops (integer) --

          Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

        • Throughput (integer) --

          Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

      • AccessPolicies (string) --

        Identity and Access Management (IAM) policy document specifying the access policies for the domain.

      • SnapshotOptions (dict) --

        DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

        • AutomatedSnapshotStartHour (integer) --

          The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

      • VPCOptions (dict) --

        The VPC configuration for the domain.

        • VPCId (string) --

          The ID for your VPC. Amazon VPC generates this value when you create a VPC.

        • SubnetIds (list) --

          A list of subnet IDs associated with the VPC endpoints for the domain.

          • (string) --
        • AvailabilityZones (list) --

          The list of Availability Zones associated with the VPC subnets.

          • (string) --
        • SecurityGroupIds (list) --

          The list of security group IDs associated with the VPC endpoints for the domain.

          • (string) --
      • CognitoOptions (dict) --

        Key-value pairs to configure Amazon Cognito authentication for OpenSearch Dashboards.

        • Enabled (boolean) --

          Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

        • UserPoolId (string) --

          The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • IdentityPoolId (string) --

          The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

        • RoleArn (string) --

          The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

      • EncryptionAtRestOptions (dict) --

        Encryption at rest settings for the domain.

        • Enabled (boolean) --

          True to enable encryption at rest.

        • KmsKeyId (string) --

          The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

      • NodeToNodeEncryptionOptions (dict) --

        Whether node-to-node encryption is enabled or disabled.

        • Enabled (boolean) --

          True to enable node-to-node encryption.

      • AdvancedOptions (dict) --

        Key-value pairs that specify advanced configuration options.

        • (string) --
          • (string) --
      • LogPublishingOptions (dict) --

        Log publishing options for the domain.

        • (string) --

          The type of log file. Can be one of the following:

          • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
          • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
          • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
          • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
          • (dict) --

            Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

            Note

            After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

            • CloudWatchLogsLogGroupArn (string) --

              The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

            • Enabled (boolean) --

              Whether the log should be published.

      • ServiceSoftwareOptions (dict) --

        The current status of the domain's service software.

        • CurrentVersion (string) --

          The current service software version present on the domain.

        • NewVersion (string) --

          The new service software version, if one is available.

        • UpdateAvailable (boolean) --

          True if you're able to update your service software version. False if you can't update your service software version.

        • Cancellable (boolean) --

          True if you're able to cancel your service software version update. False if you can't cancel your service software update.

        • UpdateStatus (string) --

          The status of your service software update.

        • Description (string) --

          A description of the service software update status.

        • AutomatedUpdateDate (datetime) --

          The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

        • OptionalDeployment (boolean) --

          True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

      • DomainEndpointOptions (dict) --

        Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

        • EnforceHTTPS (boolean) --

          True to require that all traffic to the domain arrive over HTTPS.

        • TLSSecurityPolicy (string) --

          Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

          Can be one of the following values:

          • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
          • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
        • CustomEndpointEnabled (boolean) --

          Whether to enable a custom endpoint for the domain.

        • CustomEndpoint (string) --

          The fully qualified URL for the custom endpoint.

        • CustomEndpointCertificateArn (string) --

          The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

      • AdvancedSecurityOptions (dict) --

        Settings for fine-grained access control.

        • Enabled (boolean) --

          True if fine-grained access control is enabled.

        • InternalUserDatabaseEnabled (boolean) --

          True if the internal user database is enabled.

        • SAMLOptions (dict) --

          Container for information about the SAML configuration for OpenSearch Dashboards.

          • Enabled (boolean) --

            True if SAML is enabled.

          • Idp (dict) --

            Describes the SAML identity provider's information.

            • MetadataContent (string) --

              The metadata of the SAML application, in XML format.

            • EntityId (string) --

              The unique entity ID of the application in the SAML identity provider.

          • SubjectKey (string) --

            The key used for matching the SAML subject attribute.

          • RolesKey (string) --

            The key used for matching the SAML roles attribute.

          • SessionTimeoutMinutes (integer) --

            The duration, in minutes, after which a user session becomes inactive.

        • AnonymousAuthDisableDate (datetime) --

          Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

        • AnonymousAuthEnabled (boolean) --

          True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

      • AutoTuneOptions (dict) --

        Auto-Tune settings for the domain.

        • State (string) --

          The current state of Auto-Tune on the domain.

        • ErrorMessage (string) --

          Any errors that occurred while enabling or disabling Auto-Tune.

      • ChangeProgressDetails (dict) --

        Information about a configuration change happening on the domain.

        • ChangeId (string) --

          The ID of the configuration change.

        • Message (string) --

          A message corresponding to the status of the configuration change.

Exceptions

describe_domain_auto_tunes(**kwargs)

Returns the list of optimizations that Auto-Tune has made to an Amazon OpenSearch Service domain. For more information, see Auto-Tune for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_domain_auto_tunes(
    DomainName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    Name of the domain that you want Auto-Tune details about.

  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial DescribeDomainAutoTunes operation returns a nextToken , you can include the returned nextToken in subsequent DescribeDomainAutoTunes operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'AutoTunes': [
        {
            'AutoTuneType': 'SCHEDULED_ACTION',
            'AutoTuneDetails': {
                'ScheduledAutoTuneDetails': {
                    'Date': datetime(2015, 1, 1),
                    'ActionType': 'JVM_HEAP_SIZE_TUNING'|'JVM_YOUNG_GEN_TUNING',
                    'Action': 'string',
                    'Severity': 'LOW'|'MEDIUM'|'HIGH'
                }
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    The result of a DescribeDomainAutoTunes request.

    • AutoTunes (list) --

      The list of setting adjustments that Auto-Tune has made to the domain.

      • (dict) --

        Information about an Auto-Tune action. For more information, see Auto-Tune for Amazon OpenSearch Service.

        • AutoTuneType (string) --

          The type of Auto-Tune action.

        • AutoTuneDetails (dict) --

          Details about an Auto-Tune action.

          • ScheduledAutoTuneDetails (dict) --

            Container for details about a scheduled Auto-Tune action.

            • Date (datetime) --

              The date and time when the Auto-Tune action is scheduled for the domain.

            • ActionType (string) --

              The type of Auto-Tune action.

            • Action (string) --

              A description of the Auto-Tune action.

            • Severity (string) --

              The severity of the Auto-Tune action. Valid values are LOW , MEDIUM , and HIGH .

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

Exceptions

describe_domain_change_progress(**kwargs)

Returns information about the current blue/green deployment happening on an Amazon OpenSearch Service domain. For more information, see Making configuration changes in Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_domain_change_progress(
    DomainName='string',
    ChangeId='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the domain to get progress information for.

  • ChangeId (string) -- The specific change ID for which you want to get progress information. If omitted, the request returns information about the most recent configuration change.
Return type

dict

Returns

Response Syntax

{
    'ChangeProgressStatus': {
        'ChangeId': 'string',
        'StartTime': datetime(2015, 1, 1),
        'Status': 'PENDING'|'PROCESSING'|'COMPLETED'|'FAILED',
        'PendingProperties': [
            'string',
        ],
        'CompletedProperties': [
            'string',
        ],
        'TotalNumberOfStages': 123,
        'ChangeProgressStages': [
            {
                'Name': 'string',
                'Status': 'string',
                'Description': 'string',
                'LastUpdated': datetime(2015, 1, 1)
            },
        ]
    }
}

Response Structure

  • (dict) --

    The result of a DescribeDomainChangeProgress request. Contains progress information for the requested domain change.

    • ChangeProgressStatus (dict) --

      Container for information about the stages of a configuration change happening on a domain.

      • ChangeId (string) --

        The unique change identifier associated with a specific domain configuration change.

      • StartTime (datetime) --

        The time at which the configuration change is made on the domain.

      • Status (string) --

        The overall status of the domain configuration change.

      • PendingProperties (list) --

        The list of properties in the domain configuration change that are still pending.

        • (string) --
      • CompletedProperties (list) --

        The list of properties in the domain configuration change that have completed.

        • (string) --
      • TotalNumberOfStages (integer) --

        The total number of stages required for the configuration change.

      • ChangeProgressStages (list) --

        The specific stages that the domain is going through to perform the configuration change.

        • (dict) --

          Progress details for each stage of a domain update.

          • Name (string) --

            The name of the stage.

          • Status (string) --

            The status of the stage.

          • Description (string) --

            The description of the stage.

          • LastUpdated (datetime) --

            The most recent updated timestamp of the stage.

Exceptions

describe_domain_config(**kwargs)

Returns the configuration of an Amazon OpenSearch Service domain.

See also: AWS API Documentation

Request Syntax

response = client.describe_domain_config(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

Name of the OpenSearch Service domain configuration that you want to describe.

Return type
dict
Returns
Response Syntax
{
    'DomainConfig': {
        'EngineVersion': {
            'Options': 'string',
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'ClusterConfig': {
            'Options': {
                'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'InstanceCount': 123,
                'DedicatedMasterEnabled': True|False,
                'ZoneAwarenessEnabled': True|False,
                'ZoneAwarenessConfig': {
                    'AvailabilityZoneCount': 123
                },
                'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'DedicatedMasterCount': 123,
                'WarmEnabled': True|False,
                'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
                'WarmCount': 123,
                'ColdStorageOptions': {
                    'Enabled': True|False
                }
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'EBSOptions': {
            'Options': {
                'EBSEnabled': True|False,
                'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
                'VolumeSize': 123,
                'Iops': 123,
                'Throughput': 123
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AccessPolicies': {
            'Options': 'string',
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'SnapshotOptions': {
            'Options': {
                'AutomatedSnapshotStartHour': 123
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'VPCOptions': {
            'Options': {
                'VPCId': 'string',
                'SubnetIds': [
                    'string',
                ],
                'AvailabilityZones': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ]
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'CognitoOptions': {
            'Options': {
                'Enabled': True|False,
                'UserPoolId': 'string',
                'IdentityPoolId': 'string',
                'RoleArn': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'EncryptionAtRestOptions': {
            'Options': {
                'Enabled': True|False,
                'KmsKeyId': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'NodeToNodeEncryptionOptions': {
            'Options': {
                'Enabled': True|False
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AdvancedOptions': {
            'Options': {
                'string': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'LogPublishingOptions': {
            'Options': {
                'string': {
                    'CloudWatchLogsLogGroupArn': 'string',
                    'Enabled': True|False
                }
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'DomainEndpointOptions': {
            'Options': {
                'EnforceHTTPS': True|False,
                'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
                'CustomEndpointEnabled': True|False,
                'CustomEndpoint': 'string',
                'CustomEndpointCertificateArn': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AdvancedSecurityOptions': {
            'Options': {
                'Enabled': True|False,
                'InternalUserDatabaseEnabled': True|False,
                'SAMLOptions': {
                    'Enabled': True|False,
                    'Idp': {
                        'MetadataContent': 'string',
                        'EntityId': 'string'
                    },
                    'SubjectKey': 'string',
                    'RolesKey': 'string',
                    'SessionTimeoutMinutes': 123
                },
                'AnonymousAuthDisableDate': datetime(2015, 1, 1),
                'AnonymousAuthEnabled': True|False
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AutoTuneOptions': {
            'Options': {
                'DesiredState': 'ENABLED'|'DISABLED',
                'RollbackOnDisable': 'NO_ROLLBACK'|'DEFAULT_ROLLBACK',
                'MaintenanceSchedules': [
                    {
                        'StartAt': datetime(2015, 1, 1),
                        'Duration': {
                            'Value': 123,
                            'Unit': 'HOURS'
                        },
                        'CronExpressionForRecurrence': 'string'
                    },
                ]
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
                'ErrorMessage': 'string',
                'PendingDeletion': True|False
            }
        },
        'ChangeProgressDetails': {
            'ChangeId': 'string',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Contains the configuration information of the requested domain.

    • DomainConfig (dict) --

      Container for the configuration of the OpenSearch Service domain.

      • EngineVersion (dict) --

        The OpenSearch or Elasticsearch version that the domain is running.

        • Options (string) --

          The OpenSearch or Elasticsearch version for the specified domain.

        • Status (dict) --

          The status of the version options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • ClusterConfig (dict) --

        Container for the cluster configuration of a the domain.

        • Options (dict) --

          Cluster configuration options for the specified domain.

          • InstanceType (string) --

            Instance type of data nodes in the cluster.

          • InstanceCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • DedicatedMasterEnabled (boolean) --

            Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

          • ZoneAwarenessEnabled (boolean) --

            Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

          • ZoneAwarenessConfig (dict) --

            Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

            • AvailabilityZoneCount (integer) --

              If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

          • DedicatedMasterType (string) --

            OpenSearch Service instance type of the dedicated master nodes in the cluster.

          • DedicatedMasterCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • WarmEnabled (boolean) --

            Whether to enable warm storage for the cluster.

          • WarmType (string) --

            The instance type for the cluster's warm nodes.

          • WarmCount (integer) --

            The number of warm nodes in the cluster.

          • ColdStorageOptions (dict) --

            Container for cold storage configuration options.

            • Enabled (boolean) --

              Whether to enable or disable cold storage on the domain.

        • Status (dict) --

          The status of cluster configuration options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • EBSOptions (dict) --

        Container for EBS options configured for an OpenSearch Service domain.

        • Options (dict) --

          The configured EBS options for the specified domain.

          • EBSEnabled (boolean) --

            Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

          • VolumeType (string) --

            Specifies the type of EBS volumes attached to data nodes.

          • VolumeSize (integer) --

            Specifies the size (in GiB) of EBS volumes attached to data nodes.

          • Iops (integer) --

            Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

          • Throughput (integer) --

            Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

        • Status (dict) --

          The status of the EBS options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AccessPolicies (dict) --

        Specifies the access policies for the domain.

        • Options (string) --

          The access policy configured for the domain. Access policies can be resource-based, IP-based, or IAM-based. For more information, see Configuring access policies.

        • Status (dict) --

          The status of the access policy for the domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • SnapshotOptions (dict) --

        DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

        • Options (dict) --

          The daily snapshot options specified for the domain.

          • AutomatedSnapshotStartHour (integer) --

            The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

        • Status (dict) --

          The status of a daily automated snapshot.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • VPCOptions (dict) --

        The current VPC options for the domain and the status of any updates to their configuration.

        • Options (dict) --

          The VPC options for the specified domain.

          • VPCId (string) --

            The ID for your VPC. Amazon VPC generates this value when you create a VPC.

          • SubnetIds (list) --

            A list of subnet IDs associated with the VPC endpoints for the domain.

            • (string) --
          • AvailabilityZones (list) --

            The list of Availability Zones associated with the VPC subnets.

            • (string) --
          • SecurityGroupIds (list) --

            The list of security group IDs associated with the VPC endpoints for the domain.

            • (string) --
        • Status (dict) --

          The status of the VPC options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • CognitoOptions (dict) --

        Container for Amazon Cognito options for the domain.

        • Options (dict) --

          Cognito options for the specified domain.

          • Enabled (boolean) --

            Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

          • UserPoolId (string) --

            The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • IdentityPoolId (string) --

            The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • RoleArn (string) --

            The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

        • Status (dict) --

          The status of the Cognito options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • EncryptionAtRestOptions (dict) --

        Key-value pairs to enable encryption at rest.

        • Options (dict) --

          Encryption at rest options for the specified domain.

          • Enabled (boolean) --

            True to enable encryption at rest.

          • KmsKeyId (string) --

            The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

        • Status (dict) --

          The status of the encryption at rest options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • NodeToNodeEncryptionOptions (dict) --

        Whether node-to-node encryption is enabled or disabled.

        • Options (dict) --

          The node-to-node encryption options for the specified domain.

          • Enabled (boolean) --

            True to enable node-to-node encryption.

        • Status (dict) --

          The status of the node-to-node encryption options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AdvancedOptions (dict) --

        Key-value pairs to specify advanced configuration options. For more information, see Advanced options.

        • Options (dict) --

          The status of advanced options for the specified domain.

          • (string) --
            • (string) --
        • Status (dict) --

          The status of advanced options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • LogPublishingOptions (dict) --

        Key-value pairs to configure slow log publishing.

        • Options (dict) --

          The log publishing options configured for the domain.

          • (string) --

            The type of log file. Can be one of the following:

            • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
            • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
            • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
            • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
            • (dict) --

              Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

              Note

              After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

              • CloudWatchLogsLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

              • Enabled (boolean) --

                Whether the log should be published.

        • Status (dict) --

          The status of the log publishing options for the domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • DomainEndpointOptions (dict) --

        Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

        • Options (dict) --

          Options to configure the endpoint for a domain.

          • EnforceHTTPS (boolean) --

            True to require that all traffic to the domain arrive over HTTPS.

          • TLSSecurityPolicy (string) --

            Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

            Can be one of the following values:

            • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
            • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
          • CustomEndpointEnabled (boolean) --

            Whether to enable a custom endpoint for the domain.

          • CustomEndpoint (string) --

            The fully qualified URL for the custom endpoint.

          • CustomEndpointCertificateArn (string) --

            The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

        • Status (dict) --

          The status of the endpoint options for a domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AdvancedSecurityOptions (dict) --

        Container for fine-grained access control settings for the domain.

        • Options (dict) --

          Container for fine-grained access control settings.

          • Enabled (boolean) --

            True if fine-grained access control is enabled.

          • InternalUserDatabaseEnabled (boolean) --

            True if the internal user database is enabled.

          • SAMLOptions (dict) --

            Container for information about the SAML configuration for OpenSearch Dashboards.

            • Enabled (boolean) --

              True if SAML is enabled.

            • Idp (dict) --

              Describes the SAML identity provider's information.

              • MetadataContent (string) --

                The metadata of the SAML application, in XML format.

              • EntityId (string) --

                The unique entity ID of the application in the SAML identity provider.

            • SubjectKey (string) --

              The key used for matching the SAML subject attribute.

            • RolesKey (string) --

              The key used for matching the SAML roles attribute.

            • SessionTimeoutMinutes (integer) --

              The duration, in minutes, after which a user session becomes inactive.

          • AnonymousAuthDisableDate (datetime) --

            Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

          • AnonymousAuthEnabled (boolean) --

            True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

        • Status (dict) --

          Status of the fine-grained access control settings for a domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AutoTuneOptions (dict) --

        Container for Auto-Tune settings for the domain.

        • Options (dict) --

          Auto-Tune settings for updating a domain.

          • DesiredState (string) --

            Whether Auto-Tune is enabled or disabled.

          • RollbackOnDisable (string) --

            When disabling Auto-Tune, specify NO_ROLLBACK to retain all prior Auto-Tune settings or DEFAULT_ROLLBACK to revert to the OpenSearch Service defaults. If you specify DEFAULT_ROLLBACK , you must include a MaintenanceSchedule in the request. Otherwise, OpenSearch Service is unable to perform the rollback.

          • MaintenanceSchedules (list) --

            A list of maintenance schedules during which Auto-Tune can deploy changes.

            • (dict) --

              The Auto-Tune maintenance schedule. For more information, see Auto-Tune for Amazon OpenSearch Service.

              • StartAt (datetime) --

                The Epoch timestamp at which the Auto-Tune maintenance schedule starts.

              • Duration (dict) --

                The duration of the maintenance schedule. For example, "Duration": {"Value": 2, "Unit": "HOURS"} .

                • Value (integer) --

                  Integer to specify the value of a maintenance schedule duration.

                • Unit (string) --

                  The unit of measurement for the duration of a maintenance schedule.

              • CronExpressionForRecurrence (string) --

                A cron expression for a recurring maintenance schedule during which Auto-Tune can deploy changes.

        • Status (dict) --

          The current status of Auto-Tune for a domain.

          • CreationDate (datetime) --

            Date and time when Auto-Tune was enabled for the domain.

          • UpdateDate (datetime) --

            Date and time when the Auto-Tune options were last updated for the domain.

          • UpdateVersion (integer) --

            The latest version of the Auto-Tune options.

          • State (string) --

            The current state of Auto-Tune on the domain.

          • ErrorMessage (string) --

            Any errors that occurred while enabling or disabling Auto-Tune.

          • PendingDeletion (boolean) --

            Indicates whether the domain is being deleted.

      • ChangeProgressDetails (dict) --

        Container for information about the progress of an existing configuration change.

        • ChangeId (string) --

          The ID of the configuration change.

        • Message (string) --

          A message corresponding to the status of the configuration change.

Exceptions

describe_domains(**kwargs)

Returns domain configuration information about the specified Amazon OpenSearch Service domains.

See also: AWS API Documentation

Request Syntax

response = client.describe_domains(
    DomainNames=[
        'string',
    ]
)
Parameters
DomainNames (list) --

[REQUIRED]

Array of OpenSearch Service domain names that you want information about. If you don't specify any domains, OpenSearch Service returns information about all domains owned by the account.

  • (string) --

    The name of an OpenSearch Service domain. Domain names are unique across the domains owned by an account within an Amazon Web Services Region.

Return type
dict
Returns
Response Syntax
{
    'DomainStatusList': [
        {
            'DomainId': 'string',
            'DomainName': 'string',
            'ARN': 'string',
            'Created': True|False,
            'Deleted': True|False,
            'Endpoint': 'string',
            'Endpoints': {
                'string': 'string'
            },
            'Processing': True|False,
            'UpgradeProcessing': True|False,
            'EngineVersion': 'string',
            'ClusterConfig': {
                'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'InstanceCount': 123,
                'DedicatedMasterEnabled': True|False,
                'ZoneAwarenessEnabled': True|False,
                'ZoneAwarenessConfig': {
                    'AvailabilityZoneCount': 123
                },
                'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'DedicatedMasterCount': 123,
                'WarmEnabled': True|False,
                'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
                'WarmCount': 123,
                'ColdStorageOptions': {
                    'Enabled': True|False
                }
            },
            'EBSOptions': {
                'EBSEnabled': True|False,
                'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
                'VolumeSize': 123,
                'Iops': 123,
                'Throughput': 123
            },
            'AccessPolicies': 'string',
            'SnapshotOptions': {
                'AutomatedSnapshotStartHour': 123
            },
            'VPCOptions': {
                'VPCId': 'string',
                'SubnetIds': [
                    'string',
                ],
                'AvailabilityZones': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ]
            },
            'CognitoOptions': {
                'Enabled': True|False,
                'UserPoolId': 'string',
                'IdentityPoolId': 'string',
                'RoleArn': 'string'
            },
            'EncryptionAtRestOptions': {
                'Enabled': True|False,
                'KmsKeyId': 'string'
            },
            'NodeToNodeEncryptionOptions': {
                'Enabled': True|False
            },
            'AdvancedOptions': {
                'string': 'string'
            },
            'LogPublishingOptions': {
                'string': {
                    'CloudWatchLogsLogGroupArn': 'string',
                    'Enabled': True|False
                }
            },
            'ServiceSoftwareOptions': {
                'CurrentVersion': 'string',
                'NewVersion': 'string',
                'UpdateAvailable': True|False,
                'Cancellable': True|False,
                'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
                'Description': 'string',
                'AutomatedUpdateDate': datetime(2015, 1, 1),
                'OptionalDeployment': True|False
            },
            'DomainEndpointOptions': {
                'EnforceHTTPS': True|False,
                'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
                'CustomEndpointEnabled': True|False,
                'CustomEndpoint': 'string',
                'CustomEndpointCertificateArn': 'string'
            },
            'AdvancedSecurityOptions': {
                'Enabled': True|False,
                'InternalUserDatabaseEnabled': True|False,
                'SAMLOptions': {
                    'Enabled': True|False,
                    'Idp': {
                        'MetadataContent': 'string',
                        'EntityId': 'string'
                    },
                    'SubjectKey': 'string',
                    'RolesKey': 'string',
                    'SessionTimeoutMinutes': 123
                },
                'AnonymousAuthDisableDate': datetime(2015, 1, 1),
                'AnonymousAuthEnabled': True|False
            },
            'AutoTuneOptions': {
                'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
                'ErrorMessage': 'string'
            },
            'ChangeProgressDetails': {
                'ChangeId': 'string',
                'Message': 'string'
            }
        },
    ]
}

Response Structure

  • (dict) --

    Contains the status of the specified domains or all domains owned by the account.

    • DomainStatusList (list) --

      The status of the requested domains.

      • (dict) --

        The current status of an OpenSearch Service domain.

        • DomainId (string) --

          Unique identifier for the domain.

        • DomainName (string) --

          Name of the domain. Domain names are unique across all domains owned by the same account within an Amazon Web Services Region.

        • ARN (string) --

          The Amazon Resource Name (ARN) of the domain. For more information, see IAM identifiers in the AWS Identity and Access Management User Guide .

        • Created (boolean) --

          Creation status of an OpenSearch Service domain. True if domain creation is complete. False if domain creation is still in progress.

        • Deleted (boolean) --

          Deletion status of an OpenSearch Service domain. True if domain deletion is complete. False if domain deletion is still in progress. Once deletion is complete, the status of the domain is no longer returned.

        • Endpoint (string) --

          Domain-specific endpoint used to submit index, search, and data upload requests to the domain.

        • Endpoints (dict) --

          The key-value pair that exists if the OpenSearch Service domain uses VPC endpoints.. Example key, value : 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com' .

          • (string) --
            • (string) --

              The domain endpoint to which index and search requests are submitted. For example, search-imdb-movies-oopcnjfn6ugo.eu-west-1.es.amazonaws.com or doc-imdb-movies-oopcnjfn6u.eu-west-1.es.amazonaws.com .

        • Processing (boolean) --

          The status of the domain configuration. True if OpenSearch Service is processing configuration changes. False if the configuration is active.

        • UpgradeProcessing (boolean) --

          The status of a domain version upgrade to a new version of OpenSearch or Elasticsearch. True if OpenSearch Service is in the process of a version upgrade. False if the configuration is active.

        • EngineVersion (string) --

          Version of OpenSearch or Elasticsearch that the domain is running, in the format Elasticsearch_X.Y or OpenSearch_X.Y .

        • ClusterConfig (dict) --

          Container for the cluster configuration of the domain.

          • InstanceType (string) --

            Instance type of data nodes in the cluster.

          • InstanceCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • DedicatedMasterEnabled (boolean) --

            Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

          • ZoneAwarenessEnabled (boolean) --

            Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

          • ZoneAwarenessConfig (dict) --

            Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

            • AvailabilityZoneCount (integer) --

              If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

          • DedicatedMasterType (string) --

            OpenSearch Service instance type of the dedicated master nodes in the cluster.

          • DedicatedMasterCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • WarmEnabled (boolean) --

            Whether to enable warm storage for the cluster.

          • WarmType (string) --

            The instance type for the cluster's warm nodes.

          • WarmCount (integer) --

            The number of warm nodes in the cluster.

          • ColdStorageOptions (dict) --

            Container for cold storage configuration options.

            • Enabled (boolean) --

              Whether to enable or disable cold storage on the domain.

        • EBSOptions (dict) --

          Container for EBS-based storage settings for the domain.

          • EBSEnabled (boolean) --

            Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

          • VolumeType (string) --

            Specifies the type of EBS volumes attached to data nodes.

          • VolumeSize (integer) --

            Specifies the size (in GiB) of EBS volumes attached to data nodes.

          • Iops (integer) --

            Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

          • Throughput (integer) --

            Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

        • AccessPolicies (string) --

          Identity and Access Management (IAM) policy document specifying the access policies for the domain.

        • SnapshotOptions (dict) --

          DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

          • AutomatedSnapshotStartHour (integer) --

            The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

        • VPCOptions (dict) --

          The VPC configuration for the domain.

          • VPCId (string) --

            The ID for your VPC. Amazon VPC generates this value when you create a VPC.

          • SubnetIds (list) --

            A list of subnet IDs associated with the VPC endpoints for the domain.

            • (string) --
          • AvailabilityZones (list) --

            The list of Availability Zones associated with the VPC subnets.

            • (string) --
          • SecurityGroupIds (list) --

            The list of security group IDs associated with the VPC endpoints for the domain.

            • (string) --
        • CognitoOptions (dict) --

          Key-value pairs to configure Amazon Cognito authentication for OpenSearch Dashboards.

          • Enabled (boolean) --

            Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

          • UserPoolId (string) --

            The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • IdentityPoolId (string) --

            The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • RoleArn (string) --

            The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

        • EncryptionAtRestOptions (dict) --

          Encryption at rest settings for the domain.

          • Enabled (boolean) --

            True to enable encryption at rest.

          • KmsKeyId (string) --

            The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

        • NodeToNodeEncryptionOptions (dict) --

          Whether node-to-node encryption is enabled or disabled.

          • Enabled (boolean) --

            True to enable node-to-node encryption.

        • AdvancedOptions (dict) --

          Key-value pairs that specify advanced configuration options.

          • (string) --
            • (string) --
        • LogPublishingOptions (dict) --

          Log publishing options for the domain.

          • (string) --

            The type of log file. Can be one of the following:

            • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
            • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
            • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
            • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
            • (dict) --

              Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

              Note

              After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

              • CloudWatchLogsLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

              • Enabled (boolean) --

                Whether the log should be published.

        • ServiceSoftwareOptions (dict) --

          The current status of the domain's service software.

          • CurrentVersion (string) --

            The current service software version present on the domain.

          • NewVersion (string) --

            The new service software version, if one is available.

          • UpdateAvailable (boolean) --

            True if you're able to update your service software version. False if you can't update your service software version.

          • Cancellable (boolean) --

            True if you're able to cancel your service software version update. False if you can't cancel your service software update.

          • UpdateStatus (string) --

            The status of your service software update.

          • Description (string) --

            A description of the service software update status.

          • AutomatedUpdateDate (datetime) --

            The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

          • OptionalDeployment (boolean) --

            True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

        • DomainEndpointOptions (dict) --

          Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

          • EnforceHTTPS (boolean) --

            True to require that all traffic to the domain arrive over HTTPS.

          • TLSSecurityPolicy (string) --

            Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

            Can be one of the following values:

            • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
            • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
          • CustomEndpointEnabled (boolean) --

            Whether to enable a custom endpoint for the domain.

          • CustomEndpoint (string) --

            The fully qualified URL for the custom endpoint.

          • CustomEndpointCertificateArn (string) --

            The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

        • AdvancedSecurityOptions (dict) --

          Settings for fine-grained access control.

          • Enabled (boolean) --

            True if fine-grained access control is enabled.

          • InternalUserDatabaseEnabled (boolean) --

            True if the internal user database is enabled.

          • SAMLOptions (dict) --

            Container for information about the SAML configuration for OpenSearch Dashboards.

            • Enabled (boolean) --

              True if SAML is enabled.

            • Idp (dict) --

              Describes the SAML identity provider's information.

              • MetadataContent (string) --

                The metadata of the SAML application, in XML format.

              • EntityId (string) --

                The unique entity ID of the application in the SAML identity provider.

            • SubjectKey (string) --

              The key used for matching the SAML subject attribute.

            • RolesKey (string) --

              The key used for matching the SAML roles attribute.

            • SessionTimeoutMinutes (integer) --

              The duration, in minutes, after which a user session becomes inactive.

          • AnonymousAuthDisableDate (datetime) --

            Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

          • AnonymousAuthEnabled (boolean) --

            True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

        • AutoTuneOptions (dict) --

          Auto-Tune settings for the domain.

          • State (string) --

            The current state of Auto-Tune on the domain.

          • ErrorMessage (string) --

            Any errors that occurred while enabling or disabling Auto-Tune.

        • ChangeProgressDetails (dict) --

          Information about a configuration change happening on the domain.

          • ChangeId (string) --

            The ID of the configuration change.

          • Message (string) --

            A message corresponding to the status of the configuration change.

Exceptions

describe_inbound_connections(**kwargs)

Lists all the inbound cross-cluster search connections for a destination (remote) Amazon OpenSearch Service domain. For more information, see Cross-cluster search for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_inbound_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 connections.

    • (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) --
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial DescribeInboundConnections operation returns a nextToken , you can include the returned nextToken in subsequent DescribeInboundConnections operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'Connections': [
        {
            'LocalDomainInfo': {
                'AWSDomainInformation': {
                    'OwnerId': 'string',
                    'DomainName': 'string',
                    'Region': 'string'
                }
            },
            'RemoteDomainInfo': {
                'AWSDomainInformation': {
                    'OwnerId': 'string',
                    'DomainName': 'string',
                    'Region': 'string'
                }
            },
            'ConnectionId': 'string',
            'ConnectionStatus': {
                'StatusCode': 'PENDING_ACCEPTANCE'|'APPROVED'|'PROVISIONING'|'ACTIVE'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
                'Message': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Contains a list of connections matching the filter criteria.

    • Connections (list) --

      List of inbound connections.

      • (dict) --

        Describes an inbound cross-cluster connection for Amazon OpenSearch Service. For more information, see Cross-cluster search for Amazon OpenSearch Service.

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

          The unique identifier of the connection.

        • ConnectionStatus (dict) --

          The current status of the connection.

          • StatusCode (string) --

            The status code for the connection. Can be one of the following:

            • PENDING_ACCEPTANCE - Inbound connection is not yet accepted by the remote domain owner.
            • APPROVED : Inbound connection is pending acceptance by the remote domain owner.
            • PROVISIONING : Inbound connection is being provisioned.
            • ACTIVE : Inbound connection is active and ready to use.
            • 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 can no longer be used.
          • Message (string) --

            Information about the 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.

Exceptions

describe_instance_type_limits(**kwargs)

Describes the instance count, storage, and master node limits for a given OpenSearch or Elasticsearch version and instance type.

See also: AWS API Documentation

Request Syntax

response = client.describe_instance_type_limits(
    DomainName='string',
    InstanceType='m3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
    EngineVersion='string'
)
Parameters
  • DomainName (string) -- The name of the domain. Only specify if you need the limits for an existing domain.
  • InstanceType (string) --

    [REQUIRED]

    The OpenSearch Service instance type for which you need limit information.

  • EngineVersion (string) --

    [REQUIRED]

    Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

Return type

dict

Returns

Response Syntax

{
    'LimitsByRole': {
        'string': {
            'StorageTypes': [
                {
                    'StorageTypeName': 'string',
                    'StorageSubTypeName': 'string',
                    'StorageTypeLimits': [
                        {
                            'LimitName': 'string',
                            'LimitValues': [
                                'string',
                            ]
                        },
                    ]
                },
            ],
            'InstanceLimits': {
                'InstanceCountLimits': {
                    'MinimumInstanceCount': 123,
                    'MaximumInstanceCount': 123
                }
            },
            'AdditionalLimits': [
                {
                    'LimitName': 'string',
                    'LimitValues': [
                        'string',
                    ]
                },
            ]
        }
    }
}

Response Structure

  • (dict) --

    Container for the parameters received from the DescribeInstanceTypeLimits operation.

    • LimitsByRole (dict) --

      Map that contains all applicable instance type limits. data refers to data nodes. master refers to dedicated master nodes.

      • (string) --

        • (dict) --

          Limits for a given instance type and for each of its roles.

          • StorageTypes (list) --

            Storage-related attributes that are available for a given instance type.

            • (dict) --

              A list of storage types for an Amazon OpenSearch Service domain that are available for a given intance type.

              • StorageTypeName (string) --

                The name of the storage type.

              • StorageSubTypeName (string) --

                The storage sub-type, such as gp3 or io1 .

              • StorageTypeLimits (list) --

                Limits that are applicable for the given storage type.

                • (dict) --

                  Limits that are applicable for the given Amazon OpenSearch Service storage type.

                  • LimitName (string) --

                    Name of storage limits that are applicable for the given storage type. If StorageType is ebs , the following options are available:

                    • MinimumVolumeSize - Minimum volume size that is available for the given storage type. Can be empty if not applicable.
                    • MaximumVolumeSize - Maximum volume size that is available for the given storage type. Can be empty if not applicable.
                    • MaximumIops - Maximum amount of IOPS that is available for the given the storage type. Can be empty if not applicable.
                    • MinimumIops - Minimum amount of IOPS that is available for the given the storage type. Can be empty if not applicable.
                    • MaximumThroughput - Maximum amount of throughput that is available for the given the storage type. Can be empty if not applicable.
                    • MinimumThroughput - Minimum amount of throughput that is available for the given the storage type. Can be empty if not applicable.
                  • LimitValues (list) --

                    The limit values.

                    • (string) --
          • InstanceLimits (dict) --

            The limits for a given instance type.

            • InstanceCountLimits (dict) --

              Limits on the number of instances that can be created for a given instance type.

              • MinimumInstanceCount (integer) --

                The maximum allowed number of instances.

              • MaximumInstanceCount (integer) --

                The minimum allowed number of instances.

          • AdditionalLimits (list) --

            List of additional limits that are specific to a given instance type for each of its instance roles.

            • (dict) --

              List of limits that are specific to a given instance type.

              • LimitName (string) --

                • MaximumNumberOfDataNodesSupported - This attribute only applies to master nodes and specifies the maximum number of data nodes of a given instance type a master node can support.
                • MaximumNumberOfDataNodesWithoutMasterNode - This attribute only applies to data nodes and specifies the maximum number of data nodes of a given instance type can exist without a master node governing them.
              • LimitValues (list) --

                The values of the additional instance type limits.

                • (string) --

Exceptions

describe_outbound_connections(**kwargs)

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

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

    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) --
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- 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.
Return type

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'
            }
        },
    ],
    '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.

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

Exceptions

describe_packages(**kwargs)

Describes all packages available to OpenSearch Service. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_packages(
    Filters=[
        {
            'Name': 'PackageID'|'PackageName'|'PackageStatus',
            'Value': [
                'string',
            ]
        },
    ],
    MaxResults=123,
    NextToken='string'
)
Parameters
  • Filters (list) --

    Only returns packages that match the DescribePackagesFilterList values.

    • (dict) --

      A filter to apply to the DescribePackage response.

      • Name (string) --

        Any field from PackageDetails .

      • Value (list) --

        A list of values for the specified filter field.

        • (string) --
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial DescribePackageFilters operation returns a nextToken , you can include the returned nextToken in subsequent DescribePackageFilters operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'PackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY',
            'PackageDescription': 'string',
            'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
            'CreatedAt': datetime(2015, 1, 1),
            'LastUpdatedAt': datetime(2015, 1, 1),
            'AvailablePackageVersion': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response returned by the DescribePackages operation.

    • PackageDetailsList (list) --

      Basic information about a package.

      • (dict) --

        Basic information about a package.

        • PackageID (string) --

          The unique identifier of the package.

        • PackageName (string) --

          User-specified name of the package.

        • PackageType (string) --

          The type of package.

        • PackageDescription (string) --

          User-specified description of the package.

        • PackageStatus (string) --

          Current status of the package.

        • CreatedAt (datetime) --

          The timestamp when the package was created.

        • LastUpdatedAt (datetime) --

          Date and time when the package was last updated.

        • AvailablePackageVersion (string) --

          The package version.

        • ErrorDetails (dict) --

          Additional information if the package is in an error state. Null otherwise.

          • ErrorType (string) --

            The type of error that occurred.

          • ErrorMessage (string) --

            A message describing the error.

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

Exceptions

describe_reserved_instance_offerings(**kwargs)

Describes the available Amazon OpenSearch Service Reserved Instance offerings for a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_reserved_instance_offerings(
    ReservedInstanceOfferingId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ReservedInstanceOfferingId (string) -- The Reserved Instance identifier filter value. Use this parameter to show only the available instance types that match the specified reservation identifier.
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial DescribeReservedInstanceOfferings operation returns a nextToken , you can include the returned nextToken in subsequent DescribeReservedInstanceOfferings operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'ReservedInstanceOfferings': [
        {
            'ReservedInstanceOfferingId': 'string',
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'Duration': 123,
            'FixedPrice': 123.0,
            'UsagePrice': 123.0,
            'CurrencyCode': 'string',
            'PaymentOption': 'ALL_UPFRONT'|'PARTIAL_UPFRONT'|'NO_UPFRONT',
            'RecurringCharges': [
                {
                    'RecurringChargeAmount': 123.0,
                    'RecurringChargeFrequency': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    Container for results of a DescribeReservedInstanceOfferings request.

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

    • ReservedInstanceOfferings (list) --

      List of Reserved Instance offerings.

      • (dict) --

        Details of an OpenSearch Reserved Instance offering.

        • ReservedInstanceOfferingId (string) --

          The unique identifier of the Reserved Instance offering.

        • InstanceType (string) --

          The OpenSearch instance type offered by the Reserved Instance offering.

        • Duration (integer) --

          The duration, in seconds, for which the offering will reserve the OpenSearch instance.

        • FixedPrice (float) --

          The upfront fixed charge you will pay to purchase the specific Reserved Instance offering.

        • UsagePrice (float) --

          The hourly rate at which you're charged for the domain using this Reserved Instance.

        • CurrencyCode (string) --

          The currency code for the Reserved Instance offering.

        • PaymentOption (string) --

          Payment option for the Reserved Instance offering

        • RecurringCharges (list) --

          The recurring charge to your account, regardless of whether you creates any domains using the offering.

          • (dict) --

            Contains the specific price and frequency of a recurring charges for an OpenSearch Reserved Instance, or for a Reserved Instance offering.

            • RecurringChargeAmount (float) --

              The monetary amount of the recurring charge.

            • RecurringChargeFrequency (string) --

              The frequency of the recurring charge.

Exceptions

describe_reserved_instances(**kwargs)

Describes the Amazon OpenSearch Service instances that you have reserved in a given Region. For more information, see Reserved Instances in Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.describe_reserved_instances(
    ReservedInstanceId='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • ReservedInstanceId (string) -- The reserved instance identifier filter value. Use this parameter to show only the reservation that matches the specified reserved OpenSearch instance ID.
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial DescribeReservedInstances operation returns a nextToken , you can include the returned nextToken in subsequent DescribeReservedInstances operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'NextToken': 'string',
    'ReservedInstances': [
        {
            'ReservationName': 'string',
            'ReservedInstanceId': 'string',
            'BillingSubscriptionId': 123,
            'ReservedInstanceOfferingId': 'string',
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'StartTime': datetime(2015, 1, 1),
            'Duration': 123,
            'FixedPrice': 123.0,
            'UsagePrice': 123.0,
            'CurrencyCode': 'string',
            'InstanceCount': 123,
            'State': 'string',
            'PaymentOption': 'ALL_UPFRONT'|'PARTIAL_UPFRONT'|'NO_UPFRONT',
            'RecurringCharges': [
                {
                    'RecurringChargeAmount': 123.0,
                    'RecurringChargeFrequency': 'string'
                },
            ]
        },
    ]
}

Response Structure

  • (dict) --

    Container for results from DescribeReservedInstances

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

    • ReservedInstances (list) --

      List of Reserved Instances in the current Region.

      • (dict) --

        Details of an OpenSearch Reserved Instance.

        • ReservationName (string) --

          The customer-specified identifier to track this reservation.

        • ReservedInstanceId (string) --

          The unique identifier for the reservation.

        • BillingSubscriptionId (integer) --

          The unique identifier of the billing subscription.

        • ReservedInstanceOfferingId (string) --

          The unique identifier of the Reserved Instance offering.

        • InstanceType (string) --

          The OpenSearch instance type offered by theReserved Instance offering.

        • StartTime (datetime) --

          The date and time when the reservation was purchased.

        • Duration (integer) --

          The duration, in seconds, for which the OpenSearch instance is reserved.

        • FixedPrice (float) --

          The upfront fixed charge you will paid to purchase the specific Reserved Instance offering.

        • UsagePrice (float) --

          The hourly rate at which you're charged for the domain using this Reserved Instance.

        • CurrencyCode (string) --

          The currency code for the offering.

        • InstanceCount (integer) --

          The number of OpenSearch instances that have been reserved.

        • State (string) --

          The state of the Reserved Instance.

        • PaymentOption (string) --

          The payment option as defined in the Reserved Instance offering.

        • RecurringCharges (list) --

          The recurring charge to your account, regardless of whether you create any domains using the Reserved Instance offering.

          • (dict) --

            Contains the specific price and frequency of a recurring charges for an OpenSearch Reserved Instance, or for a Reserved Instance offering.

            • RecurringChargeAmount (float) --

              The monetary amount of the recurring charge.

            • RecurringChargeFrequency (string) --

              The frequency of the recurring charge.

Exceptions

describe_vpc_endpoints(**kwargs)

Describes one or more Amazon OpenSearch Service-managed VPC endpoints.

See also: AWS API Documentation

Request Syntax

response = client.describe_vpc_endpoints(
    VpcEndpointIds=[
        'string',
    ]
)
Parameters
VpcEndpointIds (list) --

[REQUIRED]

The unique identifiers of the endpoints to get information about.

  • (string) --
Return type
dict
Returns
Response Syntax
{
    'VpcEndpoints': [
        {
            'VpcEndpointId': 'string',
            'VpcEndpointOwner': 'string',
            'DomainArn': 'string',
            'VpcOptions': {
                'VPCId': 'string',
                'SubnetIds': [
                    'string',
                ],
                'AvailabilityZones': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ]
            },
            'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED',
            'Endpoint': 'string'
        },
    ],
    'VpcEndpointErrors': [
        {
            'VpcEndpointId': 'string',
            'ErrorCode': 'ENDPOINT_NOT_FOUND'|'SERVER_ERROR',
            'ErrorMessage': 'string'
        },
    ]
}

Response Structure

  • (dict) --
    • VpcEndpoints (list) --

      Information about each requested VPC endpoint.

      • (dict) --

        The connection endpoint for connecting to an Amazon OpenSearch Service domain through a proxy.

        • VpcEndpointId (string) --

          The unique identifier of the endpoint.

        • VpcEndpointOwner (string) --

          The creator of the endpoint.

        • DomainArn (string) --

          The Amazon Resource Name (ARN) of the domain associated with the endpoint.

        • VpcOptions (dict) --

          Options to specify the subnets and security groups for an Amazon OpenSearch Service VPC endpoint.

          • VPCId (string) --

            The ID for your VPC. Amazon VPC generates this value when you create a VPC.

          • SubnetIds (list) --

            A list of subnet IDs associated with the VPC endpoints for the domain.

            • (string) --
          • AvailabilityZones (list) --

            The list of Availability Zones associated with the VPC subnets.

            • (string) --
          • SecurityGroupIds (list) --

            The list of security group IDs associated with the VPC endpoints for the domain.

            • (string) --
        • Status (string) --

          The current status of the endpoint.

        • Endpoint (string) --

          The connection endpoint ID for connecting to the domain.

    • VpcEndpointErrors (list) --

      Any errors associated with the request.

      • (dict) --

        Error information when attempting to describe an Amazon OpenSearch Service-managed VPC endpoint.

        • VpcEndpointId (string) --

          The unique identifier of the endpoint.

        • ErrorCode (string) --

          The code associated with the error.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

dissociate_package(**kwargs)

Removes a package from the specified Amazon OpenSearch Service domain. The package can't be in use with any OpenSearch index for the dissociation to succeed. The package is still available in OpenSearch Service for association later. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.dissociate_package(
    PackageID='string',
    DomainName='string'
)
Parameters
  • PackageID (string) --

    [REQUIRED]

    Internal ID of the package to dissociate from the domain. Use ListPackagesForDomain to find this value.

  • DomainName (string) --

    [REQUIRED]

    Name of the domain to dissociate the package from.

Return type

dict

Returns

Response Syntax

{
    'DomainPackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY',
        'LastUpdated': datetime(2015, 1, 1),
        'DomainName': 'string',
        'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
        'PackageVersion': 'string',
        'ReferencePath': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by an DissociatePackage operation.

    • DomainPackageDetails (dict) --

      Information about a package that has been dissociated from the domain.

      • PackageID (string) --

        Internal ID of the package.

      • PackageName (string) --

        User-specified name of the package.

      • PackageType (string) --

        The type of package.

      • LastUpdated (datetime) --

        Timestamp of the most recent update to the package association status.

      • DomainName (string) --

        Name of the domain that the package is associated with.

      • DomainPackageStatus (string) --

        State of the association.

      • PackageVersion (string) --

        The current version of the package.

      • ReferencePath (string) --

        Denotes the location of the package on the OpenSearch Service cluster nodes. It's the same as synonym_path for dictionary files.

      • ErrorDetails (dict) --

        Additional information if the package is in an error state. Null otherwise.

        • ErrorType (string) --

          The type of error that occurred.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

get_compatible_versions(**kwargs)

Returns a map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to.

See also: AWS API Documentation

Request Syntax

response = client.get_compatible_versions(
    DomainName='string'
)
Parameters
DomainName (string) -- The name of an existing domain. Provide this parameter to limit the results to a single domain.
Return type
dict
Returns
Response Syntax
{
    'CompatibleVersions': [
        {
            'SourceVersion': 'string',
            'TargetVersions': [
                'string',
            ]
        },
    ]
}

Response Structure

  • (dict) --

    Container for the response returned by the GetCompatibleVersions operation.

    • CompatibleVersions (list) --

      A map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to.

      • (dict) --

        A map of OpenSearch or Elasticsearch versions and the versions you can upgrade them to.

        • SourceVersion (string) --

          The current version that the OpenSearch Service domain is running.

        • TargetVersions (list) --

          The possible versions that you can upgrade the domain to.

          • (string) --

Exceptions

get_package_version_history(**kwargs)

Returns a list of Amazon OpenSearch Service package versions, along with their creation time and commit message. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.get_package_version_history(
    PackageID='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • PackageID (string) --

    [REQUIRED]

    The unique identifier of the package.

  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial GetPackageVersionHistory operation returns a nextToken , you can include the returned nextToken in subsequent GetPackageVersionHistory operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'PackageID': 'string',
    'PackageVersionHistoryList': [
        {
            'PackageVersion': 'string',
            'CommitMessage': 'string',
            'CreatedAt': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for response returned by GetPackageVersionHistory operation.

    • PackageID (string) --

      The unique identifier of the package.

    • PackageVersionHistoryList (list) --

      A list of package versions, along with their creation time and commit message.

      • (dict) --

        Details about a package version.

        • PackageVersion (string) --

          The package version.

        • CommitMessage (string) --

          A message associated with the package version when it was uploaded.

        • CreatedAt (datetime) --

          The date and time when the package was created.

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

Exceptions

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_upgrade_history(**kwargs)

Retrieves the complete history of the last 10 upgrades performed on an Amazon OpenSearch Service domain.

See also: AWS API Documentation

Request Syntax

response = client.get_upgrade_history(
    DomainName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of an existing domain.

  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial GetUpgradeHistory operation returns a nextToken , you can include the returned nextToken in subsequent GetUpgradeHistory operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'UpgradeHistories': [
        {
            'UpgradeName': 'string',
            'StartTimestamp': datetime(2015, 1, 1),
            'UpgradeStatus': 'IN_PROGRESS'|'SUCCEEDED'|'SUCCEEDED_WITH_ISSUES'|'FAILED',
            'StepsList': [
                {
                    'UpgradeStep': 'PRE_UPGRADE_CHECK'|'SNAPSHOT'|'UPGRADE',
                    'UpgradeStepStatus': 'IN_PROGRESS'|'SUCCEEDED'|'SUCCEEDED_WITH_ISSUES'|'FAILED',
                    'Issues': [
                        'string',
                    ],
                    'ProgressPercent': 123.0
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response returned by the GetUpgradeHistory operation.

    • UpgradeHistories (list) --

      A list of objects corresponding to each upgrade or upgrade eligibility check performed on a domain.

      • (dict) --

        History of the last 10 upgrades and upgrade eligibility checks for an Amazon OpenSearch Service domain.

        • UpgradeName (string) --

          A string that describes the upgrade.

        • StartTimestamp (datetime) --

          UTC timestamp at which the upgrade API call was made, in the format yyyy-MM-ddTHH:mm:ssZ .

        • UpgradeStatus (string) --

          The current status of the upgrade. The status can take one of the following values:

          • In Progress
          • Succeeded
          • Succeeded with Issues
          • Failed
        • StepsList (list) --

          A list of each step performed as part of a specific upgrade or upgrade eligibility check.

          • (dict) --

            Represents a single step of an upgrade or upgrade eligibility check workflow.

            • UpgradeStep (string) --

              One of three steps that an upgrade or upgrade eligibility check goes through:

              • PreUpgradeCheck
              • Snapshot
              • Upgrade
            • UpgradeStepStatus (string) --

              The current status of the upgrade. The status can take one of the following values:

              • In Progress
              • Succeeded
              • Succeeded with Issues
              • Failed
            • Issues (list) --

              A list of strings containing detailed information about the errors encountered in a particular step.

              • (string) --
            • ProgressPercent (float) --

              The floating point value representing the progress percentage of a particular step.

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

Exceptions

get_upgrade_status(**kwargs)

Returns the most recent status of the last upgrade or upgrade eligibility check performed on an Amazon OpenSearch Service domain.

See also: AWS API Documentation

Request Syntax

response = client.get_upgrade_status(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

The domain of the domain to get upgrade status information for.

Return type
dict
Returns
Response Syntax
{
    'UpgradeStep': 'PRE_UPGRADE_CHECK'|'SNAPSHOT'|'UPGRADE',
    'StepStatus': 'IN_PROGRESS'|'SUCCEEDED'|'SUCCEEDED_WITH_ISSUES'|'FAILED',
    'UpgradeName': 'string'
}

Response Structure

  • (dict) --

    Container for the response returned by the GetUpgradeStatus operation.

    • UpgradeStep (string) --

      One of three steps that an upgrade or upgrade eligibility check goes through.

    • StepStatus (string) --

      The status of the current step that an upgrade is on.

    • UpgradeName (string) --

      A string that describes the update.

Exceptions

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_domain_names(**kwargs)

Returns the names of all Amazon OpenSearch Service domains owned by the current user in the active Region.

See also: AWS API Documentation

Request Syntax

response = client.list_domain_names(
    EngineType='OpenSearch'|'Elasticsearch'
)
Parameters
EngineType (string) -- Filters the output by domain engine type.
Return type
dict
Returns
Response Syntax
{
    'DomainNames': [
        {
            'DomainName': 'string',
            'EngineType': 'OpenSearch'|'Elasticsearch'
        },
    ]
}

Response Structure

  • (dict) --

    The results of a ListDomainNames operation. Contains the names of all domains owned by this account and their respective engine types.

    • DomainNames (list) --

      The names of all OpenSearch Service domains owned by the current user and their respective engine types.

      • (dict) --

        Information about an OpenSearch Service domain.

        • DomainName (string) --

          Name of the domain.

        • EngineType (string) --

          The type of search engine that the domain is running. OpenSearch for an OpenSearch engine, or Elasticsearch for a legacy Elasticsearch OSS engine.

Exceptions

list_domains_for_package(**kwargs)

Lists all Amazon OpenSearch Service domains associated with a given package. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.list_domains_for_package(
    PackageID='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • PackageID (string) --

    [REQUIRED]

    The unique identifier of the package for which to list associated domains.

  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial ListDomainsForPackage operation returns a nextToken , you can include the returned nextToken in subsequent ListDomainsForPackage operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'DomainPackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY',
            'LastUpdated': datetime(2015, 1, 1),
            'DomainName': 'string',
            'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
            'PackageVersion': 'string',
            'ReferencePath': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response parameters to the ListDomainsForPackage operation.

    • DomainPackageDetailsList (list) --

      Information about all domains associated with a package.

      • (dict) --

        Information about a package that is associated with a domain. For more information, see Custom packages for Amazon OpenSearch Service.

        • PackageID (string) --

          Internal ID of the package.

        • PackageName (string) --

          User-specified name of the package.

        • PackageType (string) --

          The type of package.

        • LastUpdated (datetime) --

          Timestamp of the most recent update to the package association status.

        • DomainName (string) --

          Name of the domain that the package is associated with.

        • DomainPackageStatus (string) --

          State of the association.

        • PackageVersion (string) --

          The current version of the package.

        • ReferencePath (string) --

          Denotes the location of the package on the OpenSearch Service cluster nodes. It's the same as synonym_path for dictionary files.

        • ErrorDetails (dict) --

          Additional information if the package is in an error state. Null otherwise.

          • ErrorType (string) --

            The type of error that occurred.

          • ErrorMessage (string) --

            A message describing the error.

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

Exceptions

list_instance_type_details(**kwargs)

Lists all instance types and available features for a given OpenSearch or Elasticsearch version.

See also: AWS API Documentation

Request Syntax

response = client.list_instance_type_details(
    EngineVersion='string',
    DomainName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • EngineVersion (string) --

    [REQUIRED]

    Version of OpenSearch or Elasticsearch, in the format Elasticsearch_X.Y or OpenSearch_X.Y. Defaults to the latest version of OpenSearch.

  • DomainName (string) -- Name of the domain to list instance type details for.
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial ListInstanceTypeDetails operation returns a nextToken , you can include the returned nextToken in subsequent ListInstanceTypeDetails operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'InstanceTypeDetails': [
        {
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'EncryptionEnabled': True|False,
            'CognitoEnabled': True|False,
            'AppLogsEnabled': True|False,
            'AdvancedSecurityEnabled': True|False,
            'WarmEnabled': True|False,
            'InstanceRole': [
                'string',
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • InstanceTypeDetails (list) --

      Lists all supported instance types and features for the given OpenSearch or Elasticsearch version.

      • (dict) --

        Lists all instance types and available features for a given OpenSearch or Elasticsearch version.

        • InstanceType (string) --

          The instance type.

        • EncryptionEnabled (boolean) --

          Whether encryption at rest and node-to-node encryption are supported for the instance type.

        • CognitoEnabled (boolean) --

          Whether Amazon Cognito access is supported for the instance type.

        • AppLogsEnabled (boolean) --

          Whether logging is supported for the instance type.

        • AdvancedSecurityEnabled (boolean) --

          Whether fine-grained access control is supported for the instance type.

        • WarmEnabled (boolean) --

          Whether UltraWarm is supported for the instance type.

        • InstanceRole (list) --

          Whether the instance acts as a data node, a dedicated master node, or an UltraWarm node.

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

Exceptions

list_packages_for_domain(**kwargs)

Lists all packages associated with an Amazon OpenSearch Service domain. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.list_packages_for_domain(
    DomainName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the domain for which you want to list associated packages.

  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial ListPackagesForDomain operation returns a nextToken , you can include the returned nextToken in subsequent ListPackagesForDomain operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'DomainPackageDetailsList': [
        {
            'PackageID': 'string',
            'PackageName': 'string',
            'PackageType': 'TXT-DICTIONARY',
            'LastUpdated': datetime(2015, 1, 1),
            'DomainName': 'string',
            'DomainPackageStatus': 'ASSOCIATING'|'ASSOCIATION_FAILED'|'ACTIVE'|'DISSOCIATING'|'DISSOCIATION_FAILED',
            'PackageVersion': 'string',
            'ReferencePath': 'string',
            'ErrorDetails': {
                'ErrorType': 'string',
                'ErrorMessage': 'string'
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the response parameters to the ListPackagesForDomain operation.

    • DomainPackageDetailsList (list) --

      List of all packages associated with a domain.

      • (dict) --

        Information about a package that is associated with a domain. For more information, see Custom packages for Amazon OpenSearch Service.

        • PackageID (string) --

          Internal ID of the package.

        • PackageName (string) --

          User-specified name of the package.

        • PackageType (string) --

          The type of package.

        • LastUpdated (datetime) --

          Timestamp of the most recent update to the package association status.

        • DomainName (string) --

          Name of the domain that the package is associated with.

        • DomainPackageStatus (string) --

          State of the association.

        • PackageVersion (string) --

          The current version of the package.

        • ReferencePath (string) --

          Denotes the location of the package on the OpenSearch Service cluster nodes. It's the same as synonym_path for dictionary files.

        • ErrorDetails (dict) --

          Additional information if the package is in an error state. Null otherwise.

          • ErrorType (string) --

            The type of error that occurred.

          • ErrorMessage (string) --

            A message describing the error.

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

Exceptions

list_tags(**kwargs)

Returns all resource tags for an Amazon OpenSearch Service domain. For more information, see Tagging Amazon OpenSearch Service domains.

See also: AWS API Documentation

Request Syntax

response = client.list_tags(
    ARN='string'
)
Parameters
ARN (string) --

[REQUIRED]

Amazon Resource Name (ARN) for the domain to view tags for.

Return type
dict
Returns
Response Syntax
{
    'TagList': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The results of a ListTags operation.

    • TagList (list) --

      List of resource tags associated with the specified domain.

      • (dict) --

        A tag (key-value pair) for an Amazon OpenSearch Service resource.

        • Key (string) --

          The tag key. Tag keys must be unique for the domain to which they are attached.

        • Value (string) --

          The value assigned to the corresponding tag key. Tag values can be null and don't have to be unique in a tag set. For example, you can have a key value pair in a tag set of project : Trinity and cost-center : Trinity

Exceptions

list_versions(**kwargs)

Lists all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports.

See also: AWS API Documentation

Request Syntax

response = client.list_versions(
    MaxResults=123,
    NextToken='string'
)
Parameters
  • MaxResults (integer) -- An optional parameter that specifies the maximum number of results to return. You can use nextToken to get the next page of results.
  • NextToken (string) -- If your initial ListVersions operation returns a nextToken , you can include the returned nextToken in subsequent ListVersions operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'Versions': [
        'string',
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    Container for the parameters for response received from the ListVersions operation.

    • Versions (list) --

      A list of all versions of OpenSearch and Elasticsearch that Amazon OpenSearch Service supports.

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

Exceptions

list_vpc_endpoint_access(**kwargs)

Retrieves information about each Amazon Web Services principal that is allowed to access a given Amazon OpenSearch Service domain through the use of an interface VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.list_vpc_endpoint_access(
    DomainName='string',
    NextToken='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the OpenSearch Service domain to retrieve access information for.

  • NextToken (string) -- If your initial ListVpcEndpointAccess operation returns a nextToken , you can include the returned nextToken in subsequent ListVpcEndpointAccess operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'AuthorizedPrincipalList': [
        {
            'PrincipalType': 'AWS_ACCOUNT'|'AWS_SERVICE',
            'Principal': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • AuthorizedPrincipalList (list) --

      A list of IAM principals that can currently access the domain.

      • (dict) --

        Information about an Amazon Web Services account or service that has access to an Amazon OpenSearch Service domain through the use of an interface VPC endpoint.

        • PrincipalType (string) --

          The type of principal.

        • Principal (string) --

          The IAM principal that is allowed access to the domain.

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

Exceptions

list_vpc_endpoints(**kwargs)

Retrieves all Amazon OpenSearch Service-managed VPC endpoints in the current Amazon Web Services account and Region.

See also: AWS API Documentation

Request Syntax

response = client.list_vpc_endpoints(
    NextToken='string'
)
Parameters
NextToken (string) -- If your initial ListVpcEndpoints operation returns a nextToken , you can include the returned nextToken in subsequent ListVpcEndpoints operations, which returns results in the next page.
Return type
dict
Returns
Response Syntax
{
    'VpcEndpointSummaryList': [
        {
            'VpcEndpointId': 'string',
            'VpcEndpointOwner': 'string',
            'DomainArn': 'string',
            'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --
    • VpcEndpointSummaryList (list) --

      Information about each endpoint.

      • (dict) --

        Summary information for an Amazon OpenSearch Service-managed VPC endpoint.

        • VpcEndpointId (string) --

          The unique identifier of the endpoint.

        • VpcEndpointOwner (string) --

          The creator of the endpoint.

        • DomainArn (string) --

          The Amazon Resource Name (ARN) of the domain associated with the endpoint.

        • Status (string) --

          The current status of the endpoint.

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

Exceptions

list_vpc_endpoints_for_domain(**kwargs)

Retrieves all Amazon OpenSearch Service-managed VPC endpoints associated with a particular domain.

See also: AWS API Documentation

Request Syntax

response = client.list_vpc_endpoints_for_domain(
    DomainName='string',
    NextToken='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the domain to list associated VPC endpoints for.

  • NextToken (string) -- If your initial ListEndpointsForDomain operation returns a nextToken , you can include the returned nextToken in subsequent ListEndpointsForDomain operations, which returns results in the next page.
Return type

dict

Returns

Response Syntax

{
    'VpcEndpointSummaryList': [
        {
            'VpcEndpointId': 'string',
            'VpcEndpointOwner': 'string',
            'DomainArn': 'string',
            'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • VpcEndpointSummaryList (list) --

      Information about each endpoint associated with the domain.

      • (dict) --

        Summary information for an Amazon OpenSearch Service-managed VPC endpoint.

        • VpcEndpointId (string) --

          The unique identifier of the endpoint.

        • VpcEndpointOwner (string) --

          The creator of the endpoint.

        • DomainArn (string) --

          The Amazon Resource Name (ARN) of the domain associated with the endpoint.

        • Status (string) --

          The current status of the endpoint.

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

Exceptions

purchase_reserved_instance_offering(**kwargs)

Allows you to purchase Amazon OpenSearch Service Reserved Instances.

See also: AWS API Documentation

Request Syntax

response = client.purchase_reserved_instance_offering(
    ReservedInstanceOfferingId='string',
    ReservationName='string',
    InstanceCount=123
)
Parameters
  • ReservedInstanceOfferingId (string) --

    [REQUIRED]

    The ID of the Reserved Instance offering to purchase.

  • ReservationName (string) --

    [REQUIRED]

    A customer-specified identifier to track this reservation.

  • InstanceCount (integer) -- The number of OpenSearch instances to reserve.
Return type

dict

Returns

Response Syntax

{
    'ReservedInstanceId': 'string',
    'ReservationName': 'string'
}

Response Structure

  • (dict) --

    Represents the output of a PurchaseReservedInstanceOffering operation.

    • ReservedInstanceId (string) --

      The ID of the Reserved Instance offering that was purchased.

    • ReservationName (string) --

      The customer-specified identifier used to track this reservation.

Exceptions

reject_inbound_connection(**kwargs)

Allows the remote Amazon OpenSearch Service domain owner to reject an inbound cross-cluster connection request.

See also: AWS API Documentation

Request Syntax

response = client.reject_inbound_connection(
    ConnectionId='string'
)
Parameters
ConnectionId (string) --

[REQUIRED]

The unique identifier of the inbound connection to reject.

Return type
dict
Returns
Response Syntax
{
    'Connection': {
        'LocalDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'RemoteDomainInfo': {
            'AWSDomainInformation': {
                'OwnerId': 'string',
                'DomainName': 'string',
                'Region': 'string'
            }
        },
        'ConnectionId': 'string',
        'ConnectionStatus': {
            'StatusCode': 'PENDING_ACCEPTANCE'|'APPROVED'|'PROVISIONING'|'ACTIVE'|'REJECTING'|'REJECTED'|'DELETING'|'DELETED',
            'Message': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Represents the output of a RejectInboundConnection operation.

    • Connection (dict) --

      Contains details about the rejected 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) --

        The unique identifier of the connection.

      • ConnectionStatus (dict) --

        The current status of the connection.

        • StatusCode (string) --

          The status code for the connection. Can be one of the following:

          • PENDING_ACCEPTANCE - Inbound connection is not yet accepted by the remote domain owner.
          • APPROVED : Inbound connection is pending acceptance by the remote domain owner.
          • PROVISIONING : Inbound connection is being provisioned.
          • ACTIVE : Inbound connection is active and ready to use.
          • 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 can no longer be used.
        • Message (string) --

          Information about the connection.

Exceptions

remove_tags(**kwargs)

Removes the specified set of tags from an Amazon OpenSearch Service domain. For more information, see Tagging Amazon OpenSearch Service domains.

See also: AWS API Documentation

Request Syntax

response = client.remove_tags(
    ARN='string',
    TagKeys=[
        'string',
    ]
)
Parameters
  • ARN (string) --

    [REQUIRED]

    The Amazon Resource Name (ARN) of the domain from which you want to delete the specified tags.

  • TagKeys (list) --

    [REQUIRED]

    The list of tag keys to remove from the domain.

    • (string) --
Returns

None

Exceptions

revoke_vpc_endpoint_access(**kwargs)

Revokes access to an Amazon OpenSearch Service domain that was provided through an interface VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.revoke_vpc_endpoint_access(
    DomainName='string',
    Account='string'
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the OpenSearch Service domain.

  • Account (string) --

    [REQUIRED]

    The account ID to revoke access from.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Exceptions

start_service_software_update(**kwargs)

Schedules a service software update for an Amazon OpenSearch Service domain. For more information, see Service software updates in Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.start_service_software_update(
    DomainName='string'
)
Parameters
DomainName (string) --

[REQUIRED]

The name of the domain that you want to update to the latest service software.

Return type
dict
Returns
Response Syntax
{
    'ServiceSoftwareOptions': {
        'CurrentVersion': 'string',
        'NewVersion': 'string',
        'UpdateAvailable': True|False,
        'Cancellable': True|False,
        'UpdateStatus': 'PENDING_UPDATE'|'IN_PROGRESS'|'COMPLETED'|'NOT_ELIGIBLE'|'ELIGIBLE',
        'Description': 'string',
        'AutomatedUpdateDate': datetime(2015, 1, 1),
        'OptionalDeployment': True|False
    }
}

Response Structure

  • (dict) --

    Represents the output of a StartServiceSoftwareUpdate operation. Contains the status of the update.

    • ServiceSoftwareOptions (dict) --

      The current status of the OpenSearch Service software update.

      • CurrentVersion (string) --

        The current service software version present on the domain.

      • NewVersion (string) --

        The new service software version, if one is available.

      • UpdateAvailable (boolean) --

        True if you're able to update your service software version. False if you can't update your service software version.

      • Cancellable (boolean) --

        True if you're able to cancel your service software version update. False if you can't cancel your service software update.

      • UpdateStatus (string) --

        The status of your service software update.

      • Description (string) --

        A description of the service software update status.

      • AutomatedUpdateDate (datetime) --

        The timestamp, in Epoch time, until which you can manually request a service software update. After this date, we automatically update your service software.

      • OptionalDeployment (boolean) --

        True if a service software is never automatically updated. False if a service software is automatically updated after the automated update date.

Exceptions

update_domain_config(**kwargs)

Modifies the cluster configuration of the specified Amazon OpenSearch Service domain.

See also: AWS API Documentation

Request Syntax

response = client.update_domain_config(
    DomainName='string',
    ClusterConfig={
        'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
        'InstanceCount': 123,
        'DedicatedMasterEnabled': True|False,
        'ZoneAwarenessEnabled': True|False,
        'ZoneAwarenessConfig': {
            'AvailabilityZoneCount': 123
        },
        'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
        'DedicatedMasterCount': 123,
        'WarmEnabled': True|False,
        'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
        'WarmCount': 123,
        'ColdStorageOptions': {
            'Enabled': True|False
        }
    },
    EBSOptions={
        'EBSEnabled': True|False,
        'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
        'VolumeSize': 123,
        'Iops': 123,
        'Throughput': 123
    },
    SnapshotOptions={
        'AutomatedSnapshotStartHour': 123
    },
    VPCOptions={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    },
    CognitoOptions={
        'Enabled': True|False,
        'UserPoolId': 'string',
        'IdentityPoolId': 'string',
        'RoleArn': 'string'
    },
    AdvancedOptions={
        'string': 'string'
    },
    AccessPolicies='string',
    LogPublishingOptions={
        'string': {
            'CloudWatchLogsLogGroupArn': 'string',
            'Enabled': True|False
        }
    },
    EncryptionAtRestOptions={
        'Enabled': True|False,
        'KmsKeyId': 'string'
    },
    DomainEndpointOptions={
        'EnforceHTTPS': True|False,
        'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
        'CustomEndpointEnabled': True|False,
        'CustomEndpoint': 'string',
        'CustomEndpointCertificateArn': 'string'
    },
    NodeToNodeEncryptionOptions={
        'Enabled': True|False
    },
    AdvancedSecurityOptions={
        'Enabled': True|False,
        'InternalUserDatabaseEnabled': True|False,
        'MasterUserOptions': {
            'MasterUserARN': 'string',
            'MasterUserName': 'string',
            'MasterUserPassword': 'string'
        },
        'SAMLOptions': {
            'Enabled': True|False,
            'Idp': {
                'MetadataContent': 'string',
                'EntityId': 'string'
            },
            'MasterUserName': 'string',
            'MasterBackendRole': 'string',
            'SubjectKey': 'string',
            'RolesKey': 'string',
            'SessionTimeoutMinutes': 123
        },
        'AnonymousAuthEnabled': True|False
    },
    AutoTuneOptions={
        'DesiredState': 'ENABLED'|'DISABLED',
        'RollbackOnDisable': 'NO_ROLLBACK'|'DEFAULT_ROLLBACK',
        'MaintenanceSchedules': [
            {
                'StartAt': datetime(2015, 1, 1),
                'Duration': {
                    'Value': 123,
                    'Unit': 'HOURS'
                },
                'CronExpressionForRecurrence': 'string'
            },
        ]
    },
    DryRun=True|False
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    The name of the domain that you're updating.

  • ClusterConfig (dict) --

    Changes that you want to make to the cluster configuration, such as the instance type and number of EC2 instances.

    • InstanceType (string) --

      Instance type of data nodes in the cluster.

    • InstanceCount (integer) --

      Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

    • DedicatedMasterEnabled (boolean) --

      Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

    • ZoneAwarenessEnabled (boolean) --

      Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

    • ZoneAwarenessConfig (dict) --

      Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

      • AvailabilityZoneCount (integer) --

        If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

    • DedicatedMasterType (string) --

      OpenSearch Service instance type of the dedicated master nodes in the cluster.

    • DedicatedMasterCount (integer) --

      Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

    • WarmEnabled (boolean) --

      Whether to enable warm storage for the cluster.

    • WarmType (string) --

      The instance type for the cluster's warm nodes.

    • WarmCount (integer) --

      The number of warm nodes in the cluster.

    • ColdStorageOptions (dict) --

      Container for cold storage configuration options.

      • Enabled (boolean) -- [REQUIRED]

        Whether to enable or disable cold storage on the domain.

  • EBSOptions (dict) --

    The type and size of the EBS volume to attach to instances in the domain.

    • EBSEnabled (boolean) --

      Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

    • VolumeType (string) --

      Specifies the type of EBS volumes attached to data nodes.

    • VolumeSize (integer) --

      Specifies the size (in GiB) of EBS volumes attached to data nodes.

    • Iops (integer) --

      Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

    • Throughput (integer) --

      Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

  • SnapshotOptions (dict) --

    Option to set the time, in UTC format, for the daily automated snapshot. Default value is 0 hours.

    • AutomatedSnapshotStartHour (integer) --

      The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

  • VPCOptions (dict) --

    Options to specify the subnets and security groups for a VPC endpoint. For more information, see Launching your Amazon OpenSearch Service domains using a VPC.

    • SubnetIds (list) --

      A list of subnet IDs associated with the VPC endpoints for the domain. If your domain uses multiple Availability Zones, you need to provide two subnet IDs, one per zone. Otherwise, provide only one.

      • (string) --
    • SecurityGroupIds (list) --

      The list of security group IDs associated with the VPC endpoints for the domain. If you do not provide a security group ID, OpenSearch Service uses the default security group for the VPC.

      • (string) --
  • CognitoOptions (dict) --

    Key-value pairs to configure Amazon Cognito authentication for OpenSearch Dashboards.

    • Enabled (boolean) --

      Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

    • UserPoolId (string) --

      The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

    • IdentityPoolId (string) --

      The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

    • RoleArn (string) --

      The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

  • AdvancedOptions (dict) --

    Key-value pairs to specify advanced configuration options. The following key-value pairs are supported:

    • "rest.action.multi.allow_explicit_index": "true" | "false" - Note the use of a string rather than a boolean. Specifies whether explicit references to indexes are allowed inside the body of HTTP requests. If you want to configure access policies for domain sub-resources, such as specific indexes and domain APIs, you must disable this property. Default is true.
    • "indices.fielddata.cache.size": "80" - Note the use of a string rather than a boolean. Specifies the percentage of heap space allocated to field data. Default is unbounded.
    • "indices.query.bool.max_clause_count": "1024" - Note the use of a string rather than a boolean. Specifies the maximum number of clauses allowed in a Lucene boolean query. Default is 1,024. Queries with more than the permitted number of clauses result in a TooManyClauses error.
    • "override_main_response_version": "true" | "false" - Note the use of a string rather than a boolean. Specifies whether the domain reports its version as 7.10 to allow Elasticsearch OSS clients and plugins to continue working with it. Default is false when creating a domain and true when upgrading a domain.

    For more information, see Advanced cluster parameters.

    • (string) --
      • (string) --
  • AccessPolicies (string) -- Identity and Access Management (IAM) access policy as a JSON-formatted string.
  • LogPublishingOptions (dict) --

    Options to publish OpenSearch lots to Amazon CloudWatch Logs.

    • (string) --

      The type of log file. Can be one of the following:

      • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
      • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
      • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
      • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
      • (dict) --

        Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

        Note

        After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

        • CloudWatchLogsLogGroupArn (string) --

          The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

        • Enabled (boolean) --

          Whether the log should be published.

  • EncryptionAtRestOptions (dict) --

    Encryption at rest options for the domain.

    • Enabled (boolean) --

      True to enable encryption at rest.

    • KmsKeyId (string) --

      The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

  • DomainEndpointOptions (dict) --

    Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

    • EnforceHTTPS (boolean) --

      True to require that all traffic to the domain arrive over HTTPS.

    • TLSSecurityPolicy (string) --

      Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

      Can be one of the following values:

      • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
      • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
    • CustomEndpointEnabled (boolean) --

      Whether to enable a custom endpoint for the domain.

    • CustomEndpoint (string) --

      The fully qualified URL for the custom endpoint.

    • CustomEndpointCertificateArn (string) --

      The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

  • NodeToNodeEncryptionOptions (dict) --

    Node-To-Node Encryption options for the domain.

    • Enabled (boolean) --

      True to enable node-to-node encryption.

  • AdvancedSecurityOptions (dict) --

    Options for fine-grained access control.

    • Enabled (boolean) --

      True to enable fine-grained access control.

    • InternalUserDatabaseEnabled (boolean) --

      True to enable the internal user database.

    • MasterUserOptions (dict) --

      Container for information about the master user.

      • MasterUserARN (string) --

        Amazon Resource Name (ARN) for the master user. Only specify if InternalUserDatabaseEnabled is false .

      • MasterUserName (string) --

        User name for the master user. Only specify if InternalUserDatabaseEnabled is true .

      • MasterUserPassword (string) --

        Password for the master user. Only specify if InternalUserDatabaseEnabled is true .

    • SAMLOptions (dict) --

      Container for information about the SAML configuration for OpenSearch Dashboards.

      • Enabled (boolean) --

        True to enable SAML authentication for a domain.

      • Idp (dict) --

        The SAML Identity Provider's information.

        • MetadataContent (string) -- [REQUIRED]

          The metadata of the SAML application, in XML format.

        • EntityId (string) -- [REQUIRED]

          The unique entity ID of the application in the SAML identity provider.

      • MasterUserName (string) --

        The SAML master user name, which is stored in the domain's internal user database.

      • MasterBackendRole (string) --

        The backend role that the SAML master user is mapped to.

      • SubjectKey (string) --

        Element of the SAML assertion to use for the user name. Default is NameID .

      • RolesKey (string) --

        Element of the SAML assertion to use for backend roles. Default is roles .

      • SessionTimeoutMinutes (integer) --

        The duration, in minutes, after which a user session becomes inactive. Acceptable values are between 1 and 1440, and the default value is 60.

    • AnonymousAuthEnabled (boolean) --

      True to enable a 30-day migration period during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

  • AutoTuneOptions (dict) --

    Options for Auto-Tune.

    • DesiredState (string) --

      Whether Auto-Tune is enabled or disabled.

    • RollbackOnDisable (string) --

      When disabling Auto-Tune, specify NO_ROLLBACK to retain all prior Auto-Tune settings or DEFAULT_ROLLBACK to revert to the OpenSearch Service defaults. If you specify DEFAULT_ROLLBACK , you must include a MaintenanceSchedule in the request. Otherwise, OpenSearch Service is unable to perform the rollback.

    • MaintenanceSchedules (list) --

      A list of maintenance schedules during which Auto-Tune can deploy changes.

      • (dict) --

        The Auto-Tune maintenance schedule. For more information, see Auto-Tune for Amazon OpenSearch Service.

        • StartAt (datetime) --

          The Epoch timestamp at which the Auto-Tune maintenance schedule starts.

        • Duration (dict) --

          The duration of the maintenance schedule. For example, "Duration": {"Value": 2, "Unit": "HOURS"} .

          • Value (integer) --

            Integer to specify the value of a maintenance schedule duration.

          • Unit (string) --

            The unit of measurement for the duration of a maintenance schedule.

        • CronExpressionForRecurrence (string) --

          A cron expression for a recurring maintenance schedule during which Auto-Tune can deploy changes.

  • DryRun (boolean) -- This flag, when set to True, specifies whether the UpdateDomain request should return the results of validation check without actually applying the change.
Return type

dict

Returns

Response Syntax

{
    'DomainConfig': {
        'EngineVersion': {
            'Options': 'string',
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'ClusterConfig': {
            'Options': {
                'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'InstanceCount': 123,
                'DedicatedMasterEnabled': True|False,
                'ZoneAwarenessEnabled': True|False,
                'ZoneAwarenessConfig': {
                    'AvailabilityZoneCount': 123
                },
                'DedicatedMasterType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
                'DedicatedMasterCount': 123,
                'WarmEnabled': True|False,
                'WarmType': 'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search',
                'WarmCount': 123,
                'ColdStorageOptions': {
                    'Enabled': True|False
                }
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'EBSOptions': {
            'Options': {
                'EBSEnabled': True|False,
                'VolumeType': 'standard'|'gp2'|'io1'|'gp3',
                'VolumeSize': 123,
                'Iops': 123,
                'Throughput': 123
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AccessPolicies': {
            'Options': 'string',
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'SnapshotOptions': {
            'Options': {
                'AutomatedSnapshotStartHour': 123
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'VPCOptions': {
            'Options': {
                'VPCId': 'string',
                'SubnetIds': [
                    'string',
                ],
                'AvailabilityZones': [
                    'string',
                ],
                'SecurityGroupIds': [
                    'string',
                ]
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'CognitoOptions': {
            'Options': {
                'Enabled': True|False,
                'UserPoolId': 'string',
                'IdentityPoolId': 'string',
                'RoleArn': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'EncryptionAtRestOptions': {
            'Options': {
                'Enabled': True|False,
                'KmsKeyId': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'NodeToNodeEncryptionOptions': {
            'Options': {
                'Enabled': True|False
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AdvancedOptions': {
            'Options': {
                'string': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'LogPublishingOptions': {
            'Options': {
                'string': {
                    'CloudWatchLogsLogGroupArn': 'string',
                    'Enabled': True|False
                }
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'DomainEndpointOptions': {
            'Options': {
                'EnforceHTTPS': True|False,
                'TLSSecurityPolicy': 'Policy-Min-TLS-1-0-2019-07'|'Policy-Min-TLS-1-2-2019-07',
                'CustomEndpointEnabled': True|False,
                'CustomEndpoint': 'string',
                'CustomEndpointCertificateArn': 'string'
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AdvancedSecurityOptions': {
            'Options': {
                'Enabled': True|False,
                'InternalUserDatabaseEnabled': True|False,
                'SAMLOptions': {
                    'Enabled': True|False,
                    'Idp': {
                        'MetadataContent': 'string',
                        'EntityId': 'string'
                    },
                    'SubjectKey': 'string',
                    'RolesKey': 'string',
                    'SessionTimeoutMinutes': 123
                },
                'AnonymousAuthDisableDate': datetime(2015, 1, 1),
                'AnonymousAuthEnabled': True|False
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'RequiresIndexDocuments'|'Processing'|'Active',
                'PendingDeletion': True|False
            }
        },
        'AutoTuneOptions': {
            'Options': {
                'DesiredState': 'ENABLED'|'DISABLED',
                'RollbackOnDisable': 'NO_ROLLBACK'|'DEFAULT_ROLLBACK',
                'MaintenanceSchedules': [
                    {
                        'StartAt': datetime(2015, 1, 1),
                        'Duration': {
                            'Value': 123,
                            'Unit': 'HOURS'
                        },
                        'CronExpressionForRecurrence': 'string'
                    },
                ]
            },
            'Status': {
                'CreationDate': datetime(2015, 1, 1),
                'UpdateDate': datetime(2015, 1, 1),
                'UpdateVersion': 123,
                'State': 'ENABLED'|'DISABLED'|'ENABLE_IN_PROGRESS'|'DISABLE_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_SCHEDULED'|'DISABLED_AND_ROLLBACK_IN_PROGRESS'|'DISABLED_AND_ROLLBACK_COMPLETE'|'DISABLED_AND_ROLLBACK_ERROR'|'ERROR',
                'ErrorMessage': 'string',
                'PendingDeletion': True|False
            }
        },
        'ChangeProgressDetails': {
            'ChangeId': 'string',
            'Message': 'string'
        }
    },
    'DryRunResults': {
        'DeploymentType': 'string',
        'Message': 'string'
    }
}

Response Structure

  • (dict) --

    The results of an UpdateDomain request. Contains the status of the domain being updated.

    • DomainConfig (dict) --

      The status of the updated domain.

      • EngineVersion (dict) --

        The OpenSearch or Elasticsearch version that the domain is running.

        • Options (string) --

          The OpenSearch or Elasticsearch version for the specified domain.

        • Status (dict) --

          The status of the version options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • ClusterConfig (dict) --

        Container for the cluster configuration of a the domain.

        • Options (dict) --

          Cluster configuration options for the specified domain.

          • InstanceType (string) --

            Instance type of data nodes in the cluster.

          • InstanceCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • DedicatedMasterEnabled (boolean) --

            Indicates whether dedicated master nodes are enabled for the cluster. True if the cluster will use a dedicated master node. False if the cluster will not.

          • ZoneAwarenessEnabled (boolean) --

            Indicates whether multiple Availability Zones are enabled. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

          • ZoneAwarenessConfig (dict) --

            Container for zone awareness configuration options. Only required if ZoneAwarenessEnabled is true .

            • AvailabilityZoneCount (integer) --

              If you enabled multiple Availability Zones, this value is the number of zones that you want the domain to use. Valid values are 2 and 3 . If your domain is provisioned within a VPC, this value be equal to number of subnets.

          • DedicatedMasterType (string) --

            OpenSearch Service instance type of the dedicated master nodes in the cluster.

          • DedicatedMasterCount (integer) --

            Number of dedicated master nodes in the cluster. This number must be greater than 1, otherwise you receive a validation exception.

          • WarmEnabled (boolean) --

            Whether to enable warm storage for the cluster.

          • WarmType (string) --

            The instance type for the cluster's warm nodes.

          • WarmCount (integer) --

            The number of warm nodes in the cluster.

          • ColdStorageOptions (dict) --

            Container for cold storage configuration options.

            • Enabled (boolean) --

              Whether to enable or disable cold storage on the domain.

        • Status (dict) --

          The status of cluster configuration options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • EBSOptions (dict) --

        Container for EBS options configured for an OpenSearch Service domain.

        • Options (dict) --

          The configured EBS options for the specified domain.

          • EBSEnabled (boolean) --

            Indicates whether EBS volumes are attached to data nodes in an OpenSearch Service domain.

          • VolumeType (string) --

            Specifies the type of EBS volumes attached to data nodes.

          • VolumeSize (integer) --

            Specifies the size (in GiB) of EBS volumes attached to data nodes.

          • Iops (integer) --

            Specifies the baseline input/output (I/O) performance of EBS volumes attached to data nodes. Applicable only for the gp3 and provisioned IOPS EBS volume types.

          • Throughput (integer) --

            Specifies the throughput (in MiB/s) of the EBS volumes attached to data nodes. Applicable only for the gp3 volume type.

        • Status (dict) --

          The status of the EBS options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AccessPolicies (dict) --

        Specifies the access policies for the domain.

        • Options (string) --

          The access policy configured for the domain. Access policies can be resource-based, IP-based, or IAM-based. For more information, see Configuring access policies.

        • Status (dict) --

          The status of the access policy for the domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • SnapshotOptions (dict) --

        DEPRECATED. Container for parameters required to configure automated snapshots of domain indexes.

        • Options (dict) --

          The daily snapshot options specified for the domain.

          • AutomatedSnapshotStartHour (integer) --

            The time, in UTC format, when OpenSearch Service takes a daily automated snapshot of the specified domain. Default is 0 hours.

        • Status (dict) --

          The status of a daily automated snapshot.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • VPCOptions (dict) --

        The current VPC options for the domain and the status of any updates to their configuration.

        • Options (dict) --

          The VPC options for the specified domain.

          • VPCId (string) --

            The ID for your VPC. Amazon VPC generates this value when you create a VPC.

          • SubnetIds (list) --

            A list of subnet IDs associated with the VPC endpoints for the domain.

            • (string) --
          • AvailabilityZones (list) --

            The list of Availability Zones associated with the VPC subnets.

            • (string) --
          • SecurityGroupIds (list) --

            The list of security group IDs associated with the VPC endpoints for the domain.

            • (string) --
        • Status (dict) --

          The status of the VPC options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • CognitoOptions (dict) --

        Container for Amazon Cognito options for the domain.

        • Options (dict) --

          Cognito options for the specified domain.

          • Enabled (boolean) --

            Whether to enable or disable Amazon Cognito authentication for OpenSearch Dashboards.

          • UserPoolId (string) --

            The Amazon Cognito user pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • IdentityPoolId (string) --

            The Amazon Cognito identity pool ID that you want OpenSearch Service to use for OpenSearch Dashboards authentication.

          • RoleArn (string) --

            The AmazonOpenSearchServiceCognitoAccess role that allows OpenSearch Service to configure your user pool and identity pool.

        • Status (dict) --

          The status of the Cognito options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • EncryptionAtRestOptions (dict) --

        Key-value pairs to enable encryption at rest.

        • Options (dict) --

          Encryption at rest options for the specified domain.

          • Enabled (boolean) --

            True to enable encryption at rest.

          • KmsKeyId (string) --

            The KMS key ID. Takes the form 1a2a3a4-1a2a-3a4a-5a6a-1a2a3a4a5a6a .

        • Status (dict) --

          The status of the encryption at rest options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • NodeToNodeEncryptionOptions (dict) --

        Whether node-to-node encryption is enabled or disabled.

        • Options (dict) --

          The node-to-node encryption options for the specified domain.

          • Enabled (boolean) --

            True to enable node-to-node encryption.

        • Status (dict) --

          The status of the node-to-node encryption options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AdvancedOptions (dict) --

        Key-value pairs to specify advanced configuration options. For more information, see Advanced options.

        • Options (dict) --

          The status of advanced options for the specified domain.

          • (string) --
            • (string) --
        • Status (dict) --

          The status of advanced options for the specified domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • LogPublishingOptions (dict) --

        Key-value pairs to configure slow log publishing.

        • Options (dict) --

          The log publishing options configured for the domain.

          • (string) --

            The type of log file. Can be one of the following:

            • INDEX_SLOW_LOGS - Index slow logs contain insert requests that took more time than the configured index query log threshold to execute.
            • SEARCH_SLOW_LOGS - Search slow logs contain search queries that took more time than the configured search query log threshold to execute.
            • ES_APPLICATION_LOGS - OpenSearch application logs contain information about errors and warnings raised during the operation of the service and can be useful for troubleshooting.
            • AUDIT_LOGS - Audit logs contain records of user requests for access to the domain.
            • (dict) --

              Specifies whether the Amazon OpenSearch Service domain publishes the OpenSearch application and slow logs to Amazon CloudWatch. For more information, see Monitoring OpenSearch logs with Amazon CloudWatch Logs.

              Note

              After you enable log publishing, you still have to enable the collection of slow logs using the OpenSearch REST API.

              • CloudWatchLogsLogGroupArn (string) --

                The Amazon Resource Name (ARN) of the CloudWatch Logs group to publish logs to.

              • Enabled (boolean) --

                Whether the log should be published.

        • Status (dict) --

          The status of the log publishing options for the domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • DomainEndpointOptions (dict) --

        Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.

        • Options (dict) --

          Options to configure the endpoint for a domain.

          • EnforceHTTPS (boolean) --

            True to require that all traffic to the domain arrive over HTTPS.

          • TLSSecurityPolicy (string) --

            Specify the TLS security policy to apply to the HTTPS endpoint of the domain.

            Can be one of the following values:

            • Policy-Min-TLS-1-0-2019-07: TLS security policy which supports TLS version 1.0 and higher.
            • Policy-Min-TLS-1-2-2019-07: TLS security policy which supports only TLS version 1.2
          • CustomEndpointEnabled (boolean) --

            Whether to enable a custom endpoint for the domain.

          • CustomEndpoint (string) --

            The fully qualified URL for the custom endpoint.

          • CustomEndpointCertificateArn (string) --

            The ARN for your security certificate, managed in Amazon Web Services Certificate Manager (ACM).

        • Status (dict) --

          The status of the endpoint options for a domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AdvancedSecurityOptions (dict) --

        Container for fine-grained access control settings for the domain.

        • Options (dict) --

          Container for fine-grained access control settings.

          • Enabled (boolean) --

            True if fine-grained access control is enabled.

          • InternalUserDatabaseEnabled (boolean) --

            True if the internal user database is enabled.

          • SAMLOptions (dict) --

            Container for information about the SAML configuration for OpenSearch Dashboards.

            • Enabled (boolean) --

              True if SAML is enabled.

            • Idp (dict) --

              Describes the SAML identity provider's information.

              • MetadataContent (string) --

                The metadata of the SAML application, in XML format.

              • EntityId (string) --

                The unique entity ID of the application in the SAML identity provider.

            • SubjectKey (string) --

              The key used for matching the SAML subject attribute.

            • RolesKey (string) --

              The key used for matching the SAML roles attribute.

            • SessionTimeoutMinutes (integer) --

              The duration, in minutes, after which a user session becomes inactive.

          • AnonymousAuthDisableDate (datetime) --

            Date and time when the migration period will be disabled. Only necessary when enabling fine-grained access control on an existing domain.

          • AnonymousAuthEnabled (boolean) --

            True if a 30-day migration period is enabled, during which administrators can create role mappings. Only necessary when enabling fine-grained access control on an existing domain.

        • Status (dict) --

          Status of the fine-grained access control settings for a domain.

          • CreationDate (datetime) --

            The timestamp when the entity was created.

          • UpdateDate (datetime) --

            The timestamp of the last time the entity was updated.

          • UpdateVersion (integer) --

            The latest version of the entity.

          • State (string) --

            The state of the entity.

          • PendingDeletion (boolean) --

            Indicates whether the entity is being deleted.

      • AutoTuneOptions (dict) --

        Container for Auto-Tune settings for the domain.

        • Options (dict) --

          Auto-Tune settings for updating a domain.

          • DesiredState (string) --

            Whether Auto-Tune is enabled or disabled.

          • RollbackOnDisable (string) --

            When disabling Auto-Tune, specify NO_ROLLBACK to retain all prior Auto-Tune settings or DEFAULT_ROLLBACK to revert to the OpenSearch Service defaults. If you specify DEFAULT_ROLLBACK , you must include a MaintenanceSchedule in the request. Otherwise, OpenSearch Service is unable to perform the rollback.

          • MaintenanceSchedules (list) --

            A list of maintenance schedules during which Auto-Tune can deploy changes.

            • (dict) --

              The Auto-Tune maintenance schedule. For more information, see Auto-Tune for Amazon OpenSearch Service.

              • StartAt (datetime) --

                The Epoch timestamp at which the Auto-Tune maintenance schedule starts.

              • Duration (dict) --

                The duration of the maintenance schedule. For example, "Duration": {"Value": 2, "Unit": "HOURS"} .

                • Value (integer) --

                  Integer to specify the value of a maintenance schedule duration.

                • Unit (string) --

                  The unit of measurement for the duration of a maintenance schedule.

              • CronExpressionForRecurrence (string) --

                A cron expression for a recurring maintenance schedule during which Auto-Tune can deploy changes.

        • Status (dict) --

          The current status of Auto-Tune for a domain.

          • CreationDate (datetime) --

            Date and time when Auto-Tune was enabled for the domain.

          • UpdateDate (datetime) --

            Date and time when the Auto-Tune options were last updated for the domain.

          • UpdateVersion (integer) --

            The latest version of the Auto-Tune options.

          • State (string) --

            The current state of Auto-Tune on the domain.

          • ErrorMessage (string) --

            Any errors that occurred while enabling or disabling Auto-Tune.

          • PendingDeletion (boolean) --

            Indicates whether the domain is being deleted.

      • ChangeProgressDetails (dict) --

        Container for information about the progress of an existing configuration change.

        • ChangeId (string) --

          The ID of the configuration change.

        • Message (string) --

          A message corresponding to the status of the configuration change.

    • DryRunResults (dict) --

      Results of a dry run performed in an update domain request.

      • DeploymentType (string) --

        Specifies the way in which OpenSearch Service will apply an update. Possible values are:

        • Blue/Green - The update requires a blue/green deployment.
        • DynamicUpdate - No blue/green deployment required
        • Undetermined - The domain is in the middle of an update and can't predict the deployment type. Try again after the update is complete.
        • None - The request doesn't include any configuration changes.
      • Message (string) --

        A message corresponding to the deployment type.

Exceptions

update_package(**kwargs)

Updates a package for use with Amazon OpenSearch Service domains. For more information, see Custom packages for Amazon OpenSearch Service.

See also: AWS API Documentation

Request Syntax

response = client.update_package(
    PackageID='string',
    PackageSource={
        'S3BucketName': 'string',
        'S3Key': 'string'
    },
    PackageDescription='string',
    CommitMessage='string'
)
Parameters
  • PackageID (string) --

    [REQUIRED]

    The unique identifier for the package.

  • PackageSource (dict) --

    [REQUIRED]

    Amazon S3 bucket and key for the package.

    • S3BucketName (string) --

      The name of the Amazon S3 bucket containing the package.

    • S3Key (string) --

      Key (file name) of the package.

  • PackageDescription (string) -- A new description of the package.
  • CommitMessage (string) -- Commit message for the updated file, which is shown as part of GetPackageVersionHistoryResponse .
Return type

dict

Returns

Response Syntax

{
    'PackageDetails': {
        'PackageID': 'string',
        'PackageName': 'string',
        'PackageType': 'TXT-DICTIONARY',
        'PackageDescription': 'string',
        'PackageStatus': 'COPYING'|'COPY_FAILED'|'VALIDATING'|'VALIDATION_FAILED'|'AVAILABLE'|'DELETING'|'DELETED'|'DELETE_FAILED',
        'CreatedAt': datetime(2015, 1, 1),
        'LastUpdatedAt': datetime(2015, 1, 1),
        'AvailablePackageVersion': 'string',
        'ErrorDetails': {
            'ErrorType': 'string',
            'ErrorMessage': 'string'
        }
    }
}

Response Structure

  • (dict) --

    Container for the response returned by the UpdatePackage operation.

    • PackageDetails (dict) --

      Information about a package.

      • PackageID (string) --

        The unique identifier of the package.

      • PackageName (string) --

        User-specified name of the package.

      • PackageType (string) --

        The type of package.

      • PackageDescription (string) --

        User-specified description of the package.

      • PackageStatus (string) --

        Current status of the package.

      • CreatedAt (datetime) --

        The timestamp when the package was created.

      • LastUpdatedAt (datetime) --

        Date and time when the package was last updated.

      • AvailablePackageVersion (string) --

        The package version.

      • ErrorDetails (dict) --

        Additional information if the package is in an error state. Null otherwise.

        • ErrorType (string) --

          The type of error that occurred.

        • ErrorMessage (string) --

          A message describing the error.

Exceptions

update_vpc_endpoint(**kwargs)

Modifies an Amazon OpenSearch Service-managed interface VPC endpoint.

See also: AWS API Documentation

Request Syntax

response = client.update_vpc_endpoint(
    VpcEndpointId='string',
    VpcOptions={
        'SubnetIds': [
            'string',
        ],
        'SecurityGroupIds': [
            'string',
        ]
    }
)
Parameters
  • VpcEndpointId (string) --

    [REQUIRED]

    The unique identifier of the endpoint.

  • VpcOptions (dict) --

    [REQUIRED]

    The security groups and/or subnets to add, remove, or modify.

    • SubnetIds (list) --

      A list of subnet IDs associated with the VPC endpoints for the domain. If your domain uses multiple Availability Zones, you need to provide two subnet IDs, one per zone. Otherwise, provide only one.

      • (string) --
    • SecurityGroupIds (list) --

      The list of security group IDs associated with the VPC endpoints for the domain. If you do not provide a security group ID, OpenSearch Service uses the default security group for the VPC.

      • (string) --
Return type

dict

Returns

Response Syntax

{
    'VpcEndpoint': {
        'VpcEndpointId': 'string',
        'VpcEndpointOwner': 'string',
        'DomainArn': 'string',
        'VpcOptions': {
            'VPCId': 'string',
            'SubnetIds': [
                'string',
            ],
            'AvailabilityZones': [
                'string',
            ],
            'SecurityGroupIds': [
                'string',
            ]
        },
        'Status': 'CREATING'|'CREATE_FAILED'|'ACTIVE'|'UPDATING'|'UPDATE_FAILED'|'DELETING'|'DELETE_FAILED',
        'Endpoint': 'string'
    }
}

Response Structure

  • (dict) --

    • VpcEndpoint (dict) --

      The endpoint to be updated.

      • VpcEndpointId (string) --

        The unique identifier of the endpoint.

      • VpcEndpointOwner (string) --

        The creator of the endpoint.

      • DomainArn (string) --

        The Amazon Resource Name (ARN) of the domain associated with the endpoint.

      • VpcOptions (dict) --

        Options to specify the subnets and security groups for an Amazon OpenSearch Service VPC endpoint.

        • VPCId (string) --

          The ID for your VPC. Amazon VPC generates this value when you create a VPC.

        • SubnetIds (list) --

          A list of subnet IDs associated with the VPC endpoints for the domain.

          • (string) --
        • AvailabilityZones (list) --

          The list of Availability Zones associated with the VPC subnets.

          • (string) --
        • SecurityGroupIds (list) --

          The list of security group IDs associated with the VPC endpoints for the domain.

          • (string) --
      • Status (string) --

        The current status of the endpoint.

      • Endpoint (string) --

        The connection endpoint ID for connecting to the domain.

Exceptions

upgrade_domain(**kwargs)

Allows you to either upgrade your Amazon OpenSearch Service domain or perform an upgrade eligibility check to a compatible version of OpenSearch or Elasticsearch.

See also: AWS API Documentation

Request Syntax

response = client.upgrade_domain(
    DomainName='string',
    TargetVersion='string',
    PerformCheckOnly=True|False,
    AdvancedOptions={
        'string': 'string'
    }
)
Parameters
  • DomainName (string) --

    [REQUIRED]

    Name of the OpenSearch Service domain that you want to upgrade.

  • TargetVersion (string) --

    [REQUIRED]

    OpenSearch or Elasticsearch version to which you want to upgrade, in the format Opensearch_X.Y or Elasticsearch_X.Y.

  • PerformCheckOnly (boolean) -- When true, indicates that an upgrade eligibility check needs to be performed. Does not actually perform the upgrade.
  • AdvancedOptions (dict) --

    Only supports the override_main_response_version parameter and not other advanced options. You can only include this option when upgrading to an OpenSearch version. Specifies whether the domain reports its version as 7.10 so that it continues to work with Elasticsearch OSS clients and plugins.

    • (string) --
      • (string) --
Return type

dict

Returns

Response Syntax

{
    'UpgradeId': 'string',
    'DomainName': 'string',
    'TargetVersion': 'string',
    'PerformCheckOnly': True|False,
    'AdvancedOptions': {
        'string': 'string'
    },
    'ChangeProgressDetails': {
        'ChangeId': 'string',
        'Message': 'string'
    }
}

Response Structure

  • (dict) --

    Container for the response returned by UpgradeDomain operation.

    • UpgradeId (string) --

      The unique identifier of the domain upgrade.

    • DomainName (string) --

      The name of the domain that was upgraded.

    • TargetVersion (string) --

      OpenSearch or Elasticsearch version that the domain was upgraded to.

    • PerformCheckOnly (boolean) --

      When true, indicates that an upgrade eligibility check was performed.

    • AdvancedOptions (dict) --

      The advanced options configuration for the domain.

      • (string) --
        • (string) --
    • ChangeProgressDetails (dict) --

      Container for information about a configuration change happening on a domain.

      • ChangeId (string) --

        The ID of the configuration change.

      • Message (string) --

        A message corresponding to the status of the configuration change.

Exceptions

Client Exceptions

Client exceptions are available on a client instance via the exceptions property. For more detailed instructions and examples on the exact usage of client exceptions, see the error handling user guide.

The available client exceptions are:

class OpenSearchService.Client.exceptions.AccessDeniedException

An error occurred because user does not have permissions to access the resource. Returns HTTP status code 403.

Example

try:
  ...
except client.exceptions.AccessDeniedException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An error occurred because user does not have permissions to access the resource. Returns HTTP status code 403.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.BaseException

An error occurred while processing the request.

Example

try:
  ...
except client.exceptions.BaseException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{
    'message': 'string',
    'Error': {
        'Code': 'string',
        'Message': 'string'
    }
}

Structure

  • (dict) --

    An error occurred while processing the request.

    • message (string) --

      A description of the error.

    • Error (dict) -- Normalized access to common exception attributes.

      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.ConflictException

An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP status code 409.

Example

try:
  ...
except client.exceptions.ConflictException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An error occurred because the client attempts to remove a resource that is currently in use. Returns HTTP status code 409.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.DisabledOperationException

An error occured because the client wanted to access a not supported operation. Gives http status code of 409.

Example

try:
  ...
except client.exceptions.DisabledOperationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An error occured because the client wanted to access a not supported operation. Gives http status code of 409.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.InternalException

The request processing has failed because of an unknown error, exception or failure (the failure is internal to the service) . Gives http status code of 500.

Example

try:
  ...
except client.exceptions.InternalException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    The request processing has failed because of an unknown error, exception or failure (the failure is internal to the service) . Gives http status code of 500.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.InvalidPaginationTokenException

The request processing has failed because of invalid pagination token provided by customer. Returns an HTTP status code of 400.

Example

try:
  ...
except client.exceptions.InvalidPaginationTokenException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    The request processing has failed because of invalid pagination token provided by customer. Returns an HTTP status code of 400.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.InvalidTypeException

An exception for trying to create or access sub-resource that is either invalid or not supported. Gives http status code of 409.

Example

try:
  ...
except client.exceptions.InvalidTypeException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An exception for trying to create or access sub-resource that is either invalid or not supported. Gives http status code of 409.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.LimitExceededException

An exception for trying to create more than allowed resources or sub-resources. Gives http status code of 409.

Example

try:
  ...
except client.exceptions.LimitExceededException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An exception for trying to create more than allowed resources or sub-resources. Gives http status code of 409.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.ResourceAlreadyExistsException

An exception for creating a resource that already exists. Gives http status code of 400.

Example

try:
  ...
except client.exceptions.ResourceAlreadyExistsException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An exception for creating a resource that already exists. Gives http status code of 400.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.ResourceNotFoundException

An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.

Example

try:
  ...
except client.exceptions.ResourceNotFoundException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An exception for accessing or deleting a resource that does not exist. Gives http status code of 400.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.
class OpenSearchService.Client.exceptions.ValidationException

An exception for missing / invalid input fields. Gives http status code of 400.

Example

try:
  ...
except client.exceptions.ValidationException as e:
  print(e.response)
response

The parsed error response. All exceptions have a top level Error key that provides normalized access to common exception atrributes. All other keys are specific to this service or exception class.

Syntax

{}

Structure

  • (dict) --

    An exception for missing / invalid input fields. Gives http status code of 400.

    • Error (dict) -- Normalized access to common exception attributes.
      • Code (string) -- An identifier specifying the exception type.
      • Message (string) -- A descriptive message explaining why the exception occured.

Paginators

The available paginators are: