paws.compute (version 0.1.12)

ec2_describe_image_attribute: Describes the specified attribute of the specified AMI

Description

Describes the specified attribute of the specified AMI. You can specify only one attribute at a time.

Usage

ec2_describe_image_attribute(Attribute, ImageId, DryRun)

Value

A list with the following syntax:

list(
  BlockDeviceMappings = list(
    list(
      DeviceName = "string",
      VirtualName = "string",
      Ebs = list(
        DeleteOnTermination = TRUE|FALSE,
        Iops = 123,
        SnapshotId = "string",
        VolumeSize = 123,
        VolumeType = "standard"|"io1"|"io2"|"gp2"|"sc1"|"st1"|"gp3",
        KmsKeyId = "string",
        Throughput = 123,
        Encrypted = TRUE|FALSE
      ),
      NoDevice = "string"
    )
  ),
  ImageId = "string",
  LaunchPermissions = list(
    list(
      Group = "all",
      UserId = "string"
    )
  ),
  ProductCodes = list(
    list(
      ProductCodeId = "string",
      ProductCodeType = "devpay"|"marketplace"
    )
  ),
  Description = list(
    Value = "string"
  ),
  KernelId = list(
    Value = "string"
  ),
  RamdiskId = list(
    Value = "string"
  ),
  SriovNetSupport = list(
    Value = "string"
  )
)

Arguments

Attribute

[required] The AMI attribute.

Note: Depending on your account privileges, the blockDeviceMapping attribute may return a Client.AuthFailure error. If this happens, use describe_images to get information about the block device mapping for the AMI.

ImageId

[required] The ID of the AMI.

DryRun

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Request syntax

svc$describe_image_attribute(
  Attribute = "description"|"kernel"|"ramdisk"|"launchPermission"|"productCodes"|"blockDeviceMapping"|"sriovNetSupport",
  ImageId = "string",
  DryRun = TRUE|FALSE
)

Examples

if (FALSE) {
# This example describes the launch permissions for the specified AMI.
svc$describe_image_attribute(
  Attribute = "launchPermission",
  ImageId = "ami-5731123e"
)
}