すべてのプロダクト
Search

このプロダクト

    Database Autonomy Service:ModifySqlLogConfig

    ドキュメントセンター

    Database Autonomy Service:ModifySqlLogConfig

    最終更新日:Apr 18, 2026

    ModifySqlLogConfig 操作を呼び出して、データベースインスタンスの DAS Enterprise Edition を有効化または設定します。

    操作説明

    この操作を呼び出す前に、次の要件を満たしていることを確認してください。

    • 最新バージョンの Alibaba Cloud SDK または DAS SDK を使用してください。

    • SDK を使用して DAS サービスを呼び出す場合は、リージョンを cn-shanghai に設定してください。

    • この操作では、デフォルトでサポートされている最新バージョンの DAS Enterprise Edition が有効になります。DAS Enterprise Edition の各バージョンでサポートされているデータベースとリージョンについては、「DAS のエディションとサポートされている機能」をご参照ください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    hdm:ModifySqlLogConfig

    update

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    データベースインスタンスの ID。

    rr-2ze770smbq3tp****
    Enable

    boolean

    任意

    DAS Enterprise Edition を有効にするかどうかを示します。有効な値：

    • true：DAS Enterprise Edition を有効にします。

    • false：DAS Enterprise Edition を無効にします。

    説明

    DAS Enterprise Edition を有効にする場合、このパラメーターは必須です。デフォルトでは、この操作によりサポートされている最新バージョンが有効になります。

    true
    RequestEnable

    boolean

    任意

    SQL Explorer を有効にするかどうかを示します。有効な値：

    • true：SQL Explorer を有効にします。

    • false：SQL Explorer を無効にします。

    説明

    このパラメーターは、DAS Enterprise Edition V3 を有効にする場合にのみ必須です。

    true
    Retention

    integer

    任意

    データ保持期間 (日数)。有効な値：

    • 7

    • 30

    • 180

    • 365

    説明

    DAS Enterprise Edition V3 を有効にする場合、このパラメーターの値は 30 以上である必要があります。

    30
    HotRetention

    integer

    任意

    ホットストレージの保持期間 (日数)。値は 1 から 7 までの整数である必要があります。

    説明

    このパラメーターは、DAS Enterprise Edition V3 を有効にする場合にのみ必須です。

    1
    Filters

    array<object>

    任意

    予約済みのパラメーターです。

    object

    任意

    予約済みのパラメーターです。

    Key

    string

    任意

    予約済みのパラメーターです。

    None
    Value

    string

    任意

    予約済みのパラメーターです。

    None
    EnableAudit

    boolean

    任意

    セキュリティ監査を有効にするかどうかを示します。

    true

    DAS Enterprise Edition には、V0、V1、V2、V3 の 4 つのバージョンがあります。デフォルトでは、サポートされている最新バージョンが有効になります。

    • DAS Enterprise Edition V0 のみをサポートするデータベースインスタンスの場合は、Enable パラメーターと Retention パラメーターのみを指定します。

    • DAS Enterprise Edition V1 をサポートするデータベースインスタンスの場合は、Enable パラメーターと Retention パラメーターのみを指定します。システムは自動的に SQL Explorer を有効にし、デフォルトで RequestEnable が true に設定されます。

    • DAS Enterprise Edition V2 をサポートするデータベースインスタンスの場合は、Enable パラメーターと Retention パラメーターのみを指定します。システムは自動的に SQL Explorer を有効にし、デフォルトで RequestEnable が true に設定されます。また、ホットデータの保存期間 (HotRetention) は 7 日間に設定され、コールドデータの保存期間は Retention - 7 日間に設定されます。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Code

    string

    返されるステータスコード。

    200
    Message

    string

    応答メッセージ。

    説明

    リクエストが成功した場合、Successful が返されます。それ以外の場合は、エラーメッセージが返されます。

    Successful
    RequestId

    string

    リクエスト ID。

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

    string

    リクエストが成功したかどうかを示します。有効な値：

    • true：リクエストは成功しました。

    • false：リクエストは失敗しました。

    false
    Data

    object

    返されたデータ。

    SqlLogVisibleTime

    integer

    DAS Enterprise Edition が有効になった時刻。この値は、1970 年 1 月 1 日 00:00:00 (協定世界時 (UTC)) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1683712800000
    RequestStopTime

    integer

    DAS Enterprise Edition の有効期限。この値は、1970 年 1 月 1 日 00:00:00 (協定世界時 (UTC)) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1715335200000
    CollectorVersion

    string

    データベースコレクターのバージョン。有効な値：

    • 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

    サポートされている最新バージョンの DAS Enterprise Edition。有効な値：

    • 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 は有効になっていません。

    • SQL_LOG_NOT_SUPPORT：DAS Enterprise Edition はサポートされていません。

    SQL_LOG_V3
    ColdRetention

    integer

    コールドデータの保持期間。単位：日。この値は、数式 Retention - HotRetention を使用して計算されます。

    23
    SqlLogEnable

    boolean

    DAS Enterprise Edition が有効になっているかどうかを示します。

    • true：有効。

    • false：無効。

    true
    Retention

    integer

    データの合計保持期間。単位：日。

    30
    HotRetention

    integer

    ホットデータの保持期間。単位：日。

    7
    RequestEnable

    boolean

    SQL Explorer が有効になっているかどうかを示します。

    • true：有効。

    • false：無効。

    false
    Version

    string

    現在の DAS Enterprise Edition のバージョン。有効な値：

    • 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 は有効になっていません。

    • SQL_LOG_NOT_SUPPORT：DAS Enterprise Edition はサポートされていません。

    SQL_LOG_V3
    RequestStartTime

    integer

    SQL Explorer が有効になった時刻。この値は、1970 年 1 月 1 日 00:00:00 (協定世界時 (UTC)) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1683712800000
    HotEnable

    boolean

    ホットデータストレージが有効になっているかどうかを示します。

    • true：有効。

    • false：無効。

    true
    HotStartTime

    integer

    ホットデータストレージが有効になった時刻。この値は、1970 年 1 月 1 日 00:00:00 (協定世界時 (UTC)) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1683712800000
    ColdEnable

    boolean

    コールドデータストレージが有効になっているかどうかを示します。

    • true：有効。

    • false：無効。

    true
    ColdStartTime

    integer

    コールドデータストレージが有効になった時刻。この値は、1970 年 1 月 1 日 00:00:00 (協定世界時 (UTC)) から経過したミリ秒数を表す UNIX タイムスタンプです。

    1683712800000
    SqlLogState

    string

    データ移行の状態。有効な値：

    • FINISH：履歴データは移行済みです。

    • RUNNING：履歴データは移行中です。

    • FAILURE：履歴データの移行に失敗しました。

    FINISH
    LogFilter

    string

    予約済みのパラメーターです。

    None
    SqlLogSource

    string

    監査ログのソース。

    例

    成功レスポンス

    JSONJSON

    {
  "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": ""
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 InvalidParams The request parameters are invalid.
    403 NoPermission You are not authorized to do this action.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。