exportDbServerLogToObjectStorage
    • PDF

    exportDbServerLogToObjectStorage

    • PDF

    記事の要約

    Classic環境で利用できます。

    概要

    Cloud DBのデータベースサーバログファイルを Object Storageに送信します。

    リクエスト

    リクエストヘッダ

    ヘッダ名説明
    x-ncp-apigw-timestamp1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-apigw-api-keyAPIGWから発行されたキー値、v2を使用する場合、api-keyは使用しない
    x-ncp-apigw-api-key:{API Gateway API Key}
    x-ncp-iam-access-keyNAVERクラウドプラットフォームポータルで発行された Access Key ID値
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2Access Key ID値と Secret Keyで暗号化した署名
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeRequest body content typeを application/jsonに指定
    Content-Type: application/json

    リクエストボディ

    APIリクエスト時にフィールド名の大文字・小文字の区別が必要です。

    パラメータ名要否タイプ制約事項説明
    regionNoNStringリージョン番号
    dbKindCodeYStringMYSQLDBタイプコード
    fileNameYString- データベースサーバログのファイル名
    - getDbServerLogListを通じて取得可能
    bucketNameYString- Object Storageのバケット名
    -bucketNameは、ListBucketsアクションを通じて取得可能
    cloudDBInstanceNoYString- 作成されている MySQLサーバのインスタンス番号
    - getCloudDBInstanceListを通じて取得する値
    cloudDBServerInstanceNoYString- Cloud DB for MySQLのサーバインスタンス番号
    - getCloudDBInstanceListを通じて取得可能
    logTypeYStringBINARY, ERROR, SLOW, GENERALデータベースサーバログのファイルタイプ
    responseFormatTypeNStringxml, jsonレスポンス結果のフォーマットタイプ
    Default : xml
    • regionNo
      • Server APIである getRegionListを通じて取得できます。
    • dbKindCode
      • 照会する CloudDBの種類を選択します。MySQLのみ入力可能です。
    • fileName
    • bucketName
      • コンソールに作成されたバケット名を入力します。
    • cloudDBInstanceNo
      • 作成されている MySQLサーバのインスタンス番号です。getCloudDBInstanceListを通じて取得できます。
    • cloudDBServerInstanceNo
      • 作成されている MySQLサーバのインスタンス番号です。getCloudDBInstanceListを通じて取得できます。
    • LogType
      • データベースのサーバログファイルタイプを設定します。 BINARY、ERROR、SLOW、GENERALから選択できます。
    • responseFormatType
      • API実行結果のレスポンスを受けるフォーマットを設定します。 xmlと jsonの中から選択できます。

    レスポンス

    フィールド名タイプ説明備考
    requestIdStringリクエスト ID値
    returnCodeIntegerレスポンスコード値
    returnMessageStringレスポンスメッセージ

    リクエスト例

    GET {API_URL}/exportDbServerLogToObjectStorage
    ?regionNo=1
    &dbKindCode=MYSQL
    &fileName=20221209
    &bucketName=temp-bucket
    &cloudDBInstanceNo=15064241
    &cloudDBServerInstanceNo=15064245
    &logType=BINARY
    &responseFormatType=XML
    

    リクエストサンプル

    {
      "regionNo": "1",
      "dbKindCode": "MYSQL",
      "fileName": "20221209",
      "bucketName": "temp-bucket",
      "cloudDBInstanceNo": "15064241",
      "cloudDBServerInstanceNo": "15064245",
      "logType": "BINARY",
      "responseFormatType": "xml"
    }
    

    レスポンス例

     connection: keep-alive 
     content-type: application/xml;charset=UTF-8 
     date: Fri, 09 Dec 2022 06:51:39 GMT 
     server: nginx 
     transfer-encoding: chunked 
     x-ncp-apigw-response-origin: ENDPOINT 
     x-ncp-trace-id: 3ce9h6sqm2cpi6cdj460s6copg 
    
    <exportDbServerLogToObjectStorageResponse>
      <requestId>e2cbeac2-1583-479a-a8a3-ed72b3c899a0</requestId>
      <returnCode>0</returnCode>
      <returnMessage>success</returnMessage>
    </exportDbServerLogToObjectStorageResponse>
    

    エラーコード

    Cloud DB APIリクエストに誤りがあるか、処理中にエラーが発生した場合、HTTPステータスコードで成功/失敗を、JSON形式で詳細メッセージを返します。

    エラーコードには、Cloud DB APIの「共通エラーコード」と「API Gatewayエラーコード」の2種類があります。

    エラーコードレスポンスメッセージ説明
    200Ok
    500Server Error

    この記事は役に立ちましたか?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.