Skip to content

CreateDomainRequest

Source code in docs_src/capo_opensearch/types/create_domain_request.py
class CreateDomainRequest(TypedDict, closed=True):
    domain_name: "capo_opensearch.types.domain_name.DomainName"
    """<p>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.</p>"""
    engine_version: NotRequired["capo_opensearch.types.version_string.VersionString"]
    """<p>String of format Elasticsearch_X.Y or OpenSearch_X.Y to specify the engine version for the OpenSearch Service domain. For example, <code>OpenSearch_1.0</code> or <code>Elasticsearch_7.9</code>. For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/createupdatedomains.html#createdomains">Creating and managing Amazon OpenSearch Service domains</a>.</p>"""
    cluster_config: NotRequired["capo_opensearch.types.cluster_config.ClusterConfig"]
    """<p>Container for the cluster configuration of a domain.</p>"""
    ebs_options: NotRequired["capo_opensearch.types.ebs_options.EBSOptions"]
    """<p>Container for the parameters required to enable EBS-based storage for an OpenSearch Service domain.</p>"""
    access_policies: NotRequired["capo_opensearch.types.policy_document.PolicyDocument"]
    """<p>Identity and Access Management (IAM) policy document specifying the access policies for the new domain.</p>"""
    ip_address_type: NotRequired["capo_opensearch.types.ip_address_type.IPAddressType"]
    """<p>Specify either dual stack or IPv4 as your IP address type. Dual stack allows you to share domain resources across IPv4 and IPv6 address types, and is the recommended option. If you set your IP address type to dual stack, you can't change your address type later.</p>"""
    snapshot_options: NotRequired[
        "capo_opensearch.types.snapshot_options.SnapshotOptions"
    ]
    """<p>DEPRECATED. Container for the parameters required to configure automated snapshots of domain indexes.</p>"""
    vpc_options: NotRequired["capo_opensearch.types.vpc_options.VPCOptions"]
    """<p>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 <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/vpc.html">Launching your Amazon OpenSearch Service domains using a VPC</a>.</p>"""
    cognito_options: NotRequired["capo_opensearch.types.cognito_options.CognitoOptions"]
    """<p>Key-value pairs to configure Amazon Cognito authentication. For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/cognito-auth.html">Configuring Amazon Cognito authentication for OpenSearch Dashboards</a>.</p>"""
    encryption_at_rest_options: NotRequired[
        "capo_opensearch.types.encryption_at_rest_options.EncryptionAtRestOptions"
    ]
    """<p>Key-value pairs to enable encryption at rest.</p>"""
    node_to_node_encryption_options: NotRequired[
        "capo_opensearch.types.node_to_node_encryption_options.NodeToNodeEncryptionOptions"
    ]
    """<p>Enables node-to-node encryption.</p>"""
    advanced_options: NotRequired[
        "capo_opensearch.types.advanced_options.AdvancedOptions"
    ]
    """<p>Key-value pairs to specify advanced configuration options. The following key-value pairs are supported:</p> <ul> <li> <p> <code>"rest.action.multi.allow_explicit_index": "true" | "false"</code> - 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.</p> </li> <li> <p> <code>"indices.fielddata.cache.size": "80" </code> - Note the use of a string rather than a boolean. Specifies the percentage of heap space allocated to field data. Default is unbounded.</p> </li> <li> <p> <code>"indices.query.bool.max_clause_count": "1024"</code> - 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 <code>TooManyClauses</code> error.</p> </li> <li> <p> <code>"override_main_response_version": "true" | "false"</code> - 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.</p> </li> </ul> <p>For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/createupdatedomains.html#createdomain-configure-advanced-options">Advanced cluster parameters</a>.</p>"""
    log_publishing_options: NotRequired[
        "capo_opensearch.types.log_publishing_options.LogPublishingOptions"
    ]
    """<p>Key-value pairs to configure log publishing.</p>"""
    domain_endpoint_options: NotRequired[
        "capo_opensearch.types.domain_endpoint_options.DomainEndpointOptions"
    ]
    """<p>Additional options for the domain endpoint, such as whether to require HTTPS for all traffic.</p>"""
    advanced_security_options: NotRequired[
        "capo_opensearch.types.advanced_security_options_input.AdvancedSecurityOptionsInput"
    ]
    """<p>Options for fine-grained access control.</p>"""
    identity_center_options: NotRequired[
        "capo_opensearch.types.identity_center_options_input.IdentityCenterOptionsInput"
    ]
    """<p>Configuration options for enabling and managing IAM Identity Center integration within a domain.</p>"""
    tag_list: NotRequired["capo_opensearch.types.tag_list.TagList"]
    """<p>List of tags to add to the domain upon creation.</p>"""
    auto_tune_options: NotRequired[
        "capo_opensearch.types.auto_tune_options_input.AutoTuneOptionsInput"
    ]
    """<p>Options for Auto-Tune.</p>"""
    off_peak_window_options: NotRequired[
        "capo_opensearch.types.off_peak_window_options.OffPeakWindowOptions"
    ]
    """<p>Specifies a daily 10-hour time block during which OpenSearch Service can perform configuration changes on the domain, including service software updates and Auto-Tune enhancements that require a blue/green deployment. If no options are specified, the default start time of 10:00 P.M. local time (for the Region that the domain is created in) is used.</p>"""
    software_update_options: NotRequired[
        "capo_opensearch.types.software_update_options.SoftwareUpdateOptions"
    ]
    """<p>Software update options for the domain.</p>"""
    aiml_options: NotRequired[
        "capo_opensearch.types.aiml_options_input.AIMLOptionsInput"
    ]
    """<p>Options for all machine learning features for the specified domain.</p>"""
    deployment_strategy_options: NotRequired[
        "capo_opensearch.types.deployment_strategy_options.DeploymentStrategyOptions"
    ]
    """<p>Specifies the deployment strategy options for the domain.</p>"""
    automated_snapshot_pause_options: NotRequired[
        "capo_opensearch.types.automated_snapshot_pause_request_options.AutomatedSnapshotPauseRequestOptions"
    ]
    """<p>Specifies the automated snapshot pause options for the domain.</p> <important> <p>Suspending snapshots reduces data protection. You cannot restore your domain to points in time when snapshots are suspended. Use this feature only for short-term operational needs such as migrations or maintenance windows.</p> </important> <p>Maximum suspension duration: 3 days.</p>"""
    use_case: NotRequired["capo_opensearch.types.domain_use_case.DomainUseCase"]
    """<p>The primary use case for the domain. For valid values, see <code>DomainUseCase</code>.</p>"""
    engine_mode: NotRequired["capo_opensearch.types.engine_mode.EngineMode"]
    """<p>The engine mode for the domain. For valid values and requirements, see <code>EngineMode</code>.</p>"""

access_policies instance-attribute

access_policies: NotRequired[PolicyDocument]

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

advanced_options instance-attribute

advanced_options: NotRequired[AdvancedOptions]

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.

advanced_security_options instance-attribute

advanced_security_options: NotRequired[AdvancedSecurityOptionsInput]

Options for fine-grained access control.

aiml_options instance-attribute

aiml_options: NotRequired[AIMLOptionsInput]

Options for all machine learning features for the specified domain.

auto_tune_options instance-attribute

auto_tune_options: NotRequired[AutoTuneOptionsInput]

Options for Auto-Tune.

automated_snapshot_pause_options instance-attribute

automated_snapshot_pause_options: NotRequired[AutomatedSnapshotPauseRequestOptions]

Specifies the automated snapshot pause options for the domain.

Suspending snapshots reduces data protection. You cannot restore your domain to points in time when snapshots are suspended. Use this feature only for short-term operational needs such as migrations or maintenance windows.

Maximum suspension duration: 3 days.

cluster_config instance-attribute

cluster_config: NotRequired[ClusterConfig]

Container for the cluster configuration of a domain.

cognito_options instance-attribute

cognito_options: NotRequired[CognitoOptions]

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

deployment_strategy_options instance-attribute

deployment_strategy_options: NotRequired[DeploymentStrategyOptions]

Specifies the deployment strategy options for the domain.

domain_endpoint_options instance-attribute

domain_endpoint_options: NotRequired[DomainEndpointOptions]

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

domain_name instance-attribute

domain_name: DomainName

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.

ebs_options instance-attribute

ebs_options: NotRequired[EBSOptions]

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

encryption_at_rest_options instance-attribute

encryption_at_rest_options: NotRequired[EncryptionAtRestOptions]

Key-value pairs to enable encryption at rest.

engine_mode instance-attribute

engine_mode: NotRequired[EngineMode]

The engine mode for the domain. For valid values and requirements, see EngineMode.

engine_version instance-attribute

engine_version: NotRequired[VersionString]

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.

identity_center_options instance-attribute

identity_center_options: NotRequired[IdentityCenterOptionsInput]

Configuration options for enabling and managing IAM Identity Center integration within a domain.

ip_address_type instance-attribute

ip_address_type: NotRequired[IPAddressType]

Specify either dual stack or IPv4 as your IP address type. Dual stack allows you to share domain resources across IPv4 and IPv6 address types, and is the recommended option. If you set your IP address type to dual stack, you can't change your address type later.

log_publishing_options instance-attribute

log_publishing_options: NotRequired[LogPublishingOptions]

Key-value pairs to configure log publishing.

node_to_node_encryption_options instance-attribute

node_to_node_encryption_options: NotRequired[NodeToNodeEncryptionOptions]

Enables node-to-node encryption.

off_peak_window_options instance-attribute

off_peak_window_options: NotRequired[OffPeakWindowOptions]

Specifies a daily 10-hour time block during which OpenSearch Service can perform configuration changes on the domain, including service software updates and Auto-Tune enhancements that require a blue/green deployment. If no options are specified, the default start time of 10:00 P.M. local time (for the Region that the domain is created in) is used.

snapshot_options instance-attribute

snapshot_options: NotRequired[SnapshotOptions]

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

software_update_options instance-attribute

software_update_options: NotRequired[SoftwareUpdateOptions]

Software update options for the domain.

tag_list instance-attribute

tag_list: NotRequired[TagList]

List of tags to add to the domain upon creation.

use_case instance-attribute

use_case: NotRequired[DomainUseCase]

The primary use case for the domain. For valid values, see DomainUseCase.

vpc_options instance-attribute

vpc_options: NotRequired[VPCOptions]

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.