Network.AWS.KMS.ListGrants

Gets a list of all grants for the specified customer master key (CMK).

To perform this operation on a CMK in a different AWS account, specify the key ARN in the value of the KeyId parameter.

This operation returns paginated results.

Creating a Request

listGrants

Arguments

:: Text

lgKeyId

-> ListGrants

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

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

• lgMarker - 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.
• lgLimit - 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 100, inclusive. If you do not include a value, it defaults to 50.
• lgKeyId - A unique identifier for the customer master key (CMK). Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN. 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 ListGrants

See: listGrants smart constructor.

Instances

Eq ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

(==) :: ListGrants -> ListGrants -> Bool

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

Data ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

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

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

toConstr :: ListGrants -> Constr

dataTypeOf :: ListGrants -> DataType

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

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

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

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

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

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

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

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

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

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

Read ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

readsPrec :: Int -> ReadS ListGrants

readList :: ReadS [ListGrants]

readPrec :: ReadPrec ListGrants

readListPrec :: ReadPrec [ListGrants]

Show ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

showsPrec :: Int -> ListGrants -> ShowS

show :: ListGrants -> String

showList :: [ListGrants] -> ShowS

Generic ListGrants

Defined in Network.AWS.KMS.ListGrants

Associated Types

type Rep ListGrants :: Type -> Type

Methods

from :: ListGrants -> Rep ListGrants x

to :: Rep ListGrants x -> ListGrants

Hashable ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

hashWithSalt :: Int -> ListGrants -> Int

hash :: ListGrants -> Int

ToJSON ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

toJSON :: ListGrants -> Value

toEncoding :: ListGrants -> Encoding

toJSONList :: [ListGrants] -> Value

toEncodingList :: [ListGrants] -> Encoding

AWSPager ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

page :: ListGrants -> Rs ListGrants -> Maybe ListGrants

AWSRequest ListGrants

Defined in Network.AWS.KMS.ListGrants

Associated Types

type Rs ListGrants :: Type

Methods

request :: ListGrants -> Request ListGrants

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

ToHeaders ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

toHeaders :: ListGrants -> [Header]

ToPath ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

toPath :: ListGrants -> ByteString

ToQuery ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

toQuery :: ListGrants -> QueryString

NFData ListGrants

Defined in Network.AWS.KMS.ListGrants

Methods

rnf :: ListGrants -> ()

type Rep ListGrants

Defined in Network.AWS.KMS.ListGrants

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

type Rs ListGrants

Defined in Network.AWS.KMS.ListGrants

type Rs ListGrants = ListGrantsResponse

Request Lenses

lgMarker :: Lens' ListGrants (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.

lgLimit :: Lens' ListGrants (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 100, inclusive. If you do not include a value, it defaults to 50.

lgKeyId :: Lens' ListGrants Text

A unique identifier for the customer master key (CMK). Specify the key ID or the Amazon Resource Name (ARN) of the CMK. To specify a CMK in a different AWS account, you must use the key ARN. 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

listGrantsResponse :: ListGrantsResponse

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

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

• lgTruncated - 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.
• lgGrants - A list of grants.
• lgNextMarker - When Truncated is true, this element is present and contains the value to use for the Marker parameter in a subsequent request.

data ListGrantsResponse

See: listGrantsResponse smart constructor.

Instances

Eq ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

(==) :: ListGrantsResponse -> ListGrantsResponse -> Bool

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

Data ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

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

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

toConstr :: ListGrantsResponse -> Constr

dataTypeOf :: ListGrantsResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

readsPrec :: Int -> ReadS ListGrantsResponse

readList :: ReadS [ListGrantsResponse]

readPrec :: ReadPrec ListGrantsResponse

readListPrec :: ReadPrec [ListGrantsResponse]

Show ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

showsPrec :: Int -> ListGrantsResponse -> ShowS

show :: ListGrantsResponse -> String

showList :: [ListGrantsResponse] -> ShowS

Generic ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Associated Types

type Rep ListGrantsResponse :: Type -> Type

Methods

from :: ListGrantsResponse -> Rep ListGrantsResponse x

to :: Rep ListGrantsResponse x -> ListGrantsResponse

Hashable ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

hashWithSalt :: Int -> ListGrantsResponse -> Int

hash :: ListGrantsResponse -> Int

FromJSON ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

parseJSON :: Value -> Parser ListGrantsResponse

parseJSONList :: Value -> Parser [ListGrantsResponse]

NFData ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

Methods

rnf :: ListGrantsResponse -> ()

type Rep ListGrantsResponse

Defined in Network.AWS.KMS.Types.Product

type Rep ListGrantsResponse = D1 (MetaData "ListGrantsResponse" "Network.AWS.KMS.Types.Product" "amazonka-kms-1.6.1-1UDljZYfeha1jjHbbMax4v" False) (C1 (MetaCons "ListGrantsResponse'" PrefixI True) (S1 (MetaSel (Just "_lgTruncated") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 (MetaSel (Just "_lgGrants") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [GrantListEntry])) :*: S1 (MetaSel (Just "_lgNextMarker") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)))))

Response Lenses

lgTruncated :: Lens' ListGrantsResponse (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.

lgGrants :: Lens' ListGrantsResponse [GrantListEntry]

A list of grants.

lgNextMarker :: Lens' ListGrantsResponse (Maybe Text)

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