すべてのプロダクト
Search

このプロダクト

    :ModifySqlLogConfig

    ドキュメントセンター

    :ModifySqlLogConfig

    最終更新日:Sep 09, 2025

    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 です。

    Enable

    boolean

    任意

    DAS Enterprise Edition を有効にするかどうかを指定します。

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

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

    説明

    このパラメーターは、DAS Enterprise Edition を有効にするために必要です。 デフォルトでは、最新のサポートバージョンが有効になっています。

    RequestEnable

    boolean

    任意

    SQL Explorer を有効にするかどうかを指定します。

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

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

    説明

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

    Retention

    integer

    任意

    データの合計保存期間（日数）。有効な値：

    • 7

    • 30

    • 180

    • 365

    説明

    DAS Enterprise Edition V3 を有効にする場合は、このパラメーターを 30 以上に設定します。

    HotRetention

    integer

    任意

    ホットデータの保存期間（日数）。有効な値は 1 から 7 までの整数です。

    説明

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

    Filters

    array<object>

    任意

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

    object

    任意

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

    Key

    string

    任意

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

    Value

    string

    任意

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

    EnableAudit

    boolean

    任意

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

    DAS Enterprise Edition は、V0、V1、V2、および V3 で利用可能です。デフォルトでは、最新のサポートバージョンが有効になっています。

    • 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

    返された状態コード。

    Message

    string

    応答メッセージ。

    説明

    リクエストが成功した場合、Successful が返されます。リクエストが失敗した場合、エラーメッセージが返されます。

    RequestId

    string

    リクエストの ID です。

    Success

    string

    リクエストが成功したかどうかを示します。

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

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

    Data

    object

    返されたデータ。

    SqlLogVisibleTime

    integer

    DAS Enterprise Edition が有効になった時刻。これはミリ秒単位の UNIX タイムスタンプです。

    RequestStopTime

    integer

    DAS Enterprise Edition V1 の有効期限。これはミリ秒単位の UNIX タイムスタンプです。

    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。

    SupportVersion

    string

    DAS Enterprise Edition の最新のサポートバージョン。

    • SQL_LOG_V0: Enterprise Edition V0。

    • SQL_LOG_V1: Enterprise Edition V1。

    • SQL_LOG_V2: Enterprise Edition V2。

    • SQL_LOG_V3: Enterprise Edition V3。

    • SQL_LOG_NOT_ENABLE: Enterprise Edition は無効です。

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

    ColdRetention

    integer

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

    SqlLogEnable

    boolean

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

    • true: 有効。

    • false: 無効。

    Retention

    integer

    データの合計保存期間（日数）。

    HotRetention

    integer

    ホットデータの保存期間（日数）。

    RequestEnable

    boolean

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

    • true: 有効。

    • false: 無効。

    Version

    string

    DAS Enterprise Edition の現在のバージョン。

    • SQL_LOG_V0: Enterprise Edition V0。

    • SQL_LOG_V1: Enterprise Edition V1。

    • SQL_LOG_V2: Enterprise Edition V2。

    • SQL_LOG_V3: Enterprise Edition V3。

    • SQL_LOG_NOT_ENABLE: Enterprise Edition は無効です。

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

    RequestStartTime

    integer

    SQL Explorer が有効になった時刻。これはミリ秒単位の UNIX タイムスタンプです。

    HotEnable

    boolean

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

    • true: 有効。

    • false: 無効。

    HotStartTime

    integer

    ホットデータストレージが有効になった時刻。これはミリ秒単位の UNIX タイムスタンプです。

    ColdEnable

    boolean

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

    • true: 有効。

    • false: 無効。

    ColdStartTime

    integer

    コールドデータストレージが有効になった時刻。これはミリ秒単位の UNIX タイムスタンプです。

    SqlLogState

    string

    データ移行ステータス。

    • FINISH: 既存データの移行が完了しました。

    • RUNNING: 既存データの移行が実行中です。

    • FAILURE: 既存データの移行に失敗しました。

    LogFilter

    string

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

    SqlLogSource

    string

    例

    成功レスポンス

    JSONJSON

    {
  "Code": "",
  "Message": "",
  "RequestId": "",
  "Success": "",
  "Data": {
    "SqlLogVisibleTime": 0,
    "RequestStopTime": 0,
    "CollectorVersion": "",
    "SupportVersion": "",
    "ColdRetention": 0,
    "SqlLogEnable": true,
    "Retention": 0,
    "HotRetention": 0,
    "RequestEnable": true,
    "Version": "",
    "RequestStartTime": 0,
    "HotEnable": true,
    "HotStartTime": 0,
    "ColdEnable": true,
    "ColdStartTime": 0,
    "SqlLogState": "",
    "LogFilter": "",
    "SqlLogSource": ""
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

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

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

    変更履歴

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