Bir erişim kontrol listesi (ACL) sorgular.
Hata Ayıklama
İstek parametreleri
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | DescribeACLAttribute | Gerçekleştirmek istediğiniz işlem. Değeri DescribeACLAttribute olarak ayarlayın. |
| RegionId | String | No | cn-hangzhou | ACL'nin dağıtıldığı bölgenin kimliği. |
| AclId | String | No | acl-ohlexqptfhyaq**** | ACL'nin kimliği. |
| PageSize | Integer | No | 10 | Her sayfada döndürülecek giriş sayısı. Geçerli değerler: 1 ile 50. Varsayılan değer: 10. |
| PageNumber | Integer | No | 1 | Döndürülecek sayfanın numarası. Varsayılan değer: 1. |
| Direction | String | No | out | ACL kuralının uygulandığı trafik yönü. Geçerli değerler:
|
| Order | String | No | 1255444444 | Siparişin kimliği. |
| Name | String | No | doctest | ACL'nin adı. Ad 2 ila 100 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilir. Bir harfle başlamalıdır. Not Bu parametre bulanık eşlemeyi destekler. |
Yanıt parametreleri
| Parameter | Type | Example | Description |
| TotalCount | Integer | 3 | Döndürülen toplam giriş sayısı. |
| PageSize | Integer | 10 | Her sayfada döndürülecek giriş sayısı. |
| RequestId | String | 8F62CE77-FBA2-4F8D-AED9-0A02814EDA69 | İsteğin kimliği. |
| PageNumber | Integer | 1 | Döndürülen sayfanın numarası. |
| Acrs | Array of Acr | ACL içindeki ACL kuralları hakkında bilgiler. |
|
| Acr | |||
| Direction | String | out | ACL kuralının uygulandığı trafik yönü.
|
| Type | String | WAN | ACL kuralının türü:
|
| DpiSignatureIds | Array of String | 1 | Geçerli ACL kuralıyla eşleşen uygulamaların kimlikleri. Uygulama kimliklerini ve uygulama bilgilerini sorgulamak için ListDpiSignatures işlemini çağırabilirsiniz. |
| IpProtocol | String | UDP | ACL kuralı tarafından kullanılan protokol. Bu konuda sağlanan desteklenen protokoller yalnızca referans amaçlıdır. SAG konsolundaki gerçek protokoller geçerlidir. Parametrenin değeri büyük/küçük harfe duyarlı değildir. |
| Priority | Integer | 70 | ACL kuralının önceliği. Geçerli değerler: 1 ila 100. |
| AclId | String | acl-7louazbja80bmg**** | ACL'nin kimliği. |
| Policy | String | drop | ACL kuralının eylemi. Geçerli değerler:
|
| Description | String | ACLRule | ACL kuralının açıklaması. Açıklama 1 ila 512 karakter uzunluğunda olmalıdır. Varsayılan olarak bu parametre döndürülmez. ACL kuralına bir açıklama eklemek için ModifyACLRule işlemini çağırabilirsiniz. Ardından bu parametre yanıta dahil edilir. |
| GmtCreate | Long | 1580821597000 | ACL kuralının oluşturulduğu zaman damgası. Zaman damgası Long veri türündedir. Birden fazla ACL kuralı aynı önceliğe sahipse en eski zaman damgasına sahip kural etkili olur. |
| DestCidr | String | 0.0.0.0/0 | Hedef CIDR bloğu. Bu parametrenin değeri CIDR gösterimiyle belirtilir. Örnek: 192.168.10.0/24. |
| DestPortRange | String | 10000/20000 | Hedef bağlantı noktası aralığı. Geçerli değerler: 1 ila 65535 ve -1. Hedef bağlantı noktası aralığı 1/200 veya 80/80 biçimlerinden birindedir. -1/-1 değeri tüm bağlantı noktalarını ifade eder. |
| Name | String | doctest | ACL'nin adı. Ad 2 ila 100 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve kısa çizgi (-) içerebilir. Bir harfle başlamalıdır. |
| AcrId | String | acr-gxzxj5w9qqdf1c**** | ACL kuralının kimliği. |
| SourceCidr | String | 0.0.0.0/0 | Kaynak CIDR bloğu. Bu parametrenin değeri CIDR gösterimiyle belirtilir. Örnek: 192.168.1.0/24. |
| SourcePortRange | String | 30000/40000 | Kaynak bağlantı noktası aralığı. Geçerli değerler: 1 ila 65535 ve -1. Kaynak bağlantı noktası aralığı 1/200 veya 80/80 biçimlerinden birindedir. -1/-1 değeri tüm bağlantı noktalarını ifade eder. |
| DpiGroupIds | Array of String | 20 | Geçerli ACL kuralıyla eşleşen uygulama gruplarının kimlikleri. Uygulama grubu kimliklerini ve uygulama bilgilerini sorgulamak için ListDpiGroups işlemini çağırabilirsiniz. |
| AclType | String | acl-hardware | ACL ile ilişkilendirilen SAG örneklerinin sayısı. Geçerli değerler:
|
Örnekler
Örnek istekler
http(s)://[Endpoint]/?Action=DescribeACLAttribute
&RegionId=cn-hangzhou
&AclId=acl-ohlexqptfhyaq****
&PageSize=10
&PageNumber=1
&Direction=out
&Order=1255444444
&Name=doctest
&Common request parameters
Başarılı yanıt örnekleri
XML biçimi
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 biçimi
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"
} ]
}
Hata kodları
|
HttpCode |
Error code |
Error message |
Description |
|
403 |
Forbidden |
User not authorized to operate on the specified resource. |
Belirtilen kaynağı yönetme izniniz olmadığı için döndürülen hata mesajı. |
|
403 |
MissingParameter |
The input parameter is missing, please check your input. |
Gerekli bir veya daha fazla parametre boş olduğu için döndürülen hata mesajı. Tüm gerekli parametreleri yapılandırdığınızdan emin olun. |
|
403 |
InvalidParameter |
The specified parameter is invalid. |
Bir parametre geçersiz bir değere ayarlandığı için döndürülen hata mesajı. |
|
403 |
InvalidId.ACL |
The specified ACL ID is invalid. |
Belirtilen ACL kimliği geçersiz olduğu için döndürülen hata mesajı. |
|
403 |
InternalError |
An internal server error occurred. |
Dahili sunucu hatası oluştu. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.