DescribeACLs - - Alibaba Cloud Documentation Center

Mengambil daftar kontrol akses (ACLs) di wilayah tertentu.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Contoh	Description
Action	String	Yes	DescribeACLs	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeACLs.
RegionId	String	Yes	cn-shanghai	ID wilayah tempat ACL dideploy.
AclIds	String	No	acl-xhwhyuo43l*******	ID ACL. Jika Anda ingin menanyakan beberapa ACL sekaligus, pisahkan ID ACL dengan koma (,). Jika Anda tidak menetapkan parameter ini, semua ACL di wilayah yang ditentukan akan ditanyakan.
Name	String	No	test	Nama ACL. Nama harus terdiri dari 2 hingga 100 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus dimulai dengan huruf.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan per halaman. Nilai maksimum: 50. Nilai default: 10.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Nilai default: 1.
AclType	String	No	acl-hardware	Tipe instans SAG yang terkait dengan ACL. Nilai yang valid: acl-hardware: instans SAG CPE acl-software: instans Aplikasi SAG

Parameter respons

Parameter	Type	Contoh	Description
TotalCount	Integer	1	Total jumlah entri yang dikembalikan.
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	660F303F-C88E-4026-BC6A-FC24B78FD7EA	ID permintaan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
Acls	Array of Acl		Daftar ACL.
Acl
SagCount	String	0	Jumlah instans SAG yang terkait dengan ACL.
AclId	String	acl-xhwhyuo43l*******	ID ACL.
Name	String	test	Nama ACL.
ResourceGroupId	String	rg-acfm2iu4fnc****	ID kelompok sumber daya tempat ACL berada.
AclType	String	acl-hardware	Tipe instans SAG yang terkait dengan ACL. Nilai yang valid: acl-hardware: instans SAG CPE acl-software: instans Aplikasi SAG

Contoh

Contoh permintaan

http(s)://[Endpoint]/?Action=DescribeACLs
&RegionId=cn-shanghai
&AclIds=acl-xhwhyuo43l*******
&Name=test
&PageSize=10
&PageNumber=1
&AclType=acl-hardware
&Common request parameters

Contoh respons sukses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeACLsResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>660F303F-C88E-4026-BC6A-FC24B78FD7EA</RequestId>
    <PageNumber>1</PageNumber>
    <Acls>
        <SagCount>0</SagCount>
        <AclId>acl-xhwhyuo43l*******</AclId>
        <Name>test</Name>
        <ResourceGroupId>rg-acfm2iu4fnc****</ResourceGroupId>
        <AclType>acl-hardware</AclType>
    </Acls>
</DescribeACLsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "660F303F-C88E-4026-BC6A-FC24B78FD7EA",
  "PageNumber" : 1,
  "Acls" : [ {
    "SagCount" : "0",
    "AclId" : "acl-xhwhyuo43l*******",
    "Name" : "test",
    "ResourceGroupId" : "rg-acfm2iu4fnc****",
    "AclType" : "acl-hardware"
  } ]
}

Kode kesalahan

HttpCode	Kode kesalahan	Pesan kesalahan	Description
403	Forbidden	User not authorized to operate on the specified resource.	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki izin untuk mengelola resource yang ditentukan.
403	MissingParameter	The input parameter is missing, please check your input.	Pesan kesalahan yang dikembalikan karena satu atau beberapa parameter yang diperlukan kosong. Periksa apakah Anda telah mengonfigurasi semua parameter yang diperlukan.
403	InvalidParameter	The specified parameter is invalid.	Pesan kesalahan yang dikembalikan karena suatu parameter diatur ke nilai yang tidak valid.
403	InternalError	An internal server error occurred.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal pada server.

Untuk daftar kode kesalahan, lihat Service error codes.