changeCloudMysqlUserList

Prev Next

VPC環境で利用できます。

Cloud DB for MySQLインスタンスに登録されている DB User情報を変更します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
GET, POST /changeCloudMysqlUserList

リクエストヘッダ

Cloud DB for MySQL (VPC) APIで共通して使用されるヘッダの詳細は、Cloud DB for MySQL (VPC)のリクエストヘッダをご参照ください。

リクエストパラメータ

パラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
regionCode String Optional リージョンコード
  • DB User情報変更対象の Cloud DB for MySQLインスタンスのリージョンコード
  • getRegionListを通じて確認
  • getRegionList照会結果の最初のリージョン(デフォルト)
cloudMysqlInstanceNo String Required Cloud DB for MySQLインスタンス番号
cloudMysqlUserList.N.name List<String> Required DB User情報変更対象のユーザー IDリスト
  • 英数字、記号の「-」、「_」を使用して4~16文字以内で入力、先頭文字は英字にする
  • あらかじめ定義した予約語は使用不可
  • <例> cloudMysqlUserList.1.name=testuser1&cloudMysqlUserList.2.name=testuser2
cloudMysqlUserList.N.hostIp List<String> Required MySQL Serverにアクセスする IPアドレスリスト
  • IPアドレスの適用方法
    • すべてのアクセスを許可: %
    • 特定の IPアドレスからのアクセスを許可: <例>1.1.1.1
    • IPアドレス帯域からのアクセスを許可: <例> 1.1.1.%
    • GETメソッド使用時、%は%25に URLエンコードが必要
  • <例> cloudMysqlUserList.1.hostIp=%&cloudMysqlUserList.2.hostIp=1.1.1.1
cloudMysqlUserList.N.password List<String> Optional DB Userアカウントパスワード
  • 英数字、記号をそれぞれ1文字以上含めて8~20文字以内で入力
  • 記号の「` & + \ " ' /」とスペースは使用不可
    • Password Pluginが有効になっている状態では、プラグインで設定したポリシーにも従わなければならない
  • <例> cloudMysqlUserList.1.password=********&cloudMysqlUserList.2.password=********
cloudMysqlUserList.N.authority List<String> Required DB User権限
  • READ | CRUD | DDL
    • READ: データの照会のみ可能
    • CRUD: データの入力、照会、変更、削除が可能
    • DDL: CRUD権限を含めテーブルの作成、削除、変更が可能
    • <例> cloudMysqlUserList.1.authority=DDL&cloudMysqlUserList.2.authority=DDL
cloudMysqlUserList.N.isSystemTableAccess List<Boolean> Optional システムテーブルにアクセス可能かどうか
  • true (デフォルト) | false
responseFormatType String Optional レスポンス結果の形式
  • xml(デフォルト) | json

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://ncloud.apigw.ntruss.com/vmysql/v2/changeCloudMysqlUserList
?regionCode=KR
&cloudMysqlInstanceNo=****890
&cloudMysqlUserList.1.name=testuser
&cloudMysqlUserList.1.hostIp=%
&cloudMysqlUserList.1.password=********
&cloudMysqlUserList.1.authority=CRUD
&cloudMysqlUserList.1.isSystemTableAccess=true'
--header 'x-ncp-apigw-timestamp: {Timestamp}' 
--header 'x-ncp-iam-access-key: {Access Key}' 
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

レスポンス形式を説明します。

レスポンスステータスコード

NAVERクラウドプラットフォームでで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

  • responseFormatType=jsonの場合
{
    "changeCloudMysqlUserListResponse": {
        "requestId": "eb46ade8-****-****-****-133bcbc382c1",
        "returnCode": "0",
        "returnMessage": "success"
    }
}
  • responseFormatType=xml(デフォルト)の場合
<?xml version="1.0" encoding="UTF-8"?>
<changeCloudMysqlUserListResponse>
    <requestId>eb46ade8-****-****-****-133bcbc382c1</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
</changeCloudMysqlUserListResponse>