すべてのプロダクト
Search

このプロダクト

    Microservices Engine:ListAnsServiceClusters

    ドキュメントセンター

    Microservices Engine:ListAnsServiceClusters

    最終更新日:May 13, 2026

    Nacos サービスのクラスターの一覧をクエリします。

    操作説明

    説明

    このオペレーションは Nacos SDK では提供されていません。Nacos SDK の詳細については、「公式ドキュメント」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    PageNum

    integer

    必須

    返されるページの番号です。

    1
    PageSize

    integer

    必須

    ページごとに返されるエントリ数です。

    10
    ClusterId deprecated

    string

    任意

    MSE クラスターの ID です。

    説明

    MSE クラスターは、Nacos サービスのクラスターとは異なります。

    mse-09k1xxxx
    ServiceName

    string

    任意

    サービスの名前です。

    nacos.test.3
    GroupName

    string

    任意

    グループの名前です。

    DEFAULT_GROUP
    NamespaceId

    string

    任意

    名前空間の ID です。

    12233****
    ClusterName

    string

    任意

    クラスターのエイリアスです。

    qewr
    InstanceId

    string

    任意

    インスタンスの ID です。

    mse_prepaid_public_cn-tl32a6****
    AcceptLanguage

    string

    任意

    レスポンスの言語です。有効な値：

    • zh：中国語

    • en：英語

    zh

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    Message

    string

    返されるメッセージ。

    The request is successfully processed.
    RequestId

    string

    リクエスト ID。

    52BA6DA6-A702-4362-A32F-DFF79655****
    Data

    object

    返されるデータ。

    ProtectThreshold

    number

    保護しきい値。

    0
    GroupName

    string

    サービスが属するサービスグループ。

    DEFAULT_GROUP
    Clusters

    array<object>

    クラスター情報。

    array<object>

    データ構造。

    DefaultCheckPort

    integer

    ヘルスチェック用のデフォルトポート。

    80
    HealthCheckerType

    string

    ヘルスチェックの種類。

    tcp
    UseIPPort4Check

    boolean

    サーバーがエンドツーエンドヘルスチェックを開始したかどうかを示します。このパラメーターは、サービスが一時サービスでない場合にのみ有効です。

    true
    ServiceName

    string

    サービスの完全名。

    DEFAULT_GROUP@@nacos.test.3
    Name

    string

    クラスター名。

    test
    DefaultPort

    integer

    デフォルトポート。

    80
    Metadata

    object

    クラスターのメタデータ。

    111
    Name

    string

    サービスの名前。

    nacos.test.3
    SelectorType

    string

    選出モード。

    none
    Metadata

    object

    サービスのメタデータ。

    111
    Ephemeral

    boolean

    サービスが一時サービスかどうかを示します。有効な値：

    • true：サービスは一時サービスです。

    • false：サービスは一時サービスではありません。

    true
    Source

    string

    サービスのソースタイプ。有効な値：

    • console：コンソールからの登録。

    • sdk：SDK を使用した登録。

    • governance：Microservices Governance からの登録。

    console
    AppDetail

    object

    Source パラメーターが governance に設定されている場合に、Microservices Governance が有効化された関連アプリケーションの情報。

    AppId

    string

    Microservices Governance が有効化されたアプリケーションの ID。

    hkhon1po62@904cba2c0xxxxxx
    AppName

    string

    Microservices Governance が有効化されたアプリケーションの名前。

    spring-cloud-b
    Port

    integer

    Microservices Governance が有効化されたアプリケーションのポート番号。

    6001
    CheckType

    string

    ヘルスチェックの種類。有効な値：

    • connection：接続状態チェック

    • tcp：TCP 接続チェック

    • http：HTTP 接続チェック

    tcp
    CheckPath

    string

    ヘルスチェックのパス。このパラメーターは、CheckType パラメーターが http の場合にのみ必須です。

    /health
    CheckTimeout

    integer

    ヘルスチェック応答のタイムアウト期間。単位：秒。

    5
    CheckInternal

    integer

    ヘルスチェック間隔。単位：秒。

    2
    HealthyCheckTimes

    integer

    インスタンス状態が異常から正常に変化する際の、ヘルスチェックの最大再試行回数。

    2
    UnhealthyCheckTimes

    integer

    インスタンス状態が正常から異常に変化する際の、ヘルスチェックの最大再試行回数。

    2
    ErrorCode

    string

    リクエストが失敗した場合に返されるエラーコード。

    mse-100-000
    Success

    boolean

    リクエストが成功したかどうかを示します。有効な値：

    • true：リクエストは成功しました。

    • false：リクエストは失敗しました。

    true
    HttpCode

    string

    HTTP ステータスコード。

    200

    例

    成功レスポンス

    JSONJSON

    {
  "Message": "The request is successfully processed.",
  "RequestId": "52BA6DA6-A702-4362-A32F-DFF79655****",
  "Data": {
    "ProtectThreshold": 0,
    "GroupName": "DEFAULT_GROUP",
    "Clusters": [
      {
        "DefaultCheckPort": 80,
        "HealthCheckerType": "tcp",
        "UseIPPort4Check": true,
        "ServiceName": "DEFAULT_GROUP@@nacos.test.3",
        "Name": "test",
        "DefaultPort": 80,
        "Metadata": 111
      }
    ],
    "Name": "nacos.test.3",
    "SelectorType": "none",
    "Metadata": 111,
    "Ephemeral": true,
    "Source": "console",
    "AppDetail": {
      "AppId": "hkhon1po62@904cba2c0xxxxxx",
      "AppName": "spring-cloud-b",
      "Port": 6001,
      "CheckType": "tcp",
      "CheckPath": "/health",
      "CheckTimeout": 5,
      "CheckInternal": 2,
      "HealthyCheckTimes": 2,
      "UnhealthyCheckTimes": 2
    }
  },
  "ErrorCode": "mse-100-000",
  "Success": true,
  "HttpCode": "200"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IllegalRequest Invalid request:%s
    400 InvalidParameter Parameter error:%s
    500 InternalError Console error. Try again later:%s
    403 NoPermission You are not authorized to perform this operation:%s
    404 NotFound Not found:%s

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。