Tüm Ürünler
Search
Belge Merkezi

:CreateVpcPrefixList

Son Güncelleme:Oct 02, 2026

Bir ön ek listesi oluşturur.

Kullanım notları

Belirtilen süre içinde bir bölgede ön ek listesi oluşturmak için CreateVpcPrefixList işlemini art arda çağıramazsınız.

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 CreateVpcPrefixList

Gerçekleştirmek istediğiniz işlem. Değeri CreateVpcPrefixList olarak belirtin.

PrefixListName String No name

Ön ek listesinin adı.

Ad 1 ila 128 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

PrefixListDescription String No description

Ön ek listesinin açıklaması.

Açıklama 1 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

ClientToken String No 123e4567-e89b-12d3-a456-426655440000

İsteğin yinelenebilirliğini (idempotence) sağlamak için kullanılan istemci belirteci.

Belirteci istemci tarafında oluşturabilirsiniz ancak farklı istekler arasında benzersiz olduğundan emin olmalısınız. Belirteç yalnızca ASCII karakterleri içerebilir.

Not Bu parametreyi belirtmezseniz sistem otomatik olarak istek kimliğini istemci belirteci olarak kullanır. Her istek için istek kimliği farklı olabilir.
DryRun Boolean No false

Gerçek isteği göndermeden yalnızca deneme çalıştırması yapılıp yapılmayacağını belirtir. Geçerli değerler:

  • true: Deneme çalıştırması gerçekleştirilir. Sistem eksik parametre değerleri, hatalı istek sözdizimi ve hizmet sınırları gibi potansiyel sorunları kontrol eder. İstek deneme çalıştırmasından başarısız olursa bir hata mesajı döndürülür. İstek başarılı olursa DryRunOperation hata kodu döndürülür.
  • false (varsayılan): Deneme çalıştırması yapılır ve istek gönderilir. İstek deneme çalıştırmasından başarıyla geçerse 2xx HTTP durum kodu döndürülür ve işlem gerçekleştirilir.
MaxEntries Integer No 50

Ön ek listesinde belirtebileceğiniz maksimum CIDR bloğu sayısı. Varsayılan değer: 50.

PrefixListEntries.N.Cidr String No 192.168.0.0/16

Ön ek listesinde belirtilen CIDR bloğu.

PrefixListEntries.N.Description String No CIDR

Ön ek listesinde belirtilen CIDR bloğunun açıklaması.

Açıklama 1 ila 256 karakter uzunluğunda olmalı ve http:// veya https:// ile başlayamaz.

ResourceGroupId String No rg-bp67acfmxazb4ph****

Ön ek listesinin ait olduğu kaynak grubunun kimliği.

RegionId String Yes cn-hangzhou

Ön ek listesini oluşturmak istediğiniz bölgenin kimliği.

En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.

IpVersion String No IPv4

IP sürümü. Geçerli değerler:

  • IPv4 (varsayılan)
  • IPv6
Tag.N.Key String No FinanceDept

Kaynağa eklenecek N. etiketin anahtarı. En fazla 20 etiket anahtarı belirtebilirsiniz. Etiket anahtarı boş bir dize olamaz.

Etiket anahtarı en fazla 128 karakter uzunluğunda olabilir. aliyun veya acs: ile başlayamaz ve http:// veya https:// içeremez.

Tag.N.Value String No FinanceJoshua

Kaynağa eklenecek N. etiketin değeri. En fazla 20 etiket değeri belirtebilirsiniz. Etiket değeri boş bir dize olabilir.

Etiket değeri en fazla 128 karakter uzunluğunda olabilir ve acs: veya aliyun ile başlayamaz. Etiket değeri http:// veya https:// içeremez.

Yanıt parametreleri

Parameter

Type

Example

Description

PrefixListId

String

pl-0b700s2ee3***

Ön ek listesinin kimliği.

RequestId

String

54B48E3D-DF70-471B-AA93-08E683A1B45

İstek kimliği.

ResourceGroupId

String

rg-bp67acfmxazb4ph****

Ön ek listesinin ait olduğu kaynak grubunun kimliği.

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=CreateVpcPrefixList
&PrefixListName=name
&PrefixListDescription=description
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&DryRun=false
&MaxEntries=50
&PrefixListEntries=[{"Cidr":"192.168.0.0/16","Description":"CIDR"}]
&ResourceGroupId=rg-bp67acfmxazb4ph****
&RegionId=cn-hangzhou
&IpVersion=IPv4
&Tag=[{"Key":"FinanceDept","Value":"FinanceJoshua"}]
&Common request parameters

Başarılı yanıt örnekleri

XML biçimi

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

<CreateVpcPrefixListResponse>
    <PrefixListId>pl-0b700s2ee3***</PrefixListId>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <ResourceGroupId>rg-bp67acfmxazb4ph****</ResourceGroupId>
</CreateVpcPrefixListResponse>

JSON biçimi

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

{
  "PrefixListId" : "pl-0b700s2ee3***",
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ResourceGroupId" : "rg-bp67acfmxazb4ph****"
}

Hata kodları

HttpCode

Error code

Error message

Description

400

UnsupportedFeature.IpVersion

The ipversion type is not supported.

ipVersion parametresi geçersiz bir değere ayarlandığında döner.

400

QuotaExceeded.PrefixListCidrCount

The quota of prefixListMaxEntry count is exceeded.

entryCount parametresinin değeri üst sınırı aştığında döner.

400

OperationFailed.CidrCountExceedMaxCount

The operation is failed because of cidrCountExceedMaxCount.

Belirtilen CIDR bloklarının sayısı, cidrMaxCount parametresiyle belirtilen üst sınırı aştığında döner.

400

IllegalParam.CidrBlock

The param of cidrBlock is illegal.

cidrBlock parametresi geçersiz bir değere ayarlandığında döner.

400

IllegalParam.CidrName

The param of cidrName is illegal.

cidrName parametresi geçersiz bir değere ayarlandığında döner.

400

DuplicatedParam.CidrBlock

The param of cidrBlock is duplicated.

Yinelenen bir CIDR bloğu belirtildiğinde döner.

400

QuotaExceeded.PrefixListCount

The quota of prefixList count is exceeded.

prefixList parametresinin değeri üst sınırı aştığında döner.

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