更新时间:2024-11-04 GMT+08:00
分享

添加RDS数据库

功能介绍

添加RDS数据库

该接口V1版本不再维护,待下线。请使用V2版本接口添加RDS数据库

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/{instance_id}/dbss/audit/databases/rds

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

instance_id

String

实例ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token

表3 请求Body参数

参数

是否必选

参数类型

描述

databases

Array of databases objects

添加数据库信息列表

total_count

Integer

总数

表4 databases

参数

是否必选

参数类型

描述

id

String

数据库ID

db_name

String

数据库名称

status

String

数据库状态

port

String

数据库端口

ip

String

数据库IP

instance_name

String

数据库实例名称

version

String

数据库版本

type

String

数据库类型

enterprise_id

String

企业项目ID

enterprise_name

String

企业项目名称

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

illegal_db_id

Array of strings

添加失败的数据库实例id

legal_db_id

Array of strings

添加成功的数据库实例id

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error

Object

错误信息返回体。

表7 ErrorDetail

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

error_msg

String

错误请求返回的错误信息。

状态码: 403

表8 响应Body参数

参数

参数类型

描述

error

Object

错误信息返回体。

表9 ErrorDetail

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

error_msg

String

错误请求返回的错误信息。

状态码: 500

表10 响应Body参数

参数

参数类型

描述

error

Object

错误信息返回体。

表11 ErrorDetail

参数

参数类型

描述

error_code

String

错误请求返回的错误码。

error_msg

String

错误请求返回的错误信息。

请求示例

/v1/{project_id}/{instance_id}/dbss/audit/databases/rds

{
  "databases" : [ {
    "id" : "123751d3ee2f47aea64822e98318c6a8in01",
    "db_name" : "rds1",
    "status" : "ACTIVE",
    "port" : "3306",
    "ip" : "192.168.0.119",
    "instance_name" : "rds1",
    "version" : "8.0",
    "type" : "MySQL",
    "enterprise_id" : "0",
    "enterprise_name" : "default"
  }, {
    "id" : "2343f7285d684fed8b09fac201c3fc7ain01",
    "db_name" : "rds2",
    "status" : "ACTIVE",
    "port" : "3306",
    "ip" : "192.168.0.92",
    "instance_name" : "rds2",
    "version" : "8.0",
    "type" : "MySQL",
    "enterprise_id" : "0",
    "enterprise_name" : "default"
  } ]
}

响应示例

状态码: 200

成功

{
  "illegal_db_id" : [ ],
  "legal_db_id" : [ "123751d3ee2f47aea64822e98318c6a8in01", "2343f7285d684fed8b09fac201c3fc7ain01" ]
}

状态码: 400

失败

{
  "error" : {
    "error_code" : "DBSS.XXXX",
    "error_msg" : "XXX"
  }
}

SDK代码示例

SDK代码示例如下。

Java

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.dbss.v1.region.DbssRegion;
import com.huaweicloud.sdk.dbss.v1.*;
import com.huaweicloud.sdk.dbss.v1.model.*;

import java.util.List;
import java.util.ArrayList;

public class AddRdsNoAgentDatabaseSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");

        ICredential auth = new BasicCredentials()
                .withAk(ak)
                .withSk(sk);

        DbssClient client = DbssClient.newBuilder()
                .withCredential(auth)
                .withRegion(DbssRegion.valueOf("xx-xx"))
                .build();
        AddRdsNoAgentDatabaseRequest request = new AddRdsNoAgentDatabaseRequest();
        RdsNoAgentDbRequest body = new RdsNoAgentDbRequest();
        List<RdsNoAgentDbRequestDatabases> listbodyDatabases = new ArrayList<>();
        listbodyDatabases.add(
            new RdsNoAgentDbRequestDatabases()
                .withId("123751d3ee2f47aea64822e98318c6a8in01")
                .withDbName("rds1")
                .withStatus("ACTIVE")
                .withPort("3306")
                .withIp("192.168.0.119")
                .withInstanceName("rds1")
                .withVersion("8.0")
                .withType("MySQL")
                .withEnterpriseId("0")
                .withEnterpriseName("default")
        );
        listbodyDatabases.add(
            new RdsNoAgentDbRequestDatabases()
                .withId("2343f7285d684fed8b09fac201c3fc7ain01")
                .withDbName("rds2")
                .withStatus("ACTIVE")
                .withPort("3306")
                .withIp("192.168.0.92")
                .withInstanceName("rds2")
                .withVersion("8.0")
                .withType("MySQL")
                .withEnterpriseId("0")
                .withEnterpriseName("default")
        );
        body.withDatabases(listbodyDatabases);
        request.withBody(body);
        try {
            AddRdsNoAgentDatabaseResponse response = client.addRdsNoAgentDatabase(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

Python

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
# coding: utf-8

from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkdbss.v1.region.dbss_region import DbssRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkdbss.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.getenv("CLOUD_SDK_AK")
    sk = os.getenv("CLOUD_SDK_SK")

    credentials = BasicCredentials(ak, sk) \

    client = DbssClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(DbssRegion.value_of("xx-xx")) \
        .build()

    try:
        request = AddRdsNoAgentDatabaseRequest()
        listDatabasesbody = [
            RdsNoAgentDbRequestDatabases(
                id="123751d3ee2f47aea64822e98318c6a8in01",
                db_name="rds1",
                status="ACTIVE",
                port="3306",
                ip="192.168.0.119",
                instance_name="rds1",
                version="8.0",
                type="MySQL",
                enterprise_id="0",
                enterprise_name="default"
            ),
            RdsNoAgentDbRequestDatabases(
                id="2343f7285d684fed8b09fac201c3fc7ain01",
                db_name="rds2",
                status="ACTIVE",
                port="3306",
                ip="192.168.0.92",
                instance_name="rds2",
                version="8.0",
                type="MySQL",
                enterprise_id="0",
                enterprise_name="default"
            )
        ]
        request.body = RdsNoAgentDbRequest(
            databases=listDatabasesbody
        )
        response = client.add_rds_no_agent_database(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

Go

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    dbss "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dbss/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dbss/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/dbss/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        Build()

    client := dbss.NewDbssClient(
        dbss.DbssClientBuilder().
            WithRegion(region.ValueOf("xx-xx")).
            WithCredential(auth).
            Build())

    request := &model.AddRdsNoAgentDatabaseRequest{}
	enterpriseNameDatabases:= "default"
	enterpriseNameDatabases1:= "default"
	var listDatabasesbody = []model.RdsNoAgentDbRequestDatabases{
        {
            Id: "123751d3ee2f47aea64822e98318c6a8in01",
            DbName: "rds1",
            Status: "ACTIVE",
            Port: "3306",
            Ip: "192.168.0.119",
            InstanceName: "rds1",
            Version: "8.0",
            Type: "MySQL",
            EnterpriseId: "0",
            EnterpriseName: &enterpriseNameDatabases,
        },
        {
            Id: "2343f7285d684fed8b09fac201c3fc7ain01",
            DbName: "rds2",
            Status: "ACTIVE",
            Port: "3306",
            Ip: "192.168.0.92",
            InstanceName: "rds2",
            Version: "8.0",
            Type: "MySQL",
            EnterpriseId: "0",
            EnterpriseName: &enterpriseNameDatabases1,
        },
    }
	request.Body = &model.RdsNoAgentDbRequest{
		Databases: listDatabasesbody,
	}
	response, err := client.AddRdsNoAgentDatabase(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

成功

400

失败

403

认证失败

500

服务端错误

错误码

请参见错误码

相关文档