本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateSessions
使用指定的详细信息创建新的 Amazon DCV 会话。
请求参数
Name
-
会话的名称。
类型:字符串
必需:是
Owner
-
会话所有者的名称。这必须是目标 Amazon DCV 服务器上的现有用户的名称。
类型:字符串
必需:是
Type
-
会话类型。有关会话类型的更多信息,请参阅《Amazon DCV 管理员指南》中的 Amazon DCV 会话简介。
有效值:CONSOLE | VIRTUAL
类型:字符串
必需:是
InitFile
-
Linux Amazon DCV 服务器上的虚拟会话支持。Windows 和 Linux Amazon DCV 服务器上的控制台会话不支持该参数。这是 Amazon DCV 服务器上的自定义脚本的路径,用于在创建会话时运行以初始化会话。文件路径相对于为
agent.init_folder
Agent 配置参数指定的 init 目录。如果文件位于指定的 init 目录中,请仅指定文件名。如果文件没有位于指定的 init 目录中,请指定相对路径。有关更多信息,请参阅《Amazon DCV Session Manager 管理员指南》中的 Agent 配置文件。类型:字符串
必需:否
MaxConcurrents
-
并发 Amazon DCV 客户端的最大数量。
类型:整数
必需:否
DcvGlEnabled
-
指示虚拟会话是否配置为使用基于硬件的 OpenGL。仅虚拟会话支持。Windows Amazon DCV 服务器不支持该参数。
有效值:true | false
类型:布尔值
必需:否
PermissionsFile
-
Base64 编码的权限文件内容。如果省略,则默认为服务器默认值。有关更多信息,请参阅《Amazon DCV 管理员指南》中的配置 Amazon DCV 授权。
类型:字符串
必需:否
EnqueueRequest
-
指示在无法立即完成请求时是否将其排入队列。
类型:布尔值
默认:false
必需:否
AutorunFile
-
Windows Amazon DCV 服务器上的控制台会话和 Linux Amazon DCV 服务器上的虚拟会话支持。Linux Amazon DCV 服务器上的控制台会话不支持该参数。
位于主机服务器上并在会话中运行的文件的路径。文件路径相对于为
agent.autorun_folder
Agent 配置参数指定的 autorun 目录。如果文件位于指定的 autorun 目录中,请仅指定文件名。如果文件没有位于指定的 autorun 目录中,请指定相对路径。有关更多信息,请参阅《Amazon DCV Session Manager 管理员指南》中的 Agent 配置文件。该文件是代表指定所有者运行的。指定的所有者必须有权在服务器上运行该文件。在 Windows Amazon DCV 服务器上,该文件是在所有者登录到会话时运行的。在 Linux Amazon DCV 服务器上,该文件是在创建会话时运行的。
类型:字符串
必需:否
AutorunFileArguments
-
Linux Amazon DCV 服务器上的虚拟会话支持。Windows 和 Linux Amazon DCV 服务器上的控制台会话不支持该参数。命令行参数在会话中执行AutorunFile时传递给。参数是按照它们在给定数组中的出现顺序传递的。可以配置最大允许参数数量以及每个参数的最大允许长度。有关更多信息,请参阅《Amazon DCV Session Manager 管理员指南》中的 Broker 配置文件。
类型:字符串数组
必需:否
DisableRetryOnFailure
-
指示创建会话请求在 Amazon DCV 主机上由于任何原因失败后是否不重试。有关创建会话重试机制的更多信息,请参阅《Amazon DCV Session Manager 管理员指南》中的 Broker 配置文件。
类型:布尔值
默认:false
必需:否
Requirements
-
服务器必须满足才能放置会话的要求。要求可能包括服务器标签和/或服务器属性,服务器标签和服务器属性都是通过调用 DescribeServersAPI 来检索的。
要求条件表达式:
a
! 如果不等于a
,则为b
trueb
a
= 如果等于a
,则为b
trueb
a
> 如果大于a
,则为b
trueb
a
>= 如果大于或等于a
,则b
为 trueb
a
如果小于,则b
a
为 < trueb
a
如果小于或等于a
,则为 <=b
trueb
a
如果a
包含字符串,则b
为 trueb
要求布尔运算符:
a
如果a
和为b
真则b
为真a
如果a
或为b
真则b
为真如果
a
为假则@@ 不正a
确
标签键必须以
tag:
为前缀,服务器属性必须以server:
为前缀。要求表达式支持圆括号()
。要求示例:
tag:color = 'pink' and (server:Host.Os.Family = 'windows' or tag:color := 'red')
"server:Host.Aws.Ec2InstanceType := 't2' and server:Host.CpuInfo.NumberOfCpus >= 2"
可以使用指数表示法指定数值,例如:
"server:Host.Memory.TotalBytes > 1024E6"
。支持的服务器属性包括:
Id
Hostname
Version
SessionManagerAgentVersion
Host.Os.BuildNumber
Host.Os.Family
Host.Os.KernelVersion
Host.Os.Name
Host.Os.Version
Host.Memory.TotalBytes
Host.Memory.UsedBytes
Host.Swap.TotalBytes
Host.Swap.UsedBytes
Host.CpuLoadAverage.OneMinute
Host.CpuLoadAverage.FiveMinutes
Host.CpuLoadAverage.FifteenMinutes
Host.Aws.Ec2InstanceId
Host.Aws.Ec2InstanceType
Host.Aws.Region
Host.Aws.Ec2ImageId
Host.CpuInfo.Architecture
Host.CpuInfo.ModelName
Host.CpuInfo.NumberOfCpus
Host.CpuInfo.PhysicalCoresPerCpu
Host.CpuInfo.Vendor
类型:字符串
必需:否
StorageRoot
-
指定用于会话存储的文件夹的路径。有关 Amazon DCV 会话存储的更多信息,请参阅《Amazon DCV 管理员指南》中的启用会话存储。
类型:字符串
必需:否
响应参数
Id
-
会话的唯一 ID。
Name
-
会话名称。
Owner
-
会话所有者。
Type
-
会话的类型。
State
-
会话的状态。如果请求成功完成,会话将进入
CREATING
状态。 Substate
-
会话的子状态。如果请求成功完成,会话将进入
SESSION_PLACING
子状态。