すべてのプロダクト
Search

このプロダクト

    Resource Management:GetMultiAccountResourceCounts

    ドキュメントセンター

    Resource Management:GetMultiAccountResourceCounts

    最終更新日:Feb 28, 2026

    管理アカウントとリソースディレクトリの複数のメンバー内のリソース数を照会します。

    操作説明

    Resource Center がサポートするリソースのみを照会できます。詳細については、「Resource Center と連携するサービス」をご参照ください。

    今すぐお試しください

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

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    resourcecenter:GetMultiAccountResourceCounts

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    GroupByKey

    string

    任意

    リソースを照会するディメンション。有効な値：

    • ResourceType：リソースタイプ

    • RegionId：リージョン

    • ResourceGroupId：リソースグループ

    説明

    このパラメーターが設定されていない場合、条件を満たすリソースの合計数が返されます。

    ResourceType
    Filter

    array<object>

    任意

    フィルター条件。

    object

    任意

    フィルター条件。

    Key

    string

    任意

    フィルター条件のキー。詳細については、「Supported filter parameters」をご参照ください。

    RegionId
    MatchType

    string

    任意

    マッチング方法。

    値を Equals に設定すると、完全に一致することを示します。

    Equals
    Value

    array

    任意

    フィルター条件の値。

    string

    任意

    フィルター条件の値。

    cn-shanghai
    Scope

    string

    任意

    検索範囲。有効な値：

    • リソースディレクトリの ID：管理アカウントとリソースディレクトリのすべてのメンバー内のリソースが検索されます。

    • Root フォルダの ID：Root フォルダとそのサブフォルダ内のすべてのメンバー内のリソースが検索されます。

    • フォルダの ID：フォルダ内のすべてのメンバー内のリソースが検索されます。

    • メンバーの ID：メンバー内のリソースが検索されます。

    リソースディレクトリ、Root フォルダ、フォルダ、またはメンバーの ID の取得方法については、「GetResourceDirectory」、「ListFoldersForParent」、または「ListAccounts」をご参照ください。

    rd-r4****

    サポートされているフィルターパラメーター

    パラメーター説明サポートされているマッチング方法
    ResourceTypeリソースタイプ。Equals
    RegionIdリージョン ID。Equals
    ResourceIdリソース ID。Equals and Prefix
    ResourceGroupIdリソースグループ ID。Equals, Exists, and NotExists
    ResourceNameリソース名。Equals and Contains
    Tagキーと値のペア。JSON 形式は { "key": $key, "value": $value } で、キーと値の少なくともいずれかを指定する必要があります。たとえば、タグキー foo とタグ値 bar を照会するには { "key": "foo", "value": "bar" } を指定し、タグキー foo を照会するには { "key": "foo" } を指定します。Contains, NotContains, and NotExists
    VpcIdVPC ID。Equals
    VSwitchIdvSwitch ID。Equals

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    Filters

    array<object>

    フィルター条件。

    object

    フィルター条件。

    Key

    string

    フィルター条件のキー。

    RegionId
    Values

    array

    フィルター条件の値。

    string

    フィルター条件の値。

    cn-shanghai
    GroupByKey

    string

    リソースを照会するディメンション。

    ResourceType
    RequestId

    string

    リクエスト ID。

    EFA806B9-7F36-55AB-8B7A-D680C2C5EE57
    ResourceCounts

    array<object>

    リソース数。

    object

    リソース数。

    Count

    integer

    リソース数。

    2
    GroupName

    string

    グループ名。

    ACS::ECS::NetworkInterface
    Scope

    string

    検索範囲。有効な値：

    • リソースディレクトリの ID：管理アカウントとリソースディレクトリのすべてのメンバー内のリソースが検索されます。

    • Root フォルダの ID：Root フォルダとそのサブフォルダ内のすべてのメンバー内のリソースが検索されます。

    • フォルダの ID：フォルダ内のすべてのメンバー内のリソースが検索されます。

    • メンバーの ID：メンバー内のリソースが検索されます。

    リソースディレクトリ、Root フォルダ、フォルダ、またはメンバーの ID の取得方法については、「GetResourceDirectory」、「ListFoldersForParent」、または「ListAccounts」をご参照ください。

    rd-r4****

    例

    成功レスポンス

    JSONJSON

    {
  "Filters": [
    {
      "Key": "RegionId",
      "Values": [
        "cn-shanghai"
      ]
    }
  ],
  "GroupByKey": "ResourceType",
  "RequestId": "EFA806B9-7F36-55AB-8B7A-D680C2C5EE57",
  "ResourceCounts": [
    {
      "Count": 2,
      "GroupName": "ACS::ECS::NetworkInterface"
    }
  ],
  "Scope": "rd-r4****"
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 NoPermission You are not authorized to perform this operation.
    400 MultiAccountServiceNotEnabled Multi account ResourceCenter service is not enabled.
    400 InvalidParameter.Filter.ResourceType The specified parameter value of Filter.ResourceType is not valid.
    400 MissingParameter.AccountScope The specified parameter AccountScope is missing.
    400 InvalidParameter.Filter.CreateTime The specified parameter Filter.n.CreateTime is not valid.
    400 InvalidParameter.Filter.IpAddress The specified parameter Filter.n.IpAddress is not valid.
    400 InvalidParameter.Filter.Tag The specified parameter Filter.n.Tag is not valid.
    403 NoPermission.AccountScope The operator is not permitted for this account scope.
    404 NotExists.ResourceDirectory The resource directory for the account is not enabled.
    404 NotExists.ResourceDirectory.FolderId The specified folder does not exist.
    409 InvalidParameter.Scope The Scope is invalid.
    409 NoPermission.ResourceDirectory.MemberAccount ResourceDirectory Member Account is not authorized to perform this operation.
    409 ServiceNotEnabled.SpecifiedAccount ResourceCenter service of the specified account is not enabled.

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

    変更履歴

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