DescribeACLAttribute - - Alibaba Cloud Documentation Center

Mengambil daftar kontrol akses (ACL).

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	Tipe	Diperlukan	Contoh	Deskripsi
Action	String	Yes	DescribeACLAttribute	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DescribeACLAttribute.
RegionId	String	No	cn-hangzhou	ID wilayah tempat ACL ditempatkan.
AclId	String	No	acl-ohlexqptfhyaq****	ID ACL.
PageSize	Integer	No	10	Jumlah entri yang dikembalikan per halaman. Nilai valid: 1 hingga 50. Nilai default: 10.
PageNumber	Integer	No	1	Nomor halaman yang dikembalikan. Nilai default: 1.
Direction	String	No	out	Arah traffic tempat aturan ACL diterapkan. Nilai valid: in: Aturan ACL mengontrol network traffic inbound dari jaringan on-premises yang terkait dengan instans Smart Access Gateway (SAG). out: Aturan ACL mengontrol network traffic outbound dari jaringan on-premises yang terkait dengan instans SAG.
Order	String	No	1255444444	ID pesanan.
Name	String	No	doctest	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. Catatan Parameter ini mendukung fuzzy match.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
TotalCount	Integer	3	Total jumlah entri yang dikembalikan.
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	8F62CE77-FBA2-4F8D-AED9-0A02814EDA69	ID permintaan.
PageNumber	Integer	1	Nomor halaman yang dikembalikan.
Acrs	Array of Acr		Informasi tentang aturan ACL dalam ACL.
Acr
Direction	String	out	Arah traffic tempat aturan ACL diterapkan. in: Aturan ACL mengontrol network traffic inbound dari jaringan on-premises yang terkait dengan instans SAG. out: Aturan ACL mengontrol network traffic outbound dari jaringan on-premises yang terkait dengan instans SAG.
Type	String	WAN	Tipe aturan ACL: LAN: Aturan ACL mengontrol network traffic yang ditransmisikan melalui Alamat IP pribadi. WAN: Aturan ACL mengontrol network traffic yang ditransmisikan melalui Alamat IP publik.
DpiSignatureIds	Array of String	1	ID aplikasi yang sesuai dengan aturan ACL saat ini. Anda dapat memanggil operasi ListDpiSignatures untuk menanyakan ID aplikasi dan informasi tentang aplikasi tersebut.
IpProtocol	String	UDP	Protokol yang digunakan oleh aturan ACL. Protokol yang didukung dalam topik ini hanya sebagai referensi. Protokol aktual di Konsol SAG yang berlaku. Nilai parameter ini tidak peka terhadap huruf besar/kecil.
Priority	Integer	70	Prioritas aturan ACL. Nilai valid: 1 hingga 100.
AclId	String	acl-7louazbja80bmg****	ID ACL.
Policy	String	drop	Aksi aturan ACL. Nilai valid: accept: mengizinkan network traffic. drop: memblokir network traffic.
Description	String	ACLRule	Deskripsi aturan ACL. Deskripsi harus terdiri dari 1 hingga 512 karakter. Secara default, parameter ini tidak dikembalikan. Anda dapat memanggil operasi ModifyACLRule untuk menambahkan deskripsi pada aturan ACL. Setelah itu, parameter ini akan disertakan dalam respons.
GmtCreate	Long	1580821597000	Timestamp saat aturan ACL dibuat. Timestamp bertipe data Long. Jika beberapa aturan ACL memiliki prioritas yang sama, aturan dengan timestamp paling awal yang berlaku.
DestCidr	String	0.0.0.0/0	Blok CIDR tujuan. Nilai parameter ini ditentukan dalam Notasi CIDR. Contoh: 192.168.10.0/24.
DestPortRange	String	10000/20000	Rentang port tujuan. Nilai valid: 1 hingga 65535 dan -1. Rentang port tujuan dalam salah satu format berikut: 1/200 atau 80/80. Nilai -1/-1 menunjukkan semua port.
Name	String	doctest	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.
AcrId	String	acr-gxzxj5w9qqdf1c****	ID aturan ACL.
SourceCidr	String	0.0.0.0/0	Blok CIDR sumber. Nilai parameter ini ditentukan dalam Notasi CIDR. Contoh: 192.168.1.0/24.
SourcePortRange	String	30000/40000	Rentang port sumber. Nilai valid: 1 hingga 65535 dan -1. Rentang port sumber dalam salah satu format berikut: 1/200 atau 80/80. Nilai -1/-1 menunjukkan semua port.
DpiGroupIds	Array of String	20	ID kelompok aplikasi yang sesuai dengan aturan ACL saat ini. Anda dapat memanggil operasi ListDpiGroups untuk menanyakan ID kelompok aplikasi dan informasi tentang aplikasi tersebut.
AclType	String	acl-hardware	Jumlah instans SAG yang terkait dengan ACL. Nilai valid: acl-hardware: Instans SAG CPE acl-software: Instans Aplikasi SAG

Contoh

Permintaan contoh

http(s)://[Endpoint]/?Action=DescribeACLAttribute
&RegionId=cn-hangzhou
&AclId=acl-ohlexqptfhyaq****
&PageSize=10
&PageNumber=1
&Direction=out
&Order=1255444444
&Name=doctest
&Common request parameters

Respons sukses contoh

XML format

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

<DescribeACLAttributeResponse>
    <TotalCount>3</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>8F62CE77-FBA2-4F8D-AED9-0A02814EDA69</RequestId>
    <PageNumber>1</PageNumber>
    <Acrs>
        <Direction>out</Direction>
        <Type>WAN</Type>
        <DpiSignatureIds>1</DpiSignatureIds>
        <IpProtocol>UDP</IpProtocol>
        <Priority>70</Priority>
        <AclId>acl-7louazbja80bmg****</AclId>
        <Policy>drop</Policy>
        <Description>ACLRule</Description>
        <GmtCreate>1580821597000</GmtCreate>
        <DestCidr>0.0.0.0/0</DestCidr>
        <DestPortRange>10000/20000</DestPortRange>
        <Name>doctest</Name>
        <AcrId>acr-gxzxj5w9qqdf1c****</AcrId>
        <SourceCidr>0.0.0.0/0</SourceCidr>
        <SourcePortRange>30000/40000</SourcePortRange>
        <DpiGroupIds>20</DpiGroupIds>
        <AclType>acl-hardware</AclType>
    </Acrs>
</DescribeACLAttributeResponse>

JSON format

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

{
  "TotalCount" : 3,
  "PageSize" : 10,
  "RequestId" : "8F62CE77-FBA2-4F8D-AED9-0A02814EDA69",
  "PageNumber" : 1,
  "Acrs" : [ {
    "Direction" : "out",
    "Type" : "WAN",
    "DpiSignatureIds" : [ "1" ],
    "IpProtocol" : "UDP",
    "Priority" : 70,
    "AclId" : "acl-7louazbja80bmg****",
    "Policy" : "drop",
    "Description" : "ACLRule",
    "GmtCreate" : 1580821597000,
    "DestCidr" : "0.0.0.0/0",
    "DestPortRange" : "10000/20000",
    "Name" : "doctest",
    "AcrId" : "acr-gxzxj5w9qqdf1c****",
    "SourceCidr" : "0.0.0.0/0",
    "SourcePortRange" : "30000/40000",
    "DpiGroupIds" : [ "20" ],
    "AclType" : "acl-hardware"
  } ]
}

Kode kesalahan

HttpCode	Kode kesalahan	Pesan kesalahan	Deskripsi
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	InvalidId.ACL	The specified ACL ID is invalid.	Pesan kesalahan yang dikembalikan karena ID ACL yang ditentukan tidak valid.
403	InternalError	An internal server error occurred.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal pada server.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.