tencentcloud-sdk-sts 3.0.1094 → 3.0.1123

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 68e9c037e4460d248af9cc804f4818bd62306a2e
-  data.tar.gz: d3d0b6695e64978ed04fe075e2388278a5d90bc2
+  metadata.gz: 384bba21fee0533b599d295f70403ff1ead34474
+  data.tar.gz: 56858c3a2b7622a1083ad89d9cceaa285b848726
 SHA512:
-  metadata.gz: 77b709c81e0da36c5a2b06593d706c499630b249f4092c1aa76b5abb617cbbb1e318ec41f710641f8e73489fd2056377233cecfc8c2ded7db919c4c6f908866e
-  data.tar.gz: 343d5689348e5b6ed43a8fda93782fe7281551a23012c2d0bad17142328c0a1bae34748b98406e4fc7ff21af2a0ef1db7a3b853feb7f642edd7a619dc2c8a118
+  metadata.gz: 419bf94ae405bb52766e6cbf45adc972f4dde75070fa12c9633cdedd20d182118b5a0ae19e05e3fa4446ed0cbbfd938411608d15cac85fdfe282d76005e6654b
+  data.tar.gz: e422371acaa8438484b192fe396a46cbbd0c4fd14344931eac5fe3ff697e28357ccff34831e009dfe6485c7b62a757d01c0ade8b1af057d7ee637c89e91f65cc

data/lib/VERSION

@@ -1 +1 @@
-3.0.1094
+3.0.1123

data/lib/v20180813/client.rb

@@ -29,20 +29,34 @@ module TencentCloud
         end
 
 
-        # 申请扮演角色临时访问凭证。
+        # **使用说明**
+
+        # 1. 申请扮演某个角色的临时访问凭证，返回临时身份的token和能够扮演该角色的临时密钥；
+        # 2. 角色策略组成
+        # （1）角色载体：指定谁可以扮演该角色；
+        # （2）角色权限：指定扮演角色后可以执行哪些操作，操作哪些资源。
+
+        # 3. 角色可被扮演的条件
+        # （1）给该用户绑定包含AssumeRole的策略；
+        # （2）将该用户配置为角色载体的主体。
 
-        # 1、角色策略组成
+        # 4. 此接口可以支持永久密钥或临时密钥调用。
 
-        # （1）角色信任策略：指定谁可以扮演该角色；
 
-        # （2）角色权限策略：指定扮演角色后可以执行哪些操作。
+        # **典型场景**
 
+        # 1. 跨账号授权：主账号A需要操作主账号B的资源。
+        # 例如：A账号下有子用户a，B账号下有角色role b，a可以通过AssumeRole接口扮演b，以角色b身份登录账号B的控制台，并操作资源。
 
-        # 2、角色可扮演条件
+        # 2. 跨服务调用：云上的A服务需要访问或操作B服务的资源。
+        # 例如：为A服务接入一个服务相关角色，用户授权创建角色和策略后，A服务即可调用AssumeRole获取用户的服务相关角色临时密钥，调用B服务接口并访问资源。
 
-        # （1）给用户绑定允许调用AssumeRole的策略 ；
 
-        # （2）将用户添加为角色信任策略中的主体。
+
+        # **最佳实践**
+        # 1. 临时访问凭证在有效期内（Expiration）都可以使用，建议在有效期内重复使用，避免业务请求该接口频率达到上限被限频；
+        # 2. 授予临时访问凭证权限的CAM策略，建议严格遵循最小权限原则；
+        # 3. 建议不要使用主账号永久密钥，对该接口进行调用。
 
         # @param request: Request instance for AssumeRole.
         # @type request: :class:`Tencentcloud::sts::V20180813::AssumeRoleRequest`
@@ -146,13 +160,25 @@ module TencentCloud
 
         # **使用说明**
 
-        # 返回一组临时访问凭证，典型的应用场景是代理应用程序集中申请临时访问凭证，下发给企业网络内其他分布式终端应用，比如终端应用上传文件到COS场景，本接口仅支持永久密钥调用。
+        # 1. 返回一组临时身份访问凭证，包含token和获取该身份的临时密钥；
+
+        # 2. 当您需要将当前账号下的部分权限和资源临时委托给第三方（如合作伙伴、外包团队），且希望避免下发永久密钥时，调用此接口；
+        # 3. 临时身份的权限为：当前调用账号的权限和输入参数 Policy 权限的交集；
+        # 4. 此接口仅支持永久密钥调用。
+
+
+        # **典型场景**
+
+        # 1. 代理应用程序集中申请临时访问凭证，下发给企业网络内的其他分布式终端应用。例如：终端应用上传文件到COS。
+
+        # 2. 将指定资源临时委托给第三方代理。例如：申请临时访问凭证，分发给企业外部团队，仅允许查看某个存储桶，有效期结束后权限自动回收。
+
 
         # **最佳实践**
+        # 1. 临时访问凭证在有效期内（Expiration）都可以使用，建议在有效期内重复使用，避免业务请求该接口频率达到上限被限频；
 
-        # 1. 临时访问凭据在有效期内都可以使用，建议在有效期内重复使用，以避免业务请求速率上升后被限频
-        # 2. 授予临时访问凭证权限的CAM策略，建议按权限最小化原则
-        # 3. 调用接口的永久密钥，建议不要使用主账号
+        # 2. 授予临时访问凭证权限的CAM策略，建议严格遵循最小权限原则；
+        # 3. 建议不要使用主账号永久密钥，对该接口进行调用。
 
         # @param request: Request instance for GetFederationToken.
         # @type request: :class:`Tencentcloud::sts::V20180813::GetFederationTokenRequest`

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-sts
 version: !ruby/object:Gem::Version
-  version: 3.0.1094
+  version: 3.0.1123
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-05 00:00:00.000000000 Z
+date: 2025-08-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common