tencentcloud-sdk-sts 3.0.596 → 3.0.597

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: acebb3431f2379a5bb2130b188580bfb59495363
-  data.tar.gz: 6eb49d86023727001936fbc03e7ce94882d94b37
+  metadata.gz: 9fa02147cd4cbebe6ab2920758be4f6f7a5bc941
+  data.tar.gz: 99725ab83f07bd66f5d0e4199d5484d79751b6d0
 SHA512:
-  metadata.gz: 4ce8b463d0c95456a049d0e7e22f0c70058f0218ac5cae4a81b49c3543e82f89226dd6fb564c2a2c472b30d15925f5eae0101fdf30af3cf2291f83c9b90c22ff
-  data.tar.gz: f792fd2e0e75c57b79bbb0283c87a2c544632fb439a56ae9c1ba12ceab1ee4831892dcb8dde93afcdca9097cde7d39a92b8bd05aff81777e60399dda53f52a61
+  metadata.gz: 4e1a8b36a0d5e3750603defb08a1fe903efb212331908716df7f5ff5642532743f7a28709e135f7addd30b3e848b9b15212f0bfd3ee396779948f735c985789a
+  data.tar.gz: 2e44a06e0b714eca8e91854d167ebb00cf0859217281fd5a7b92e8418326cfa97d09f0deb8af566714daedd963fbc41a629e6231d499603447dda588033ab1c5

data/lib/VERSION

@@ -1 +1 @@
-3.0.596
+3.0.597

data/lib/v20180813/client.rb

@@ -29,7 +29,7 @@ module TencentCloud
         end
 
 
-        # 申请扮演角色
+        # 申请扮演角色临时访问凭证。
 
         # @param request: Request instance for AssumeRole.
         # @type request: :class:`Tencentcloud::sts::V20180813::AssumeRoleRequest`
@@ -53,7 +53,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时凭证。
+        # 本接口（AssumeRoleWithSAML）用于根据 SAML 断言申请角色临时访问凭证。
+
+        # 注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
 
         # @param request: Request instance for AssumeRoleWithSAML.
         # @type request: :class:`Tencentcloud::sts::V20180813::AssumeRoleWithSAMLRequest`
@@ -77,7 +79,9 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 申请OIDC角色临时密钥
+        # 申请OIDC角色临时访问凭证。
+
+        # 注意：当使用签名方法 V3 调用本接口时，请求头无须传入 X-TC-Token, 但 Authorization 需要传入值 SKIP。
 
         # @param request: Request instance for AssumeRoleWithWebIdentity.
         # @type request: :class:`Tencentcloud::sts::V20180813::AssumeRoleWithWebIdentityRequest`
@@ -102,7 +106,8 @@ module TencentCloud
         end
 
         # 获取当前调用者的身份信息。
-        # 接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时凭据的身份获取。
+
+        # 接口支持主账号，子账号长期密钥以及AssumeRole，GetFederationToken生成的临时访问凭证身份获取。
 
         # @param request: Request instance for GetCallerIdentity.
         # @type request: :class:`Tencentcloud::sts::V20180813::GetCallerIdentityRequest`
@@ -126,7 +131,15 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 获取联合身份临时访问凭证
+        # **使用说明**
+
+        # 返回一组临时访问凭证，典型的应用场景是代理应用程序集中申请临时访问凭证，下发给企业网络内其他分布式终端应用，比如终端应用上传文件到COS场景，本接口仅支持永久密钥调用。
+
+        # **最佳实践**
+
+        # 1. 临时访问凭据在有效期内都可以使用，建议在有效期内重复使用，以避免业务请求速率上升后被限频
+        # 2. 授予临时访问凭证权限的CAM策略，建议按权限最小化原则
+        # 3. 调用接口的永久密钥，建议不要使用主账号
 
         # @param request: Request instance for GetFederationToken.
         # @type request: :class:`Tencentcloud::sts::V20180813::GetFederationTokenRequest`

data/lib/v20180813/models.rb

@@ -52,7 +52,7 @@ module TencentCloud
         # @param RoleSessionName: 临时会话名称，由用户自定义名称。
         # 长度在2到128之间，可包含大小写字符，数字以及特殊字符：=,.@_-。 正则为：[\w+=,.@_-]*
         # @type RoleSessionName: String
-        # @param DurationSeconds: 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+        # @param DurationSeconds: 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
         # @type DurationSeconds: Integer
         # @param Policy: 策略描述
         # 注意：
@@ -100,11 +100,11 @@ module TencentCloud
 
       # AssumeRole返回参数结构体
       class AssumeRoleResponse < TencentCloud::Common::AbstractModel
-        # @param Credentials: 临时安全证书
+        # @param Credentials: 临时访问凭证
         # @type Credentials: :class:`Tencentcloud::Sts.v20180813.models.Credentials`
-        # @param ExpiredTime: 证书无效的时间，返回 Unix 时间戳，精确到秒
+        # @param ExpiredTime: 临时访问凭证的过期时间，返回 Unix 时间戳，精确到秒
         # @type ExpiredTime: Integer
-        # @param Expiration: 证书无效的时间，以 iso8601 格式的 UTC 时间表示
+        # @param Expiration: 临时访问凭证的过期时间，以 iso8601 格式的 UTC 时间表示
         # @type Expiration: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -139,7 +139,7 @@ module TencentCloud
         # @type RoleArn: String
         # @param RoleSessionName: 会话名称
         # @type RoleSessionName: String
-        # @param DurationSeconds: 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+        # @param DurationSeconds: 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
         # @type DurationSeconds: Integer
 
         attr_accessor :SAMLAssertion, :PrincipalArn, :RoleArn, :RoleSessionName, :DurationSeconds
@@ -165,9 +165,9 @@ module TencentCloud
       class AssumeRoleWithSAMLResponse < TencentCloud::Common::AbstractModel
         # @param Credentials: 对象里面包含 Token，TmpSecretId，TmpSecretKey 三元组
         # @type Credentials: :class:`Tencentcloud::Sts.v20180813.models.Credentials`
-        # @param ExpiredTime: 证书无效的时间，返回 Unix 时间戳，精确到秒
+        # @param ExpiredTime: 临时访问凭证的过期时间，返回 Unix 时间戳，精确到秒
         # @type ExpiredTime: Integer
-        # @param Expiration: 证书无效的时间，以 ISO8601 格式的 UTC 时间表示
+        # @param Expiration: 临时访问凭证的过期时间，以 ISO8601 格式的 UTC 时间表示
         # @type Expiration: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -202,7 +202,7 @@ module TencentCloud
         # @type RoleArn: String
         # @param RoleSessionName: 会话名称
         # @type RoleSessionName: String
-        # @param DurationSeconds: 指定临时证书的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
+        # @param DurationSeconds: 指定临时访问凭证的有效期，单位：秒，默认 7200 秒，最长可设定有效期为 43200 秒
         # @type DurationSeconds: Integer
 
         attr_accessor :ProviderId, :WebIdentityToken, :RoleArn, :RoleSessionName, :DurationSeconds
@@ -226,11 +226,11 @@ module TencentCloud
 
       # AssumeRoleWithWebIdentity返回参数结构体
       class AssumeRoleWithWebIdentityResponse < TencentCloud::Common::AbstractModel
-        # @param ExpiredTime: 临时密钥过期时间(时间戳)
+        # @param ExpiredTime: 临时访问凭证过期时间(时间戳)
         # @type ExpiredTime: Integer
-        # @param Expiration: 临时密钥过期时间
+        # @param Expiration: 临时访问凭证过期时间
         # @type Expiration: String
-        # @param Credentials: 临时密钥
+        # @param Credentials: 临时访问凭证
         # @type Credentials: :class:`Tencentcloud::Sts.v20180813.models.Credentials`
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
         # @type RequestId: String
@@ -335,7 +335,7 @@ module TencentCloud
       class GetFederationTokenRequest < TencentCloud::Common::AbstractModel
         # @param Name: 您可以自定义调用方英文名称，由字母组成。
         # @type Name: String
-        # @param Policy: 授予该临时证书权限的CAM策略
+        # @param Policy: 授予该临时访问凭证权限的CAM策略
         # 注意：
         # 1、策略语法参照[ CAM 策略语法](https://cloud.tencent.com/document/product/598/10603)。
         # 2、策略中不能包含 principal 元素。
@@ -361,11 +361,11 @@ module TencentCloud
 
       # GetFederationToken返回参数结构体
       class GetFederationTokenResponse < TencentCloud::Common::AbstractModel
-        # @param Credentials: 临时证书
+        # @param Credentials: 临时访问凭证
         # @type Credentials: :class:`Tencentcloud::Sts.v20180813.models.Credentials`
-        # @param ExpiredTime: 临时证书有效的时间，返回 Unix 时间戳，精确到秒
+        # @param ExpiredTime: 临时访问凭证有效的时间，返回 Unix 时间戳，精确到秒
         # @type ExpiredTime: Integer
-        # @param Expiration: 证书有效的时间，以 iso8601 格式的 UTC 时间表示
+        # @param Expiration: 临时访问凭证有效的时间，以 iso8601 格式的 UTC 时间表示
         # 注意：此字段可能返回 null，表示取不到有效值。
         # @type Expiration: String
         # @param RequestId: 唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-sts
 version: !ruby/object:Gem::Version
-  version: 3.0.596
+  version: 3.0.597
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-06-20 00:00:00.000000000 Z
+date: 2023-06-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common