All Products
Search
Document Center

Artificial Intelligence Recommendation:ListUserClusters

Last Updated:Oct 16, 2025

Lists the user clusters for a specified instance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /v2/openapi/instances/{instanceId}/user-clusters HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

instanceId

string

Yes

The ID of the instance.

airec-test

Response elements

Element

Type

Description

Example

object

result

array<object>

The result details.

object

The result details.

gmtModified

string

The Coordinated Universal Time (UTC) time when the cluster was last modified.

2018-12-07T02:24:26.000Z

status

string

The status.

1

gmtCreate

string

The UTC time when the cluster was created.

2018-12-07T02:24:26.000Z

name

string

The name of the user cluster.

mycluster-for-airec

meta

object

The metadata.

metaType

string

The type of metadata.

UserCluster

description

string

The description.

tst

headers

object

The header information.

X-Total-Count

integer

The total number of entries.

1

requestId

string

The ID of the request.

1E2CBBA8-C623-4FEE-BC84-9672E460CA39

Examples

Success response

JSON format

{
  "result": [
    {
      "gmtModified": "2018-12-07T02:24:26.000Z",
      "status": "1",
      "gmtCreate": "2018-12-07T02:24:26.000Z",
      "name": "mycluster-for-airec",
      "meta": {
        "metaType": "UserCluster",
        "description": "tst"
      }
    }
  ],
  "headers": {
    "X-Total-Count": 1
  },
  "requestId": "1E2CBBA8-C623-4FEE-BC84-9672E460CA39"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.