WorkSpaces / Client / describe_workspace_image_permissions

describe_workspace_image_permissions#

WorkSpaces.Client.describe_workspace_image_permissions(**kwargs)#

Describes the permissions that the owner of an image has granted to other Amazon Web Services accounts for an image.

See also: AWS API Documentation

Request Syntax

response = client.describe_workspace_image_permissions(
    ImageId='string',
    NextToken='string',
    MaxResults=123
)

Parameters:

ImageId (string) –
[REQUIRED]

The identifier of the image.
NextToken (string) – If you received a NextToken from a previous call that was paginated, provide this token to receive the next set of results.
MaxResults (integer) – The maximum number of items to return.

Return type:

dict

Returns:

Response Syntax

{
    'ImageId': 'string',
    'ImagePermissions': [
        {
            'SharedAccountId': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

(dict) –
- ImageId (string) –
  
  The identifier of the image.
- ImagePermissions (list) –
  
  The identifiers of the Amazon Web Services accounts that the image has been shared with.
  - (dict) –
    
    Describes the Amazon Web Services accounts that have been granted permission to use a shared image. For more information about sharing images, see Share or Unshare a Custom WorkSpaces Image.
    - SharedAccountId (string) –
      
      The identifier of the Amazon Web Services account that an image has been shared with.
- NextToken (string) –
  
  The token to use to retrieve the next page of results. This value is null when there are no more results to return.

Exceptions

WorkSpaces.Client.exceptions.ResourceNotFoundException
WorkSpaces.Client.exceptions.AccessDeniedException
WorkSpaces.Client.exceptions.InvalidParameterValuesException