DescribeCacheAnalysisJob - - Alibaba Cloud Dokümantasyon Merkezi

Bir önbellek analizi görevinin ayrıntılarını sorgular.

Operation description

Bu işlemi çağırmadan önce aşağıdaki hususlara dikkat edin:

Bu işlemi çağırmak için bir Alibaba Cloud SDK veya Veritabanı Otonomi Hizmeti (DAS) SDK kullanıyorsanız, SDK'nın en son sürümünü kullanmanızı öneririz.
DAS API işlemlerini çağırmak için bir SDK kullanıyorsanız, bölge kimliğini cn-shanghai olarak ayarlamanız gerekir.
Bu işlem yalnızca ApsaraDB for Redis için geçerlidir.

Not

Bir önbellek analizi görevindeki en üst 500 anahtarı döndürür.

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

hdm:DescribeCacheAnalysisJob

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	Örneğin kimliği.	r-bp18ff4a195d****
JobId	string	Yes	Önbellek analizi görevinin kimliği. Görev kimliğini CreateCacheAnalysisJob işleminin yanıt parametrelerinden alabilirsiniz.	sf79-sd99-sa37-****

Response elements

Element	Type	Description	Example
	object	Yanıt parametreleri.
Message	string	İstek için döndürülen mesaj. Not İstek başarılıysa Successful 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.	Successful
RequestId	string	İsteğin kimliği.	B6D17591-B48B-4D31-9CD6-9B9796B2****
Data	object	Önbellek analizi görevinin ayrıntıları.
TaskState	string	Önbellek analizi görevinin durumu. Geçerli değerler: BACKUP: Veriler yedekleniyor. ANALYZING: Veriler analiz ediliyor. FINISHED: Veriler analiz edildi. FAILED: Bir hata oluştu.	BACKUP
JobId	string	Önbellek analizi görevinin kimliği.	sf79-sd99-sa37-****
Message	string	İstek için döndürülen mesaj. Not İstek başarılıysa Successful 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.	Successful
BigKeys	object
KeyInfo	array<object>	Büyük anahtarların ayrıntıları. Döndürülen büyük anahtarlar, anahtarlar tarafından kullanılan bayt sayısına göre azalan sırada sıralanır.
	object
Type	string	Örneğin veri türü.	hash
Db	integer	Veritabanı adı.	0
ExpirationTimeMillis	integer	Anahtarın sona erme zamanı. Bu değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır. 0 değeri, anahtarın hiçbir zaman sona ermediğini gösterir.	1596256542547
Key	string	Anahtar adı.	task_x****
Encoding	string	Anahtarın kodlama türü.	hashtable
Bytes	integer	Anahtar tarafından kullanılan bayt sayısı.	12345
NodeId	string	Örnekteki veri düğümünün kimliği.	r-x****-db-0
Count	integer	Anahtardaki öğe sayısı.	127
KeyPrefixes	object
Prefix	array<object>	Anahtarların ön ekleri.
	object
KeyNum	integer	Ön eki içeren anahtar sayısı.	123
Type	string	Örneğin veri türü.	hash
Bytes	integer	Anahtar tarafından kullanılan bayt sayısı.	12345
Prefix	string	Anahtarın ön eki.	task_
Count	integer	Anahtardaki öğe sayısı.	127
BigKeysOfNum	object
KeyInfo	array<object>	Büyük anahtarların ayrıntıları. Döndürülen büyük anahtarlar, anahtar sayısına göre azalan sırada sıralanır.
	object
Type	string	Örneğin veri türü.	hash
Db	integer	Veritabanı adı.	0
ExpirationTimeMillis	integer	Anahtarın sona erme zamanı. Bu değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır. 0 değeri, anahtarın hiçbir zaman sona ermediğini gösterir.	1596256542547
Key	string	Anahtar adı.	task_x****
Encoding	string	Anahtarın kodlama türü.	hashtable
Bytes	integer	Anahtar tarafından kullanılan bayt sayısı.	12345
NodeId	string	Örnekteki veri düğümünün kimliği.	r-x****-db-0
Count	integer	Anahtardaki öğe sayısı.	127
UnexBigKeysOfBytes	object
KeyInfo	array<object>	Kalıcı anahtarların ayrıntıları. Döndürülen anahtarlar, anahtarlar tarafından kullanılan bayt sayısına göre azalan sırada sıralanır.
	object
Type	string	Örneğin veri türü.	hash
Db	integer	Veritabanı adı.	0
ExpirationTimeMillis	integer	Anahtarın sona erme zamanı. Bu değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır. 0 değeri, anahtarın hiçbir zaman sona ermediğini gösterir.	1596256542547
Key	string	Anahtar adı.	task_x****
Encoding	string	Anahtarın kodlama türü.	hashtable
Bytes	integer	Anahtar tarafından kullanılan bayt sayısı.	12345
NodeId	string	Örnekteki veri düğümünün kimliği.	r-x****-db-0
Count	integer	Anahtardaki öğe sayısı.	127
UnexBigKeysOfNum	object
KeyInfo	array<object>	Kalıcı anahtarların ayrıntıları. Döndürülen anahtarlar, anahtar sayısına göre azalan sırada sıralanır.
	object
Type	string	Örneğin veri türü.	hash
Db	integer	Veritabanı adı.	0
ExpirationTimeMillis	integer	Anahtarın sona erme zamanı. Bu değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır. 0 değeri, anahtarın hiçbir zaman sona ermediğini gösterir.	1596256542547
Key	string	Anahtar adı.	task_x****
Encoding	string	Anahtarın kodlama türü.	hashtable
Bytes	integer	Anahtar tarafından kullanılan bayt sayısı.	12345
NodeId	string	Örnekteki veri düğümünün kimliği.	r-x****-db-0
Count	integer	Anahtardaki öğe sayısı.	127
InstanceId	string	Örnek kimliği.	r-bp18ff4a195d****
NodeId	string	Örnekteki veri düğümünün kimliği.	r-x****-db-0
ExpiryKeysLevelCount	object
ExpiryLevel	array<object>	Süresi dolan anahtarların istatistikleri.
	object
AnalysisTs	integer	Önbellek analizi görevinin tamamlandığı zaman. Bu değer, 1 Ocak 1970 00:00:00 UTC'den bu yana geçen milisaniye sayısını temsil eden bir UNIX zaman damgasıdır.	1717469347000
Level	integer	Sona erme seviyesi. Geçerli değerler: 0: Anahtar hiçbir zaman sona ermez. 1: Anahtarın süresi dolmuştur. 2: Anahtarın süresi 0 ila 1 saattir dolmuş durumdadır. 3: Anahtarın süresi 1 ila 3 saattir dolmuş durumdadır. 4: Anahtarın süresi 3 ila 12 saattir dolmuş durumdadır. 5: Anahtarın süresi 12 ila 24 saattir dolmuş durumdadır. 6: Anahtarın süresi bir ila iki gündür dolmuş durumdadır. 7: Anahtarın süresi üç ila yedi gündür dolmuş durumdadır. 8: Anahtarın süresi yedi günden fazla bir süredir dolmuş durumdadır.	0
TotalBytes	integer	Süresi dolan anahtarlar tarafından kullanılan bayt sayısı.	8064
TotalKeys	integer	Süresi dolan anahtarların toplam sayısı.	62
Code	string	Döndürülen HTTP durum kodu.	200
Success	string	İsteğin başarılı olup olmadığını gösterir. Geçerli değerler: true false	true

Examples

Success response

JSON format

{
  "Message": "Successful",
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "Data": {
    "TaskState": "BACKUP",
    "JobId": "sf79-sd99-sa37-****",
    "Message": "Successful",
    "BigKeys": {
      "KeyInfo": [
        {
          "Type": "hash",
          "Db": 0,
          "ExpirationTimeMillis": 1596256542547,
          "Key": "task_x****",
          "Encoding": "hashtable",
          "Bytes": 12345,
          "NodeId": "r-x****-db-0",
          "Count": 127
        }
      ]
    },
    "KeyPrefixes": {
      "Prefix": [
        {
          "KeyNum": 123,
          "Type": "hash",
          "Bytes": 12345,
          "Prefix": "task_",
          "Count": 127
        }
      ]
    },
    "BigKeysOfNum": {
      "KeyInfo": [
        {
          "Type": "hash",
          "Db": 0,
          "ExpirationTimeMillis": 1596256542547,
          "Key": "task_x****",
          "Encoding": "hashtable",
          "Bytes": 12345,
          "NodeId": "r-x****-db-0",
          "Count": 127
        }
      ]
    },
    "UnexBigKeysOfBytes": {
      "KeyInfo": [
        {
          "Type": "hash",
          "Db": 0,
          "ExpirationTimeMillis": 1596256542547,
          "Key": "task_x****",
          "Encoding": "hashtable",
          "Bytes": 12345,
          "NodeId": "r-x****-db-0",
          "Count": 127
        }
      ]
    },
    "UnexBigKeysOfNum": {
      "KeyInfo": [
        {
          "Type": "hash",
          "Db": 0,
          "ExpirationTimeMillis": 1596256542547,
          "Key": "task_x****",
          "Encoding": "hashtable",
          "Bytes": 12345,
          "NodeId": "r-x****-db-0",
          "Count": 127
        }
      ]
    },
    "InstanceId": "r-bp18ff4a195d****",
    "NodeId": "r-x****-db-0",
    "ExpiryKeysLevelCount": {
      "ExpiryLevel": [
        {
          "AnalysisTs": 1717469347000,
          "Level": 0,
          "TotalBytes": 8064,
          "TotalKeys": 62
        }
      ]
    }
  },
  "Code": "200",
  "Success": "true"
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParams	The request parameters are invalid.
403	NoPermission	You are not authorized to do this action.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.