Tüm Ürünler
Search
Belge Merkezi

:DescribeACLs

Son Güncelleme:Oct 01, 2026

Belirtilen bölgedeki erişim denetim listelerini (ACL) sorgular.

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 işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre Tür Gerekli Örnek Açıklama
Action String Evet DescribeACLs

Gerçekleştirmek istediğiniz işlem. Değeri DescribeACLs olarak ayarlayın.

RegionId String Evet cn-shanghai

ACL'nin dağıtıldığı bölgenin kimliği.

AclIds String Hayır acl-xhwhyuo43l*******

ACL kimliği.

  • Aynı anda birden fazla ACL sorgulamak istiyorsanız ACL kimliklerini virgül (,) ile ayırın.
  • Bu parametreyi ayarlamazsanız belirtilen bölgedeki tüm ACL'ler sorgulanır.
Name String Hayır test

ACL adı.

Ad 2 ila 100 karakter uzunluğunda olmalı; harf, rakam, nokta (.), alt çizgi (_) ve tire (-) içerebilir. Bir harfle başlamalıdır.

PageSize Integer Hayır 10

Her sayfada döndürülecek giriş sayısı. Maksimum değer: 50. Varsayılan değer: 10.

PageNumber Integer Hayır 1

Döndürülecek sayfanın numarası. Varsayılan değer: 1.

AclType String Hayır acl-hardware

ACL ile ilişkili SAG örneğinin türü. Geçerli değerler:

  • acl-hardware: SAG CPE örneği
  • acl-software: SAG uygulama örneği

Yanıt parametreleri

Parametre Tür Örnek Açıklama
TotalCount Integer 1

Döndürülen toplam giriş sayısı.

PageSize Integer 10

Sayfa başına döndürülen giriş sayısı.

RequestId String 660F303F-C88E-4026-BC6A-FC24B78FD7EA

İstek kimliği.

PageNumber Integer 1

Döndürülen sayfanın numarası.

Acls Array of Acl

ACL listesi.

Acl
SagCount String 0

ACL ile ilişkili SAG örneklerinin sayısı.

AclId String acl-xhwhyuo43l*******

ACL kimliği.

Name String test

ACL adı.

ResourceGroupId String rg-acfm2iu4fnc****

ACL'nin ait olduğu kaynak grubunun kimliği.

AclType String acl-hardware

ACL ile ilişkili SAG örneğinin türü. Geçerli değerler:

  • acl-hardware: SAG CPE örneği
  • acl-software: SAG uygulama örneği

Örnekler

Örnek istekler

http(s)://[Endpoint]/?Action=DescribeACLs
&RegionId=cn-shanghai
&AclIds=acl-xhwhyuo43l*******
&Name=test
&PageSize=10
&PageNumber=1
&AclType=acl-hardware
&Common request parameters

Örnek başarılı yanıt

XML biçimi

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

<DescribeACLsResponse>
    <TotalCount>1</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>660F303F-C88E-4026-BC6A-FC24B78FD7EA</RequestId>
    <PageNumber>1</PageNumber>
    <Acls>
        <SagCount>0</SagCount>
        <AclId>acl-xhwhyuo43l*******</AclId>
        <Name>test</Name>
        <ResourceGroupId>rg-acfm2iu4fnc****</ResourceGroupId>
        <AclType>acl-hardware</AclType>
    </Acls>
</DescribeACLsResponse>

JSON biçimi

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

{
  "TotalCount" : 1,
  "PageSize" : 10,
  "RequestId" : "660F303F-C88E-4026-BC6A-FC24B78FD7EA",
  "PageNumber" : 1,
  "Acls" : [ {
    "SagCount" : "0",
    "AclId" : "acl-xhwhyuo43l*******",
    "Name" : "test",
    "ResourceGroupId" : "rg-acfm2iu4fnc****",
    "AclType" : "acl-hardware"
  } ]
}

Hata kodları

HttpCode

Hata kodu

Hata mesajı

Açıklama

403

Forbidden

User not authorized to operate on the specified resource.

Belirtilen kaynağı yönetme izniniz olmadığı için döndürülen hata mesajı.

403

MissingParameter

The input parameter is missing, please check your input.

Gerekli bir veya daha fazla parametrenin boş olması nedeniyle döndürülen hata mesajı. Gerekli tüm parametreleri yapılandırdığınızdan emin olun.

403

InvalidParameter

The specified parameter is invalid.

Bir parametrenin geçersiz bir değere ayarlanması nedeniyle döndürülen hata mesajı.

403

InternalError

An internal server error occurred.

Dahili sunucu hatası oluştuğu için döndürülen hata mesajı.

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