すべてのプロダクト
Search
ドキュメントセンター

Data Management:ListInstances

最終更新日:Jul 15, 2026

インスタンスのリストを取得します。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dms:ListInstances

list

*すべてのリソース。

*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

Tid

integer

任意

テナント ID。このパラメーターを取得するには、 GetUserActiveTenant 操作を呼び出します。

3***

SearchKey

string

任意

検索キーワード。

test

DbType

string

任意

データベースタイプ。有効な値の詳細については、「DbType パラメーターの説明」を参照してください。

MySQL

EnvType

string

任意

環境タイプ。有効な値:

  • product: プロダクト環境

  • dev: 開発環境

  • pre: プレリリース環境

  • test: テスト環境

  • sit: SIT 環境

  • uat: UAT 環境

  • pet: ストレステスト環境

  • stag: STAG 環境

product

InstanceSource

string

任意

ホストインスタンスのソース。有効な値:

  • PUBLIC_OWN: インターネット経由で接続された自己管理インスタンス

  • RDS: ApsaraDB RDS インスタンス

  • ECS_OWN: ECS インスタンス上の自己管理インスタンス

  • VPC_IDC: VPC 接続された IDC 内の自己管理インスタンス

RDS

NetType

string

任意

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

  • CLASSIC: クラシックネットワーク

  • VPC: VPC ネットワーク

VPC

InstanceState

string

任意

インスタンスステータス。有効な値:

  • NORMAL: 法線

  • DISABLE: 無効

NORMAL

PageNumber

integer

任意

ページ番号。

1

PageSize

integer

任意

1 ページあたりのエントリ数。値は 100 を超えることはできません。

50

Region

string

任意

インスタンスのリージョン ID。

cn-hangzhou

RealLoginUserUid

string

任意

API オペレーションを実際に呼び出すユーザーの Alibaba Cloud アカウント ID。

21400447956867****

レスポンスフィールド

フィールド

説明

object

応答パラメーター。

TotalCount

integer

条件に合致するインスタンスの総数。

1

RequestId

string

リクエスト ID。

B4B07137-F6AE-4756-8474-7F92BB6C4E04

ErrorCode

string

エラーコード。

UnknownError

ErrorMessage

string

エラーメッセージ。

UnknownError

InstanceList

object

Instance

array<object>

インスタンスリスト。

array<object>

インスタンス情報。

VpcId

string

インスタンスが属する VPC の ID。

vpc-o6wrloqsdqc9io3mg****

DatabaseUser

string

データベースユーザー名。

dbUser

DbaId

string

インスタンスの DBA ID。

31****

UseDsql

integer

インスタンスでクロスデータベースクエリが有効かどうかを示します。有効な値:

  • 0: 無効。

  • 1: 有効。

1

Port

integer

インスタンスの接続ポート。

3306

EcsInstanceId

string

ECS インスタンス ID。

150****

EnvType

string

インスタンスの環境タイプ。有効な値:

  • product: プロダクト環境

  • dev: 開発環境

  • pre: プレリリース環境

  • test: テスト環境

  • sit: SIT 環境

  • uat: UAT 環境

  • pet: ストレステスト環境

  • stag: STAG 環境。

product

Sid

string

インスタンスの SID。

test

OwnerIdList

object

OwnerIds

array

インスタンスのオーナーユーザー ID のリスト。

string

インスタンスのオーナーユーザー ID。

12****

SafeRuleId

string

インスタンスのセキュリティルール ID。

1

OwnerNameList

object

OwnerNames

array

インスタンスのオーナーニックネームのリスト。

string

インスタンスのオーナーニックネーム。

yuyang_test

DbaNickName

string

インスタンスの DBA ニックネーム。

dbaName

QueryTimeout

integer

インスタンスのクエリタイムアウト期間。

60

InstanceSource

string

インスタンスソース。

RDS

Host

string

インスタンスのエンドポイント。

****.mysql.rds.aliyuncs.com

State

string

インスタンスステータス。

NORMAL

DataLinkName

string

DataLink 名。

dblink_test

ExportTimeout

integer

エクスポートタイムアウト期間。

86400

InstanceId

string

インスタンス ID。

150***

InstanceType

string

インスタンスのデータベースタイプ。

mysql

DatabasePassword

string

データベースユーザーパスワード。

******

InstanceAlias

string

インスタンスエイリアス。

test

DdlOnline

integer

インスタンスの DdlOnline 構成。

1

EcsRegion

string

インスタンスが属するリージョン。

cn-hangzhou

StandardGroup

object

インスタンスのコントロールモード情報。

GroupName

string

コントロールモードに対応するセキュリティルールの名前。

test

GroupMode

string

コントロールモードタイプ。有効な値:

  • COMMON: セキュリティコラボレーションモード

  • NONE_CONTROL: フリー操作モード

  • STABLE: 安定的な変更モード。

COMMON

SellSitd

boolean

機密データ保護が有効かどうかを示します。有効な値:

  • true: 有効。

  • false: 無効。

true

SellTrust

string

セキュリティホスティングが有効かどうかを示します。有効な値:

  • true: 有効。

  • false: 無効。

true

UseSsl

integer

Success

boolean

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

  • true: リクエストが成功しました。

  • false: リクエストが失敗しました。

true

成功レスポンス

JSONJSON

{
  "TotalCount": 1,
  "RequestId": "B4B07137-F6AE-4756-8474-7F92BB6C4E04",
  "ErrorCode": "UnknownError",
  "ErrorMessage": "UnknownError",
  "InstanceList": {
    "Instance": [
      {
        "VpcId": "vpc-o6wrloqsdqc9io3mg****",
        "DatabaseUser": "dbUser",
        "DbaId": "31****",
        "UseDsql": 1,
        "Port": 3306,
        "EcsInstanceId": "150****",
        "EnvType": "product",
        "Sid": "test",
        "OwnerIdList": {
          "OwnerIds": [
            "12****"
          ]
        },
        "SafeRuleId": "1",
        "OwnerNameList": {
          "OwnerNames": [
            "yuyang_test"
          ]
        },
        "DbaNickName": "dbaName",
        "QueryTimeout": 60,
        "InstanceSource": "RDS",
        "Host": "****.mysql.rds.aliyuncs.com",
        "State": "NORMAL",
        "DataLinkName": "dblink_test",
        "ExportTimeout": 86400,
        "InstanceId": "150***",
        "InstanceType": "mysql",
        "DatabasePassword": "******",
        "InstanceAlias": "test",
        "DdlOnline": 1,
        "EcsRegion": "cn-hangzhou",
        "StandardGroup": {
          "GroupName": "test",
          "GroupMode": "COMMON"
        },
        "SellSitd": true,
        "SellTrust": "true",
        "UseSsl": 0
      }
    ]
  },
  "Success": true
}

エラーコード

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

変更履歴

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