Note:

You are viewing the documentation for an older major version of the AWS CLI (version 1).

AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.

[ aws . appstream ]

create-theme-for-stack

Description

Creates custom branding that customizes the appearance of the streaming application catalog page.

See also: AWS API Documentation

Synopsis

  create-theme-for-stack
--stack-name <value>
[--footer-links <value>]
--title-text <value>
--theme-styling <value>
--organization-logo-s3-location <value>
--favicon-s3-location <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]

Options

--stack-name (string)

The name of the stack for the theme.

--footer-links (list)

The links that are displayed in the footer of the streaming application catalog page. These links are helpful resources for users, such as the organization's IT support and product marketing sites.

(structure)

The website links that display in the catalog page footer.

DisplayName -> (string)

The name of the websites that display in the catalog page footer.

FooterLinkURL -> (string)

The URL of the websites that display in the catalog page footer.

Shorthand Syntax:

DisplayName=string,FooterLinkURL=string ...

JSON Syntax:

[
  {
    "DisplayName": "string",
    "FooterLinkURL": "string"
  }
  ...
]

--title-text (string)

The title that is displayed at the top of the browser tab during users' application streaming sessions.

--theme-styling (string)

The color theme that is applied to website links, text, and buttons. These colors are also applied as accents in the background for the streaming application catalog page.

Possible values:

• LIGHT_BLUE
• BLUE
• PINK
• RED

--organization-logo-s3-location (structure)

The organization logo that appears on the streaming application catalog page.

S3Bucket -> (string)

The S3 bucket of the S3 object.

S3Key -> (string)

The S3 key of the S3 object.

This is required when used for the following:

• IconS3Location (Actions: CreateApplication and UpdateApplication)
• SessionScriptS3Location (Actions: CreateFleet and UpdateFleet)
• ScriptDetails (Actions: CreateAppBlock)
• SourceS3Location when creating an app block with CUSTOM PackagingType (Actions: CreateAppBlock)
• SourceS3Location when creating an app block with APPSTREAM2 PackagingType, and using an existing application package (VHD file). In this case, S3Key refers to the VHD file. If a new application package is required, then S3Key is not required. (Actions: CreateAppBlock)

Shorthand Syntax:

S3Bucket=string,S3Key=string

JSON Syntax:

{
  "S3Bucket": "string",
  "S3Key": "string"
}

--favicon-s3-location (structure)

The S3 location of the favicon. The favicon enables users to recognize their application streaming site in a browser full of tabs or bookmarks. It is displayed at the top of the browser tab for the application streaming site during users' streaming sessions.

S3Bucket -> (string)

The S3 bucket of the S3 object.

S3Key -> (string)

The S3 key of the S3 object.

This is required when used for the following:

• IconS3Location (Actions: CreateApplication and UpdateApplication)
• SessionScriptS3Location (Actions: CreateFleet and UpdateFleet)
• ScriptDetails (Actions: CreateAppBlock)
• SourceS3Location when creating an app block with CUSTOM PackagingType (Actions: CreateAppBlock)
• SourceS3Location when creating an app block with APPSTREAM2 PackagingType, and using an existing application package (VHD file). In this case, S3Key refers to the VHD file. If a new application package is required, then S3Key is not required. (Actions: CreateAppBlock)

Shorthand Syntax:

S3Bucket=string,S3Key=string

JSON Syntax:

{
  "S3Bucket": "string",
  "S3Key": "string"
}

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

Global Options

--debug (boolean)

Turn on debug logging.

--endpoint-url (string)

Override command's default URL with the given URL.

--no-verify-ssl (boolean)

By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.

--no-paginate (boolean)

Disable automatic pagination. If automatic pagination is disabled, the AWS CLI will only make one call, for the first page of results.

--output (string)

The formatting style for command output.

• json
• text
• table

--query (string)

A JMESPath query to use in filtering the response data.

--profile (string)

Use a specific profile from your credential file.

--region (string)

The region to use. Overrides config/env settings.

--version (string)

Display the version of this tool.

--color (string)

Turn on/off color output.

• on
• off
• auto

--no-sign-request (boolean)

Do not sign requests. Credentials will not be loaded if this argument is provided.

--ca-bundle (string)

The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.

--cli-read-timeout (int)

The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.

--cli-connect-timeout (int)

The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.

Output

Theme -> (structure)

The theme object that contains the metadata of the custom branding.

StackName -> (string)

The stack that has the custom branding theme.

State -> (string)

The state of the theme.

ThemeTitleText -> (string)

The browser tab page title.

ThemeStyling -> (string)

The color that is used for the website links, text, buttons, and catalog page background.

ThemeFooterLinks -> (list)

The website links that display in the catalog page footer.

(structure)

The website links that display in the catalog page footer.

DisplayName -> (string)

The name of the websites that display in the catalog page footer.

FooterLinkURL -> (string)

The URL of the websites that display in the catalog page footer.

ThemeOrganizationLogoURL -> (string)

The URL of the logo that displays in the catalog page header.

ThemeFaviconURL -> (string)

The URL of the icon that displays at the top of a user's browser tab during streaming sessions.

CreatedTime -> (timestamp)

The time the theme was created.