Tüm Ürünler
Search
Belge Merkezi

:ModifyACLRule

Son Güncelleme:Oct 01, 2026

Bir erişim kontrol listesi (ACL) kuralını değiştirir.

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 örnek kodları dinamik olarak oluşturur.

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

  • 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.
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:

  • 1/200: 1. bağlantı noktasından 200. bağlantı noktasına kadar.
  • 80/80: 80. bağlantı noktası.
  • -1/-1: tüm bağlantı noktaları.
DestPortRange String No 80/80

Hedef bağlantı noktası aralığı. Geçerli değerler: 1 ile 65535 arasında ve -1.

Örnekler:

  • 1/200: 1. bağlantı noktasından 200. bağlantı noktasına kadar.
  • 80/80: 80. bağlantı noktası.
  • -1/-1: tüm bağlantı noktaları.
Policy String No accept

ACL kuralının eylemi. Geçerli değerler:

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

  • LAN: ACL kuralı özel IP adreslerinin trafiğini kontrol eder.
  • WAN: ACL kuralı genel IP adreslerinin trafiğini kontrol eder.
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.

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

  • 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

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