Skip to content

UpdateDomainConfigRequest

Source code in docs_src/capo_opensearch/types/update_domain_config_request.py
class UpdateDomainConfigRequest(TypedDict, closed=True):
    domain_name: "capo_opensearch.types.domain_name.DomainName"
    """<p>The name of the domain that you're updating.</p>"""
    cluster_config: NotRequired["capo_opensearch.types.cluster_config.ClusterConfig"]
    """<p>Changes that you want to make to the cluster configuration, such as the instance type and number of EC2 instances.</p>"""
    ebs_options: NotRequired["capo_opensearch.types.ebs_options.EBSOptions"]
    """<p>The type and size of the EBS volume to attach to instances in the domain.</p>"""
    snapshot_options: NotRequired[
        "capo_opensearch.types.snapshot_options.SnapshotOptions"
    ]
    """<p>Option to set the time, in UTC format, for the daily automated snapshot. Default value is <code>0</code> hours. </p>"""
    vpc_options: NotRequired["capo_opensearch.types.vpc_options.VPCOptions"]
    """<p>Options to specify the subnets and security groups for a VPC 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 OpenSearch Dashboards.</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> </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>"""
    access_policies: NotRequired["capo_opensearch.types.policy_document.PolicyDocument"]
    """<p>Identity and Access Management (IAM) access policy as a JSON-formatted string.</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 your IP address type is currently set to dual stack, you can't change it. </p>"""
    log_publishing_options: NotRequired[
        "capo_opensearch.types.log_publishing_options.LogPublishingOptions"
    ]
    """<p>Options to publish OpenSearch logs to Amazon CloudWatch Logs.</p>"""
    encryption_at_rest_options: NotRequired[
        "capo_opensearch.types.encryption_at_rest_options.EncryptionAtRestOptions"
    ]
    """<p>Encryption at rest options for the domain.</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>"""
    node_to_node_encryption_options: NotRequired[
        "capo_opensearch.types.node_to_node_encryption_options.NodeToNodeEncryptionOptions"
    ]
    """<p>Node-to-node encryption options for the domain.</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"
    ]
    auto_tune_options: NotRequired[
        "capo_opensearch.types.auto_tune_options.AutoTuneOptions"
    ]
    """<p>Options for Auto-Tune.</p>"""
    dry_run: NotRequired["capo_opensearch.types.dry_run.DryRun"]
    """<p>This flag, when set to True, specifies whether the <code>UpdateDomain</code> request should return the results of a dry run analysis without actually applying the change. A dry run determines what type of deployment the update will cause.</p>"""
    dry_run_mode: NotRequired["capo_opensearch.types.dry_run_mode.DryRunMode"]
    """<p>The type of dry run to perform.</p> <ul> <li> <p> <code>Basic</code> only returns the type of deployment (blue/green or dynamic) that the update will cause.</p> </li> <li> <p> <code>Verbose</code> runs an additional check to validate the changes you're making. For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/managedomains-configuration-changes#validation-check">Validating a domain update</a>.</p> </li> </ul>"""
    off_peak_window_options: NotRequired[
        "capo_opensearch.types.off_peak_window_options.OffPeakWindowOptions"
    ]
    """<p>Off-peak window options for the domain.</p>"""
    software_update_options: NotRequired[
        "capo_opensearch.types.software_update_options.SoftwareUpdateOptions"
    ]
    """<p>Service 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. The engine mode can't be changed after the domain is created. For valid values, see <code>EngineMode</code>.</p>"""
    accepted_warnings: NotRequired[
        "capo_opensearch.types.accepted_warnings_list.AcceptedWarningsList"
    ]
    """<p>A list of advisory warning codes to accept for this configuration change. By default, any advisory warning blocks the change. Include the code of each warning you want to accept so the change can proceed. You can find warning codes in the <code>ValidationFailures</code> list returned by <code>DescribeDomainChangeProgress</code> and <code>DescribeDryRunProgress</code>. Critical validation failures cannot be accepted and always block the change. If you omit this parameter or pass an empty list, all warnings block the change. For more information, see <a href="https://docs.aws.amazon.com/opensearch-service/latest/developerguide/managedomains-configuration-changes#validation-check">Validating a domain update</a>.</p>"""

accepted_warnings instance-attribute

accepted_warnings: NotRequired[AcceptedWarningsList]

A list of advisory warning codes to accept for this configuration change. By default, any advisory warning blocks the change. Include the code of each warning you want to accept so the change can proceed. You can find warning codes in the ValidationFailures list returned by DescribeDomainChangeProgress and DescribeDryRunProgress. Critical validation failures cannot be accepted and always block the change. If you omit this parameter or pass an empty list, all warnings block the change. For more information, see Validating a domain update.

access_policies instance-attribute

access_policies: NotRequired[PolicyDocument]

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

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.

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[AutoTuneOptions]

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]

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

cognito_options instance-attribute

cognito_options: NotRequired[CognitoOptions]

Key-value pairs to configure 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

The name of the domain that you're updating.

dry_run instance-attribute

dry_run: NotRequired[DryRun]

This flag, when set to True, specifies whether the UpdateDomain request should return the results of a dry run analysis without actually applying the change. A dry run determines what type of deployment the update will cause.

dry_run_mode instance-attribute

dry_run_mode: NotRequired[DryRunMode]

The type of dry run to perform.

  • Basic only returns the type of deployment (blue/green or dynamic) that the update will cause.

  • Verbose runs an additional check to validate the changes you're making. For more information, see Validating a domain update.

ebs_options instance-attribute

ebs_options: NotRequired[EBSOptions]

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

encryption_at_rest_options instance-attribute

encryption_at_rest_options: NotRequired[EncryptionAtRestOptions]

Encryption at rest options for the domain.

engine_mode instance-attribute

engine_mode: NotRequired[EngineMode]

The engine mode for the domain. The engine mode can't be changed after the domain is created. For valid values, see EngineMode.

identity_center_options instance-attribute

identity_center_options: NotRequired[IdentityCenterOptionsInput]

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 your IP address type is currently set to dual stack, you can't change it.

log_publishing_options instance-attribute

log_publishing_options: NotRequired[LogPublishingOptions]

Options to publish OpenSearch logs to Amazon CloudWatch Logs.

node_to_node_encryption_options instance-attribute

node_to_node_encryption_options: NotRequired[NodeToNodeEncryptionOptions]

Node-to-node encryption options for the domain.

off_peak_window_options instance-attribute

off_peak_window_options: NotRequired[OffPeakWindowOptions]

Off-peak window options for the domain.

snapshot_options instance-attribute

snapshot_options: NotRequired[SnapshotOptions]

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

software_update_options instance-attribute

software_update_options: NotRequired[SoftwareUpdateOptions]

Service software update options for the domain.

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]

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.