GetMultiAccountResourceCounts - Resource Management - Alibaba Cloud Documentation Center

Mengkueri jumlah sumber daya dalam akun manajemen dan beberapa anggota dari direktori sumber daya.

Deskripsi operasi

Anda hanya dapat mengkueri sumber daya yang didukung oleh Resource Center. Untuk informasi selengkapnya, lihat Layanan yang bekerja dengan Resource Center.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

resourcecenter:GetMultiAccountResourceCounts

get

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
GroupByKey	string	No	Dimensi yang digunakan untuk mengkueri sumber daya. Nilai yang valid: ResourceType: jenis sumber daya RegionId: region ResourceGroupId: grup sumber daya Catatan Jika parameter ini tidak dikonfigurasi, jumlah total sumber daya yang memenuhi ketentuan akan dikembalikan.	ResourceType
Filter	array<object>	No	Kondisi filter.
	object	No	Kondisi filter.
Key	string	No	Kunci dari kondisi filter. Untuk informasi selengkapnya, lihat `Parameter filter yang didukung`.	RegionId
MatchType	string	No	Metode pencocokan. Tetapkan nilai ke Equals, yang menunjukkan pencocokan persis.	Equals
Value	array	No	Nilai-nilai dari kondisi filter.
	string	No	Nilai dari kondisi filter.	cn-shanghai
Scope	string	No	Cakupan pencarian. Nilai yang valid: ID direktori sumber daya: Sumber daya dalam akun manajemen dan semua anggota dari direktori sumber daya akan dicari. ID folder Root: Sumber daya dalam semua anggota di folder Root dan subfolder dari folder Root akan dicari. ID folder: Sumber daya dalam semua anggota di folder akan dicari. ID anggota: Sumber daya dalam anggota akan dicari. Untuk informasi tentang cara mendapatkan ID direktori sumber daya, folder Root, folder, atau anggota, lihat GetResourceDirectory, ListFoldersForParent, atau ListAccounts.	rd-r4****

Parameter filter yang didukung

Parameter	Deskripsi	Metode pencocokan yang didukung
ResourceType	Jenis sumber daya.	Equals
RegionId	ID region.	Equals
ResourceId	ID sumber daya.	Equals dan Prefix
ResourceGroupId	ID grup sumber daya.	Equals, Exists, dan NotExists
ResourceName	Nama sumber daya.	Equals dan Contains
Tag	Pasangan kunci-nilai. Format JSON-nya adalah `{ "key": $key, "value": $value }`, dan setidaknya salah satu dari key dan value harus ditentukan. Misalnya, tentukan `{ "key": "foo", "value": "bar" }` untuk mengkueri tag key `foo` dan tag value `bar`, atau tentukan `{ "key": "foo" }` untuk mengkueri tag key `foo`.	Contains, NotContains, dan NotExists
VpcId	ID virtual private cloud (VPC).	Equals
VSwitchId	ID vSwitch.	Equals

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
Filters	array<object>	Kondisi filter.
	object	Kondisi filter.
Key	string	Kunci dari kondisi filter.	RegionId
Values	array	Nilai-nilai dari kondisi filter.
	string	Nilai dari kondisi filter.	cn-shanghai
GroupByKey	string	Dimensi yang digunakan untuk mengkueri sumber daya.	ResourceType
RequestId	string	ID permintaan.	EFA806B9-7F36-55AB-8B7A-D680C2C5EE57
ResourceCounts	array<object>	Jumlah sumber daya.
	object	Jumlah sumber daya.
Count	integer	Jumlah sumber daya.	2
GroupName	string	Nama grup.	ACS::ECS::NetworkInterface
Scope	string	Cakupan pencarian. Nilai yang valid: ID direktori sumber daya: Sumber daya dalam akun manajemen dan semua anggota dari direktori sumber daya akan dicari. ID folder Root: Sumber daya dalam semua anggota di folder Root dan subfolder dari folder Root akan dicari. ID folder: Sumber daya dalam semua anggota di folder akan dicari. ID anggota: Sumber daya dalam anggota akan dicari. Untuk informasi tentang cara mendapatkan ID direktori sumber daya, folder Root, folder, atau anggota, lihat GetResourceDirectory, ListFoldersForParent, atau ListAccounts.	rd-r4****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.