Bir erişim kontrol listesi (ACL) kuralını değiştirir.
Hata Ayıklama
İstek parametreleri
| Parameter | Type | Required | Example | Description |
| Action | String | Yes | ModifyACLRule | Gerçekleştirmek istediğiniz işlem. Değeri ModifyACLRule olarak ayarlayın. |
| RegionId | String | Yes | cn-shanghai | ACL'nin dağıtıldığı bölgenin kimliği. |
| AclId | String | Yes | acl-xhwhyuo43l0n******* | ACL kimliği. |
| AcrId | String | Yes | acr-u98qztgtgvhb******** | ACL kuralının kimliği. ACL'ye eklenen ACL kuralının kimliğini sorgulamak için DescribeACLAttribute işlemini çağırabilirsiniz. |
| Description | String | No | test | ACL kuralının açıklaması. Açıklama 1 ile 512 karakter uzunluğunda olmalıdır. |
| Direction | String | No | in | ACL kuralının uygulandığı trafik yönü. Geçerli değerler:
|
| SourceCidr | String | No | 0.0.0.0/0 | Kaynak CIDR bloğu. Bu parametrenin değerini CIDR gösterimiyle belirtin. Örnek: 192.168.1.0/24. |
| DestCidr | String | No | 0.0.0.0/0 | Hedef CIDR bloğu. 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 konuda sağlanan desteklenen protokoller yalnızca referans içindir. SAG konsolundaki gerçek protokoller geçerlidir. Parametre değeri büyük/küçük harfe duyarlı değildir. |
| SourcePortRange | String | No | 80/80 | Kaynak bağlantı noktası aralığı. Geçerli değerler: 1 ile 65535 arasında ve -1. Örnekler:
|
| DestPortRange | String | No | 80/80 | Hedef bağlantı noktası aralığı. Geçerli değerler: 1 ile 65535 arasında ve -1. Örnekler:
|
| Policy | String | No | accept | ACL kuralının eylemi. Geçerli değerler:
|
| Priority | Integer | No | 2 | ACL kuralının önceliği. Daha küçük bir değer daha yüksek öncelik anlamına gelir. Birden fazla kural aynı önceliğe sahipse daha önce uygulanan kural geçerli olur. Geçerli değerler: 1 ile 100. Varsayılan değer: 1. |
| Type | String | No | LAN | ACL kuralının türü. Geçerli değerler:
|
| Name | String | No | doctest | ACL kuralının adı. Ad 2 ila 128 karakter uzunluğunda olmalı; harf, rakam, alt çizgi (_) ve tire (-) içerebilir. Ad bir harfle başlamalıdır. |
| DpiSignatureIds.N | String | No | 1 | ACL kuralıyla eşleşen uygulamaların kimlikleri. Uygulama kimliklerini ve uygulama bilgilerini sorgulamak için ListDpiSignatures işlemini çağırabilirsiniz. |
| DpiGroupIds.N | String | No | 20 | 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. |
Yanıt parametreleri
| Parameter | Type | Example | Description |
| Policy | String | accept | ACL kuralının eylemi.
|
| Description | String | test | ACL kuralının açıklaması. |
| RequestId | String | 7F3DD2C1-0F6B-4575-9106-B2D50DF7A711 | İsteğin kimliği. |
| SourcePortRange | String | -1/-1 | Kaynak bağlantı noktası aralığı. |
| SourceCidr | String | 0.0.0.0/0 | Kaynak CIDR bloğu. Bu parametrenin değeri CIDR gösterimindedir. Ö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. Birden fazla kural aynı önceliğe sahipse daha önce uygulanan kural geçerli olur. |
| AclId | String | acl-jdc7tir4fkplwr**** | ACL kimliği. |
| AcrId | String | acr-r8hezn2pi39s5a**** | ACL kuralının kimliği. |
| DestPortRange | String | -1/-1 | Hedef bağlantı noktası aralığı. |
| Direction | String | in | ACL kuralının uygulandığı trafik yönü. Geçerli değerler:
|
| DpiGroupIds | Array of String | 20 | ACL kuralıyla eşleşen uygulama gruplarının kimlikleri. |
| Name | String | doctest | ACL kuralının adı. |
| GmtCreate | Long | 1553777700000 | 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 olan kural geçerli olur. |
| DestCidr | String | 0.0.0.0/0 | Hedef CIDR bloğu. Bu parametrenin değeri CIDR gösterimindedir. Örnek: 192.168.10.0/24. |
| DpiSignatureIds | Array of String | 1 | ACL kuralıyla eşleşen uygulamaların kimlikleri. |
| IpProtocol | String | ALL | ACL kuralı tarafından kullanılan protokol. |
Örnekler
Örnek istekler
http(s)://[Endpoint]/?Action=ModifyACLRule
&RegionId=cn-shanghai
&AclId=acl-xhwhyuo43l0n*******
&AcrId=acr-u98qztgtgvhb********
&Description=test
&Direction=in
&SourceCidr=0.0.0.0/0
&DestCidr=0.0.0.0/0
&IpProtocol=tcp
&SourcePortRange=80/80
&DestPortRange=80/80
&Policy=accept
&Priority=2
&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
<ModifyACLRuleResponse>
<Policy>accept</Policy>
<Description>test</Description>
<RequestId>7F3DD2C1-0F6B-4575-9106-B2D50DF7A711</RequestId>
<SourcePortRange>-1/-1</SourcePortRange>
<SourceCidr>0.0.0.0/0</SourceCidr>
<Priority>1</Priority>
<AclId>acl-jdc7tir4fkplwr****</AclId>
<AcrId>acr-r8hezn2pi39s5a****</AcrId>
<DestPortRange>-1/-1</DestPortRange>
<Direction>in</Direction>
<DpiGroupIds>20</DpiGroupIds>
<Name>doctest</Name>
<GmtCreate>1553777700000</GmtCreate>
<DestCidr>0.0.0.0/0</DestCidr>
<DpiSignatureIds>1</DpiSignatureIds>
<IpProtocol>ALL</IpProtocol>
</ModifyACLRuleResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Policy" : "accept",
"Description" : "test",
"RequestId" : "7F3DD2C1-0F6B-4575-9106-B2D50DF7A711",
"SourcePortRange" : "-1/-1",
"SourceCidr" : "0.0.0.0/0",
"Priority" : 1,
"AclId" : "acl-jdc7tir4fkplwr****",
"AcrId" : "acr-r8hezn2pi39s5a****",
"DestPortRange" : "-1/-1",
"Direction" : "in",
"DpiGroupIds" : [ "20" ],
"Name" : "doctest",
"GmtCreate" : 1553777700000,
"DestCidr" : "0.0.0.0/0",
"DpiSignatureIds" : [ "1" ],
"IpProtocol" : "ALL"
}
Hata kodları
|
HttpCode |
Error code |
Error message |
Description |
|
400 |
ACL.NoSupportWanType |
An SAG 1000 device does not support a WAN ACL. |
SAG-1000 cihazının WAN ACL kuralını desteklememesi nedeniyle dönen hata mesajı. |
|
400 |
ACL.InvalidType |
The specified ACL type is invalid. |
Belirtilen ACL kuralı türünün geçersiz olması nedeniyle dönen hata mesajı. |
|
403 |
Forbidden |
User not authorized to operate on the specified resource. |
Belirtilen kaynağı yönetme izniniz olmaması nedeniyle dönen hata mesajı. |
|
403 |
MissingParameter |
The input parameter is missing, please check your input. |
Bir veya daha fazla gerekli parametrenin boş olması nedeniyle dönen hata mesajı. Tüm gerekli parametreleri yapılandırdığınızdan emin olun. |
|
403 |
InvalidDescription |
Description not valid. |
Açıklamanın uzunluğunun üst sınırı aşması nedeniyle dönen hata mesajı. |
|
403 |
InvalidParameter |
The specified parameter is invalid. |
Bir parametrenin geçersiz bir değere ayarlanmış olması nedeniyle dönen hata mesajı. |
|
403 |
FeatureNotSupport |
The current edition of the smart access gateway does not support this feature. |
Belirtilen SAG cihazının mevcut sürümünün bu özelliği desteklememesi nedeniyle dönen hata mesajı. |
|
403 |
FeatureNotSupportForActiveSmartAG |
The current edition of the active smart access gateway does not support this feature. |
Aktif SAG cihazının mevcut sürümünün bu özelliği desteklememesi nedeniyle dönen hata mesajı. |
|
403 |
FeatureNotSupportForStandBySmartAG |
The current edition of the standby smart access gateway does not support this feature. |
Yedekteki SAG cihazının mevcut sürümünün bu özelliği desteklememesi nedeniyle dönen hata mesajı. |
|
403 |
NotSupportedProtocol |
The specified protocol of the ACL rule is not supported. |
ACL kuralı için belirttiğiniz protokol türünün desteklenmemesi nedeniyle dönen hata mesajı. |
|
403 |
InvalidId.ACL |
The specified ACL ID is invalid. |
Belirtilen ACL kimliğinin geçersiz olması nedeniyle dönen hata mesajı. |
|
403 |
InvalidId.ACR |
The specified ACL rule ID is invalid. |
Belirtilen ACL kuralı kimliğinin geçersiz olması nedeniyle dönen hata mesajı. |
|
403 |
InvalidPortRange |
The specified port range is invalid. |
Belirtilen bağlantı noktası aralığının geçersiz olması nedeniyle dönen hata mesajı. |
|
403 |
InternalError |
An internal server error occurred. |
Dahili bir sunucu hatası oluşması nedeniyle dönen hata mesajı. |
Hata kodlarının listesi için bkz. Hizmet hata kodları.