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

Identity as a Service:ListCloudAccounts

最終更新日:Aug 27, 2026

ページングを使用して 1 つ以上のクラウドアカウントの情報を照会します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

eiam:ListCloudAccounts

list

*CloudAccount

acs:eiam:{#regionId}:{#accountId}:instance/{#InstanceId}/cloudaccount/*

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

InstanceId

string

必須

インスタンスの ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

NextToken

string

任意

次のページの開始位置を示すトークン。

  • このパラメーターが指定されていない場合、クエリは最初のページから開始されます。

NTxxxxxexample

MaxResults

integer

任意

1 ページあたりの最大レコード数。

  • このパラメーターが指定されていない場合、デフォルト値は 20 です。

  • 最大値は 100 です。

20

Filter

array<object>

任意

フィルター条件。

object

任意

フィルター条件。

Name

string

任意

フィルターフィールド名。有効な値:

  • CloudAccountId: クラウドアカウントの ID。

  • CloudAccountExternalId: クラウドアカウントの外部一意識別子。

  • CloudAccountVendorType: クラウドアカウントのタイプ。

列挙値:

  • CloudAccountVendorType :

    CloudAccountVendorType。

  • CloudAccountExternalId :

    CloudAccountExternalId。

  • CloudAccountId :

    CloudAccountId。

CloudAccountId

Value

array

任意

フィルターフィールド値のリスト。

string

任意

フィルターフィールドの値。

ca_01kmegjc11qa1txxxxx

レスポンスフィールド

フィールド

説明

object

RequestId

string

リクエストの ID。

0441BD79-92F3-53AA-8657-F8CE4A2B912A

TotalCount

integer

返されたエントリの総数。

100

NextToken

string

このリクエストに対して返されたトークン。

NTxxxexample

MaxResults

integer

ページサイズ。

20

CloudAccounts

array<object>

クラウドアカウントのリスト。

array<object>

クラウドアカウントの詳細。

InstanceId

string

インスタンスの ID。

idaas_ue2jvisn35ea5lmthk267xxxxx

CloudAccountId

string

クラウドアカウントの ID。

ca_01kmegjc11qa1txxxxx

CloudAccountName

string

クラウドアカウントの名前。

cloud_accout_xxxx

CloudAccountVendorType

string

クラウドアカウントのタイプ。有効な値:

  • alibaba_cloud: Alibaba Cloud。

alibaba_cloud

CloudAccountExternalId

string

クラウドアカウントの外部一意識別子。

1234567

CloudAccountProviderName

string

ID プロバイダーの名前。

idaas-eiam-oidc-provider

CloudAccountHealth

string

クラウドアカウントのヘルスステータス。有効な値:

  • healthy: 正常。

  • unhealthy: 異常。

  • unknown: 不明。

列挙値:

  • healthy :

    healthy。

  • unhealthy :

    unhealthy。

  • unknown :

    unknown。

healthy

Description

string

クラウドアカウントの説明。

cloud_accout_description

CreateTime

integer

作成時間 (UNIX タイムスタンプフォーマット、ミリ秒単位)。

1649830225000

UpdateTime

integer

最終更新時間 (UNIX タイムスタンプフォーマット、ミリ秒単位)。

1649830227000

CloudAccountHealthCheckResult

object

クラウドアカウントのヘルスチェック結果。

LastCheckTime

integer

最終チェック時間 (UNIX タイムスタンプフォーマット、ミリ秒単位)。

1649830226000

Result

string

クラウドアカウントのヘルスチェック結果。有効な値:

  • success: 成功。

  • failed: 失敗した。

列挙値:

  • success :

    success。

  • failed :

    失敗した

success

ErrorReason

object

エラーの原因。このフィールドは、ヘルスチェックステータスが unhealthy の場合に返されます。

ErrorCode

string

エラーコード。

AuthenticationFail.NoPermission

ErrorMessage

string

エラーの説明。

権限がありません。

CloudAccountSite

string

クラウドアカウントのサイト。有効な値:

  • china_mainland: 中国本土。

  • global: グローバル。

china_mainland

PrivilegeHostingState

string

クラウドアカウントのホスティング状態。デフォルト値は unmanaged です。有効な値:

  • hosting_unmanaged: 未管理。クラウドアカウントはホスティングを開始しておらず、初期状態にあります。

  • hosting_pending: ホスティング中。ホスティングタスクが送信され、非同期で実行されています。最終状態に達する前に、ホスティングプロセスが完了するまで待機してください。

  • hosting_completed: ホスティング完了。クラウドアカウントのホスティングプロセスが正常に実行され、関連する権限テンプレートとホスティングバインディングが効果を発揮しています。

  • hosting_failed: ホスティング失敗。ホスティングプロセスで例外が発生しました。失敗した理由を確認し、ホスティングを再実行してください。

  • hosting_removing: 削除中。削除タスクが送信され、非同期で実行されています。最終状態に達する前に、削除プロセスが完了するまで待機してください。

  • hosting_remove_failed: 削除失敗。削除プロセスで例外が発生しました。失敗した理由を確認し、削除を再実行してください。

hosting_unmanaged

PrivilegeStatus

string

特典クォータスイッチのステータス。有効な値:

  • enabled: 有効。リソースはアクティブな状態であり、通常どおり使用できます。

  • disabled: 無効。リソースは非アクティブ化されており、効果を発揮しません。再度有効にすることで機能を解凍できます。

有効

PrivilegeApplicationIds

array

関連付けられた特典クォータアプリケーション ID のリスト。

string

関連付けられた特典クォータアプリケーションの ID。

app_mkv7rgt4d7i4u7zqtzev2mxxxx

PrivilegeHostingError

object

特典クォータのホスティングまたは削除が失敗した理由。

ErrorCode

string

エラーコード。

Error

ErrorMessage

string

エラーメッセージ。

テストメッセージ

成功レスポンス

JSONJSON

{
  "RequestId": "0441BD79-92F3-53AA-8657-F8CE4A2B912A",
  "TotalCount": 100,
  "NextToken": "NTxxxexample",
  "MaxResults": 20,
  "CloudAccounts": [
    {
      "InstanceId": "idaas_ue2jvisn35ea5lmthk267xxxxx",
      "CloudAccountId": "ca_01kmegjc11qa1txxxxx",
      "CloudAccountName": "cloud_accout_xxxx",
      "CloudAccountVendorType": "alibaba_cloud",
      "CloudAccountExternalId": "1234567",
      "CloudAccountProviderName": "idaas-eiam-oidc-provider",
      "CloudAccountHealth": "healthy",
      "Description": "cloud_accout_description",
      "CreateTime": 1649830225000,
      "UpdateTime": 1649830227000,
      "CloudAccountHealthCheckResult": {
        "LastCheckTime": 1649830226000,
        "Result": "success",
        "ErrorReason": {
          "ErrorCode": "AuthenticationFail.NoPermission",
          "ErrorMessage": "There is no permission"
        }
      },
      "CloudAccountSite": "china_mainland",
      "PrivilegeHostingState": "hosting_unmanaged",
      "PrivilegeStatus": "enabled",
      "PrivilegeApplicationIds": [
        "app_mkv7rgt4d7i4u7zqtzev2mxxxx"
      ],
      "PrivilegeHostingError": {
        "ErrorCode": "Error",
        "ErrorMessage": "test message"
      }
    }
  ]
}

エラーコード

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

変更履歴

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