Tüm Ürünler
Search
Belge Merkezi

:AddEntriesToAcl

Son Güncelleme:Oct 26, 2026

Bir erişim kontrolü ilke grubuna IP girişleri ekler.

Operation description

  • Her ilke grubu birden fazla IP adresi girişi veya CIDR bloğu girişi içerebilir. Bir erişim kontrolü ilke grubu için giriş sınırları aşağıdaki gibidir:

    • Her çağrıda hesap başına eklenebilecek maksimum IP adresi girişi sayısı: 20.

    • Her erişim kontrolü ilke grubunun içerebileceği maksimum giriş sayısı: 500.

  • AddEntriesToAcl işlemi eşzamansızdır. Bu işlemi çağırdıktan sonra sistem bir istek kimliği döndürür, ancak IP girişleri erişim kontrolü ilke grubuna hemen eklenmez. Ekleme görevi arka planda çalışmaya devam eder. IP girişlerinin eklenme durumunu sorgulamak için ListAclEntries işlemini çağırabilirsiniz:

    • Erişim kontrolü ilke grubu Adding durumundaysa, IP girişleri ekleniyor demektir.

    • Erişim kontrolü ilke grubu Available durumundaysa, IP girişleri eklenmiş demektir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

alb:AddEntriesToAcl

create

*Acl.

acs:alb:{#regionId}:{#accountId}:acl/{#aclId}

None None

Request parameters

Parameter

Type

Required

Description

Example

AclId

string

Yes

ACL örneği kimliği.

acl-hp34s2h0xx1ht4nwo****

AclEntries

array<object>

Yes

Eklenecek erişim kontrolü girişlerinin listesi. Tek bir çağrıda en fazla 20 erişim kontrolü girişi ekleyebilirsiniz.

object

No

Erişim kontrolü ilkesi yapısı.

Description

string

No

Erişim kontrolü girişinin açıklaması. Açıklama 2 ila 256 karakter uzunluğunda olmalı ve harf, rakam, Çince karakter, virgül (,), nokta (.), noktalı virgül (;), eğik çizgi (/), et işareti (@), alt çizgi (_) ve tire (-) içerebilir.

Tek bir çağrıda en fazla 20 erişim kontrolü girişi ekleyebilirsiniz.

test-entry

Entry

string

Yes

Erişim kontrolü girişinin CIDR bloğu.

10.0.1.0/24

ClientToken

string

No

İsteğin idempotansını sağlamak için kullanılan istemci belirteci.

Parametre değerini istemcinizden oluşturabilir ve değerin farklı istekler arasında benzersiz olduğundan emin olabilirsiniz. ClientToken parametresi yalnızca ASCII karakterleri destekler.

Not

Bu parametreyi belirtmezseniz, sistem otomatik olarak API isteğinin RequestId değerini ClientToken olarak kullanır. Her API isteğinin RequestId değeri benzersizdir.

5A2CFF0E-5718-45B5-9D4D-70B3******

DryRun

boolean

No

Yalnızca isteğin ön kontrolünün yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Sistem, erişim kontrolü ilke grubuna IP girişleri eklemeden isteğin ön kontrolünü yapar. Sistem gerekli parametrelerin belirtilip belirtilmediğini, istek biçimini ve hizmet sınırlarını kontrol eder. İstek ön kontrolü geçemezse, ilgili hata döndürülür. İstek ön kontrolü geçerse, DryRunOperation hata kodu döndürülür.

  • false (varsayılan): Sistem normal bir istek gönderir. İstek ön kontrolü geçerse, sistem bir HTTP 2xx durum kodu döndürür ve işlemi gerçekleştirir.

false

Response elements

Element

Type

Description

Example

object

Bir erişim kontrolü ilke grubuna IP girişleri ekler.

JobId

string

Eşzamansız görevin kimliği.

72dcd26b-f12d-4c27-b3af-18f6aed5****

RequestId

string

İsteğin kimliği.

365F4154-92F6-4AE4-92F8-7FF34******

Examples

Success response

JSON format

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710"
}

Error codes

HTTP status code

Error code

Error message

Description

400 ResourceAlreadyExist.AclEntry The specified resource %s already exists. IP girişi erişim kontrolü ilke grubunda zaten mevcut.
400 ResourceQuotaExceeded.AclEntriesNum The quota of %s is exceeded for resource %s, usage %s/%s. %s kotası aşıldı. Kaynak %s'dir. Mevcut kullanım %s'dir. Kota %s'dir.
400 IncorrectStatus.Acl The status of %s [%s] is incorrect. Erişim kontrolü ilke grubu ACL'nin mevcut durumu bu işlemi desteklemiyor.
400 ResourceQuotaExceeded.ListenerAclEntriesNum The quota of %s is exceeded for resource %s, usage %s/%s. %s kotası aşıldı. Kaynak %s'dir. Mevcut kullanım %s'dir. Kota %s'dir.
400 ResourceQuotaExceeded.LoadBalancerAclEntriesNum The quota of %s is exceeded for resource %s, usage %s/%s. %s kotası aşıldı. Kaynak %s'dir. Mevcut kullanım %s'dir. Kota %s'dir.
404 ResourceNotFound.Acl The specified resource %s is not found. Erişim denetimi ilke grubu ACL mevcut değildir.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.