AppStream / Client / describe_image_permissions

describe_image_permissions#

AppStream.Client.describe_image_permissions(**kwargs)#

Retrieves a list that describes the permissions for shared AWS account IDs on a private image that you own.

See also: AWS API Documentation

Request Syntax

response = client.describe_image_permissions(
    Name='string',
    MaxResults=123,
    SharedAwsAccountIds=[
        'string',
    ],
    NextToken='string'
)
Parameters:
  • Name (string) –

    [REQUIRED]

    The name of the private image for which to describe permissions. The image must be one that you own.

  • MaxResults (integer) – The maximum size of each page of results.

  • SharedAwsAccountIds (list) –

    The 12-digit identifier of one or more AWS accounts with which the image is shared.

    • (string) –

  • NextToken (string) – 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.

Return type:

dict

Returns:

Response Syntax

{
    'Name': 'string',
    'SharedImagePermissionsList': [
        {
            'sharedAccountId': 'string',
            'imagePermissions': {
                'allowFleet': True|False,
                'allowImageBuilder': True|False
            }
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • Name (string) –

      The name of the private image.

    • SharedImagePermissionsList (list) –

      The permissions for a private image that you own.

      • (dict) –

        Describes the permissions that are available to the specified AWS account for a shared image.

        • sharedAccountId (string) –

          The 12-digit identifier of the AWS account with which the image is shared.

        • imagePermissions (dict) –

          Describes the permissions for a shared image.

          • allowFleet (boolean) –

            Indicates whether the image can be used for a fleet.

          • allowImageBuilder (boolean) –

            Indicates whether the image can be used for an image builder.

    • 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.

Exceptions

  • AppStream.Client.exceptions.ResourceNotFoundException