Class: AWS.OpenSearch

var params = {
  DataSourceType: { /* required */
    S3GlueDataCatalog: {
      RoleArn: 'STRING_VALUE'
    }
  },
  DomainName: 'STRING_VALUE', /* required */
  Name: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE'
};
opensearch.addDataSource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DomainName — (String)

    The name of the domain to add the data source to.

  • Name — (String)

    A name for the data source.

  • DataSourceType — (map)

    The type of data source.

    • S3GlueDataCatalog — (map)

      An Amazon S3 data source.

      • RoleArn — (String)

        >The Amazon Resource Name (ARN) for the S3 Glue Data Catalog.

  • Description — (String)

    A description of the data source.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Message — (String)

      A message associated with creation of the data source.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  ARN: 'STRING_VALUE', /* required */
  TagList: [ /* required */
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ]
};
opensearch.addTags(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • ARN — (String)

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

  • TagList — (Array<map>)

    List of resource tags.

    • Key — required — (String)

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

    • Value — required — (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

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DomainName: 'STRING_VALUE', /* required */
  PackageID: 'STRING_VALUE' /* required */
};
opensearch.associatePackage(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • PackageID — (String)

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

  • DomainName — (String)

    Name of the domain to associate the package with.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • DomainPackageDetails — (map)

      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.

        Possible values include:
        • "TXT-DICTIONARY"
        • "ZIP-PLUGIN"
      • LastUpdated — (Date)

        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.

        Possible values include:
        • "ASSOCIATING"
        • "ASSOCIATION_FAILED"
        • "ACTIVE"
        • "DISSOCIATING"
        • "DISSOCIATION_FAILED"
      • PackageVersion — (String)

        The current version of the package.

      • ReferencePath — (String)

        The relative path of the package on the OpenSearch Service cluster nodes. This is synonym_path when the package is for synonym files.

      • ErrorDetails — (map)

        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.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  Account: 'STRING_VALUE', /* required */
  DomainName: 'STRING_VALUE' /* required */
};
opensearch.authorizeVpcEndpointAccess(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DomainName — (String)

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

  • Account — (String)

    The Amazon Web Services account ID to grant access to.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • AuthorizedPrincipal — (map)

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

      • PrincipalType — (String)

        The type of principal.

        Possible values include:
        • "AWS_ACCOUNT"
        • "AWS_SERVICE"
      • Principal — (String)

        The IAM principal that is allowed access to the domain.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DomainName: 'STRING_VALUE', /* required */
  DryRun: true || false
};
opensearch.cancelDomainConfigChange(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DomainName — (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.

  • DryRun — (Boolean)

    When set to True, returns the list of change IDs and properties that will be cancelled without actually cancelling the change.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CancelledChangeIds — (Array<String>)

      The unique identifiers of the changes that were cancelled.

    • CancelledChangeProperties — (Array<map>)

      The domain change properties that were cancelled.

      • PropertyName — (String)

        The name of the property whose change was cancelled.

      • CancelledValue — (String)

        The pending value of the property that was cancelled. This would have been the eventual value of the property if the chance had not been cancelled.

      • ActiveValue — (String)

        The current value of the property, after the change was cancelled.

    • DryRun — (Boolean)

      Whether or not the request was a dry run. If True, the changes were not actually cancelled.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DomainName: 'STRING_VALUE' /* required */
};
opensearch.cancelServiceSoftwareUpdate(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DomainName — (String)

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

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • ServiceSoftwareOptions — (map)

      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.

        Possible values include:
        • "PENDING_UPDATE"
        • "IN_PROGRESS"
        • "COMPLETED"
        • "NOT_ELIGIBLE"
        • "ELIGIBLE"
      • Description — (String)

        A description of the service software update status.

      • AutomatedUpdateDate — (Date)

        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.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DomainName: 'STRING_VALUE', /* required */
  AIMLOptions: {
    NaturalLanguageQueryGenerationOptions: {
      DesiredState: ENABLED | DISABLED
    }
  },
  AccessPolicies: 'STRING_VALUE',
  AdvancedOptions: {
    '<String>': 'STRING_VALUE',
    /* '<String>': ... */
  },
  AdvancedSecurityOptions: {
    AnonymousAuthEnabled: true || false,
    Enabled: true || false,
    InternalUserDatabaseEnabled: true || false,
    JWTOptions: {
      Enabled: true || false,
      PublicKey: 'STRING_VALUE',
      RolesKey: 'STRING_VALUE',
      SubjectKey: 'STRING_VALUE'
    },
    MasterUserOptions: {
      MasterUserARN: 'STRING_VALUE',
      MasterUserName: 'STRING_VALUE',
      MasterUserPassword: 'STRING_VALUE'
    },
    SAMLOptions: {
      Enabled: true || false,
      Idp: {
        EntityId: 'STRING_VALUE', /* required */
        MetadataContent: 'STRING_VALUE' /* required */
      },
      MasterBackendRole: 'STRING_VALUE',
      MasterUserName: 'STRING_VALUE',
      RolesKey: 'STRING_VALUE',
      SessionTimeoutMinutes: 'NUMBER_VALUE',
      SubjectKey: 'STRING_VALUE'
    }
  },
  AutoTuneOptions: {
    DesiredState: ENABLED | DISABLED,
    MaintenanceSchedules: [
      {
        CronExpressionForRecurrence: 'STRING_VALUE',
        Duration: {
          Unit: HOURS,
          Value: 'NUMBER_VALUE'
        },
        StartAt: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789
      },
      /* more items */
    ],
    UseOffPeakWindow: true || false
  },
  ClusterConfig: {
    ColdStorageOptions: {
      Enabled: true || false /* required */
    },
    DedicatedMasterCount: 'NUMBER_VALUE',
    DedicatedMasterEnabled: true || false,
    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 | or1.medium.search | or1.large.search | or1.xlarge.search | or1.2xlarge.search | or1.4xlarge.search | or1.8xlarge.search | or1.12xlarge.search | or1.16xlarge.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: 'NUMBER_VALUE',
    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 | or1.medium.search | or1.large.search | or1.xlarge.search | or1.2xlarge.search | or1.4xlarge.search | or1.8xlarge.search | or1.12xlarge.search | or1.16xlarge.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,
    MultiAZWithStandbyEnabled: true || false,
    WarmCount: 'NUMBER_VALUE',
    WarmEnabled: true || false,
    WarmType: ultrawarm1.medium.search | ultrawarm1.large.search | ultrawarm1.xlarge.search,
    ZoneAwarenessConfig: {
      AvailabilityZoneCount: 'NUMBER_VALUE'
    },
    ZoneAwarenessEnabled: true || false
  },
  CognitoOptions: {
    Enabled: true || false,
    IdentityPoolId: 'STRING_VALUE',
    RoleArn: 'STRING_VALUE',
    UserPoolId: 'STRING_VALUE'
  },
  DomainEndpointOptions: {
    CustomEndpoint: 'STRING_VALUE',
    CustomEndpointCertificateArn: 'STRING_VALUE',
    CustomEndpointEnabled: true || false,
    EnforceHTTPS: true || false,
    TLSSecurityPolicy: Policy-Min-TLS-1-0-2019-07 | Policy-Min-TLS-1-2-2019-07 | Policy-Min-TLS-1-2-PFS-2023-10
  },
  EBSOptions: {
    EBSEnabled: true || false,
    Iops: 'NUMBER_VALUE',
    Throughput: 'NUMBER_VALUE',
    VolumeSize: 'NUMBER_VALUE',
    VolumeType: standard | gp2 | io1 | gp3
  },
  EncryptionAtRestOptions: {
    Enabled: true || false,
    KmsKeyId: 'STRING_VALUE'
  },
  EngineVersion: 'STRING_VALUE',
  IPAddressType: ipv4 | dualstack,
  LogPublishingOptions: {
    '<LogType>': {
      CloudWatchLogsLogGroupArn: 'STRING_VALUE',
      Enabled: true || false
    },
    /* '<LogType>': ... */
  },
  NodeToNodeEncryptionOptions: {
    Enabled: true || false
  },
  OffPeakWindowOptions: {
    Enabled: true || false,
    OffPeakWindow: {
      WindowStartTime: {
        Hours: 'NUMBER_VALUE', /* required */
        Minutes: 'NUMBER_VALUE' /* required */
      }
    }
  },
  SnapshotOptions: {
    AutomatedSnapshotStartHour: 'NUMBER_VALUE'
  },
  SoftwareUpdateOptions: {
    AutoSoftwareUpdateEnabled: true || false
  },
  TagList: [
    {
      Key: 'STRING_VALUE', /* required */
      Value: 'STRING_VALUE' /* required */
    },
    /* more items */
  ],
  VPCOptions: {
    SecurityGroupIds: [
      'STRING_VALUE',
      /* more items */
    ],
    SubnetIds: [
      'STRING_VALUE',
      /* more items */
    ]
  }
};
opensearch.createDomain(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DomainName — (String)

    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 — (map)

    Container for the cluster configuration of a domain.

    • InstanceType — (String)

      Instance type of data nodes in the cluster.

      Possible values include:
      • "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"
      • "or1.medium.search"
      • "or1.large.search"
      • "or1.xlarge.search"
      • "or1.2xlarge.search"
      • "or1.4xlarge.search"
      • "or1.8xlarge.search"
      • "or1.12xlarge.search"
      • "or1.16xlarge.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 — (Integer)

      Number of data 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 — (map)

      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.

      Possible values include:
      • "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"
      • "or1.medium.search"
      • "or1.large.search"
      • "or1.xlarge.search"
      • "or1.2xlarge.search"
      • "or1.4xlarge.search"
      • "or1.8xlarge.search"
      • "or1.12xlarge.search"
      • "or1.16xlarge.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 — (Integer)

      Number of dedicated master nodes in the cluster. This number must be greater than 2 and not 4, 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.

      Possible values include:
      • "ultrawarm1.medium.search"
      • "ultrawarm1.large.search"
      • "ultrawarm1.xlarge.search"
    • WarmCount — (Integer)

      The number of warm nodes in the cluster.

    • ColdStorageOptions — (map)

      Container for cold storage configuration options.

      • Enabled — required — (Boolean)

        Whether to enable or disable cold storage on the domain. You must enable UltraWarm storage to enable cold storage.

    • MultiAZWithStandbyEnabled — (Boolean)

      A boolean that indicates whether a multi-AZ domain is turned on with a standby AZ. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

  • EBSOptions — (map)

    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.

      Possible values include:
      • "standard"
      • "gp2"
      • "io1"
      • "gp3"
    • 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.

  • IPAddressType — (String)

    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.

    Possible values include:
    • "ipv4"
    • "dualstack"
  • SnapshotOptions — (map)

    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 — (map)

    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 — (Array<String>)

      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.

    • SecurityGroupIds — (Array<String>)

      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.

  • CognitoOptions — (map)

    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 — (map)

    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 — (map)

    Enables node-to-node encryption.

    • Enabled — (Boolean)

      True to enable node-to-node encryption.

  • AdvancedOptions — (map<String>)

    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.

  • LogPublishingOptions — (map<map>)

    Key-value pairs to configure log publishing.

    • 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 — (map)

    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. The policy can be one of the following values:

      • Policy-Min-TLS-1-0-2019-07: TLS security policy that supports TLS version 1.0 to TLS version 1.2

      • Policy-Min-TLS-1-2-2019-07: TLS security policy that supports only TLS version 1.2

      • Policy-Min-TLS-1-2-PFS-2023-10: TLS security policy that supports TLS version 1.2 to TLS version 1.3 with perfect forward secrecy cipher suites

      Possible values include:
      • "Policy-Min-TLS-1-0-2019-07"
      • "Policy-Min-TLS-1-2-2019-07"
      • "Policy-Min-TLS-1-2-PFS-2023-10"
    • 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 — (map)

    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 — (map)

      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 — (map)

      Container for information about the SAML configuration for OpenSearch Dashboards.

      • Enabled — (Boolean)

        True to enable SAML authentication for a domain.

      • Idp — (map)

        The SAML Identity Provider's information.

        • MetadataContent — required — (String)

          The metadata of the SAML application, in XML format.

        • EntityId — required — (String)

          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.

    • JWTOptions — (map)

      Container for information about the JWT configuration of the Amazon OpenSearch Service.

      • Enabled — (Boolean)

        True to enable JWT authentication and authorization for a domain.

      • SubjectKey — (String)

        Element of the JWT assertion to use for the user name.

      • RolesKey — (String)

        Element of the JWT assertion to use for roles.

      • PublicKey — (String)

        Element of the JWT assertion used by the cluster to verify JWT signatures.

    • 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 — (Array<map>)

    List of tags to add to the domain upon creation.

    • Key — required — (String)

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

    • Value — required — (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

  • AutoTuneOptions — (map)

    Options for Auto-Tune.

    • DesiredState — (String)

      Whether Auto-Tune is enabled or disabled.

      Possible values include:
      • "ENABLED"
      • "DISABLED"
    • MaintenanceSchedules — (Array<map>)

      A list of maintenance schedules during which Auto-Tune can deploy changes. Maintenance windows are deprecated and have been replaced with off-peak windows.

      • StartAt — (Date)

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

      • Duration — (map)

        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.

          Possible values include:
          • "HOURS"
      • CronExpressionForRecurrence — (String)

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

    • UseOffPeakWindow — (Boolean)

      Whether to schedule Auto-Tune optimizations that require blue/green deployments during the domain's configured daily off-peak window.

  • OffPeakWindowOptions — (map)

    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.

    • Enabled — (Boolean)

      Whether to enable an off-peak window.

      This option is only available when modifying a domain created prior to February 16, 2023, not when creating a new domain. All domains created after this date have the off-peak window enabled by default. You can't disable the off-peak window after it's enabled for a domain.

    • OffPeakWindow — (map)

      Off-peak window settings for the domain.

      • WindowStartTime — (map)

        A custom start time for the off-peak window, in Coordinated Universal Time (UTC). The window length will always be 10 hours, so you can't specify an end time. For example, if you specify 11:00 P.M. UTC as a start time, the end time will automatically be set to 9:00 A.M.

        • Hours — required — (Integer)

          The start hour of the window in Coordinated Universal Time (UTC), using 24-hour time. For example, 17 refers to 5:00 P.M. UTC.

        • Minutes — required — (Integer)

          The start minute of the window, in UTC.

  • SoftwareUpdateOptions — (map)

    Software update options for the domain.

    • AutoSoftwareUpdateEnabled — (Boolean)

      Whether automatic service software updates are enabled for the domain.

  • AIMLOptions — (map)

    Options for all machine learning features for the specified domain.

    • NaturalLanguageQueryGenerationOptions — (map)

      Container for parameters required for natural language query generation on the specified domain.

      • DesiredState — (String)

        The desired state of the natural language query generation feature. Valid values are ENABLED and DISABLED.

        Possible values include:
        • "ENABLED"
        • "DISABLED"

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • DomainStatus — (map)

      The status of the newly created domain.

      • DomainId — required — (String)

        Unique identifier for the domain.

      • DomainName — required — (String)

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

      • ARN — required — (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.

      • EndpointV2 — (String)

        If IPAddressType to set to dualstack, a version 2 domain endpoint is provisioned. This endpoint functions like a normal endpoint, except that it works with both IPv4 and IPv6 IP addresses. Normal endpoints work only with IPv4 IP addresses.

      • Endpoints — (map<String>)

        The key-value pair that exists if the OpenSearch Service domain uses VPC endpoints. For example:

        • IPv4 IP addresses - 'vpc','vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.us-east-1.es.amazonaws.com'

        • Dual stack IP addresses - 'vpcv2':'vpc-endpoint-h2dsd34efgyghrtguk5gt6j2foh4.aos.us-east-1.on.aws'

      • DomainEndpointV2HostedZoneId — (String)

        The dual stack hosted zone ID for the domain.

      • 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 — required — (map)

        Container for the cluster configuration of the domain.

        • InstanceType — (String)

          Instance type of data nodes in the cluster.

          Possible values include:
          • "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"
          • "or1.medium.search"
          • "or1.large.search"
          • "or1.xlarge.search"
          • "or1.2xlarge.search"
          • "or1.4xlarge.search"
          • "or1.8xlarge.search"
          • "or1.12xlarge.search"
          • "or1.16xlarge.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 — (Integer)

          Number of data 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 — (map)

          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.

          Possible values include:
          • "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"
          • "or1.medium.search"
          • "or1.large.search"
          • "or1.xlarge.search"
          • "or1.2xlarge.search"
          • "or1.4xlarge.search"
          • "or1.8xlarge.search"
          • "or1.12xlarge.search"
          • "or1.16xlarge.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 — (Integer)

          Number of dedicated master nodes in the cluster. This number must be greater than 2 and not 4, 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.

          Possible values include:
          • "ultrawarm1.medium.search"
          • "ultrawarm1.large.search"
          • "ultrawarm1.xlarge.search"
        • WarmCount — (Integer)

          The number of warm nodes in the cluster.

        • ColdStorageOptions — (map)

          Container for cold storage configuration options.

          • Enabled — required — (Boolean)

            Whether to enable or disable cold storage on the domain. You must enable UltraWarm storage to enable cold storage.

        • MultiAZWithStandbyEnabled — (Boolean)

          A boolean that indicates whether a multi-AZ domain is turned on with a standby AZ. For more information, see Configuring a multi-AZ domain in Amazon OpenSearch Service.

      • EBSOptions — (map)

        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.

          Possible values include:
          • "standard"
          • "gp2"
          • "io1"
          • "gp3"
        • 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.

      • IPAddressType — (String)

        The type of IP addresses supported by the endpoint for the domain.

        Possible values include:
        • "ipv4"
        • "dualstack"
      • SnapshotOptions — (map)

        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 — (map)

        The VPC configuration for the domain.

        • VPCId — (String)

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

        • SubnetIds — (Array<String>)

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

        • AvailabilityZones — (Array<String>)

          The list of Availability Zones associated with the VPC subnets.

        • SecurityGroupIds — (Array<String>)

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

      • CognitoOptions — (map)

        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 — (map)

        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 — (map)

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

        • Enabled — (Boolean)

          True to enable node-to-node encryption.

      • AdvancedOptions — (map<String>)

        Key-value pairs that specify advanced configuration options.

      • LogPublishingOptions — (map<map>)

        Log publishing options for the domain.

        • 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 — (map)

        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.

          Possible values include:
          • "PENDING_UPDATE"
          • "IN_PROGRESS"
          • "COMPLETED"
          • "NOT_ELIGIBLE"
          • "ELIGIBLE"
        • Description — (String)

          A description of the service software update status.

        • AutomatedUpdateDate — (Date)

          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 — (map)

        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. The policy can be one of the following values:

          • Policy-Min-TLS-1-0-2019-07: TLS security policy that supports TLS version 1.0 to TLS version 1.2

          • Policy-Min-TLS-1-2-2019-07: TLS security policy that supports only TLS version 1.2

          • Policy-Min-TLS-1-2-PFS-2023-10: TLS security policy that supports TLS version 1.2 to TLS version 1.3 with perfect forward secrecy cipher suites

          Possible values include:
          • "Policy-Min-TLS-1-0-2019-07"
          • "Policy-Min-TLS-1-2-2019-07"
          • "Policy-Min-TLS-1-2-PFS-2023-10"
        • 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 — (map)

        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 — (map)

          Container for information about the SAML configuration for OpenSearch Dashboards.

          • Enabled — (Boolean)

            True if SAML is enabled.

          • Idp — (map)

            Describes the SAML identity provider's information.

            • MetadataContent — required — (String)

              The metadata of the SAML application, in XML format.

            • EntityId — required — (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.

        • JWTOptions — (map)

          Container for information about the JWT configuration of the Amazon OpenSearch Service.

          • Enabled — (Boolean)

            True if JWT use is enabled.

          • SubjectKey — (String)

            The key used for matching the JWT subject attribute.

          • RolesKey — (String)

            The key used for matching the JWT roles attribute.

          • PublicKey — (String)

            The key used to verify the signature of incoming JWT requests.

        • AnonymousAuthDisableDate — (Date)

          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 — (map)

        Auto-Tune settings for the domain.

        • State — (String)

          The current state of Auto-Tune on the domain.

          Possible values include:
          • "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)

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

        • UseOffPeakWindow — (Boolean)

          Whether the domain's off-peak window will be used to deploy Auto-Tune changes rather than a maintenance schedule.

      • ChangeProgressDetails — (map)

        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.

        • ConfigChangeStatus — (String)

          The current status of the configuration change.

          Possible values include:
          • "Pending"
          • "Initializing"
          • "Validating"
          • "ValidationFailed"
          • "ApplyingChanges"
          • "Completed"
          • "PendingUserInput"
          • "Cancelled"
        • InitiatedBy — (String)

          The IAM principal who initiated the configuration change.

          Possible values include:
          • "CUSTOMER"
          • "SERVICE"
        • StartTime — (Date)

          The time that the configuration change was initiated, in Universal Coordinated Time (UTC).

        • LastUpdatedTime — (Date)

          The last time that the configuration change was updated.

      • OffPeakWindowOptions — (map)

        Options that specify a custom 10-hour window during which OpenSearch Service can perform configuration changes on the domain.

        • Enabled — (Boolean)

          Whether to enable an off-peak window.

          This option is only available when modifying a domain created prior to February 16, 2023, not when creating a new domain. All domains created after this date have the off-peak window enabled by default. You can't disable the off-peak window after it's enabled for a domain.

        • OffPeakWindow — (map)

          Off-peak window settings for the domain.

          • WindowStartTime — (map)

            A custom start time for the off-peak window, in Coordinated Universal Time (UTC). The window length will always be 10 hours, so you can't specify an end time. For example, if you specify 11:00 P.M. UTC as a start time, the end time will automatically be set to 9:00 A.M.

            • Hours — required — (Integer)

              The start hour of the window in Coordinated Universal Time (UTC), using 24-hour time. For example, 17 refers to 5:00 P.M. UTC.

            • Minutes — required — (Integer)

              The start minute of the window, in UTC.

      • SoftwareUpdateOptions — (map)

        Service software update options for the domain.

        • AutoSoftwareUpdateEnabled — (Boolean)

          Whether automatic service software updates are enabled for the domain.

      • DomainProcessingStatus — (String)

        The status of any changes that are currently in progress for the domain.

        Possible values include:
        • "Creating"
        • "Active"
        • "Modifying"
        • "UpgradingEngineVersion"
        • "UpdatingServiceSoftware"
        • "Isolated"
        • "Deleting"
      • ModifyingProperties — (Array<map>)

        Information about the domain properties that are currently being modified.

        • Name — (String)

          The name of the property that is currently being modified.

        • ActiveValue — (String)

          The current value of the domain property that is being modified.

        • PendingValue — (String)

          The value that the property that is currently being modified will eventually have.

        • ValueType — (String)

          The type of value that is currently being modified. Properties can have two types:

          • PLAIN_TEXT: Contain direct values such as "1", "True", or "c5.large.search".

          • STRINGIFIED_JSON: Contain content in JSON format, such as {"Enabled":"True"}".

          Possible values include:
          • "PLAIN_TEXT"
          • "STRINGIFIED_JSON"
      • AIMLOptions — (map)

        Container for parameters required to enable all machine learning features.

        • NaturalLanguageQueryGenerationOptions — (map)

          Container for parameters required for natural language query generation on the specified domain.

          • DesiredState — (String)

            The desired state of the natural language query generation feature. Valid values are ENABLED and DISABLED.

            Possible values include:
            • "ENABLED"
            • "DISABLED"
          • CurrentState — (String)

            The current state of the natural language query generation feature, indicating completion, in progress, or failure.

            Possible values include:
            • "NOT_ENABLED"
            • "ENABLE_COMPLETE"
            • "ENABLE_IN_PROGRESS"
            • "ENABLE_FAILED"
            • "DISABLE_COMPLETE"
            • "DISABLE_IN_PROGRESS"
            • "DISABLE_FAILED"

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  ConnectionAlias: 'STRING_VALUE', /* required */
  LocalDomainInfo: { /* required */
    AWSDomainInformation: {
      DomainName: 'STRING_VALUE', /* required */
      OwnerId: 'STRING_VALUE',
      Region: 'STRING_VALUE'
    }
  },
  RemoteDomainInfo: { /* required */
    AWSDomainInformation: {
      DomainName: 'STRING_VALUE', /* required */
      OwnerId: 'STRING_VALUE',
      Region: 'STRING_VALUE'
    }
  },
  ConnectionMode: DIRECT | VPC_ENDPOINT,
  ConnectionProperties: {
    CrossClusterSearch: {
      SkipUnavailable: ENABLED | DISABLED
    },
    Endpoint: 'STRING_VALUE'
  }
};
opensearch.createOutboundConnection(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • LocalDomainInfo — (map)

    Name and Region of the source (local) domain.

    • AWSDomainInformation — (map)

      Information about an Amazon OpenSearch Service domain.

      • OwnerId — (String)

        The Amazon Web Services account ID of the domain owner.

      • DomainName — required — (String)

        Name of the domain.

      • Region — (String)

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

  • RemoteDomainInfo — (map)

    Name and Region of the destination (remote) domain.

    • AWSDomainInformation — (map)

      Information about an Amazon OpenSearch Service domain.

      • OwnerId — (String)

        The Amazon Web Services account ID of the domain owner.

      • DomainName — required — (String)

        Name of the domain.

      • Region — (String)

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

  • ConnectionAlias — (String)

    Name of the connection.

  • ConnectionMode — (String)

    The connection mode.

    Possible values include:
    • "DIRECT"
    • "VPC_ENDPOINT"
  • ConnectionProperties — (map)

    The ConnectionProperties for the outbound connection.

    • Endpoint — (String)

      The Endpoint attribute cannot be modified.

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

    • CrossClusterSearch — (map)

      The connection properties for cross cluster search.

      • SkipUnavailable — (String)

        The status of the SkipUnavailable setting for the outbound connection. This feature allows you to specify some clusters as optional and ensure that your cross-cluster queries return partial results despite failures on one or more remote clusters.

        Possible values include:
        • "ENABLED"
        • "DISABLED"

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • LocalDomainInfo — (map)

      Information about the source (local) domain.

      • AWSDomainInformation — (map)

        Information about an Amazon OpenSearch Service domain.

        • OwnerId — (String)

          The Amazon Web Services account ID of the domain owner.

        • DomainName — required — (String)

          Name of the domain.

        • Region — (String)

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

    • RemoteDomainInfo — (map)

      Information about the destination (remote) domain.

      • AWSDomainInformation — (map)

        Information about an Amazon OpenSearch Service domain.

        • OwnerId — (String)

          The Amazon Web Services account ID of the domain owner.

        • DomainName — required — (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 — (map)

      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.

        Possible values include:
        • "VALIDATING"
        • "VALIDATION_FAILED"
        • "PENDING_ACCEPTANCE"
        • "APPROVED"
        • "PROVISIONING"
        • "ACTIVE"
        • "REJECTING"
        • "REJECTED"
        • "DELETING"
        • "DELETED"
      • Message — (String)

        Verbose information for the outbound connection.

    • ConnectionId — (String)

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

    • ConnectionMode — (String)

      The connection mode.

      Possible values include:
      • "DIRECT"
      • "VPC_ENDPOINT"
    • ConnectionProperties — (map)

      The ConnectionProperties for the newly created connection.

      • Endpoint — (String)

        The Endpoint attribute cannot be modified.

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

      • CrossClusterSearch — (map)

        The connection properties for cross cluster search.

        • SkipUnavailable — (String)

          The status of the SkipUnavailable setting for the outbound connection. This feature allows you to specify some clusters as optional and ensure that your cross-cluster queries return partial results despite failures on one or more remote clusters.

          Possible values include:
          • "ENABLED"
          • "DISABLED"

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  PackageName: 'STRING_VALUE', /* required */
  PackageSource: { /* required */
    S3BucketName: 'STRING_VALUE',
    S3Key: 'STRING_VALUE'
  },
  PackageType: TXT-DICTIONARY | ZIP-PLUGIN, /* required */
  PackageDescription: 'STRING_VALUE'
};
opensearch.createPackage(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —