AWS API Changes

2018/07/10 - Amazon AppStream - 4 updated api methods

Changes Update appstream client to latest version

CreateStack (updated)

Link ¶
Changes (request, response)
Request

{'StorageConnectors': {'ConnectorType': {'ONE_DRIVE'}}}

Response

{'Stack': {'StorageConnectors': {'ConnectorType': {'ONE_DRIVE'}}}}

Creates a stack to start streaming applications to users. A stack consists of an associated fleet, user access policies, and storage configurations.

See also: AWS API Documentation

Request Syntax

client.create_stack(
    Name='string',
    Description='string',
    DisplayName='string',
    StorageConnectors=[
        {
            'ConnectorType': 'HOMEFOLDERS'|'GOOGLE_DRIVE'|'ONE_DRIVE',
            'ResourceIdentifier': 'string',
            'Domains': [
                'string',
            ]
        },
    ],
    RedirectURL='string',
    FeedbackURL='string',
    UserSettings=[
        {
            'Action': 'CLIPBOARD_COPY_FROM_LOCAL_DEVICE'|'CLIPBOARD_COPY_TO_LOCAL_DEVICE'|'FILE_UPLOAD'|'FILE_DOWNLOAD'|'PRINTING_TO_LOCAL_DEVICE',
            'Permission': 'ENABLED'|'DISABLED'
        },
    ]
)

type Name:

string

param Name:

[REQUIRED]

The name of the stack.

type Description:

string

param Description:

The description for display.

type DisplayName:

string

param DisplayName:

The stack name for display.

type StorageConnectors:

list

param StorageConnectors:

The storage connectors to enable.

(dict) --

Describes a connector to enable persistent storage for users.
- ConnectorType (string) -- [REQUIRED]
  
  The type of storage connector.
- ResourceIdentifier (string) --
  
  The ARN of the storage connector.
- Domains (list) --
  
  The names of the domains for the G Suite account.
  - (string) -- GSuite domain for GDrive integration.

type RedirectURL:

string

param RedirectURL:

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

type FeedbackURL:

string

param FeedbackURL:

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

type UserSettings:

list

param UserSettings:

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

(dict) --

Describes an action and whether the action is enabled or disabled for users during their streaming sessions.
- Action (string) -- [REQUIRED]
  
  The action that is enabled or disabled.
- Permission (string) -- [REQUIRED]
  
  Indicates whether the action is enabled or disabled.

rtype:

dict

returns:

Response Syntax

{
    'Stack': {
        'Arn': 'string',
        'Name': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'StorageConnectors': [
            {
                'ConnectorType': 'HOMEFOLDERS'|'GOOGLE_DRIVE'|'ONE_DRIVE',
                'ResourceIdentifier': 'string',
                'Domains': [
                    'string',
                ]
            },
        ],
        'RedirectURL': 'string',
        'FeedbackURL': 'string',
        'StackErrors': [
            {
                'ErrorCode': 'STORAGE_CONNECTOR_ERROR'|'INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string'
            },
        ],
        'UserSettings': [
            {
                'Action': 'CLIPBOARD_COPY_FROM_LOCAL_DEVICE'|'CLIPBOARD_COPY_TO_LOCAL_DEVICE'|'FILE_UPLOAD'|'FILE_DOWNLOAD'|'PRINTING_TO_LOCAL_DEVICE',
                'Permission': 'ENABLED'|'DISABLED'
            },
        ]
    }
}

Response Structure

(dict) --
- Stack (dict) --
  
  Information about the stack.
  - Arn (string) --
    
    The ARN of the stack.
  - Name (string) --
    
    The name of the stack.
  - Description (string) --
    
    The description for display.
  - DisplayName (string) --
    
    The stack name for display.
  - CreatedTime (datetime) --
    
    The time the stack was created.
  - StorageConnectors (list) --
    
    The storage connectors to enable.
    - (dict) --
      
      Describes a connector to enable persistent storage for users.
      - ConnectorType (string) --
        
        The type of storage connector.
      - ResourceIdentifier (string) --
        
        The ARN of the storage connector.
      - Domains (list) --
        
        The names of the domains for the G Suite account.
        
        (string) -- GSuite domain for GDrive integration.
  - RedirectURL (string) --
    
    The URL that users are redirected to after their streaming session ends.
  - FeedbackURL (string) --
    
    The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.
  - StackErrors (list) --
    
    The errors for the stack.
    - (dict) --
      
      Describes a stack error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
  - UserSettings (list) --
    
    The actions that are enabled or disabled for users during their streaming sessions. By default these actions are enabled.
    - (dict) --
      
      Describes an action and whether the action is enabled or disabled for users during their streaming sessions.
      - Action (string) --
        
        The action that is enabled or disabled.
      - Permission (string) --
        
        Indicates whether the action is enabled or disabled.

DescribeImages (updated)

Link ¶
Changes (request, response)
Request

{'MaxResults': 'integer', 'NextToken': 'string'}

Response

{'NextToken': 'string'}

Retrieves a list that describes one or more specified images, if the image names are provided. Otherwise, all images in the account are described.

See also: AWS API Documentation

Request Syntax

client.describe_images(
    Names=[
        'string',
    ],
    NextToken='string',
    MaxResults=123
)

type Names:

list

param Names:

The names of the images to describe.

(string) --

type NextToken:

string

param NextToken:

The pagination token to use to retrieve the next page of results. If this value is empty, only the first page is retrieved.

type MaxResults:

integer

param MaxResults:

The maximum size of each results page.

rtype:

dict

returns:

Response Syntax

{
    'Images': [
        {
            'Name': 'string',
            'Arn': 'string',
            'BaseImageArn': 'string',
            'DisplayName': 'string',
            'State': 'PENDING'|'AVAILABLE'|'FAILED'|'COPYING'|'DELETING',
            'Visibility': 'PUBLIC'|'PRIVATE',
            'ImageBuilderSupported': True|False,
            'Platform': 'WINDOWS',
            'Description': 'string',
            'StateChangeReason': {
                'Code': 'INTERNAL_ERROR'|'IMAGE_BUILDER_NOT_AVAILABLE'|'IMAGE_COPY_FAILURE',
                'Message': 'string'
            },
            'Applications': [
                {
                    'Name': 'string',
                    'DisplayName': 'string',
                    'IconURL': 'string',
                    'LaunchPath': 'string',
                    'LaunchParameters': 'string',
                    'Enabled': True|False,
                    'Metadata': {
                        'string': 'string'
                    }
                },
            ],
            'CreatedTime': datetime(2015, 1, 1),
            'PublicBaseImageReleasedDate': datetime(2015, 1, 1),
            'AppstreamAgentVersion': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- Images (list) --
  
  Information about the images.
  - (dict) --
    
    Describes an image.
    - Name (string) --
      
      The name of the image.
    - Arn (string) --
      
      The ARN of the image.
    - BaseImageArn (string) --
      
      The ARN of the image from which this image was created.
    - DisplayName (string) --
      
      The image name for display.
    - State (string) --
      
      The image starts in the PENDING state. If image creation succeeds, the state is AVAILABLE. If image creation fails, the state is FAILED.
    - Visibility (string) --
      
      Indicates whether the image is public or private.
    - ImageBuilderSupported (boolean) --
      
      Indicates whether an image builder can be launched from this image.
    - Platform (string) --
      
      The operating system platform of the image.
    - Description (string) --
      
      The description for display.
    - StateChangeReason (dict) --
      
      The reason why the last state change occurred.
      - Code (string) --
        
        The state change reason code.
      - Message (string) --
        
        The state change reason message.
    - Applications (list) --
      
      The applications associated with the image.
      - (dict) --
        
        Describes an application in the application catalog.
        
        Name (string) --
        
        The name of the application.
        
        DisplayName (string) --
        
        The application name for display.
        
        IconURL (string) --
        
        The URL for the application icon. This URL might be time-limited.
        
        LaunchPath (string) --
        
        The path to the application executable in the instance.
        
        LaunchParameters (string) --
        
        The arguments that are passed to the application at launch.
        
        Enabled (boolean) --
        
        If there is a problem, the application can be disabled after image creation.
        
        Metadata (dict) --
        
        Additional attributes that describe the application.
        
        (string) --
        
        (string) --
    - CreatedTime (datetime) --
      
      The time the image was created.
    - PublicBaseImageReleasedDate (datetime) --
      
      The release date of the public base image. For private images, this date is the release date of the base image from which the image was created.
    - AppstreamAgentVersion (string) --
      
      The version of the AppStream 2.0 agent to use for instances that are launched from this image.
- NextToken (string) --
  
  The pagination token used to retrieve the next page of results. If this value is empty, only the first page is retrieved.

DescribeStacks (updated)

Link ¶
Changes (response)

{'Stacks': {'StorageConnectors': {'ConnectorType': {'ONE_DRIVE'}}}}

Retrieves a list that describes one or more specified stacks, if the stack names are provided. Otherwise, all stacks in the account are described.

See also: AWS API Documentation

Request Syntax

client.describe_stacks(
    Names=[
        'string',
    ],
    NextToken='string'
)

type Names:

list

param Names:

The names of the stacks to describe.

(string) --

type NextToken:

string

param NextToken:

The pagination token to use to retrieve the next page of results for this operation. If this value is null, it retrieves the first page.

rtype:

dict

returns:

Response Syntax

{
    'Stacks': [
        {
            'Arn': 'string',
            'Name': 'string',
            'Description': 'string',
            'DisplayName': 'string',
            'CreatedTime': datetime(2015, 1, 1),
            'StorageConnectors': [
                {
                    'ConnectorType': 'HOMEFOLDERS'|'GOOGLE_DRIVE'|'ONE_DRIVE',
                    'ResourceIdentifier': 'string',
                    'Domains': [
                        'string',
                    ]
                },
            ],
            'RedirectURL': 'string',
            'FeedbackURL': 'string',
            'StackErrors': [
                {
                    'ErrorCode': 'STORAGE_CONNECTOR_ERROR'|'INTERNAL_SERVICE_ERROR',
                    'ErrorMessage': 'string'
                },
            ],
            'UserSettings': [
                {
                    'Action': 'CLIPBOARD_COPY_FROM_LOCAL_DEVICE'|'CLIPBOARD_COPY_TO_LOCAL_DEVICE'|'FILE_UPLOAD'|'FILE_DOWNLOAD'|'PRINTING_TO_LOCAL_DEVICE',
                    'Permission': 'ENABLED'|'DISABLED'
                },
            ]
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) --
- Stacks (list) --
  
  Information about the stacks.
  - (dict) --
    
    Describes a stack.
    - Arn (string) --
      
      The ARN of the stack.
    - Name (string) --
      
      The name of the stack.
    - Description (string) --
      
      The description for display.
    - DisplayName (string) --
      
      The stack name for display.
    - CreatedTime (datetime) --
      
      The time the stack was created.
    - StorageConnectors (list) --
      
      The storage connectors to enable.
      - (dict) --
        
        Describes a connector to enable persistent storage for users.
        
        ConnectorType (string) --
        
        The type of storage connector.
        
        ResourceIdentifier (string) --
        
        The ARN of the storage connector.
        
        Domains (list) --
        
        The names of the domains for the G Suite account.
        
        (string) -- GSuite domain for GDrive integration.
    - RedirectURL (string) --
      
      The URL that users are redirected to after their streaming session ends.
    - FeedbackURL (string) --
      
      The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.
    - StackErrors (list) --
      
      The errors for the stack.
      - (dict) --
        
        Describes a stack error.
        
        ErrorCode (string) --
        
        The error code.
        
        ErrorMessage (string) --
        
        The error message.
    - UserSettings (list) --
      
      The actions that are enabled or disabled for users during their streaming sessions. By default these actions are enabled.
      - (dict) --
        
        Describes an action and whether the action is enabled or disabled for users during their streaming sessions.
        
        Action (string) --
        
        The action that is enabled or disabled.
        
        Permission (string) --
        
        Indicates whether the action is enabled or disabled.
- NextToken (string) --
  
  The pagination token to use to retrieve the next page of results for this operation. If there are no more pages, this value is null.

UpdateStack (updated)

Link ¶
Changes (request, response)
Request

{'AttributesToDelete': {'STORAGE_CONNECTOR_ONE_DRIVE'},
 'StorageConnectors': {'ConnectorType': {'ONE_DRIVE'}}}

Response

{'Stack': {'StorageConnectors': {'ConnectorType': {'ONE_DRIVE'}}}}

Updates the specified fields for the specified stack.

See also: AWS API Documentation

Request Syntax

client.update_stack(
    DisplayName='string',
    Description='string',
    Name='string',
    StorageConnectors=[
        {
            'ConnectorType': 'HOMEFOLDERS'|'GOOGLE_DRIVE'|'ONE_DRIVE',
            'ResourceIdentifier': 'string',
            'Domains': [
                'string',
            ]
        },
    ],
    DeleteStorageConnectors=True|False,
    RedirectURL='string',
    FeedbackURL='string',
    AttributesToDelete=[
        'STORAGE_CONNECTORS'|'STORAGE_CONNECTOR_HOMEFOLDERS'|'STORAGE_CONNECTOR_GOOGLE_DRIVE'|'STORAGE_CONNECTOR_ONE_DRIVE'|'REDIRECT_URL'|'FEEDBACK_URL'|'THEME_NAME'|'USER_SETTINGS',
    ],
    UserSettings=[
        {
            'Action': 'CLIPBOARD_COPY_FROM_LOCAL_DEVICE'|'CLIPBOARD_COPY_TO_LOCAL_DEVICE'|'FILE_UPLOAD'|'FILE_DOWNLOAD'|'PRINTING_TO_LOCAL_DEVICE',
            'Permission': 'ENABLED'|'DISABLED'
        },
    ]
)

type DisplayName:

string

param DisplayName:

The stack name for display.

type Description:

string

param Description:

The description for display.

type Name:

string

param Name:

[REQUIRED]

The name of the stack.

type StorageConnectors:

list

param StorageConnectors:

The storage connectors to enable.

(dict) --

Describes a connector to enable persistent storage for users.
- ConnectorType (string) -- [REQUIRED]
  
  The type of storage connector.
- ResourceIdentifier (string) --
  
  The ARN of the storage connector.
- Domains (list) --
  
  The names of the domains for the G Suite account.
  - (string) -- GSuite domain for GDrive integration.

type DeleteStorageConnectors:

boolean

param DeleteStorageConnectors:

Deletes the storage connectors currently enabled for the stack.

type RedirectURL:

string

param RedirectURL:

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

type FeedbackURL:

string

param FeedbackURL:

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

type AttributesToDelete:

list

param AttributesToDelete:

The stack attributes to delete.

(string) --

type UserSettings:

list

param UserSettings:

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

(dict) --

Describes an action and whether the action is enabled or disabled for users during their streaming sessions.
- Action (string) -- [REQUIRED]
  
  The action that is enabled or disabled.
- Permission (string) -- [REQUIRED]
  
  Indicates whether the action is enabled or disabled.

rtype:

dict

returns:

Response Syntax

{
    'Stack': {
        'Arn': 'string',
        'Name': 'string',
        'Description': 'string',
        'DisplayName': 'string',
        'CreatedTime': datetime(2015, 1, 1),
        'StorageConnectors': [
            {
                'ConnectorType': 'HOMEFOLDERS'|'GOOGLE_DRIVE'|'ONE_DRIVE',
                'ResourceIdentifier': 'string',
                'Domains': [
                    'string',
                ]
            },
        ],
        'RedirectURL': 'string',
        'FeedbackURL': 'string',
        'StackErrors': [
            {
                'ErrorCode': 'STORAGE_CONNECTOR_ERROR'|'INTERNAL_SERVICE_ERROR',
                'ErrorMessage': 'string'
            },
        ],
        'UserSettings': [
            {
                'Action': 'CLIPBOARD_COPY_FROM_LOCAL_DEVICE'|'CLIPBOARD_COPY_TO_LOCAL_DEVICE'|'FILE_UPLOAD'|'FILE_DOWNLOAD'|'PRINTING_TO_LOCAL_DEVICE',
                'Permission': 'ENABLED'|'DISABLED'
            },
        ]
    }
}

Response Structure

(dict) --
- Stack (dict) --
  
  Information about the stack.
  - Arn (string) --
    
    The ARN of the stack.
  - Name (string) --
    
    The name of the stack.
  - Description (string) --
    
    The description for display.
  - DisplayName (string) --
    
    The stack name for display.
  - CreatedTime (datetime) --
    
    The time the stack was created.
  - StorageConnectors (list) --
    
    The storage connectors to enable.
    - (dict) --
      
      Describes a connector to enable persistent storage for users.
      - ConnectorType (string) --
        
        The type of storage connector.
      - ResourceIdentifier (string) --
        
        The ARN of the storage connector.
      - Domains (list) --
        
        The names of the domains for the G Suite account.
        
        (string) -- GSuite domain for GDrive integration.
  - RedirectURL (string) --
    
    The URL that users are redirected to after their streaming session ends.
  - FeedbackURL (string) --
    
    The URL that users are redirected to after they click the Send Feedback link. If no URL is specified, no Send Feedback link is displayed.
  - StackErrors (list) --
    
    The errors for the stack.
    - (dict) --
      
      Describes a stack error.
      - ErrorCode (string) --
        
        The error code.
      - ErrorMessage (string) --
        
        The error message.
  - UserSettings (list) --
    
    The actions that are enabled or disabled for users during their streaming sessions. By default these actions are enabled.
    - (dict) --
      
      Describes an action and whether the action is enabled or disabled for users during their streaming sessions.
      - Action (string) --
        
        The action that is enabled or disabled.
      - Permission (string) --
        
        Indicates whether the action is enabled or disabled.