Amazon OpenSearch Service

2023/05/04 - Amazon OpenSearch Service - 1 new api methods

Changes  DescribeDomainNodes: A new API that provides configuration information for nodes part of the domain

DescribeDomainNodes (new) Link ΒΆ

Returns information about domain and nodes, including data nodes, master nodes, ultrawarm nodes, Availability Zone(s), standby nodes, node configurations, and node states.

See also: AWS API Documentation

Request Syntax

client.describe_domain_nodes(
    DomainName='string'
)
type DomainName

string

param DomainName

[REQUIRED]

The name of the domain.

rtype

dict

returns

Response Syntax

{
    'DomainNodesStatusList': [
        {
            'NodeId': 'string',
            'NodeType': 'Data'|'Ultrawarm'|'Master',
            'AvailabilityZone': 'string',
            'InstanceType': 'm3.medium.search'|'m3.large.search'|'m3.xlarge.search'|'m3.2xlarge.search'|'m4.large.search'|'m4.xlarge.search'|'m4.2xlarge.search'|'m4.4xlarge.search'|'m4.10xlarge.search'|'m5.large.search'|'m5.xlarge.search'|'m5.2xlarge.search'|'m5.4xlarge.search'|'m5.12xlarge.search'|'m5.24xlarge.search'|'r5.large.search'|'r5.xlarge.search'|'r5.2xlarge.search'|'r5.4xlarge.search'|'r5.12xlarge.search'|'r5.24xlarge.search'|'c5.large.search'|'c5.xlarge.search'|'c5.2xlarge.search'|'c5.4xlarge.search'|'c5.9xlarge.search'|'c5.18xlarge.search'|'t3.nano.search'|'t3.micro.search'|'t3.small.search'|'t3.medium.search'|'t3.large.search'|'t3.xlarge.search'|'t3.2xlarge.search'|'ultrawarm1.medium.search'|'ultrawarm1.large.search'|'ultrawarm1.xlarge.search'|'t2.micro.search'|'t2.small.search'|'t2.medium.search'|'r3.large.search'|'r3.xlarge.search'|'r3.2xlarge.search'|'r3.4xlarge.search'|'r3.8xlarge.search'|'i2.xlarge.search'|'i2.2xlarge.search'|'d2.xlarge.search'|'d2.2xlarge.search'|'d2.4xlarge.search'|'d2.8xlarge.search'|'c4.large.search'|'c4.xlarge.search'|'c4.2xlarge.search'|'c4.4xlarge.search'|'c4.8xlarge.search'|'r4.large.search'|'r4.xlarge.search'|'r4.2xlarge.search'|'r4.4xlarge.search'|'r4.8xlarge.search'|'r4.16xlarge.search'|'i3.large.search'|'i3.xlarge.search'|'i3.2xlarge.search'|'i3.4xlarge.search'|'i3.8xlarge.search'|'i3.16xlarge.search'|'r6g.large.search'|'r6g.xlarge.search'|'r6g.2xlarge.search'|'r6g.4xlarge.search'|'r6g.8xlarge.search'|'r6g.12xlarge.search'|'m6g.large.search'|'m6g.xlarge.search'|'m6g.2xlarge.search'|'m6g.4xlarge.search'|'m6g.8xlarge.search'|'m6g.12xlarge.search'|'c6g.large.search'|'c6g.xlarge.search'|'c6g.2xlarge.search'|'c6g.4xlarge.search'|'c6g.8xlarge.search'|'c6g.12xlarge.search'|'r6gd.large.search'|'r6gd.xlarge.search'|'r6gd.2xlarge.search'|'r6gd.4xlarge.search'|'r6gd.8xlarge.search'|'r6gd.12xlarge.search'|'r6gd.16xlarge.search'|'t4g.small.search'|'t4g.medium.search',
            'NodeStatus': 'Active'|'StandBy'|'NotAvailable',
            'StorageType': 'string',
            'StorageVolumeType': 'standard'|'gp2'|'io1'|'gp3',
            'StorageSize': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    The result of a DescribeDomainNodes request. Contains information about the nodes on the requested domain.

    • DomainNodesStatusList (list) --

      Contains nodes information list DomainNodesStatusList with details about the all nodes on the requested domain.

      • (dict) --

        Container for information about nodes on the domain.

        • NodeId (string) --

          The ID of the node.

        • NodeType (string) --

          Indicates whether the nodes is a data, master, or ultrawarm node.

        • AvailabilityZone (string) --

          The Availability Zone of the node.

        • InstanceType (string) --

          The instance type information of the node.

        • NodeStatus (string) --

          Indicates if the node is active or in standby.

        • StorageType (string) --

          Indicates if the node has EBS or instance storage.

        • StorageVolumeType (string) --

          If the nodes has EBS storage, indicates if the volume type is GP2 or GP3. Only applicable for data nodes.

        • StorageSize (string) --

          The storage size of the node, in GiB.