Network.AWS.KMS.ListKeyPolicies

Gets the names of the key policies that are attached to a customer master key (CMK). This operation is designed to get policy names that you can use in a GetKeyPolicy operation. However, the only valid policy name is default . You cannot perform this operation on a CMK in a different AWS account.

This operation returns paginated results.

Creating a Request

listKeyPolicies

Arguments

:: Text

lkpKeyId

-> ListKeyPolicies

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

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

• lkpMarker - Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.
• lkpLimit - Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer. This value is optional. If you include a value, it must be between 1 and 1000, inclusive. If you do not include a value, it defaults to 100. Currently only 1 policy can be attached to a key.
• lkpKeyId - A unique identifier for the customer master key (CMK). Specify the key ID or the Amazon Resource Name (ARN) of the CMK. For example: * Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab * Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey .

data ListKeyPolicies

See: listKeyPolicies smart constructor.

Instances

Eq ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

(==) :: ListKeyPolicies -> ListKeyPolicies -> Bool

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

Data ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

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

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

toConstr :: ListKeyPolicies -> Constr

dataTypeOf :: ListKeyPolicies -> DataType

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

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

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

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

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

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

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

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

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

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

Read ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

readsPrec :: Int -> ReadS ListKeyPolicies

readList :: ReadS [ListKeyPolicies]

readPrec :: ReadPrec ListKeyPolicies

readListPrec :: ReadPrec [ListKeyPolicies]

Show ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

showsPrec :: Int -> ListKeyPolicies -> ShowS

show :: ListKeyPolicies -> String

showList :: [ListKeyPolicies] -> ShowS

Generic ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Associated Types

type Rep ListKeyPolicies :: Type -> Type

Methods

from :: ListKeyPolicies -> Rep ListKeyPolicies x

to :: Rep ListKeyPolicies x -> ListKeyPolicies

Hashable ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

hashWithSalt :: Int -> ListKeyPolicies -> Int

hash :: ListKeyPolicies -> Int

ToJSON ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

toJSON :: ListKeyPolicies -> Value

toEncoding :: ListKeyPolicies -> Encoding

toJSONList :: [ListKeyPolicies] -> Value

toEncodingList :: [ListKeyPolicies] -> Encoding

AWSPager ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

page :: ListKeyPolicies -> Rs ListKeyPolicies -> Maybe ListKeyPolicies

AWSRequest ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Associated Types

type Rs ListKeyPolicies :: Type

Methods

request :: ListKeyPolicies -> Request ListKeyPolicies

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

ToHeaders ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

toHeaders :: ListKeyPolicies -> [Header]

ToPath ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

toPath :: ListKeyPolicies -> ByteString

ToQuery ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

toQuery :: ListKeyPolicies -> QueryString

NFData ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

rnf :: ListKeyPolicies -> ()

type Rep ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

type Rep ListKeyPolicies = D1 (MetaData "ListKeyPolicies" "Network.AWS.KMS.ListKeyPolicies" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "ListKeyPolicies'" PrefixI True) (S1 (MetaSel (Just "_lkpMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_lkpLimit") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Nat)) :*: S1 (MetaSel (Just "_lkpKeyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs ListKeyPolicies

Defined in Network.AWS.KMS.ListKeyPolicies

type Rs ListKeyPolicies = ListKeyPoliciesResponse

Request Lenses

lkpMarker :: Lens' ListKeyPolicies (Maybe Text)

Use this parameter in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the truncated response you just received.

lkpLimit :: Lens' ListKeyPolicies (Maybe Natural)

Use this parameter to specify the maximum number of items to return. When this value is present, AWS KMS does not return more than the specified number of items, but it might return fewer. This value is optional. If you include a value, it must be between 1 and 1000, inclusive. If you do not include a value, it defaults to 100. Currently only 1 policy can be attached to a key.

lkpKeyId :: Lens' ListKeyPolicies Text

A unique identifier for the customer master key (CMK). Specify the key ID or the Amazon Resource Name (ARN) of the CMK. For example: * Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab * Key ARN: arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab To get the key ID and key ARN for a CMK, use ListKeys or DescribeKey .

Destructuring the Response

listKeyPoliciesResponse

Arguments

:: Int

lkprsResponseStatus

-> ListKeyPoliciesResponse

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

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

• lkprsPolicyNames - A list of key policy names. Currently, there is only one key policy per CMK and it is always named default .
• lkprsTruncated - A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.
• lkprsNextMarker - When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.
• lkprsResponseStatus - -- | The response status code.

data ListKeyPoliciesResponse

See: listKeyPoliciesResponse smart constructor.

Instances

Eq ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

(==) :: ListKeyPoliciesResponse -> ListKeyPoliciesResponse -> Bool

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

Data ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

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

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

toConstr :: ListKeyPoliciesResponse -> Constr

dataTypeOf :: ListKeyPoliciesResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

readsPrec :: Int -> ReadS ListKeyPoliciesResponse

readList :: ReadS [ListKeyPoliciesResponse]

readPrec :: ReadPrec ListKeyPoliciesResponse

readListPrec :: ReadPrec [ListKeyPoliciesResponse]

Show ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

showsPrec :: Int -> ListKeyPoliciesResponse -> ShowS

show :: ListKeyPoliciesResponse -> String

showList :: [ListKeyPoliciesResponse] -> ShowS

Generic ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Associated Types

type Rep ListKeyPoliciesResponse :: Type -> Type

Methods

from :: ListKeyPoliciesResponse -> Rep ListKeyPoliciesResponse x

to :: Rep ListKeyPoliciesResponse x -> ListKeyPoliciesResponse

NFData ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

Methods

rnf :: ListKeyPoliciesResponse -> ()

type Rep ListKeyPoliciesResponse

Defined in Network.AWS.KMS.ListKeyPolicies

type Rep ListKeyPoliciesResponse = D1 (MetaData "ListKeyPoliciesResponse" "Network.AWS.KMS.ListKeyPolicies" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "ListKeyPoliciesResponse'" PrefixI True) ((S1 (MetaSel (Just "_lkprsPolicyNames") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [Text])) :*: S1 (MetaSel (Just "_lkprsTruncated") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) :*: (S1 (MetaSel (Just "_lkprsNextMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_lkprsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int))))

Response Lenses

lkprsPolicyNames :: Lens' ListKeyPoliciesResponse [Text]

A list of key policy names. Currently, there is only one key policy per CMK and it is always named default .

lkprsTruncated :: Lens' ListKeyPoliciesResponse (Maybe Bool)

A flag that indicates whether there are more items in the list. When this value is true, the list in this response is truncated. To get more items, pass the value of the NextMarker element in this response to the Marker parameter in a subsequent request.

lkprsNextMarker :: Lens' ListKeyPoliciesResponse (Maybe Text)

When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

lkprsResponseStatus :: Lens' ListKeyPoliciesResponse Int

• - | The response status code.