Network.AWS.EC2.ModifyImageAttribute

Modifies the specified attribute of the specified AMI. You can specify only one attribute at a time. You can use the Attribute parameter to specify the attribute or one of the following parameters: Description , LaunchPermission , or ProductCode .

AWS Marketplace product codes cannot be modified. Images with an AWS Marketplace product code cannot be made public.

To enable the SriovNetSupport enhanced networking attribute of an image, enable SriovNetSupport on an instance and create an AMI from the instance.

Creating a Request

modifyImageAttribute

Arguments

:: Text

miaImageId

-> ModifyImageAttribute

Creates a value of ModifyImageAttribute with the minimum fields required to make a request.

Use one of the following lenses to modify other fields as desired:

• miaAttribute - The name of the attribute to modify. The valid values are description , launchPermission , and productCodes .
• miaUserIds - One or more AWS account IDs. This parameter can be used only when the Attribute parameter is launchPermission .
• miaUserGroups - One or more user groups. This parameter can be used only when the Attribute parameter is launchPermission .
• miaValue - The value of the attribute being modified. This parameter can be used only when the Attribute parameter is description or productCodes .
• miaLaunchPermission - A new launch permission for the AMI.
• miaOperationType - The operation type. This parameter can be used only when the Attribute parameter is launchPermission .
• miaProductCodes - One or more DevPay product codes. After you add a product code to an AMI, it can't be removed.
• miaDescription - A new description for the AMI.
• miaDryRun - 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 .
• miaImageId - The ID of the AMI.

data ModifyImageAttribute

Contains the parameters for ModifyImageAttribute.

See: modifyImageAttribute smart constructor.

Instances

Eq ModifyImageAttribute

Methods

(==) :: ModifyImageAttribute -> ModifyImageAttribute -> Bool

(/=) :: ModifyImageAttribute -> ModifyImageAttribute -> Bool

Data ModifyImageAttribute

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ModifyImageAttribute -> c ModifyImageAttribute

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ModifyImageAttribute

toConstr :: ModifyImageAttribute -> Constr

dataTypeOf :: ModifyImageAttribute -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ModifyImageAttribute)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ModifyImageAttribute)

gmapT :: (forall b. Data b => b -> b) -> ModifyImageAttribute -> ModifyImageAttribute

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ModifyImageAttribute -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ModifyImageAttribute -> r

gmapQ :: (forall d. Data d => d -> u) -> ModifyImageAttribute -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ModifyImageAttribute -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ModifyImageAttribute -> m ModifyImageAttribute

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyImageAttribute -> m ModifyImageAttribute

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyImageAttribute -> m ModifyImageAttribute

Read ModifyImageAttribute

Methods

readsPrec :: Int -> ReadS ModifyImageAttribute

readList :: ReadS [ModifyImageAttribute]

readPrec :: ReadPrec ModifyImageAttribute

readListPrec :: ReadPrec [ModifyImageAttribute]

Show ModifyImageAttribute

Methods

showsPrec :: Int -> ModifyImageAttribute -> ShowS

show :: ModifyImageAttribute -> String

showList :: [ModifyImageAttribute] -> ShowS

Generic ModifyImageAttribute

Associated Types

type Rep ModifyImageAttribute :: * -> *

Methods

from :: ModifyImageAttribute -> Rep ModifyImageAttribute x

to :: Rep ModifyImageAttribute x -> ModifyImageAttribute

Hashable ModifyImageAttribute

Methods

hashWithSalt :: Int -> ModifyImageAttribute -> Int

hash :: ModifyImageAttribute -> Int

NFData ModifyImageAttribute

Methods

rnf :: ModifyImageAttribute -> ()

AWSRequest ModifyImageAttribute

Associated Types

type Rs ModifyImageAttribute :: *

Methods

request :: ModifyImageAttribute -> Request ModifyImageAttribute

response :: (MonadResource m, MonadThrow m) => Logger -> Service -> Proxy * ModifyImageAttribute -> ClientResponse -> m (Response ModifyImageAttribute)

ToHeaders ModifyImageAttribute

Methods

toHeaders :: ModifyImageAttribute -> [Header]

ToPath ModifyImageAttribute

Methods

toPath :: ModifyImageAttribute -> ByteString

ToQuery ModifyImageAttribute

Methods

toQuery :: ModifyImageAttribute -> QueryString

type Rep ModifyImageAttribute

type Rep ModifyImageAttribute = D1 * (MetaData "ModifyImageAttribute" "Network.AWS.EC2.ModifyImageAttribute" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "ModifyImageAttribute'" PrefixI True) ((:*:) * ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_miaAttribute") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_miaUserIds") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text])))) ((:*:) * (S1 * (MetaSel (Just Symbol "_miaUserGroups") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text]))) ((:*:) * (S1 * (MetaSel (Just Symbol "_miaValue") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Text))) (S1 * (MetaSel (Just Symbol "_miaLaunchPermission") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe LaunchPermissionModifications)))))) ((:*:) * ((:*:) * (S1 * (MetaSel (Just Symbol "_miaOperationType") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe OperationType))) (S1 * (MetaSel (Just Symbol "_miaProductCodes") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe [Text])))) ((:*:) * (S1 * (MetaSel (Just Symbol "_miaDescription") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe AttributeValue))) ((:*:) * (S1 * (MetaSel (Just Symbol "_miaDryRun") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * (Maybe Bool))) (S1 * (MetaSel (Just Symbol "_miaImageId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 * Text)))))))

type Rs ModifyImageAttribute

type Rs ModifyImageAttribute = ModifyImageAttributeResponse

Request Lenses

miaAttribute :: Lens' ModifyImageAttribute (Maybe Text)

The name of the attribute to modify. The valid values are description , launchPermission , and productCodes .

miaUserIds :: Lens' ModifyImageAttribute [Text]

One or more AWS account IDs. This parameter can be used only when the Attribute parameter is launchPermission .

miaUserGroups :: Lens' ModifyImageAttribute [Text]

One or more user groups. This parameter can be used only when the Attribute parameter is launchPermission .

miaValue :: Lens' ModifyImageAttribute (Maybe Text)

The value of the attribute being modified. This parameter can be used only when the Attribute parameter is description or productCodes .

miaLaunchPermission :: Lens' ModifyImageAttribute (Maybe LaunchPermissionModifications)

A new launch permission for the AMI.

miaOperationType :: Lens' ModifyImageAttribute (Maybe OperationType)

The operation type. This parameter can be used only when the Attribute parameter is launchPermission .

miaProductCodes :: Lens' ModifyImageAttribute [Text]

One or more DevPay product codes. After you add a product code to an AMI, it can't be removed.

miaDescription :: Lens' ModifyImageAttribute (Maybe AttributeValue)

A new description for the AMI.

miaDryRun :: Lens' ModifyImageAttribute (Maybe Bool)

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 .

miaImageId :: Lens' ModifyImageAttribute Text

The ID of the AMI.

Destructuring the Response

modifyImageAttributeResponse :: ModifyImageAttributeResponse

Creates a value of ModifyImageAttributeResponse with the minimum fields required to make a request.

data ModifyImageAttributeResponse

See: modifyImageAttributeResponse smart constructor.

Instances

Eq ModifyImageAttributeResponse

Methods

(==) :: ModifyImageAttributeResponse -> ModifyImageAttributeResponse -> Bool

(/=) :: ModifyImageAttributeResponse -> ModifyImageAttributeResponse -> Bool

Data ModifyImageAttributeResponse

Methods

gfoldl :: (forall d b. Data d => c (d -> b) -> d -> c b) -> (forall g. g -> c g) -> ModifyImageAttributeResponse -> c ModifyImageAttributeResponse

gunfold :: (forall b r. Data b => c (b -> r) -> c r) -> (forall r. r -> c r) -> Constr -> c ModifyImageAttributeResponse

toConstr :: ModifyImageAttributeResponse -> Constr

dataTypeOf :: ModifyImageAttributeResponse -> DataType

dataCast1 :: Typeable (* -> *) t => (forall d. Data d => c (t d)) -> Maybe (c ModifyImageAttributeResponse)

dataCast2 :: Typeable (* -> * -> *) t => (forall d e. (Data d, Data e) => c (t d e)) -> Maybe (c ModifyImageAttributeResponse)

gmapT :: (forall b. Data b => b -> b) -> ModifyImageAttributeResponse -> ModifyImageAttributeResponse

gmapQl :: (r -> r' -> r) -> r -> (forall d. Data d => d -> r') -> ModifyImageAttributeResponse -> r

gmapQr :: (r' -> r -> r) -> r -> (forall d. Data d => d -> r') -> ModifyImageAttributeResponse -> r

gmapQ :: (forall d. Data d => d -> u) -> ModifyImageAttributeResponse -> [u]

gmapQi :: Int -> (forall d. Data d => d -> u) -> ModifyImageAttributeResponse -> u

gmapM :: Monad m => (forall d. Data d => d -> m d) -> ModifyImageAttributeResponse -> m ModifyImageAttributeResponse

gmapMp :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyImageAttributeResponse -> m ModifyImageAttributeResponse

gmapMo :: MonadPlus m => (forall d. Data d => d -> m d) -> ModifyImageAttributeResponse -> m ModifyImageAttributeResponse

Read ModifyImageAttributeResponse

Methods

readsPrec :: Int -> ReadS ModifyImageAttributeResponse

readList :: ReadS [ModifyImageAttributeResponse]

readPrec :: ReadPrec ModifyImageAttributeResponse

readListPrec :: ReadPrec [ModifyImageAttributeResponse]

Show ModifyImageAttributeResponse

Methods

showsPrec :: Int -> ModifyImageAttributeResponse -> ShowS

show :: ModifyImageAttributeResponse -> String

showList :: [ModifyImageAttributeResponse] -> ShowS

Generic ModifyImageAttributeResponse

Associated Types

type Rep ModifyImageAttributeResponse :: * -> *

Methods

from :: ModifyImageAttributeResponse -> Rep ModifyImageAttributeResponse x

to :: Rep ModifyImageAttributeResponse x -> ModifyImageAttributeResponse

NFData ModifyImageAttributeResponse

Methods

rnf :: ModifyImageAttributeResponse -> ()

type Rep ModifyImageAttributeResponse

type Rep ModifyImageAttributeResponse = D1 * (MetaData "ModifyImageAttributeResponse" "Network.AWS.EC2.ModifyImageAttribute" "amazonka-ec2-1.6.0-Kkew7Kpgof6EYi20Z0WOzs" False) (C1 * (MetaCons "ModifyImageAttributeResponse'" PrefixI False) (U1 *))