Tüm Ürünler
Search
Belge Merkezi

:DescribeACLAttribute

Son Güncelleme:Oct 01, 2026

Bir erişim kontrol listesi (ACL) sorgular.

Hata Ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodlarını dinamik olarak oluşturur.

İ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:

  • in: ACL kuralı, Smart Access Gateway (SAG) örneğiyle ilişkilendirilmiş yerel ağın gelen ağ trafiğini kontrol eder.
  • out: ACL kuralı, SAG örneğiyle ilişkilendirilmiş yerel ağın giden ağ trafiğini kontrol eder.
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ü.

  • in: ACL kuralı, SAG örneğiyle ilişkilendirilmiş yerel ağın gelen ağ trafiğini kontrol eder.
  • out: ACL kuralı, SAG örneğiyle ilişkilendirilmiş yerel ağın giden ağ trafiğini kontrol eder.
Type String WAN

ACL kuralının türü:

  • LAN: ACL kuralı, özel IP adresleri üzerinden iletilen ağ trafiğini kontrol eder.
  • WAN: ACL kuralı, genel IP adresleri üzerinden iletilen ağ trafiğini kontrol eder.
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:

  • accept: ağ trafiğine izin verir.
  • drop: ağ trafiğini engeller.
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:

  • acl-hardware: SAG CPE örneği
  • acl-software: SAG app örneği

Ö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ı.