すべてのプロダクト
Search

このプロダクト

    Enterprise Distributed Application Service:GetCluster

    ドキュメントセンター

    Enterprise Distributed Application Service:GetCluster

    最終更新日:Dec 22, 2025

    特定のクラスターの情報を照会します。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    edas:ReadCluster

    get

    *Cluster

    acs:edas:{#regionId}:{#accountId}:namespace/{#NameSpaceId}/cluster/{#ClusterId}

    		 なし なし

    リクエスト構文

    GET /pop/v5/resource/cluster HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ClusterId

    string

    必須

    Enterprise Distributed Application Service (EDAS) のクラスター ID。 ListCluster 操作を呼び出して、クラスター ID を照会できます。 詳細については、「ListCluster」をご参照ください。

    5439271a-015b-433d-****-d76db49****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    integer

    返される HTTP ステータスコード。

    200
    Message

    string

    返される詳細情報。

    success
    RequestId

    string

    リクエスト ID。

    d76db491
    Cluster

    object

    クラスターに関する情報。

    VpcId

    string

    VPC の ID。

    vpc-xxxxz1mlwpb****
    OversoldFactor

    integer

    Docker クラスターでサポートされるオーバーコミット率。 有効な値：

    • 1：1:1。リソースがオーバーコミットされていないことを示します。

    • 2：1:2。リソースが 1:2 でオーバーコミットされていることを示します。

    • 4：1:4。リソースが 1:4 でオーバーコミットされていることを示します。

    • 8：1:8。リソースが 1:8 でオーバーコミットされていることを示します。

    2
    UpdateTime

    integer

    クラスターが最後に変更された時刻。 この値は、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプです。

    1570708232145
    MemUsed

    integer

    使用済みメモリのサイズ。 単位：MB。

    1024
    IaasProvider

    string

    クラスターで使用されるサービスとしてのインフラストラクチャ (IaaS) リソースのプロバイダー。

    ALIYUN
    CreateTime

    integer

    クラスターが作成された時刻。 この値は、協定世界時 (UTC) 1970年1月1日 00:00:00 から経過したミリ秒数を表す UNIX タイムスタンプです。

    1570708232145
    CpuUsed

    integer

    使用されている CPU コアの数。

    2
    Mem

    integer

    メモリの合計サイズ。 単位：MB。

    2048
    RegionId

    string

    クラスターが存在するリージョンの ID。

    cn-hangzhou
    Cpu

    integer

    CPU コアの総数。

    4
    CsClusterId

    string

    Container Service for Kubernetes (ACK) クラスターの ID。

    c2ce62869f4d4466b920312315f05****
    NetworkMode

    integer

    クラスターのネットワークタイプ。 有効な値：

    • 1：クラシックネットワーク

    • 2：VPC

    2
    Description

    string

    クラスターの説明。

    测试
    ClusterType

    integer

    クラスターのタイプ。 有効な値：

    • 0：通常の Docker クラスター

    • 1：Swarm クラスター

    • 2：Elastic Compute Service (ECS) クラスター

    • 3：EDAS の自己管理型 Kubernetes クラスター

    • 4：Pandora がアプリケーションを自動的に登録するクラスター

    • 5：ACK クラスター

    2
    ClusterName

    string

    クラスターの名前。

    ClusterTest
    NodeNum

    integer

    ECS インスタンスの数。

    4
    ClusterImportStatus

    integer

    クラスターのインポートステータス。 有効な値：

    • 1：クラスターはインポート済みです。

    • 2：クラスターのインポートに失敗しました。

    • 3：クラスターはインポート中です。

    • 4：クラスターは削除済みです。

    • 0：クラスターはインポートされていません。

    0
    ClusterId

    string

    クラスターの ID。

    5439271a-015b-433d-befb-d76d****
    SubClusterType

    string

    Kubernetes クラスターのサブタイプ。 有効な値：ManagedKubernetes、Ask、ExternalKubernetes。 ManagedKubernetes は ACK クラスターを指します。 Ask は Serverless Kubernetes (ASK) クラスターを指します。 ExternalKubernetes は外部クラスターを指します。

    ManagedKubernetes

    例

    成功レスポンス

    JSONJSON

    {
  "Code": 200,
  "Message": "success",
  "RequestId": "d76db491",
  "Cluster": {
    "VpcId": "vpc-xxxxz1mlwpb****",
    "OversoldFactor": 2,
    "UpdateTime": 1570708232145,
    "MemUsed": 1024,
    "IaasProvider": "ALIYUN",
    "CreateTime": 1570708232145,
    "CpuUsed": 2,
    "Mem": 2048,
    "RegionId": "cn-hangzhou",
    "Cpu": 4,
    "CsClusterId": "c2ce62869f4d4466b920312315f05****",
    "NetworkMode": 2,
    "Description": "测试",
    "ClusterType": 2,
    "ClusterName": "ClusterTest",
    "NodeNum": 4,
    "ClusterImportStatus": 0,
    "ClusterId": "5439271a-015b-433d-befb-d76d****",
    "SubClusterType": "ManagedKubernetes"
  }
}

    エラーコード

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

    変更履歴

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