Skip to content

Updates the specified fields for the specified stack

Description

Updates the specified fields for the specified stack.

Usage

appstream_update_stack(DisplayName, Description, Name,
  StorageConnectors, DeleteStorageConnectors, RedirectURL, FeedbackURL,
  AttributesToDelete, UserSettings, ApplicationSettings, AccessEndpoints,
  EmbedHostDomains, StreamingExperienceSettings, ContentRedirection,
  AgentAccessConfig)

Arguments

  • DisplayName

    The stack name to display.

  • Description

    The description to display.

  • Name

    [required] The name of the stack.

  • StorageConnectors

    The storage connectors to enable.

  • DeleteStorageConnectors

    Deletes the storage connectors currently enabled for the stack.

  • RedirectURL

    The URL that users are redirected to after their streaming session ends.

  • FeedbackURL

    The URL that users are redirected to after they choose the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.

  • AttributesToDelete

    The stack attributes to delete.

  • UserSettings

    The actions that are enabled or disabled for users during their streaming sessions. By default, these actions are enabled.

  • ApplicationSettings

    The persistent application settings for users of a stack. When these settings are enabled, changes that users make to applications and Windows settings are automatically saved after each session and applied to the next session.

  • AccessEndpoints

    The list of interface VPC endpoint (interface endpoint) objects. Users of the stack can connect to WorkSpaces Applications only through the specified endpoints.

  • EmbedHostDomains

    The domains where WorkSpaces Applications streaming sessions can be embedded in an iframe. You must approve the domains that you want to host embedded WorkSpaces Applications streaming sessions.

  • StreamingExperienceSettings

    The streaming protocol you want your stack to prefer. This can be UDP or TCP. Currently, UDP is only supported in the Windows native client.

  • ContentRedirection

    Configuration for bidirectional URL redirection between the streaming session and the local client. Use HostToClient to redirect URLs from the remote desktop to the local browser.

  • AgentAccessConfig

    The configuration for agent access on the stack. Specify this to update agent access settings. To remove agent access, use AttributesToDelete with the AGENT_ACCESS_CONFIG value.

Value

A list with the following syntax:

list(
  Stack = list(
    Arn = "string",
    Name = "string",
    Description = "string",
    DisplayName = "string",
    CreatedTime = as.POSIXct(
      "2015-01-01"
    ),
    StorageConnectors = list(
      list(
        ConnectorType = "HOMEFOLDERS"|"GOOGLE_DRIVE"|"ONE_DRIVE",
        ResourceIdentifier = "string",
        Domains = list(
          "string"
        ),
        DomainsRequireAdminConsent = list(
          "string"
        )
      )
    ),
    RedirectURL = "string",
    FeedbackURL = "string",
    StackErrors = list(
      list(
        ErrorCode = "STORAGE_CONNECTOR_ERROR"|"INTERNAL_SERVICE_ERROR",
        ErrorMessage = "string"
      )
    ),
    UserSettings = list(
      list(
        Action = "CLIPBOARD_COPY_FROM_LOCAL_DEVICE"|"CLIPBOARD_COPY_TO_LOCAL_DEVICE"|"FILE_UPLOAD"|"FILE_DOWNLOAD"|"PRINTING_TO_LOCAL_DEVICE"|"DOMAIN_PASSWORD_SIGNIN"|"DOMAIN_SMART_CARD_SIGNIN"|"AUTO_TIME_ZONE_REDIRECTION",
        Permission = "ENABLED"|"DISABLED",
        MaximumLength = 123
      )
    ),
    ApplicationSettings = list(
      Enabled = TRUE|FALSE,
      SettingsGroup = "string",
      S3BucketName = "string"
    ),
    AccessEndpoints = list(
      list(
        EndpointType = "STREAMING",
        VpceId = "string"
      )
    ),
    EmbedHostDomains = list(
      "string"
    ),
    StreamingExperienceSettings = list(
      PreferredProtocol = "TCP"|"UDP"
    ),
    ContentRedirection = list(
      HostToClient = list(
        Enabled = TRUE|FALSE,
        AllowedUrls = list(
          "string"
        ),
        DeniedUrls = list(
          "string"
        )
      )
    ),
    AgentAccessConfig = list(
      Settings = list(
        list(
          AgentAction = "COMPUTER_VISION"|"COMPUTER_INPUT"|"FORWARD_MCP_TOOLS",
          Permission = "ENABLED"|"DISABLED"
        )
      ),
      S3BucketArn = "string",
      ScreenshotsUploadEnabled = TRUE|FALSE,
      ScreenResolution = "W_1280xH_720",
      ScreenImageFormat = "PNG"|"JPEG",
      UserControlMode = "VIEW_ONLY"|"VIEW_STOP"|"DISABLED"
    )
  )
)

Request syntax

svc$update_stack(
  DisplayName = "string",
  Description = "string",
  Name = "string",
  StorageConnectors = list(
    list(
      ConnectorType = "HOMEFOLDERS"|"GOOGLE_DRIVE"|"ONE_DRIVE",
      ResourceIdentifier = "string",
      Domains = list(
        "string"
      ),
      DomainsRequireAdminConsent = list(
        "string"
      )
    )
  ),
  DeleteStorageConnectors = TRUE|FALSE,
  RedirectURL = "string",
  FeedbackURL = "string",
  AttributesToDelete = list(
    "STORAGE_CONNECTORS"|"STORAGE_CONNECTOR_HOMEFOLDERS"|"STORAGE_CONNECTOR_GOOGLE_DRIVE"|"STORAGE_CONNECTOR_ONE_DRIVE"|"REDIRECT_URL"|"FEEDBACK_URL"|"THEME_NAME"|"USER_SETTINGS"|"EMBED_HOST_DOMAINS"|"IAM_ROLE_ARN"|"ACCESS_ENDPOINTS"|"STREAMING_EXPERIENCE_SETTINGS"|"CONTENT_REDIRECTION"|"AGENT_ACCESS_CONFIG"
  ),
  UserSettings = list(
    list(
      Action = "CLIPBOARD_COPY_FROM_LOCAL_DEVICE"|"CLIPBOARD_COPY_TO_LOCAL_DEVICE"|"FILE_UPLOAD"|"FILE_DOWNLOAD"|"PRINTING_TO_LOCAL_DEVICE"|"DOMAIN_PASSWORD_SIGNIN"|"DOMAIN_SMART_CARD_SIGNIN"|"AUTO_TIME_ZONE_REDIRECTION",
      Permission = "ENABLED"|"DISABLED",
      MaximumLength = 123
    )
  ),
  ApplicationSettings = list(
    Enabled = TRUE|FALSE,
    SettingsGroup = "string"
  ),
  AccessEndpoints = list(
    list(
      EndpointType = "STREAMING",
      VpceId = "string"
    )
  ),
  EmbedHostDomains = list(
    "string"
  ),
  StreamingExperienceSettings = list(
    PreferredProtocol = "TCP"|"UDP"
  ),
  ContentRedirection = list(
    HostToClient = list(
      Enabled = TRUE|FALSE,
      AllowedUrls = list(
        "string"
      ),
      DeniedUrls = list(
        "string"
      )
    )
  ),
  AgentAccessConfig = list(
    Settings = list(
      list(
        AgentAction = "COMPUTER_VISION"|"COMPUTER_INPUT"|"FORWARD_MCP_TOOLS",
        Permission = "ENABLED"|"DISABLED"
      )
    ),
    S3BucketArn = "string",
    ScreenshotsUploadEnabled = TRUE|FALSE,
    ScreenResolution = "W_1280xH_720",
    ScreenImageFormat = "PNG"|"JPEG",
    UserControlMode = "VIEW_ONLY"|"VIEW_STOP"|"DISABLED"
  )
)