AddACLRule - - Alibaba Cloud Dokümantasyon Merkezi

Hata Ayıklama

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

İstek Parametreleri

Parameter	Type	Required	Example	Description
Action	String	Yes	AddACLRule	Gerçekleştirmek istediğiniz işlem. Değeri AddACLRule olarak ayarlayın.
RegionId	String	No	cn-shanghai	ACL'nin dağıtıldığı bölgenin kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
AclId	String	No	acl-xhwhyuo43l0n*****	ACL kimliği.
Description	String	No	desctest	ACL kuralının açıklaması. Açıklama 1 ila 512 karakter uzunluğunda olmalıdır.
Direction	String	No	in	ACL kuralının uygulandığı trafik yönü. Geçerli değerler: in: ACL kuralı, Smart Access Gateway (SAG) örneğiyle ilişkili yerel ağın gelen ağ trafiğini kontrol eder. out: ACL kuralı, SAG örneğiyle ilişkili yerel ağın giden ağ trafiğini kontrol eder.
SourceCidr	String	No	192.168.20.0/24	Kaynak IP adreslerinin aralığı. Bu parametrenin değerini CIDR gösterimiyle belirtin. Örnek: 192.168.1.0/24.
DestCidr	String	No	192.168.10.0/24	Hedef IP adreslerinin aralığı. Bu parametrenin değerini CIDR gösterimiyle belirtin. Örnek: 192.168.10.0/24.
IpProtocol	String	No	tcp	ACL kuralı tarafından kullanılan protokol. Bu konudaki protokoller yalnızca referans amaçlıdır. SAG konsolunda bulunan protokoller değişiklik gösterebilir. Parametre değeri büyük/küçük harfe duyarlı değildir.
SourcePortRange	String	No	1/200	Kaynak bağlantı noktası aralığı. Geçerli değerler: 1 ile 65535 ve -1. Kaynak bağlantı noktası aralığını 1/200 veya 80/80 biçimlerinden birinde ayarlayın. -1/-1 değeri tüm bağlantı noktalarını ifade eder.
DestPortRange	String	No	1/200	Hedef bağlantı noktası aralığı. Geçerli değerler: 1 ile 65535 ve -1. Hedef bağlantı noktası aralığını 1/200 veya 80/80 biçimlerinden birinde ayarlayın. -1/-1 değeri tüm bağlantı noktalarını ifade eder.
Policy	String	No	accept	ACL kuralının eylem ilkesi. Geçerli değerler: accept: Ağ trafiğine izin verir. drop: Ağ trafiğini engeller.
Priority	Integer	No	12	ACL kuralının önceliği. Daha küçük bir değer daha yüksek öncelik anlamına gelir. Kurallar aynı önceliğe sahipse SAG cihazlarına daha önce uygulanan kural geçerli olur. Geçerli değerler: 1 ila 100. Varsayılan değer: 1.
Type	String	No	LAN	ACL kuralının türü. Geçerli değerler: 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.
Name	String	No	doctest	ACL kuralının adı. Ad 2 ila 100 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Bir harfle başlamalıdır.
DpiSignatureIds.N	String	No	1	Uygulamanın kimliği. Her çağrıda en fazla 100 uygulama kimliği girebilirsiniz.
DpiGroupIds.N	String	No	20	Uygulama grubunun kimliği. Her çağrıda en fazla 100 uygulama grubu kimliği girebilirsiniz.

Yanıt Parametreleri

Parameter	Type	Example	Description
Policy	String	drop	ACL kuralının eylem ilkesi. accept: Ağ trafiğine izin verir. drop: Ağ trafiğini engeller.
Description	String	test	ACL kuralının açıklaması.
RequestId	String	880F84CB-9B54-4413-A8A3-8832C82D1BC4	İsteğin kimliği.
SourcePortRange	String	1/65535	Kaynak bağlantı noktası aralığı.
SourceCidr	String	192.168.20.0/24	Kaynak CIDR bloğu. Bu parametrenin değeri CIDR gösterimiyle belirtilir. Örnek: 192.168.1.0/24.
Priority	Integer	1	ACL kuralının önceliği. Daha küçük bir değer daha yüksek öncelik anlamına gelir. Kurallar aynı önceliğe sahipse SAG cihazlarına daha önce uygulanan kural geçerli olur.
AclId	String	acl-xhwhyuo43l0*******	ACL kimliği.
AcrId	String	acr-c1hkd054qywi******	ACL kuralının kimliği.
DestPortRange	String	1/65535	Hedef bağlantı noktası aralığı.
Direction	String	out	ACL kuralının uygulandığı trafik yönü. Geçerli değerler: in: ACL kuralı, SAG örneğiyle ilişkili yerel ağın gelen ağ trafiğini kontrol eder. out: ACL kuralı, SAG örneğiyle ilişkili yerel ağın giden ağ trafiğini kontrol eder.
DpiGroupIds	Array of String	20	Mevcut ACL kuralıyla eşleşen uygulama gruplarının kimlikleri.
Name	String	doctest	ACL kuralının adı.
Type	String	LAN	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.
GmtCreate	Long	1553766882689	ACL kuralının oluşturulduğu zaman damgası. Zaman damgası Long veri türündedir. Birden çok ACL kuralı aynı önceliğe sahipse en eski zaman damgasına sahip kural geçerli olur.
DestCidr	String	192.168.10.0/24	Hedef CIDR bloğu. Bu parametrenin değeri CIDR gösterimiyle belirtilir. Örnek: 192.168.10.0/24.
DpiSignatureIds	Array of String	1	Mevcut ACL kuralıyla eşleşen uygulamaların kimlikleri.
IpProtocol	String	TCP	ACL kuralı tarafından kullanılan protokol.

Örnekler

Örnek İstekler

http(s)://[Endpoint]/?Action=AddACLRule
&RegionId=cn-shanghai
&AclId=acl-xhwhyuo43l0n*****
&Description=desctest
&Direction=in
&SourceCidr=192.168.20.0/24
&DestCidr=192.168.10.0/24
&IpProtocol=tcp
&SourcePortRange=1/200
&DestPortRange=1/200
&Policy=accept
&Priority=12
&Type=LAN
&Name=doctest
&DpiSignatureIds=["1"]
&DpiGroupIds=["20"]
&Common request parameters

Başarılı Yanıt Örnekleri

XML Biçimi

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

<AddACLRuleResponse>
    <Policy>drop</Policy>
    <Description>test</Description>
    <RequestId>880F84CB-9B54-4413-A8A3-8832C82D1BC4</RequestId>
    <SourcePortRange>1/65535</SourcePortRange>
    <SourceCidr>192.168.20.0/24</SourceCidr>
    <Priority>1</Priority>
    <AclId>acl-xhwhyuo43l0*******</AclId>
    <AcrId>acr-c1hkd054qywi******</AcrId>
    <DestPortRange>1/65535</DestPortRange>
    <Direction>out</Direction>
    <DpiGroupIds>20</DpiGroupIds>
    <Name>doctest</Name>
    <Type>LAN</Type>
    <GmtCreate>1553766882689</GmtCreate>
    <DestCidr>192.168.10.0/24</DestCidr>
    <DpiSignatureIds>1</DpiSignatureIds>
    <IpProtocol>TCP</IpProtocol>
</AddACLRuleResponse>

JSON Biçimi

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

{
  "Policy" : "drop",
  "Description" : "test",
  "RequestId" : "880F84CB-9B54-4413-A8A3-8832C82D1BC4",
  "SourcePortRange" : "1/65535",
  "SourceCidr" : "192.168.20.0/24",
  "Priority" : 1,
  "AclId" : "acl-xhwhyuo43l0*******",
  "AcrId" : "acr-c1hkd054qywi******",
  "DestPortRange" : "1/65535",
  "Direction" : "out",
  "DpiGroupIds" : [ "20" ],
  "Name" : "doctest",
  "Type" : "LAN",
  "GmtCreate" : 1553766882689,
  "DestCidr" : "192.168.10.0/24",
  "DpiSignatureIds" : [ "1" ],
  "IpProtocol" : "TCP"
}

Hata Kodları

HttpCode	Error code	Error message	Description
400	ACL.NoSupportWanType	An SAG 1000 device does not support a WAN ACL.	Hata mesajı, bir SAG-1000 cihazının WAN ACL kuralını desteklemediğini belirtir.
400	ACL.InvalidType	The specified ACL type is invalid.	Hata mesajı, belirtilen ACL kuralı türünün geçersiz olduğunu belirtir.
403	Forbidden	User not authorized to operate on the specified resource.	Hata mesajı, belirtilen kaynağı yönetme izniniz olmadığını belirtir.
403	MissingParameter	The input parameter is missing, please check your input.	Hata mesajı, bir veya daha fazla zorunlu parametrenin boş olduğunu belirtir. Tüm zorunlu parametreleri yapılandırdığınızdan emin olun.
403	InvalidDescription	Description not valid.	Hata mesajı, açıklamanın uzunluğunun üst sınırı aştığını belirtir.
403	InvalidParameter	The specified parameter is invalid.	Hata mesajı, bir parametrenin geçersiz bir değere ayarlandığını belirtir.
403	FeatureNotSupport	The current edition of the smart access gateway does not support this feature.	Hata mesajı, belirtilen SAG cihazının mevcut sürümünün bu özelliği desteklemediğini belirtir.
403	FeatureNotSupportForActiveSmartAG	The current edition of the active smart access gateway does not support this feature.	Hata mesajı, etkin SAG cihazının mevcut sürümünün bu özelliği desteklemediğini belirtir.
403	FeatureNotSupportForStandBySmartAG	The current edition of the standby smart access gateway does not support this feature.	Hata mesajı, yedek SAG cihazının mevcut sürümünün bu özelliği desteklemediğini belirtir.
403	NotSupportedProtocol	The specified protocol of the ACL rule is not supported.	Hata mesajı, ACL kuralı için belirttiğiniz protokol türünün desteklenmediğini belirtir.
403	InvalidId.ACL	The specified ACL ID is invalid.	Hata mesajı, belirtilen ACL kimliğinin geçersiz olduğunu belirtir.
403	InvalidPortRange	The specified port range is invalid.	Hata mesajı, belirtilen bağlantı noktası aralığının geçersiz olduğunu belirtir.
403	AcrPerAclAmountLimit	The maximum number of rules in an ACL is exceeded. You can open a ticket to increase the quota.	ACL kuralı sayısı, her ACL grubu altında oluşturabileceğiniz ACL kuralları için üst sınıra ulaştı. Kota artış talebinde bulunmak için bir destek bileti gönderebilirsiniz.
403	InternalError	An internal server error occurred.	Hata mesajı, bir iç sunucu hatası oluştuğunu belirtir.

Hata kodlarının listesi için bkz. Hizmet hata kodları.