Tüm Ürünler
Search
Belge Merkezi

:DescribeHotKeys

Son Güncelleme:Oct 06, 2026

Belirtilen ApsaraDB for Redis örneğindeki hot key'leri sorgular.

Bu işlemi çağırmadan önce aşağıdaki gereksinimlerin karşılandığından emin olun:

  • Bir Alibaba Cloud SDK kullanıyorsanız aliyun-sdk-core sürümünün 4.3.3'ten yeni olduğundan emin olun. En son sürümü kullanmanızı öneririz.

  • Database Autonomy Service (DAS) SDK sürümünüzün 1.0.2 veya üzeri olması gerekir.

  • SDK kullanarak DAS'i çağırıyorsanız bölgeyi cn-shanghai olarak ayarlamanız gerekir.

  • DescribeHotKeys işlemi yalnızca aşağıdaki gereksinimleri karşılayan ApsaraDB for Redis örneklerinde kullanılabilir:

    • Örnek, ana sürümü 5,0 veya üzeri olan bir Community Edition örneği ya da Enhanced Edition (Tair) performans artırılmış bir örnektir.

    • Örnek en son küçük sürüme güncellenmiştir.

İstek parametreleri

Parametre Tür Zorunlu Örnek Açıklama
Action String Evet DescribeHotKeys


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

InstanceId String Evet r-bp18ff4a195d****


ApsaraDB for Redis örneğinin kimliği. Kimliği sorgulamak için DescribeInstances işlemini çağırabilirsiniz.

NodeId String Hayır r-x****-db-0


ApsaraDB for Redis örneğindeki veri parçasının kimliği. Kimliği sorgulamak için DescribeRoleZoneInfo işlemini çağırabilirsiniz.

Yanıt parametreleri

ParametreTürÖrnekAçıklama
MessageStringSuccessful

İstek için döndürülen mesaj.

Not İstek başarılı olursa Successful değeri döndürülür. İstek başarısız olursa hata kodu gibi bilgiler içeren bir hata mesajı döndürülür.
RequestIdStringB6D17591-B48B-4D31-9CD6-9B9796B2****

İsteğin kimliği.

DataHotKey Dizisi

Hot key'lerle ilgili ayrıntılar.

HotKey
KeyStringabc:def:eng

Anahtarın adı.

DbInteger0

Anahtarın depolandığı veritabanı.

HotString5500~6000

Anahtara erişim sıklığı; bu değer anahtarın saniye başına sorgu (QPS) sayısını gösterir.

KeyTypeStringzset

Anahtarın türü.

SizeLong2

Anahtardaki öğe sayısı.

CodeString200

Döndürülen HTTP durum kodu.

SuccessStringtrue

İsteğin başarılı olup olmadığını belirtir. Geçerli değerler:

  • true: İstek başarılı oldu.
  • false: İstek başarısız oldu.

Örnekler

Örnek istekler

http(s)://das.cn-shanghai.aliyuncs.com/?Action=DescribeHotKeys
&InstanceId=r-bp18ff4a195d****
&NodeId=r-x****-db-0
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

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

<DescribeHotKeysResponse>
    <Message>Successful</Message>
    <RequestId>B6D17591-B48B-4D31-9CD6-9B9796B2****</RequestId>
    <Data>
        <Key>abc:def:eng</Key>
        <Db>0</Db>
        <Hot>5500~6000</Hot>
        <KeyType>zset</KeyType>
        <Size>2</Size>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</DescribeHotKeysResponse>

JSON biçimi

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

{
  "Message" : "Successful",
  "RequestId" : "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data" : [ {
    "Key" : "abc:def:eng",
    "Db" : 0,
    "Hot" : "5500~6000",
    "KeyType" : "zset",
    "Size" : 2
  } ],
  "Code" : "200",
  "Success" : "true"
}

Hata kodları

HTTP durum kodu Hata kodu Hata mesajı Açıklama
400 InvalidParams The request parameters are invalid. Belirtilen istek parametreleri geçersiz olduğu için döndürülen hata mesajı.

Hata kodlarının listesi için API Error Center adresini ziyaret edin.