Describe Images

appstream_describe_images

R Documentation

Retrieves a list that describes one or more specified images, if the image names or image ARNs are provided

Description

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

Usage

appstream_describe_images(Names, Arns, Type, NextToken, MaxResults)

Arguments

Names	The names of the public or private images to describe.
Arns	The ARNs of the public, private, and shared images to describe.
Type	The type of image (public, private, or shared) to describe.
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.
MaxResults	The maximum size of each page of results.

Value

A list with the following syntax:

list(
  Images = list(
    list(
      Name = "string",
      Arn = "string",
      BaseImageArn = "string",
      DisplayName = "string",
      State = "PENDING"|"AVAILABLE"|"FAILED"|"COPYING"|"DELETING"|"CREATING"|"IMPORTING",
      Visibility = "PUBLIC"|"PRIVATE"|"SHARED",
      ImageBuilderSupported = TRUE|FALSE,
      ImageBuilderName = "string",
      Platform = "WINDOWS"|"WINDOWS_SERVER_2016"|"WINDOWS_SERVER_2019"|"WINDOWS_SERVER_2022"|"AMAZON_LINUX2"|"RHEL8"|"ROCKY_LINUX8",
      Description = "string",
      StateChangeReason = list(
        Code = "INTERNAL_ERROR"|"IMAGE_BUILDER_NOT_AVAILABLE"|"IMAGE_COPY_FAILURE",
        Message = "string"
      ),
      Applications = list(
        list(
          Name = "string",
          DisplayName = "string",
          IconURL = "string",
          LaunchPath = "string",
          LaunchParameters = "string",
          Enabled = TRUE|FALSE,
          Metadata = list(
            "string"
          ),
          WorkingDirectory = "string",
          Description = "string",
          Arn = "string",
          AppBlockArn = "string",
          IconS3Location = list(
            S3Bucket = "string",
            S3Key = "string"
          ),
          Platforms = list(
            "WINDOWS"|"WINDOWS_SERVER_2016"|"WINDOWS_SERVER_2019"|"WINDOWS_SERVER_2022"|"AMAZON_LINUX2"|"RHEL8"|"ROCKY_LINUX8"
          ),
          InstanceFamilies = list(
            "string"
          ),
          CreatedTime = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      CreatedTime = as.POSIXct(
        "2015-01-01"
      ),
      PublicBaseImageReleasedDate = as.POSIXct(
        "2015-01-01"
      ),
      AppstreamAgentVersion = "string",
      ImagePermissions = list(
        allowFleet = TRUE|FALSE,
        allowImageBuilder = TRUE|FALSE
      ),
      ImageErrors = list(
        list(
          ErrorCode = "IAM_SERVICE_ROLE_MISSING_ENI_DESCRIBE_ACTION"|"IAM_SERVICE_ROLE_MISSING_ENI_CREATE_ACTION"|"IAM_SERVICE_ROLE_MISSING_ENI_DELETE_ACTION"|"NETWORK_INTERFACE_LIMIT_EXCEEDED"|"INTERNAL_SERVICE_ERROR"|"IAM_SERVICE_ROLE_IS_MISSING"|"MACHINE_ROLE_IS_MISSING"|"STS_DISABLED_IN_REGION"|"SUBNET_HAS_INSUFFICIENT_IP_ADDRESSES"|"IAM_SERVICE_ROLE_MISSING_DESCRIBE_SUBNET_ACTION"|"SUBNET_NOT_FOUND"|"IMAGE_NOT_FOUND"|"INVALID_SUBNET_CONFIGURATION"|"SECURITY_GROUPS_NOT_FOUND"|"IGW_NOT_ATTACHED"|"IAM_SERVICE_ROLE_MISSING_DESCRIBE_SECURITY_GROUPS_ACTION"|"FLEET_STOPPED"|"FLEET_INSTANCE_PROVISIONING_FAILURE"|"DOMAIN_JOIN_ERROR_FILE_NOT_FOUND"|"DOMAIN_JOIN_ERROR_ACCESS_DENIED"|"DOMAIN_JOIN_ERROR_LOGON_FAILURE"|"DOMAIN_JOIN_ERROR_INVALID_PARAMETER"|"DOMAIN_JOIN_ERROR_MORE_DATA"|"DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN"|"DOMAIN_JOIN_ERROR_NOT_SUPPORTED"|"DOMAIN_JOIN_NERR_INVALID_WORKGROUP_NAME"|"DOMAIN_JOIN_NERR_WORKSTATION_NOT_STARTED"|"DOMAIN_JOIN_ERROR_DS_MACHINE_ACCOUNT_QUOTA_EXCEEDED"|"DOMAIN_JOIN_NERR_PASSWORD_EXPIRED"|"DOMAIN_JOIN_INTERNAL_SERVICE_ERROR",
          ErrorMessage = "string",
          ErrorTimestamp = as.POSIXct(
            "2015-01-01"
          )
        )
      ),
      LatestAppstreamAgentVersion = "TRUE"|"FALSE",
      SupportedInstanceFamilies = list(
        "string"
      ),
      DynamicAppProvidersEnabled = "ENABLED"|"DISABLED",
      ImageSharedWithOthers = "TRUE"|"FALSE"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$describe_images(
  Names = list(
    "string"
  ),
  Arns = list(
    "string"
  ),
  Type = "PUBLIC"|"PRIVATE"|"SHARED",
  NextToken = "string",
  MaxResults = 123
)