Tüm Ürünler
Search
Belge Merkezi

:ModifySqlLogConfig

Son Güncelleme:Oct 27, 2026

Bir veritabanı örneği için DAS Enterprise Edition'ı etkinleştirir veya yapılandırır.

Operation description

Bu işlemi kullanmak için aşağıdaki ön koşulların karşılanması gerekir:

  • Alibaba Cloud veya DAS SDK'sının en son sürümünü kullanın.

  • SDK'yı kullanarak DAS hizmetini çağırırken bölgeyi cn-shanghai olarak ayarlayın.

  • Varsayılan olarak bu işlem, desteklenen en son sürümü etkinleştirir. Her DAS Enterprise Edition sürümü tarafından desteklenen veritabanları ve bölgeler için DAS sürümleri ve desteklenen özellikler konusuna bakın.

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

update

*All resources.

*

None None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

Veritabanı örneğinin kimliği.

rr-2ze770smbq3tp****

Enable

boolean

No

DAS Enterprise Edition'ın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

Not

Bu parametre, DAS Enterprise Edition'ı etkinleştirdiğinizde gereklidir. Varsayılan olarak, desteklenen en son sürüm etkinleştirilir.

true

RequestEnable

boolean

No

SQL Explorer'ın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

Not

Bu parametre yalnızca DAS Enterprise Edition V3'ü etkinleştirdiğinizde gereklidir.

true

Retention

integer

No

Toplam veri depolama süresi. Birim: gün. Geçerli değerler:

  • 7

  • 30

  • 180

  • 365

Not

DAS Enterprise Edition V3'ü etkinleştirdiğinizde, bu parametrenin değeri 30'dan büyük veya ona eşit olmalıdır.

30

HotRetention

integer

No

Sıcak veri depolama süresi. Birim: gün. Değer, [1, 7] aralığında bir tam sayıdır.

Not

Bu parametre yalnızca DAS Enterprise Edition V3'ü etkinleştirdiğinizde gereklidir.

1

Filters

array<object>

No

Ayrılmış bir parametre.

object

No

Ayrılmış bir parametre.

Key

string

No

Ayrılmış bir parametre.

None

Value

string

No

Ayrılmış bir parametre.

None

EnableAudit

boolean

No

Güvenlik denetiminin etkinleştirilip etkinleştirilmeyeceğini belirtir.

true

DAS Enterprise Edition'ın dört sürümü vardır: V0, V1, V2 ve V3. Varsayılan olarak, desteklenen en son sürüm etkinleştirilir.

  • Yalnızca DAS Enterprise Edition V0'ı destekleyen veritabanı örnekleri için yalnızca Enable ve Retention parametrelerini belirtmeniz gerekir.

  • DAS Enterprise Edition V1'i destekleyen veritabanı örnekleri için yalnızca Enable ve Retention parametrelerini belirtmeniz gerekir. Sistem, SQL Explorer özelliğini otomatik olarak etkinleştirir (yani, varsayılan yapılandırmalar RequestEnable değerini true olarak ayarlar).

  • DAS Enterprise Edition V2'yi destekleyen veritabanı örnekleri için yalnızca Enable ve Retention parametrelerini belirtmeniz gerekir. Sistem, SQL Explorer özelliğini otomatik olarak etkinleştirir (yani, varsayılan yapılandırmalar RequestEnable değerini true olarak ayarlar), sıcak depolama süresini (HotRetention) 7 güne ayarlar ve soğuk depolama süresini Retention - 7 gün olarak ayarlar.

Response elements

Element

Type

Description

Example

object

Code

string

Döndürülen durum kodu.

200

Message

string

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 bir hata mesajı döndürülür.

Successful

RequestId

string

İsteğin kimliği.

03C88D8E-1541-518E-8BFF-BEC6589B6334

Success

string

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

  • true: İstek başarılıydı.

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

false

Data

object

Döndürülen veriler.

SqlLogVisibleTime

integer

DAS Enterprise Edition'ın etkinleştirildiği zaman. Zaman, UNIX zaman damgası biçimindedir. Birim: milisaniye.

1683712800000

RequestStopTime

integer

DAS Enterprise Edition V1'in sona erme zamanı. Zaman, UNIX zaman damgası biçimindedir. Birim: milisaniye.

1715335200000

CollectorVersion

string

Toplayıcı sürümü. Geçerli değerler:

  • MYSQL_V0: MySQL V0.

  • MYSQL_V1: MySQL V1.

  • MYSQL_V2: MySQL V2.

  • MYSQL_V3: MySQL V3.

  • PG_V1: PostgreSQL V1.

  • rdspg_v1: ApsaraDB RDS for PostgreSQL V1.

  • polarpg_v1: PolarDB for PostgreSQL V1.

MYSQL_V3

SupportVersion

string

Desteklenen en son DAS Enterprise Edition sürümü. Geçerli değerler:

  • SQL_LOG_V0: DAS Enterprise Edition V0.

  • SQL_LOG_V1: DAS Enterprise Edition V1.

  • SQL_LOG_V2: DAS Enterprise Edition V2.

  • SQL_LOG_V3: DAS Enterprise Edition V3.

  • SQL_LOG_NOT_ENABLE: DAS Enterprise Edition etkin değil.

  • SQL_LOG_NOT_SUPPORT: DAS Enterprise Edition desteklenmiyor.

SQL_LOG_V3

ColdRetention

integer

Soğuk veri depolama süresi. Birim: gün. Değer, şu formül kullanılarak hesaplanır: Retention - HotRetention.

23

SqlLogEnable

boolean

DAS Enterprise Edition'ın etkin olup olmadığını gösterir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

true

Retention

integer

Toplam veri depolama süresi. Birim: gün.

30

HotRetention

integer

Sıcak veri depolama süresi. Birim: gün.

7

RequestEnable

boolean

SQL Explorer'ın etkin olup olmadığını gösterir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

false

Version

string

Etkinleştirilmiş DAS Enterprise Edition sürümü. Geçerli değerler:

  • SQL_LOG_V0: DAS Enterprise Edition V0.

  • SQL_LOG_V1: DAS Enterprise Edition V1.

  • SQL_LOG_V2: DAS Enterprise Edition V2.

  • SQL_LOG_V3: DAS Enterprise Edition V3.

  • SQL_LOG_NOT_ENABLE: DAS Enterprise Edition etkin değil.

  • SQL_LOG_NOT_SUPPORT: DAS Enterprise Edition desteklenmiyor.

SQL_LOG_V3

RequestStartTime

integer

SQL Explorer'ın etkinleştirildiği zaman. Zaman, UNIX zaman damgası biçimindedir. Birim: milisaniye.

1683712800000

HotEnable

boolean

Sıcak veri depolamanın etkin olup olmadığını gösterir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

true

HotStartTime

integer

Sıcak veri depolamanın başlangıç zamanı. Zaman, UNIX zaman damgası biçimindedir. Birim: milisaniye.

1683712800000

ColdEnable

boolean

Soğuk veri depolamanın etkin olup olmadığını gösterir. Geçerli değerler:

  • true: Evet.

  • false: Hayır.

true

ColdStartTime

integer

Soğuk veri depolamanın başlangıç zamanı. Zaman, UNIX zaman damgası biçimindedir. Birim: milisaniye.

1683712800000

SqlLogState

string

Veri geçiş durumu. Geçerli değerler:

  • FINISH: Geçmiş veri geçişi tamamlandı.

  • RUNNING: Geçmiş veri geçişi devam ediyor.

  • FAILURE: Geçmiş veri geçişi başarısız oldu.

FINISH

LogFilter

string

Ayrılmış bir parametre.

None

SqlLogSource

string

Etkinleştirilmiş denetim günlüklerinin kaynağı.

DSC:DAS_SIDE

Examples

Success response

JSON format

{
  "Code": "200",
  "Message": "Successful",
  "RequestId": "03C88D8E-1541-518E-8BFF-BEC6589B6334",
  "Success": "false",
  "Data": {
    "SqlLogVisibleTime": 1683712800000,
    "RequestStopTime": 1715335200000,
    "CollectorVersion": "MYSQL_V3",
    "SupportVersion": "SQL_LOG_V3",
    "ColdRetention": 23,
    "SqlLogEnable": true,
    "Retention": 30,
    "HotRetention": 7,
    "RequestEnable": false,
    "Version": "SQL_LOG_V3",
    "RequestStartTime": 1683712800000,
    "HotEnable": true,
    "HotStartTime": 1683712800000,
    "ColdEnable": true,
    "ColdStartTime": 1683712800000,
    "SqlLogState": "FINISH",
    "LogFilter": "None",
    "SqlLogSource": "DSC:DAS_SIDE"
  }
}

Error codes

HTTP status code

Error code

Error message

Description

400 InvalidParams The request parameters are invalid. İstek parametreleri geçersiz.
403 NoPermission You are not authorized to do this action. Bu işlemi gerçekleştirme izniniz yok.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.