Tüm Ürünler
Search
Belge Merkezi

:CreateStorageAnalysisTask

Son Güncelleme:Sep 30, 2026

Bir veya daha fazla veritabanı ve tablonun kullanım ayrıntılarını sorgulamak için bir depolama analizi görevi oluşturur.

Operation description

  • Bu işlem yalnızca ApsaraDB RDS for MySQL örnekleri, PolarDB for MySQL kümeleri ve ApsaraDB for MongoDB örnekleri için geçerlidir.

  • ApsaraDB RDS for MySQL örnekleri ve PolarDB for MySQL kümeleri için bu işlem, önceki sürümün depolama analizi özelliğiyle aynı şekilde çalışır. Bu işlem tarafından oluşturulan görevler, Veritabanı Otonomi Hizmeti (DAS) konsolundaki yeni sürümün Depolama Analizi sayfasında görüntülenemez. Görevleri ve sonuçları görüntülemek istiyorsanız, verileri almak ve bilgisayarınıza kaydetmek için ilgili API işlemini çağırın.

  • Bu işlemi çağırmak için bir Alibaba Cloud SDK veya DAS SDK kullanıyorsanız, SDK'nın en son sürümünü kullanmanızı öneririz.

  • DAS işlemlerini çağırmak için bir SDK kullanıyorsanız, bölge kimliğini cn-shanghai olarak ayarlamanız gerekir.

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:CreateStorageAnalysisTask

none

*All Resource

*

None None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

Örnek kimliği.

rm-2ze1jdv45i7l6****

NodeId

string

No

Düğüm kimliği. ApsaraDB for MongoDB örnekleri için, depolama analizi için bir düğüm belirtmek üzere bu parametreyi kullanabilirsiniz. Bir ApsaraDB for MongoDB örneğinin düğümleri hakkındaki bilgileri sorgulamak için DescribeRoleZoneInfo işlemini çağırabilirsiniz.

  • Bu parametreyi d-bp1872fa24d5**** gibi InsName biçiminde bir değere ayarlarsanız, düğüm kimliğine karşılık gelen gizli düğümü analiz etmek için bu işlemi çağırabilirsiniz.

  • Bu parametreyi d-bp1872fa24d5****#299****5 gibi InsName#RoleId biçiminde bir değere ayarlarsanız, belirtilen düğümü analiz etmek için bu işlemi çağırabilirsiniz.

Not

Bir ApsaraDB for MongoDB replika kümesi örneğinde bir depolama analizi görevi çalıştırırsanız ve bu parametreyi belirtmezseniz, varsayılan olarak yalnızca örneğin gizli düğümü analiz edilir. Bir ApsaraDB for MongoDB parçalı küme örneğinde bir depolama analizi görevi çalıştırırsanız, bir düğüm belirtmek için bu parametreyi ayarlamanızı öneririz.

d-bp1872fa24d5****

DbName

string

No

Veritabanı adı. Bir veritabanı belirtirseniz, işlem belirtilen veritabanının depolama kullanımını analiz eder.

testdb01

TableName

string

No

Tablo adı. Belirtilen veritabanında bir tablo belirtirseniz, işlem belirtilen tablonun depolama kullanımını analiz eder. Bir tablo belirtirseniz, DbName kullanarak tablonun ait olduğu veritabanını da belirtmeniz gerekir.

test_table

Response elements

Element

Type

Description

Example

object

Yanıt parametreleri.

Code

integer

Döndürülen HTTP durum kodu.

200

Message

string

Döndürülen mesaj.

Not

İstek başarılıysa Successful döndürülür. Aksi takdirde, bir hata kodu gibi bir hata mesajı döndürülür.

Successful

Data

object

Döndürülen veri.

TaskId

string

Görev kimliği.

910f83f4b96df0524ddc5749f61539f8

CreateTaskSuccess

boolean

Görevin oluşturulup oluşturulmadığını gösterir. Geçerli değerler:

  • true

  • false

false

ErrorMessage

string

Döndürülen hata mesajı.

unknown error

RequestId

string

İstek kimliği.

B6D17591-B48B-4D31-9CD6-9B9796B2****

Success

boolean

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

  • true

  • false

true

Examples

Success response

JSON format

{
  "Code": 200,
  "Message": "Successful",
  "Data": {
    "TaskId": "910f83f4b96df0524ddc5749f61539f8",
    "CreateTaskSuccess": false,
    "ErrorMessage": "unknown error"
  },
  "RequestId": "B6D17591-B48B-4D31-9CD6-9B9796B2****",
  "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.