ModifyCenterPolicy-阿里云帮助中心

Modifies a configuration that does not have a region-specific policy.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ecd:ModifyCenterPolicy

update

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID. Set the value to `cn-shanghai`. Valid values: cn-shanghai : China (Shanghai)	cn-shanghai
PolicyGroupId	string	Yes	The cloud computer policy ID.	pg-53iyi2aar0nd6****
BusinessType	integer	Yes	The business type. Valid values: 1 : Public cloud 8 : Commercial edition	1
ResourceType	string	Yes	The resource type. Valid values: app : Cloud applications desktop : Cloud computers	desktop
Clipboard	string	No	The clipboard permissions. Valid values: read : One-way allowed. You can copy local content to the cloud computer, but not from the cloud computer to local. readwrite : Two-way allowed. You can copy content between local and the cloud computer. write : One-way allowed. You can copy content from the cloud computer to local, but not from local to the cloud computer. off : Two-way disabled. No copying is allowed between the cloud computer and local. [Default]	off
LocalDrive	string	No	The local disk mapping permissions. Valid values: read : Read-only. The cloud computer maps the local disk, but you can only read (copy) local files—not modify them. readwrite : Read and write. The cloud computer maps the local disk, and you can both read (copy) and modify local files. off : Disabled. The cloud computer does not map the local disk. [Default]	off
UsbRedirect	string	No	USB redirection. Valid values: off : Disabled [Default] on : Enabled	off
PrinterRedirect	string	No	The printer redirection policy. This parameter takes effect only if DeviceRedirects does not include a printer redirection policy. Valid values: deviceRedirect : Device redirection [Default] usbRedirect : USB redirection off : Disabled	off
VisualQuality	string	No	The image display quality policy. Valid values: high : High definition low : Smooth lossless : Lossless medium : Automatic rotation [Default]	low
GpuAcceleration	string	No	Specifies whether to enable the image quality policy for graphics-intensive cloud computers. Enable this policy for scenarios such as professional design where high performance and user experience are required. Valid values: off : Disabled on : Enabled	off
Html5FileTransfer	string	No	The file transfer policy for web clients. Valid values: all : Allow upload and download download : Allow download upload : Allow upload off : Disabled [Default]	off
Watermark	string	No	Watermark. Valid values: blind : Enable blind watermark off : Disable watermark [Default] on : Enable visible watermark	off
Name	string	No	The policy name.	testPolicyGroupName
WatermarkType	string	No	The watermark type. You can select up to three types, separated by commas. Note If you set this parameter to `custom`, you must also specify custom text using the `WatermarkCustomText` parameter. Valid values: EndUserId : Username Custom : Custom text DesktopIp : Cloud computer IP address ClientIp : Client IP address HostName : Last 15 digits of the cloud computer ID ClientTime : Current time on the cloud computer	EndUserId
WatermarkCustomText	string	No	If you set `WatermarkType` to `custom`, you must also specify custom text using the `WatermarkCustomText` parameter.	test
WatermarkTransparencyValue	integer	No	Watermark opacity. A higher value means lower transparency. Valid values: 10 to 100.	10
WatermarkSecurity	string	No	Blind watermark security priority rule. Valid values: off : Disabled on : Enabled	off
CameraRedirect	string	No	Local camera redirection. This parameter takes effect only if DeviceRedirects does not include a local camera redirection policy. Valid values: deviceRedirect : Device redirection off : Disabled	on
NetRedirect	string	No	Specifies whether to enable network redirection. Note This feature is in invitational preview and not available to the public. Valid values: all : Enables network redirection globally. off : Disabled [Default] on : Enable whitelist mode	on
AppContentProtection	string	No	Specifies whether to enable anti-screenshot protection. Valid values: off : Disabled [Default] on : Enabled	on
RemoteCoordinate	string	No	Keyboard and mouse control permissions for remote assistance. Valid values: optionalControl : Disabled by default (can be enabled on request) fullControl : Full control disableControl : No control	fullControl
InternetCommunicationProtocol	string	No	Network communication protocol. Valid values: tcp : TCP mode applies when UDP/AST is restricted rtc : AST mode applies to high-frequency audio and video scenarios auto : UTO mode automatically switches between AST and UDP modes based on desktop content both : UDP mode applies to office and high-definition graphic design scenarios	both
VideoRedirect	string	No	Multimedia redirection. Valid values: off : Disabled on : Enabled	on
WatermarkColor	integer	No	Watermark font color. Valid values: 0 to 16777215.	0
WatermarkDegree	number	No	Watermark tilt angle. Valid values: -10 to -30.	-10
WatermarkFontSize	integer	No	Watermark font size. Valid values: 10 to 20.	10
WatermarkFontStyle	string	No	Watermark font style. Valid values: plain : Plain bold : Bold	plain
WatermarkRowAmount	integer	No	Number of watermark rows. Valid values: 3 to 10.	5
CpuProtectedMode	string	No	CPU protection mode switch. Valid values: off : Disabled on : Enabled	off
CpuRateLimit	integer	No	Overall CPU usage percentage. Valid values: 70 to 90.	70
CpuSampleDuration	integer	No	Overall CPU sampling duration. Valid values: 10 to 60. Unit: seconds.	30
CpuSingleRateLimit	integer	No	Single-core CPU usage percentage. Valid values: 70 to 100.	80
CpuDownGradeDuration	integer	No	CPU downclocking duration. Valid values: 30 to 120. Unit: seconds.	50
MemoryProtectedMode	string	No	Memory protection mode switch. Valid values: off : Disabled on : Enabled	off
MemoryRateLimit	integer	No	Overall memory usage percentage. Valid values: 70 to 90.	70
MemorySampleDuration	integer	No	Overall memory sampling duration. Valid values: 30 to 60. Unit: seconds.	40
MemorySingleRateLimit	integer	No	Memory usage per process percentage. Valid values: 30 to 60.	40
MemoryDownGradeDuration	integer	No	Memory downclocking duration per process. Valid values: 30 to 120. Unit: seconds.	40
EndUserApplyAdminCoordinate	string	No	User requests administrator assistance. Valid values: off : Disabled on : Enabled	off
EndUserGroupCoordinate	string	No	Users on the same office network share cloud computers. Valid values: off : Disabled on : Enabled	off
Scope	string	No	The effective scope of the policy. Valid values: IP : Applies to specific IP addresses GLOBAL : Applies globally	GLOBAL
Recording	string	No	Specifies whether to enable screen recording. Valid values: period : Periodic screen recording session : Session-based screen recording off : Disabled alltime : Continuous screen recording	off
RecordingAudio	string	No	Cloud computer audio recording option. Valid values: off : Record video only on : Record system and peripheral audio	on
RecordingStartTime	string	No	Screen recording start time in HH:MM:SS format. This parameter is meaningful only when `Recording` is set to `PERIOD`.	08:00:00
RecordingEndTime	string	No	Screen recording end time in HH:MM:SS format. This parameter is meaningful only when `Recording` is set to `PERIOD`.	08:59:00
RecordingFps	string	No	Screen recording frame rate. Unit: FPS.	5
RecordingDuration	integer	No	Screen recording file viewing duration in minutes. Recording files are automatically split based on the specified duration and uploaded to the storage bucket. When a file reaches 300 MB, it is prioritized for rolling updates. Valid values: 10 to 60.	10
RecordingExpires	integer	No	Retention period of screen recording files. Valid values: 1 to 180 days.	15
RecordingUserNotify	string	No	Notify end users when screen recording is enabled. Valid values: off : Disabled on : Enabled	off
RecordingUserNotifyMessage	string	No	Message to notify end users when screen recording is enabled.	Recording on
AdminAccess	string	No	Specifies whether users have administrator permissions after logging on to cloud computers. Note This feature is in invitational preview and not available to the public. Valid values: allow : Force allow deny : Force deny inherited : Inherit administrator permission control from user dimension	deny
EnableSessionRateLimiting	string	No	Session bandwidth throttling. Valid values: off : Disabled on : Enabled	off
SessionMaxRateKbps	integer	No	Maximum session bandwidth throttling value. Unit: Kbps. Valid values: 2000 to 100000.	2000
DisplayMode	string	No	Display mode. Valid values: clientCustom : User self-configuration adminOffice : Daily office scenario adminDesign : Design and 3D applications adminCustom : Custom	clientCustom
StreamingMode	string	No	Streaming mode adaptation scenario. Valid values: intelligent : Intelligent mode smooth : Smoothness priority	smooth
ColorEnhancement	string	No	Specifies whether to enable color enhancement for design and 3D applications. Valid values: off : Disabled on : Enabled	off
SmoothEnhancement	string	No	Specifies whether to enable smoothness enhancement for daily office scenarios. Valid values: off : Disabled on : Enabled	off
QualityEnhancement	string	No	Specifies whether to enable image quality enhancement for design and 3D applications. Valid values: off : Disabled on : Enabled	off
VideoEncPolicy	string	No	Video encoding policy. Valid values: qualityFirst : Quality priority bandwidthFirst : Bandwidth priority	qualityFirst
TargetFps	integer	No	Target frame rate. Valid values: 10 to 60.	30
VideoEncMinQP	integer	No	Minimum QP for video encoding, representing highest quality. Valid values: 0 to 51.	30
VideoEncMaxQP	integer	No	Maximum QP for video encoding, representing lowest quality. Valid values: 0 to 51.	30
VideoEncAvgKbps	integer	No	Average bitrate for video encoding. Unit: Kbps. Valid values: 1000 to 50000.	2000
VideoEncPeakKbps	integer	No	Peak bitrate for video encoding. Unit: Kbps. Valid values: 1000 to 50000.	2000
MaxReconnectTime	integer	No	Maximum reconnection retry time after an unexpected disconnection. Valid values: 30 to 7200. Unit: seconds.	120
WyAssistant	string	No	Specifies whether to provide the Wuying AI Assistant entry in the cloud computer floating ball when connecting via desktop clients (including Windows and macOS clients). Note This feature applies only to desktop clients of version 7.7 or later. Valid values: off : Disabled on : Enabled	on
WatermarkAntiCam	string	No	Blind watermark anti-photo feature. Valid values: off : Disabled on : Enabled	off
WatermarkPower	string	No	Blind watermark enhancement feature. Valid values: high : High low : Low medium : Medium	medium
CpuProcessors	array	No	The name of the process.
	string	No	Process name.	chrome.exe
MemoryProcessors	array	No	The name of the process.
	string	No	Process name.	notepad.exe
DomainResolveRule	array<object>	No	Domain name resolution policies.
	object	No	Domain name resolution policy.
Domain	string	No	Domain name.	*.example.com
Policy	string	No	Resolution policy. Valid values: allow : Allow block : Deny	allow
Description	string	No	Policy description.	Policy description.
NetRedirectRule	array<object>	No	Network redirection policy details. Note This feature is in invitational preview and not available to the public.
	object	No	Network redirection policy details. Note This feature is in invitational preview and not available to the public.
Domain	string	No	Domain name.	*.example.com
RuleType	string	No	Rule type. Valid values: prc : Process domain : Domain name	domain
Policy	string	No	Redirection policy.	Allow
ScopeValue	array	No	Specify when `Scope` is set to `IP`. Takes effect only when `Scope` is `IP`.
	string	No	Effective CIDR block range.	47.100.XX.XX/24
ClientType	array<object>	No	List of client login control rules. Controls which clients can access cloud computers.
	object	No	Client login control rule.
Status	string	No	Client login control. Specifies whether to allow using a specific client type to log on to cloud computers. Note If you don't configure `ClientType` parameters, all client types are allowed by default. Valid values: off : Not allowed on : Allowed	off
ClientType	string	No	Client login control. Specifies the client type. Valid values: html5 : Web client android : Android client ios : iOS client windows : Windows client macos : macOS client	android
UsbSupplyRedirectRule	array<object>	No	USB redirection rules.
	object	No	USB redirection rule.
VendorId	string	No	Vendor ID. For more information, see Valid USB Vendor IDs (VIDs).	04**
UsbRuleType	string	No	USB redirection rule type. Valid values: 1 : Device vendor	1
Description	string	No	Rule description.	Test rule
UsbRedirectType	string	No	USB redirection type. Valid values: 1 : Allow 2 : Deny	1
ProductId	string	No	Product ID.	08**
AuthorizeSecurityPolicyRule	array<object>	No	List of new security group control rules.
	object	No	Security group control rule list.
Type	string	No	Rule direction for the security group control rule. Valid values: outflow : Outbound inflow : Inbound	inflow
Policy	string	No	Authorization policy for the security group control rule. Valid values: drop : Deny policy. Denies all access requests. No denial message is returned. Requests either time out or fail to establish a connection. accept : Allow policy. Accepts all access requests. [Default]	accept
PortRange	string	No	Port range for the security group control rule. The port range depends on the protocol (IpProtocol): For TCP or UDP protocols: Port range is 1 to 65535. Separate the start and end ports with a forward slash (/). Example: 1/200. For ICMP protocol: Set to -1/-1. For GRE protocol: Set to -1/-1. When IpProtocol is set to all: Set to -1/-1. For more information about common ports for typical applications, see Common ports.	22/22
Description	string	No	Description of the security group control rule.	test
IpProtocol	string	No	Protocol type for the security group control rule. Valid values: TCP : TCP protocol UDP : UDP protocol ALL : Supports all protocols GRE : GRE protocol ICMP : ICMP (IPv4) protocol	TCP
Priority	string	No	Priority of the security group control rule. A smaller number indicates a higher priority. Valid values: 1 to 60. Default value: 1.	1
CidrIp	string	No	Target of the security group control rule. Specify an IPv4 CIDR block.	47.100.XX.XX/16
RevokeSecurityPolicyRule	array<object>	No	List of security group control rules to delete.
	object	No	Security group control rule to delete.
Type	string	No	Rule direction for the security group control rule to delete. Valid values: outflow : Outbound inflow : Inbound	outflow
Policy	string	No	Authorization policy for the security group control rule to delete. Valid values: drop : Deny policy. Denies all access requests. No denial message is returned. Requests either time out or fail to establish a connection. accept : Allow policy. Accepts all access requests. [Default]	accept
PortRange	string	No	Port range for the security group control rule to delete. The port range depends on the protocol (IpProtocol): For TCP or UDP protocols: Port range is 1 to 65535. Separate the start and end ports with a forward slash (/). Example: 1/200. For ICMP protocol: Set to -1/-1. For GRE protocol: Set to -1/-1. When IpProtocol is set to all: Set to -1/-1. For more information about common ports for typical applications, see Common ports.	22/22
Description	string	No	Description of the security group control rule to delete.	test
IpProtocol	string	No	Protocol type for the security group control rule to delete. Valid values: TCP : TCP protocol UDP : UDP protocol ALL : Supports all protocols GRE : GRE protocol ICMP : ICMP (IPv4) protocol	TCP
Priority	string	No	Priority of the security group control rule to delete. A smaller number indicates a higher priority. Valid values: 1 to 60. Default value: 1.	1
CidrIp	string	No	Target of the security group control rule to delete. Specify an IPv4 CIDR block.	47.100.XX.XX/16
AuthorizeAccessPolicyRule	array<object>	No	List of new client IP address whitelists.
	object	No	Client IP address whitelist.
Description	string	No	Description of the client IP address whitelist.	test
CidrIp	string	No	Client access IP address range. Specify an IPv4 CIDr block.	47.100.XX.XX/16
RevokeAccessPolicyRule	array<object>	No	The list of client IP address whitelists to delete.
	object	No	Client IP address whitelist to delete.
Description	string	No	Description of the client IP address whitelist to delete.	test
CidrIp	string	No	Client access IP address range to delete. Specify an IPv4 CIDR block.	47.100.XX.XX/16
DeviceRedirects	array<object>	No	Device redirection rules.
	object	No	List of device redirect rules.
RedirectType	string	No	Redirection type. Valid values: deviceRedirect : Device redirection usbRedirect : USB redirection off : Disabled	deviceRedirect
DeviceType	string	No	Peripheral type. Valid values: printer : Printer scanner : Scanner serialport : Serial port device camera : Camera adb : ADB	camera
DeviceRules	array<object>	No	Custom peripheral rules.
	object	No	List of custom peripheral rules.
DeviceName	string	No	Device name.	sandisk
RedirectType	string	No	Redirection type. Valid values: deviceRedirect : Device redirection usbRedirect : USB redirection off : Prohibited	usbRedirect
DeviceType	string	No	Peripheral type. Valid values: usbKey : UKey other : Other graphicsTablet : Graphics tablet cardReader : Card reader printer : Printer scanner : Scanner storage : Storage device camera : Camera networkInterfaceCard : NIC device	storage
OptCommand	string	No	Link optimization command.	2:0
DevicePid	string	No	Product ID.	0x55b1
DeviceVid	string	No	Vendor ID. For more information, see Valid USB Vendor IDs (VIDs).	0x0781
Platforms	string	No
WatermarkColumnAmount	integer	No	Number of watermark columns. Valid values: 3 to 10.	3
DomainResolveRuleType	string	No	Domain name resolution policy type. Valid values: off : Disabled on : Enabled	off
ClipboardScope	string	No
ClipboardGraineds	array<object>	No
	object	No
GrainedType	string	No
ClipboardType	string	No
ClipboardSize	integer	No
ClipboardSizeUnit	string	No
InClipboardSize	integer	No
InClipboardSizeUnit	string	No
OutClipboardSize	integer	No
OutClipboardSizeUnit	string	No
StatusMonitor	string	No	Specifies whether to provide the status monitoring entry in the cloud computer floating ball. Valid values: off : Disabled on : Enabled	off
MobileRestart	string	No	Specifies whether to provide the Restart button in the cloud computer floating ball when connecting via mobile clients (Android and iOS clients). Note This feature applies only to mobile clients of version 7.4 or later. Valid values: off : Disabled on : Enabled	off
MobileShutdown	string	No	Specifies whether to provide the Shutdown button in the cloud computer floating ball when connecting via mobile clients (Android and iOS clients). Note This feature applies only to mobile clients of version 7.4 or later. Valid values: off : Disabled on : Enabled	off
ResolutionModel	string	No	Resolution type. Valid values: adaptive : Adaptive resolution customer : Fixed resolution	adaptive
ResolutionWidth	integer	No	Resolution width. Unit: pixels. Valid values for cloud applications: 500 to 50000. Valid values for cloud computers: 480 to 4096.	720
ResolutionHeight	integer	No	Resolution height. Unit: pixels. Valid values for cloud applications: 500 to 50000. Valid values for cloud computers: 480 to 4096.	1280
Taskbar	string	No	Application taskbar. Note This parameter applies only to cloud application policies. Valid values: off : Disabled on : Enabled	off
NoOperationDisconnect	string	No	Disconnect on inactivity. Note This parameter applies only to cloud application policies. Valid values: off : Disabled on : Enabled	off
NoOperationDisconnectTime	integer	No	Inactivity disconnect duration. Valid values: 120 to 7200. Unit: seconds. Note This parameter applies only to cloud application policies.	120
DisconnectKeepSession	string	No	Session retention after disconnection. Note This parameter applies only to cloud application policies. Valid values: customTime : Fixed time persistent : Persistent	customTime
DisconnectKeepSessionTime	integer	No	Session retention duration after disconnection. Valid values: 30 to 7200. Unit: seconds. Note This parameter applies only to cloud application policies.	120
RecordEvents	array	No	List of screen recording events.
	string	No	Screen recording event. Valid values: transferWithLocal : Clipboard and file transfer operations userInput : User input usbRedirect : USB peripheral plug and unplug	transferWithLocal
RecordEventFilePaths	array	No	Absolute paths for file monitoring in screen recording audit.
	string	No	Absolute path for file monitoring in screen recording audit.	C://test.txt
RecordEventRegisters	array	No	Absolute paths for registry monitoring in screen recording audit.
	string	No	Absolute path for registry monitoring in screen recording audit.	PC\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\USBSTOR
RecordEventDuration	integer	No	Screen recording duration after an event is detected in audit. Unit: minutes. Valid values: 10 to 60.	10
ResetDesktop	string	No	Reset cloud computer. Valid values: off : Disabled on : Enabled	off
DeviceConnectHint	string	No	Peripheral connection prompt control. Valid values: off : Disabled on : Enabled	off
FileMigrate	string	No	File migration. Valid values: off : Disabled on : Enabled	off
WuyingKeeper	string	No	Wuying Keeper switch. Valid values: off : Disabled on : Enabled	off
InternetPrinter	string	No	Wuying Keeper toggle for mobile devices	off
SafeMenu	string	No	Security button toggle for Windows systems on mobile devices	off
ScreenDisplayMode	string	No	Xiao Ying toggle for mobile devices	off
ClientControlMenu	string	No	Event level for screen recording
FileTransferSpeedLocation	string	No	Screen recording event suffix
FileTransferSpeed	string	No
FileTransferAddress	string	No
CpdDriveClipboard	string	No
UseTime	string	No
AutoReconnect	string	No	Automatically reconnect after disconnection	off
MobileWuyingKeeper	string	No	Wuying Keeper toggle for mobile devices	off
MobileSafeMenu	string	No	The security button toggle for Windows systems on mobile devices	off
MobileWyAssistant	string	No	Mobile Wy Assistant Toggle	off
RecordEventLevels	array<object>	No	Levels of screen recording events
	object	No
EventType	string	No	Event type	StartApplication
EventLevel	string	No	Event level	HIGH
RecordEventFileExts	array	No	File extensions for screen recording events
	string	No		txt
ExternalDrive	string	No
WatermarkShadow	string	No
ClientCreateSnapshot	string	No
AcademicProxy	string	No
ModelLibrary	string	No
PortProxy	string	No
BusinessChannel	string	No
MemoryOverload	string	No
CpuOverload	string	No
DiskOverload	string	No
ResolutionDpi	integer	No
HoverConfigMsg	string	No
MultiScreen	string	No
AdminKeyboardOnWindows	string	No
AdminKeyboardOnFullScreen	string	No
Description	string	No

Response elements

Element	Type	Description	Example
	object	The response structure.
RequestId	string	The request ID.	5CED7F18-43B1-5035-BBB6-2538B***

Examples

Success response

JSON format

{
  "RequestId": "5CED7F18-43B1-5035-BBB6-2538B***"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.