更新时间:2024-10-21 GMT+08:00

修改用户参数

功能介绍

修改用户参数(仅AMQP版本支持)。

调用方法

请参见如何调用API

URI

PUT /v2/{project_id}/instances/{instance_id}/users/{user_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,获取方式请参见获取项目ID

instance_id

String

实例ID。

user_name

String

用户名。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

access_key

String

用户名,只能英文字母开头,且由英文字母、数字、中划线、下划线组成,长度为7~64个字符。

secret_key

String

密钥。

8-32个字符。

至少包含以下字符中的3种:

  • 大写字母

  • 小写字母

  • 数字

  • 特殊字符`~!@#$%^&*()-_=+\|[{}];:'",<.>/?。

    不能与名称或倒序的名称相同。

vhosts

Array of AMQPUserPerm objects

需要配置权限的Vhost,一个用户可以配置多个Vhost下的资源权限。

表3 AMQPUserPerm

参数

是否必选

参数类型

描述

vhost

String

需要配置权限的Vhost名称,一个用户可以配置多个Vhost下的资源权限。

conf

String

使用正则表达式匹配资源配置权限。例如,在输入框内输入“^janeway-.*”,则表示授权给该用户当前Vhost下,所有名称以“janeway-”开头的资源的配置权限。

write

String

使用正则表达式匹配资源写权限。例如,在输入框内输入“.*”,则表示授权给该用户当前Vhost下,所有资源的写权限。

read

String

使用正则表达式匹配资源读权限。例如,在输入框内输入“.*”,则表示授权给该用户当前Vhost下,所有资源的读权限。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

access_key

String

用户名,只能英文字母开头,且由英文字母、数字、中划线、下划线组成,长度为7~64个字符。

secret_key

String

密钥。

8-32个字符。

至少包含以下字符中的3种:

  • 大写字母

  • 小写字母

  • 数字

  • 特殊字符`~!@#$%^&*()-_=+\|[{}];:'",<.>/?。

    不能与名称或倒序的名称相同。

vhosts

Array of AMQPUserPerm objects

需要配置权限的Vhost,一个用户可以配置多个Vhost下的资源权限。

表5 AMQPUserPerm

参数

参数类型

描述

vhost

String

需要配置权限的Vhost名称,一个用户可以配置多个Vhost下的资源权限。

conf

String

使用正则表达式匹配资源配置权限。例如,在输入框内输入“^janeway-.*”,则表示授权给该用户当前Vhost下,所有名称以“janeway-”开头的资源的配置权限。

write

String

使用正则表达式匹配资源写权限。例如,在输入框内输入“.*”,则表示授权给该用户当前Vhost下,所有资源的写权限。

read

String

使用正则表达式匹配资源读权限。例如,在输入框内输入“.*”,则表示授权给该用户当前Vhost下,所有资源的读权限。

请求示例

修改用户参数,允许访问名称为default的Vhost,允许对此Vhost下所有资源进行读、写、但仅允许对以janeway-开头的资源进行配置。

PUT https://{endpoint}/v2/{project_id}/instances/{instance_id}/users/{user_name}

{
  "access_key" : "admin123",
  "secret_key" : "**************",
  "vhosts" : [ {
    "vhost" : "default",
    "conf" : "^janeway-.*",
    "write" : ".*",
    "read" : ".*"
  } ]
}

响应示例

状态码: 200

修改用户参数成功。

{
  "access_key" : "admin123",
  "secret_key" : "**************",
  "vhosts" : [ {
    "vhost" : "default",
    "conf" : "^janeway-.*",
    "write" : ".*",
    "read" : ".*"
  } ]
}

SDK代码示例

SDK代码示例如下。

修改用户参数,允许访问名称为default的Vhost,允许对此Vhost下所有资源进行读、写、但仅允许对以janeway-开头的资源进行配置。

 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
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.rabbitmq.v2.region.RabbitMQRegion;
import com.huaweicloud.sdk.rabbitmq.v2.*;
import com.huaweicloud.sdk.rabbitmq.v2.model.*;

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

public class UpdateUserSolution {

    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");
        String projectId = "{project_id}";

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

        RabbitMQClient client = RabbitMQClient.newBuilder()
                .withCredential(auth)
                .withRegion(RabbitMQRegion.valueOf("<YOUR REGION>"))
                .build();
        UpdateUserRequest request = new UpdateUserRequest();
        request.withInstanceId("{instance_id}");
        request.withUserName("{user_name}");
        AMQPUser body = new AMQPUser();
        List<AMQPUserPerm> listbodyVhosts = new ArrayList<>();
        listbodyVhosts.add(
            new AMQPUserPerm()
                .withVhost("default")
                .withConf("^janeway-.*")
                .withWrite(".*")
                .withRead(".*")
        );
        body.withVhosts(listbodyVhosts);
        body.withSecretKey("**************");
        body.withAccessKey("admin123");
        request.withBody(body);
        try {
            UpdateUserResponse response = client.updateUser(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());
        }
    }
}

修改用户参数,允许访问名称为default的Vhost,允许对此Vhost下所有资源进行读、写、但仅允许对以janeway-开头的资源进行配置。

 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
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkrabbitmq.v2.region.rabbitmq_region import RabbitMQRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkrabbitmq.v2 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.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = RabbitMQClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(RabbitMQRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = UpdateUserRequest()
        request.instance_id = "{instance_id}"
        request.user_name = "{user_name}"
        listVhostsbody = [
            AMQPUserPerm(
                vhost="default",
                conf="^janeway-.*",
                write=".*",
                read=".*"
            )
        ]
        request.body = AMQPUser(
            vhosts=listVhostsbody,
            secret_key="**************",
            access_key="admin123"
        )
        response = client.update_user(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

修改用户参数,允许访问名称为default的Vhost,允许对此Vhost下所有资源进行读、写、但仅允许对以janeway-开头的资源进行配置。

 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
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    rabbitmq "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/rabbitmq/v2"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/rabbitmq/v2/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/rabbitmq/v2/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")
    projectId := "{project_id}"

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

    client := rabbitmq.NewRabbitMQClient(
        rabbitmq.RabbitMQClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.UpdateUserRequest{}
	request.InstanceId = "{instance_id}"
	request.UserName = "{user_name}"
	vhostVhosts:= "default"
	confVhosts:= "^janeway-.*"
	writeVhosts:= ".*"
	readVhosts:= ".*"
	var listVhostsbody = []model.AmqpUserPerm{
        {
            Vhost: &vhostVhosts,
            Conf: &confVhosts,
            Write: &writeVhosts,
            Read: &readVhosts,
        },
    }
	secretKeyAmqpUser:= "**************"
	accessKeyAmqpUser:= "admin123"
	request.Body = &model.AmqpUser{
		Vhosts: &listVhostsbody,
		SecretKey: &secretKeyAmqpUser,
		AccessKey: &accessKeyAmqpUser,
	}
	response, err := client.UpdateUser(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

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

状态码

状态码

描述

200

修改用户参数成功。

错误码

请参见错误码