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

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

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

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

Data ModifyImageAttribute

Defined in Network.AWS.EC2.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

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

readsPrec :: Int -> ReadS ModifyImageAttribute

readList :: ReadS [ModifyImageAttribute]

readPrec :: ReadPrec ModifyImageAttribute

readListPrec :: ReadPrec [ModifyImageAttribute]

Show ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

showsPrec :: Int -> ModifyImageAttribute -> ShowS

show :: ModifyImageAttribute -> String

showList :: [ModifyImageAttribute] -> ShowS

Generic ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Associated Types

type Rep ModifyImageAttribute :: Type -> Type

Methods

from :: ModifyImageAttribute -> Rep ModifyImageAttribute x

to :: Rep ModifyImageAttribute x -> ModifyImageAttribute

Hashable ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

hashWithSalt :: Int -> ModifyImageAttribute -> Int

hash :: ModifyImageAttribute -> Int

AWSRequest ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Associated Types

type Rs ModifyImageAttribute :: Type

Methods

request :: ModifyImageAttribute -> Request ModifyImageAttribute

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

ToHeaders ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

toHeaders :: ModifyImageAttribute -> [Header]

ToPath ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

toPath :: ModifyImageAttribute -> ByteString

ToQuery ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

toQuery :: ModifyImageAttribute -> QueryString

NFData ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

rnf :: ModifyImageAttribute -> ()

type Rep ModifyImageAttribute

Defined in Network.AWS.EC2.ModifyImageAttribute

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

type Rs ModifyImageAttribute

Defined in Network.AWS.EC2.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

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

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

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

Data ModifyImageAttributeResponse

Defined in Network.AWS.EC2.ModifyImageAttribute

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

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

readsPrec :: Int -> ReadS ModifyImageAttributeResponse

readList :: ReadS [ModifyImageAttributeResponse]

readPrec :: ReadPrec ModifyImageAttributeResponse

readListPrec :: ReadPrec [ModifyImageAttributeResponse]

Show ModifyImageAttributeResponse

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

showsPrec :: Int -> ModifyImageAttributeResponse -> ShowS

show :: ModifyImageAttributeResponse -> String

showList :: [ModifyImageAttributeResponse] -> ShowS

Generic ModifyImageAttributeResponse

Defined in Network.AWS.EC2.ModifyImageAttribute

Associated Types

type Rep ModifyImageAttributeResponse :: Type -> Type

Methods

from :: ModifyImageAttributeResponse -> Rep ModifyImageAttributeResponse x

to :: Rep ModifyImageAttributeResponse x -> ModifyImageAttributeResponse

NFData ModifyImageAttributeResponse

Defined in Network.AWS.EC2.ModifyImageAttribute

Methods

rnf :: ModifyImageAttributeResponse -> ()

type Rep ModifyImageAttributeResponse

Defined in Network.AWS.EC2.ModifyImageAttribute

type Rep ModifyImageAttributeResponse = D1 (MetaData "ModifyImageAttributeResponse" "Network.AWS.EC2.ModifyImageAttribute" "amazonka-ec2-1.6.1-GgG1M0FWcBrE5I5IM2QktE" False) (C1 (MetaCons "ModifyImageAttributeResponse'" PrefixI False) (U1 :: Type -> Type))