All Products
Search
Document Center

OpenSearch:Instance management

Last Updated:Jun 23, 2026

View and manage your OpenSearch Vector Search Edition instances, including instance details, network settings, API endpoints, and node resources.

List page overview

image

The Instance List page displays all purchased instances. You can perform the following operations in the Operations column:

  • Manage: Go to the instance details page.

  • Query data: Run simple search tests on the instance.

  • Upgrade/Downgrade: Increase or decrease the number of query nodes and data nodes.

Basic information

On the OpenSearch Vector Search Edition console, go to the Instance List page. Find your instance and click Manage in the Operations column to go to the instance details page.

Instance details 1.png

Field

Description

Instance Name/Instance ID

The name of your instance. By default, the instance name is the same as the instance ID. Instances under the same Alibaba Cloud account can share the same name. The instance ID is automatically generated when you purchase an instance.

Instance Status

The billing status of the instance. Valid values: Normal and Frozen. An instance is frozen if you have overdue payments for a pay-as-you-go instance.

Tags

Tags that you add to identify the business a resource belongs to.

Creation Time

The time when the instance was created.

Product Version

Vector Search Edition.

Current Engine Version

New version: vector_service_1.0.0

Old version: ha3_3.10.0

Current Offline Version

The version of the index built from offline data in the instance.

Billing Method

Pay-as-you-go/Subscription.

Total Query Nodes

The number of query nodes that you purchased.

Query Node Specifications

The specifications of the query nodes that you purchased.

Total Data Nodes

The number of data nodes that you purchased.

Data Node Specifications

The specifications of the data nodes that you purchased.

Storage Space per Data Node

For SSD data nodes, you are charged for the storage space that exceeds the free quota.

For disk-based or GPU-accelerated data nodes, no free storage quota is provided. All storage space is billable.

Region

The region where the instance is located.

Resource Group ID/Resource Group Name

Resource groups let you organize resources under your Alibaba Cloud account. You can manage permissions, deploy resources, and monitor resources by group instead of individually.

Availability Edition

Standard Edition: Deploys the instance in a single zone. Zone-level disaster recovery is not supported.

High-availability Edition: Deploys the instance across multiple zones. This edition provides two clusters for mutual backup and offers higher availability. If a zone fails, you can switch traffic to another zone.

Network information

Virtual Private Cloud (VPC), Virtual Switch ID, and Public Network Access: The VPC, virtual switch, and public network access settings configured on the purchase page. The instance uses these settings and must be in the same region.

Add to public access whitelist: Public network access is disabled by default. After you enable it, the whitelist configuration option appears.

image.png

Click Public Access Whitelist to add, delete, or edit whitelist entries. If you exit without saving, a confirmation message appears and unsaved changes are discarded.

Add to whitelist: Enter IP addresses separated by commas, as shown in the following figure: image.png

Verify the whitelist: Log on to a whitelisted machine and ping the API domain name of the endpoint to test the connection.

You can obtain the domain name from the API endpoint. Add public to the domain name to enable public access. For example, `ha-cn-*******.public.ha.aliyuncs.com`. A successful ping from your local machine confirms the whitelist is correctly configured.

image

API endpoints

An API endpoint is accessible from an ECS instance in the same region and VPC. Each region has a unique API domain name. When you use an API or SDK to access OpenSearch, use the endpoint provided here. Select the appropriate domain name for your deployment and ping it to verify accessibility.

Note

API endpoints only support access from the VPC that you specified when you purchased the instance.

image

Username and password: The credentials you configured on the purchase page. Click Set to change the username and password, as shown in the following figure:

image.png

Password requirements:

  • Username: Must start with a letter. Can contain uppercase letters, lowercase letters, digits, and underscores (_). Must be 1 to 30 characters in length.

  • Password: Must be 13 or more characters in length. Must contain uppercase letters, lowercase letters, digits, and special characters, such as `!@#$%^&*()_+-=`.

Single-cluster node resource information

On the instance details page, view node information and cluster service status. For High-availability Edition instances, you can also switch traffic between clusters.

Node Category

Node Name

Description

Query node

Number of query nodes

The number of query nodes that you purchased.

Data node

Number of data nodes

The number of data nodes that you purchased.

Number of data node replicas

The default value is 1. You can scale out as needed.

Number of data node shards

You can increase the instance memory by configuring the number of node columns.