All Products
Search

This Product

    App Streaming:ModifyBrowserInstanceGroup

    Document Center

    App Streaming:ModifyBrowserInstanceGroup

    Last Updated:Dec 17, 2025

    Modifies the properties of the cloud browser.

    Operation description

    Modifies the properties of the cloud browser.

    Debugging

    You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

    Authorization information

    The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

    • Operation: the value that you can use in the Action element to specify the operation on a resource.
    • Access level: the access level of each operation. The levels are read, write, and list.
    • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
      • For mandatory resource types, indicate with a prefix of * .
      • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
    • Condition Key: the condition key that is defined by the cloud service.
    • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
    OperationAccess levelResource typeCondition keyAssociated operation
    appstreaming:CreateAppInstanceGroupupdate
    *All Resources
    *
      none
    		none

    Request parameters

    ParameterTypeRequiredDescriptionExample
    BrowserInstanceGroupIdstringYes

    The ID of the cloud browser to be modified.

    		big-0bz55ixxxxx9xi9w9
    CloudBrowserNamestringNo

    The name of the cloud browser.

    		BrowserTest
    NetworkobjectNo

    The network configurations.

    AccessRestrictionstringNo

    The type of the access control list.

    Valid value:

    • ALLOW_LIST: The whitelist.
    		ALLOW_LIST
    RestrictedURLsarray<object>No

    The domain restriction configurations.

    objectNo

    The restricted domain names.

    URLstringNo

    The restricted domain name.

    		aliyun.com
    RestrictedURLIdstringNo

    The ID of the domain name. This parameter is required only when you want to modify the domain restriction configuration.

    		ru-12345
    RemoveRestrictedURLIdsarrayNo

    The domain names to be removed.

    stringNo

    The ID of the domain name.

    		ru-12345
    PolicyobjectNo

    The access policy.

    ClipboardPolicyobjectNo

    The settings related to clipboard control.

    ClipboardstringNo

    The clipboard policy.

    Valid values:

    • read: Allows copying from the local device to the cloud browser.
    • readwrite: Allows copying in both directions.
    • write: Allows copying from the cloud browser to the local device.
    • off: Blocks copying in both directions.
    		off
    ClipboardScopestringNo

    The clipboard control scope.

    Valid values:

    • grained: fine-grained control
    • global: global control
    		global
    TextClipboardstringNo

    The text clipboard policy.

    Valid values:

    • read: Allows copying from the local device to the cloud browser.
    • readwrite: Allows copying in both directions.
    • write: Allows copying from the cloud browser to the local device.
    • off: Blocks copying in both directions.
    		off
    RichTextClipboardstringNo

    The rich text clipboard policy.

    Valid values:

    • read: Allows copying from the local device to the cloud browser.
    • readwrite: Allows copying in both directions.
    • write: Allows copying from the cloud browser to the local device.
    • off: Blocks copying in both directions.
    		off
    FileClipboardstringNo

    The file clipboard policy.

    Valid values:

    • read: Allows copying from the local device to the cloud browser.
    • readwrite: Allows copying in both directions.
    • write: Allows copying from the cloud browser to the local device.
    • off: Blocks copying in both directions.
    		off
    ClipboardReadLimitintegerNo

    The maximum number of characters allowed when copying from the clipboard.

    		1000
    ClipboardWriteLimitintegerNo

    The maximum number of characters allowed when copying to the clipboard.

    		1000
    VideoPolicyobjectNo

    The display policy.

    FrameRateintegerNo

    The frame rate.

    		60
    WatermarkPolicyobjectNo

    The watermark configuration.

    WatermarkSwitchstringNo

    Specifies whether to enable the watermark.

    Valid values:

    • off
    • on
    		off
    WatermarkTypesarrayNo

    The watermark types.

    stringNo

    The watermark type.

    Valid values:

    • EndUserId: convenience account ID
    • ClientTime: the system time
    • InstanceGroup: browser group ID.
    		EndUserId
    PolicyIdstringNo

    The ID of the policy.

    		pg-12345
    PolicyVersionstringNo

    The policy version.

    Valid value:

    • Center: center policy
    		Center
    DisconnectKeepSessionstringNo

    Defines what happens to a session when a user disconnects.

    Valid values:

    • customTime: The session will be terminated after a custom-defined timeout.
    • persistent: The session will never be automatically terminated..
    		customTime
    DisconnectKeepSessionTimeintegerNo

    The session persistence duration.

    		15
    Html5FileTransferstringNo

    The file transfer policy on the web client.

    		off
    Timersarray<object>No

    The timer.

    objectNo

    The associated scheduled task.

    TimerTypestringNo

    The timer type:

    Valid value:

    • SESSION_TIMEOUT: Defines the timeout period before a disconnected session is terminated.
    		SESSION_TIMEOUT
    IntervalintegerNo

    The interval.

    		15
    BrowserConfigobjectNo

    The browser settings.

    HomepagestringNo

    The home page.

    		https://www.aliyun.com
    BrowserParamstringNo

    The startup parameter.

    		--incognito
    Bookmarksarray<object>No

    The bookmark.

    objectNo

    The description of the associated bookmark.

    BookmarkIdstringNo

    The ID of the bookmark. This parameter needs to be specified only to modify the bookmark.

    		bm-12345
    BookmarkNamestringYes

    The name of the bookmark.

    		test
    BookmarkURLstringYes

    The URL of the bookmark.

    		https://www.aliyun.com
    BookmarkFolderstringNo

    The folder where the bookmark is located.

    		test
    RemoveBookmarksarrayNo

    The removed bookmarks.

    stringNo

    The IDs of the removed bookmarks.

    		bm-12345

    Response parameters

    ParameterTypeDescriptionExample
    object

    Schema of Response

    RequestIdstring

    Id of the request

    		1CBAFFAB-B697-4049-A9B1-67E1FC5F****

    Examples

    Sample success responses

    JSONformat

    {
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****"
}

    Error codes

    For a list of error codes, visit the Service error codes.

    Change history

    Change timeSummary of changesOperation
    2025-10-30The internal configuration of the API is changed, but the call is not affectedView Change Details
    2025-10-20Add OperationView Change Details