release 3.1.165 source code

Author: Huaweicloud-SDK

CHANGELOG.md

@@ -222,6 +222,7 @@ the [CHANGELOG.md](https://github.com/huaweicloud/huaweicloud-sdk-python-v3/blob
     * [3.3 Custom Configuration](#33-custom-configuration-top)
         * [3.3.1 IAM endpoint configuration](#331-iam-endpoint-configuration-top)
         * [3.3.2 Region configuration](#332-region-configuration-top)
+    * [3.4 User Agent](#34-user-agent-top)
 * [4. Send Requests and Handle Responses](#4-send-requests-and-handle-responses-top)
     * [4.1 Exceptions](#41-exceptions-top)
     * [4.2 Get Response Object](#42-get-response-object-top)
@@ -819,6 +820,24 @@ region1 = EcsRegion.value_of("cn-north-1")
 region2 = EcsRegion.value_of("cn-north-9")
 ```
 
+#### 3.4 User Agent [:top:](#user-manual-top)
+
+Additional information will be appended to the User-Agent in the request header by default since **v3.1.165**. It is used by service to identify what SDK language, python version, and platform info a client is using to call into their service, and a random identifier will be generated and appended to the User-Agent. The identifier will be stored in the user's home directory, as `~/.huaweicloud/application_id` on Linux and `C:\Users\USER_NAME\.huaweicloud\application_id` on Windows.
+
+The above information will be used to protect the security of your and your users' Huawei Cloud accounts.
+
+You can disable this automatic User-Agent augmentation by explicitly setting a custom User-Agent header value. The value is recommended to be less than 50 characters and should use US-ASCII visible characters:
+
+```python
+http_config = HttpConfig.get_default_config()
+# Append custom User-Agent information to replace the default
+http_config.user_agent = "custom user agent..."
+
+client = IamClient.new_builder() \
+    .with_http_config(http_config) \
+    .build()
+```
+
 ### 4. Send Requests and Handle Responses [:top:](#user-manual-top)
 
 ```python

CHANGELOG_CN.md

@@ -221,6 +221,7 @@ if __name__ == "__main__":
     * [3.3 自定义配置](#33-自定义配置-top)
         * [3.3.1 IAM endpoint配置](#331-IAM-endpoint配置-top)
         * [3.3.2 Region配置](#332-Region配置-top)
+    * [3.4 用户代理](#34-用户代理--top)
 * [4. 发送请求并查看响应](#4-发送请求并查看响应-top)
     * [4.1 异常处理](#41-异常处理-top)
     * [4.2 获取响应对象](#42-获取响应对象-top)
@@ -811,6 +812,24 @@ region1 = EcsRegion.value_of("cn-north-1")
 region2 = EcsRegion.value_of("cn-north-9")
 ```
 
+#### 3.4 用户代理 [:top:](#用户手册-top)
+
+从**3.1.165**版本起，默认会在请求头User-Agent中附加额外信息，用于识别客户端调用服务时所使用的SDK语言、客户端库版本以及平台信息等。 User-Agent包含Python版本、操作系统信息，同时会生成一个随机标识符追加到User-Agent信息中。随机标识符会存储在用户主目录下，linux为 `~/.huaweicloud/application_id`，windows为`C:\Users\USER_NAME\.huaweicloud\application_id`。
+
+上述信息将用于保护您及您的用户的华为云账号安全。
+
+您可以通过自定义User-Agent的方式关闭上述行为，自定义User-Agent信息建议长度不超过50个字符，仅可包含ASCII可打印字符：
+
+```python
+http_config = HttpConfig.get_default_config()
+# 追加自定义User-Agent信息，替代默认追加内容
+http_config.user_agent = "custom user agent..."
+
+client = IamClient.new_builder() \
+    .with_http_config(http_config) \
+    .build()
+```
+
 ### 4. 发送请求并查看响应 [:top:](#用户手册-top)
 
 ```python

README.md

@@ -1 +1 @@
-3.1.164
+3.1.165

README_CN.md

@@ -1 +1 @@
-huaweicloudsdkcore>=3.1.164
+huaweicloudsdkcore>=3.1.165

VERSION

@@ -4,7 +4,7 @@
 from setuptools import setup, find_packages
 
 NAME = "huaweicloudsdkaad"
-VERSION = "3.1.164"
+VERSION = "3.1.165"
 AUTHOR = "HuaweiCloud SDK"
 AUTHOR_EMAIL = "hwcloudsdk@huawei.com"
 URL = "https://github.com/huaweicloud/huaweicloud-sdk-python-v3"
@@ -14,7 +14,7 @@
 with open(path.join(this_directory, 'README_PYPI.md'), encoding='utf-8') as f:
     LONG_DESCRIPTION = f.read()
 
-REQUIRES = ["huaweicloudsdkcore>=3.1.164"]
+REQUIRES = ["huaweicloudsdkcore>=3.1.165"]
 
 setup(
     name=NAME,