CreateThemeForStackCommand

Suggest an Edit

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

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { AppStreamClient, CreateThemeForStackCommand } from "@aws-sdk/client-appstream"; // ES Modules import
// const { AppStreamClient, CreateThemeForStackCommand } = require("@aws-sdk/client-appstream"); // CommonJS import
const client = new AppStreamClient(config);
const input = { // CreateThemeForStackRequest
  StackName: "STRING_VALUE", // required
  FooterLinks: [ // ThemeFooterLinks
    { // ThemeFooterLink
      DisplayName: "STRING_VALUE",
      FooterLinkURL: "STRING_VALUE",
    },
  ],
  TitleText: "STRING_VALUE", // required
  ThemeStyling: "LIGHT_BLUE" || "BLUE" || "PINK" || "RED", // required
  OrganizationLogoS3Location: { // S3Location
    S3Bucket: "STRING_VALUE", // required
    S3Key: "STRING_VALUE",
  },
  FaviconS3Location: {
    S3Bucket: "STRING_VALUE", // required
    S3Key: "STRING_VALUE",
  },
};
const command = new CreateThemeForStackCommand(input);
const response = await client.send(command);
// { // CreateThemeForStackResult
//   Theme: { // Theme
//     StackName: "STRING_VALUE",
//     State: "ENABLED" || "DISABLED",
//     ThemeTitleText: "STRING_VALUE",
//     ThemeStyling: "LIGHT_BLUE" || "BLUE" || "PINK" || "RED",
//     ThemeFooterLinks: [ // ThemeFooterLinks
//       { // ThemeFooterLink
//         DisplayName: "STRING_VALUE",
//         FooterLinkURL: "STRING_VALUE",
//       },
//     ],
//     ThemeOrganizationLogoURL: "STRING_VALUE",
//     ThemeFaviconURL: "STRING_VALUE",
//     CreatedTime: new Date("TIMESTAMP"),
//   },
// };

CreateThemeForStackCommand Input

See CreateThemeForStackCommandInput for more details

Parameter
Type
Description
FaviconS3Location
Required
S3Location | undefined

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.

OrganizationLogoS3Location
Required
S3Location | undefined

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

StackName
Required
string | undefined

The name of the stack for the theme.

ThemeStyling
Required
ThemeStyling | undefined

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.

TitleText
Required
string | undefined

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

FooterLinks
ThemeFooterLink[] | undefined

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.

CreateThemeForStackCommand Output

See CreateThemeForStackCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
Theme
Theme | undefined

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

Throws

Name
Fault
Details
ConcurrentModificationException
client

An API error occurred. Wait a few minutes and try again.

InvalidAccountStatusException
client

The resource cannot be created because your AWS account is suspended. For assistance, contact AWS Support.

LimitExceededException
client

The requested limit exceeds the permitted limit for an account.

OperationNotPermittedException
client

The attempted operation is not permitted.

ResourceAlreadyExistsException
client

The specified resource already exists.

ResourceNotFoundException
client

The specified resource was not found.

AppStreamServiceException
Base exception class for all service exceptions from AppStream service.