tencentcloud-sdk-gs 3.0.1073 → 3.0.1074

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 759a539f077a55a1da08c18807f5a21b31cbc69f
-  data.tar.gz: 514a7af2b852530f0929151df56678282b472d74
+  metadata.gz: c130c31f8c80fc664e6114c2b6398438bf1b8909
+  data.tar.gz: 5b8cf00df4b2f23d44aed988023939f32a6e6d50
 SHA512:
-  metadata.gz: a3bc475afdf922de9fb5dd10db049c911421acf28def27cf80482076e33c94faa9fbb452848e0441ff356428e19174d15856abdc219e7615748e7047b80d0f79
-  data.tar.gz: 874d33343475c0b052ba6bb44100a5b5f286609b3ccd7970ef41cce89f1878da24a519c6444564587cae9fc68b9d8298d3e179c9af20ca7bab473ee1dec7a7fd
+  metadata.gz: 879414c7b421d1361dd8c0fca96289399edf6ebe06ed3ec66d0a0dd38ecf707f8e6e9125afbc438e6790fd137457080cddc419d6406d8848130836e8b18b4028
+  data.tar.gz: 312cf8cbe7dceff3b9d8b5e9e1d4b85aa0e1a9304d21c15339be7cb8c4276e86ece74c6fe8484ad8e6b182647db7a9a3023133dce82ac70ff4ecb8b31e29842b

data/lib/VERSION

@@ -1 +1 @@
-3.0.1073
+3.0.1074

data/lib/v20191118/client.rb

@@ -29,7 +29,7 @@ module TencentCloud
         end
 
 
-        # 备份云手机到指定存储
+        # 备份云手机数据到指定存储，支持 COS 和兼容 AWS S3 协议的对象存储服务。如果是备份到 COS 时，会使用公网流量，授权 COS bucket 请在控制台中操作。
 
         # @param request: Request instance for BackUpAndroidInstanceToStorage.
         # @type request: :class:`Tencentcloud::gs::V20191118::BackUpAndroidInstanceToStorageRequest`
@@ -78,7 +78,7 @@ module TencentCloud
         end
 
         # 复制安卓实例：
-        # 1. 排除和包含文件只能指定/data下的文件，不指定时复制整个/data目录
+        # 1. 排除和包含文件只能指定 /data 下的文件，不指定时复制整个 /data 目录
         # 2. 源实例和目的实例必须在同一区域
         # 3. 复制时，源实例和目的实例都会停机，复制完后实例会自动启动
         # 4. 复制时会产生大量内网流量，请限制并发
@@ -153,6 +153,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 创建云手机实例 ADB 连接信息，请将返回结果的 PrivateKey 字段保存为 pem 文件，并将 pem 文件权限设置为 600，再参考返回结果的 ConnectCommand 使用 adb 连接实例。
+
+        # @param request: Request instance for CreateAndroidInstanceADB.
+        # @type request: :class:`Tencentcloud::gs::V20191118::CreateAndroidInstanceADBRequest`
+        # @rtype: :class:`Tencentcloud::gs::V20191118::CreateAndroidInstanceADBResponse`
+        def CreateAndroidInstanceADB(request)
+          body = send_request('CreateAndroidInstanceADB', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = CreateAndroidInstanceADBResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 创建安卓实例镜像
 
         # @param request: Request instance for CreateAndroidInstanceImage.
@@ -201,7 +225,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建安卓实例 SSH 连接
+        # 创建安卓实例 SSH 连接信息，请将返回结果的 PrivateKey 字段保存为 pem 文件，并将 pem 文件权限设置为 600，再参考返回结果的 ConnectCommand 使用 ssh 连接实例。
 
         # @param request: Request instance for CreateAndroidInstanceSSH.
         # @type request: :class:`Tencentcloud::gs::V20191118::CreateAndroidInstanceSSHRequest`
@@ -225,7 +249,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 创建安卓实例 WebShell 连接
+        # 创建安卓实例 WebShell 连接信息，返回的 ConnectUrl 可通过浏览器直接打开访问，链接有效期 1 小时，链接打开后可持续使用。
 
         # @param request: Request instance for CreateAndroidInstanceWebShell.
         # @type request: :class:`Tencentcloud::gs::V20191118::CreateAndroidInstanceWebShellRequest`
@@ -633,7 +657,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 分发文件到安卓实例
+        # 将一个文件批量分发到多个实例，一次接口调用触发一次文件分发，一次文件分发只会从公网下载一次，然后文件会走内网分发到实例列表中的实例。
 
         # @param request: Request instance for DistributeFileToAndroidInstances.
         # @type request: :class:`Tencentcloud::gs::V20191118::DistributeFileToAndroidInstancesRequest`
@@ -681,7 +705,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 批量获取安卓实例日志
+        # 批量将实例的 logcat 日志文件上传到您已授权的 COS bucket 中，授权 COS bucket 请在控制台中操作。
 
         # @param request: Request instance for FetchAndroidInstancesLogs.
         # @type request: :class:`Tencentcloud::gs::V20191118::FetchAndroidInstancesLogsRequest`
@@ -729,6 +753,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 安装安卓实例应用
+
+        # @param request: Request instance for InstallAndroidInstancesAppWithURL.
+        # @type request: :class:`Tencentcloud::gs::V20191118::InstallAndroidInstancesAppWithURLRequest`
+        # @rtype: :class:`Tencentcloud::gs::V20191118::InstallAndroidInstancesAppWithURLResponse`
+        def InstallAndroidInstancesAppWithURL(request)
+          body = send_request('InstallAndroidInstancesAppWithURL', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = InstallAndroidInstancesAppWithURLResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 修改安卓应用信息
 
         # @param request: Request instance for ModifyAndroidApp.
@@ -873,6 +921,30 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
+        # 批量修改安卓实例属性
+
+        # @param request: Request instance for ModifyAndroidInstancesProperties.
+        # @type request: :class:`Tencentcloud::gs::V20191118::ModifyAndroidInstancesPropertiesRequest`
+        # @rtype: :class:`Tencentcloud::gs::V20191118::ModifyAndroidInstancesPropertiesResponse`
+        def ModifyAndroidInstancesProperties(request)
+          body = send_request('ModifyAndroidInstancesProperties', request.serialize)
+          response = JSON.parse(body)
+          if response['Response'].key?('Error') == false
+            model = ModifyAndroidInstancesPropertiesResponse.new
+            model.deserialize(response['Response'])
+            model
+          else
+            code = response['Response']['Error']['Code']
+            message = response['Response']['Error']['Message']
+            reqid = response['Response']['RequestId']
+            raise TencentCloud::Common::TencentCloudSDKException.new(code, message, reqid)
+          end
+        rescue TencentCloud::Common::TencentCloudSDKException => e
+          raise e
+        rescue StandardError => e
+          raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
+        end
+
         # 修改安卓实例分辨率。需要注意的是该接口需要重启才能生效。
 
         # @param request: Request instance for ModifyAndroidInstancesResolution.
@@ -1020,7 +1092,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 指定存储还原云手机
+        # 使用指定存储数据还原云手机，支持 COS 和兼容 AWS S3 协议的对象存储服务。如果还原数据来自 COS 时，会使用公网流量，授权 COS bucket 请在控制台中操作。
 
         # @param request: Request instance for RestoreAndroidInstanceFromStorage.
         # @type request: :class:`Tencentcloud::gs::V20191118::RestoreAndroidInstanceFromStorageRequest`
@@ -1380,7 +1452,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 上传文件到安卓实例
+        # 将文件下载到指定实例列表的实例上，每个实例都会从公网下载文件。如果您需要将同一个文件分发到多个实例，建议使用 DistributeFileToAndroidInstances 接口减少公网下载的流量。如果您需要将不同的文件下载到不同的实例，可考虑使用 UploadFilesToAndroidInstances 接口批量将不同文件下载到不同的实例。
 
         # @param request: Request instance for UploadFileToAndroidInstances.
         # @type request: :class:`Tencentcloud::gs::V20191118::UploadFileToAndroidInstancesRequest`
@@ -1404,7 +1476,7 @@ module TencentCloud
           raise TencentCloud::Common::TencentCloudSDKException.new(nil, e.inspect)
         end
 
-        # 批量上传文件到安卓实例
+        # 批量将不同的文件下载到不同的实例，每个实例下载文件都是从公网下载，建议只用在文件下载使用一次的场景。如果您需要将同一个文件分发到不同实例，建议使用 DistributeFileToAndroidInstances 接口。
 
         # @param request: Request instance for UploadFilesToAndroidInstances.
         # @type request: :class:`Tencentcloud::gs::V20191118::UploadFilesToAndroidInstancesRequest`

data/lib/v20191118/models.rb

@@ -98,15 +98,18 @@ module TencentCloud
         # @type Command: String
         # @param UninstallCommand: shell 卸载命令（支持多条命令执行，通过 && 组合；只在应用 AppMode 为 ADVANCED 高级模式下 才会生效）
         # @type UninstallCommand: String
+        # @param CleanupMode: 应用资源清理模式（实例安装应用所用资源），取值：CLEANUP_ON_UNINSTALL（默认值），卸载 App 时清理；CLEANUP_AFTER_INSTALL，安装 App 后立即清理。普通应用只有 CLEANUP_AFTER_INSTALL 模式。
+        # @type CleanupMode: String
 
-        attr_accessor :AndroidAppVersion, :State, :CreateTime, :Command, :UninstallCommand
+        attr_accessor :AndroidAppVersion, :State, :CreateTime, :Command, :UninstallCommand, :CleanupMode
 
-        def initialize(androidappversion=nil, state=nil, createtime=nil, command=nil, uninstallcommand=nil)
+        def initialize(androidappversion=nil, state=nil, createtime=nil, command=nil, uninstallcommand=nil, cleanupmode=nil)
           @AndroidAppVersion = androidappversion
           @State = state
           @CreateTime = createtime
           @Command = command
           @UninstallCommand = uninstallcommand
+          @CleanupMode = cleanupmode
         end
 
         def deserialize(params)
@@ -115,6 +118,7 @@ module TencentCloud
           @CreateTime = params['CreateTime']
           @Command = params['Command']
           @UninstallCommand = params['UninstallCommand']
+          @CleanupMode = params['CleanupMode']
         end
       end
 
@@ -237,6 +241,26 @@ module TencentCloud
         end
       end
 
+      # 安卓实例设备信息
+      class AndroidInstanceDevice < TencentCloud::Common::AbstractModel
+        # @param Brand: 品牌
+        # @type Brand: String
+        # @param Model: 型号
+        # @type Model: String
+
+        attr_accessor :Brand, :Model
+
+        def initialize(brand=nil, model=nil)
+          @Brand = brand
+          @Model = model
+        end
+
+        def deserialize(params)
+          @Brand = params['Brand']
+          @Model = params['Model']
+        end
+      end
+
       # 安卓实例镜像信息
       class AndroidInstanceImage < TencentCloud::Common::AbstractModel
         # @param AndroidInstanceImageId: 镜像 ID
@@ -305,6 +329,26 @@ module TencentCloud
         end
       end
 
+      # 安卓实例属性
+      class AndroidInstanceProperty < TencentCloud::Common::AbstractModel
+        # @param Key: 属性键
+        # @type Key: String
+        # @param Value: 属性值
+        # @type Value: String
+
+        attr_accessor :Key, :Value
+
+        def initialize(key=nil, value=nil)
+          @Key = key
+          @Value = value
+        end
+
+        def deserialize(params)
+          @Key = params['Key']
+          @Value = params['Value']
+        end
+      end
+
       # 安卓实例任务信息
       class AndroidInstanceTask < TencentCloud::Common::AbstractModel
         # @param TaskId: 任务ID
@@ -621,14 +665,17 @@ module TencentCloud
         # @type Command: String
         # @param UninstallCommand: 应用 shell 卸载命令（支持多条命令执行，通过 && 组合；只在应用 AppMode 为 ADVANCED 高级模式下 才会生效）
         # @type UninstallCommand: String
+        # @param CleanupMode: 应用资源清理模式（实例安装应用所用资源），取值：CLEANUP_ON_UNINSTALL（默认值），卸载 App 时清理；CLEANUP_AFTER_INSTALL，安装 App 后立即清理。普通应用只有 CLEANUP_AFTER_INSTALL 模式。
+        # @type CleanupMode: String
 
-        attr_accessor :AndroidAppId, :DownloadUrl, :Command, :UninstallCommand
+        attr_accessor :AndroidAppId, :DownloadUrl, :Command, :UninstallCommand, :CleanupMode
 
-        def initialize(androidappid=nil, downloadurl=nil, command=nil, uninstallcommand=nil)
+        def initialize(androidappid=nil, downloadurl=nil, command=nil, uninstallcommand=nil, cleanupmode=nil)
           @AndroidAppId = androidappid
           @DownloadUrl = downloadurl
           @Command = command
           @UninstallCommand = uninstallcommand
+          @CleanupMode = cleanupmode
         end
 
         def deserialize(params)
@@ -636,6 +683,7 @@ module TencentCloud
           @DownloadUrl = params['DownloadUrl']
           @Command = params['Command']
           @UninstallCommand = params['UninstallCommand']
+          @CleanupMode = params['CleanupMode']
         end
       end
 
@@ -659,6 +707,58 @@ module TencentCloud
         end
       end
 
+      # CreateAndroidInstanceADB请求参数结构体
+      class CreateAndroidInstanceADBRequest < TencentCloud::Common::AbstractModel
+        # @param AndroidInstanceId: 安卓实例 ID
+        # @type AndroidInstanceId: String
+
+        attr_accessor :AndroidInstanceId
+
+        def initialize(androidinstanceid=nil)
+          @AndroidInstanceId = androidinstanceid
+        end
+
+        def deserialize(params)
+          @AndroidInstanceId = params['AndroidInstanceId']
+        end
+      end
+
+      # CreateAndroidInstanceADB返回参数结构体
+      class CreateAndroidInstanceADBResponse < TencentCloud::Common::AbstractModel
+        # @param PrivateKey: 连接私钥，需要保存为文件形式，例如 private_key.pem
+        # @type PrivateKey: String
+        # @param UserName: 用户名称
+        # @type UserName: String
+        # @param HostName: 连接地址
+        # @type HostName: String
+        # @param Port: 连接端口
+        # @type Port: Integer
+        # @param ConnectCommand: 连接参考命令
+        # @type ConnectCommand: String
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :PrivateKey, :UserName, :HostName, :Port, :ConnectCommand, :RequestId
+
+        def initialize(privatekey=nil, username=nil, hostname=nil, port=nil, connectcommand=nil, requestid=nil)
+          @PrivateKey = privatekey
+          @UserName = username
+          @HostName = hostname
+          @Port = port
+          @ConnectCommand = connectcommand
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @PrivateKey = params['PrivateKey']
+          @UserName = params['UserName']
+          @HostName = params['HostName']
+          @Port = params['Port']
+          @ConnectCommand = params['ConnectCommand']
+          @RequestId = params['RequestId']
+        end
+      end
+
       # CreateAndroidInstanceImage请求参数结构体
       class CreateAndroidInstanceImageRequest < TencentCloud::Common::AbstractModel
         # @param AndroidInstanceImageName: 安卓实例镜像名称
@@ -1949,6 +2049,54 @@ module TencentCloud
         end
       end
 
+      # InstallAndroidInstancesAppWithURL请求参数结构体
+      class InstallAndroidInstancesAppWithURLRequest < TencentCloud::Common::AbstractModel
+        # @param AndroidInstanceIds: 实例ID
+        # @type AndroidInstanceIds: Array
+        # @param AndroidAppURL: 安卓应用下载 URL
+        # @type AndroidAppURL: String
+
+        attr_accessor :AndroidInstanceIds, :AndroidAppURL
+
+        def initialize(androidinstanceids=nil, androidappurl=nil)
+          @AndroidInstanceIds = androidinstanceids
+          @AndroidAppURL = androidappurl
+        end
+
+        def deserialize(params)
+          @AndroidInstanceIds = params['AndroidInstanceIds']
+          @AndroidAppURL = params['AndroidAppURL']
+        end
+      end
+
+      # InstallAndroidInstancesAppWithURL返回参数结构体
+      class InstallAndroidInstancesAppWithURLResponse < TencentCloud::Common::AbstractModel
+        # @param TaskSet: 任务集合
+        # 注意：此字段可能返回 null，表示取不到有效值。
+        # @type TaskSet: Array
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :TaskSet, :RequestId
+
+        def initialize(taskset=nil, requestid=nil)
+          @TaskSet = taskset
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          unless params['TaskSet'].nil?
+            @TaskSet = []
+            params['TaskSet'].each do |i|
+              androidinstancetask_tmp = AndroidInstanceTask.new
+              androidinstancetask_tmp.deserialize(i)
+              @TaskSet << androidinstancetask_tmp
+            end
+          end
+          @RequestId = params['RequestId']
+        end
+      end
+
       # 标签要求
       class LabelRequirement < TencentCloud::Common::AbstractModel
         # @param Key: 标签键
@@ -2247,6 +2395,56 @@ module TencentCloud
         end
       end
 
+      # ModifyAndroidInstancesProperties请求参数结构体
+      class ModifyAndroidInstancesPropertiesRequest < TencentCloud::Common::AbstractModel
+        # @param AndroidInstanceIds: 安卓实例 ID 列表
+        # @type AndroidInstanceIds: Array
+        # @param AndroidInstanceDevice: 安卓实例设备
+        # @type AndroidInstanceDevice: :class:`Tencentcloud::Gs.v20191118.models.AndroidInstanceDevice`
+        # @param AndroidInstanceProperties: 安卓实例其它属性列表
+        # @type AndroidInstanceProperties: Array
+
+        attr_accessor :AndroidInstanceIds, :AndroidInstanceDevice, :AndroidInstanceProperties
+
+        def initialize(androidinstanceids=nil, androidinstancedevice=nil, androidinstanceproperties=nil)
+          @AndroidInstanceIds = androidinstanceids
+          @AndroidInstanceDevice = androidinstancedevice
+          @AndroidInstanceProperties = androidinstanceproperties
+        end
+
+        def deserialize(params)
+          @AndroidInstanceIds = params['AndroidInstanceIds']
+          unless params['AndroidInstanceDevice'].nil?
+            @AndroidInstanceDevice = AndroidInstanceDevice.new
+            @AndroidInstanceDevice.deserialize(params['AndroidInstanceDevice'])
+          end
+          unless params['AndroidInstanceProperties'].nil?
+            @AndroidInstanceProperties = []
+            params['AndroidInstanceProperties'].each do |i|
+              androidinstanceproperty_tmp = AndroidInstanceProperty.new
+              androidinstanceproperty_tmp.deserialize(i)
+              @AndroidInstanceProperties << androidinstanceproperty_tmp
+            end
+          end
+        end
+      end
+
+      # ModifyAndroidInstancesProperties返回参数结构体
+      class ModifyAndroidInstancesPropertiesResponse < TencentCloud::Common::AbstractModel
+        # @param RequestId: 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。
+        # @type RequestId: String
+
+        attr_accessor :RequestId
+
+        def initialize(requestid=nil)
+          @RequestId = requestid
+        end
+
+        def deserialize(params)
+          @RequestId = params['RequestId']
+        end
+      end
+
       # ModifyAndroidInstancesResolution请求参数结构体
       class ModifyAndroidInstancesResolutionRequest < TencentCloud::Common::AbstractModel
         # @param AndroidInstanceIds: 安卓实例 ID 列表

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tencentcloud-sdk-gs
 version: !ruby/object:Gem::Version
-  version: 3.0.1073
+  version: 3.0.1074
 platform: ruby
 authors:
 - Tencent Cloud
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-06-03 00:00:00.000000000 Z
+date: 2025-06-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: tencentcloud-sdk-common