Network.AWS.KMS.ListGrants

List the grants for a specified key.

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 only when paginating results and only in a subsequent request after you receive a response with truncated results. Set it to the value of NextMarker from the response you just received.
• lgLimit - When paginating results, specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the Truncated element in the response is set to true. 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. This value can be a globally unique identifier or the fully specified ARN to a key. * Key ARN Example - arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 * Globally Unique Key ID Example - 12345678-1234-1234-1234-123456789012

data ListGrants

See: listGrants smart constructor.

Instances

Eq ListGrants

Methods

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

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

Data 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

Methods

readsPrec :: Int -> ReadS ListGrants

readList :: ReadS [ListGrants]

readPrec :: ReadPrec ListGrants

readListPrec :: ReadPrec [ListGrants]

Show ListGrants

Methods

showsPrec :: Int -> ListGrants -> ShowS

show :: ListGrants -> String

showList :: [ListGrants] -> ShowS

Generic ListGrants

Associated Types

type Rep ListGrants :: * -> *

Methods

from :: ListGrants -> Rep ListGrants x

to :: Rep ListGrants x -> ListGrants

Hashable ListGrants

Methods

hashWithSalt :: Int -> ListGrants -> Int

hash :: ListGrants -> Int

ToJSON ListGrants

Methods

toJSON :: ListGrants -> Value

toEncoding :: ListGrants -> Encoding

toJSONList :: [ListGrants] -> Value

toEncodingList :: [ListGrants] -> Encoding

NFData ListGrants

Methods

rnf :: ListGrants -> ()

AWSPager ListGrants

Methods

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

AWSRequest ListGrants

Associated Types

type Rs ListGrants :: *

Methods

request :: ListGrants -> Request ListGrants

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

ToPath ListGrants

Methods

toPath :: ListGrants -> ByteString

ToHeaders ListGrants

Methods

toHeaders :: ListGrants -> [Header]

ToQuery ListGrants

Methods

toQuery :: ListGrants -> QueryString

type Rep ListGrants

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

type Rs ListGrants

type Rs ListGrants = ListGrantsResponse

Request Lenses

lgMarker :: Lens' ListGrants (Maybe Text)

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

lgLimit :: Lens' ListGrants (Maybe Natural)

When paginating results, specify the maximum number of items to return in the response. If additional items exist beyond the number you specify, the Truncated element in the response is set to true. 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. This value can be a globally unique identifier or the fully specified ARN to a key. * Key ARN Example - arn:aws:kms:us-east-1:123456789012:key/12345678-1234-1234-1234-123456789012 * Globally Unique Key ID Example - 12345678-1234-1234-1234-123456789012

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. If your results were truncated, you can use the Marker parameter to make a subsequent pagination request to retrieve more items in the list.
• lgGrants - A list of grants.
• lgNextMarker - When Truncated is true, this value is present and contains the value to use for the Marker parameter in a subsequent pagination request.

data ListGrantsResponse

See: listGrantsResponse smart constructor.

Instances

Eq ListGrantsResponse

Methods

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

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

Data ListGrantsResponse

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

Methods

readsPrec :: Int -> ReadS ListGrantsResponse

readList :: ReadS [ListGrantsResponse]

readPrec :: ReadPrec ListGrantsResponse

readListPrec :: ReadPrec [ListGrantsResponse]

Show ListGrantsResponse

Methods

showsPrec :: Int -> ListGrantsResponse -> ShowS

show :: ListGrantsResponse -> String

showList :: [ListGrantsResponse] -> ShowS

Generic ListGrantsResponse

Associated Types

type Rep ListGrantsResponse :: * -> *

Methods

from :: ListGrantsResponse -> Rep ListGrantsResponse x

to :: Rep ListGrantsResponse x -> ListGrantsResponse

Hashable ListGrantsResponse

Methods

hashWithSalt :: Int -> ListGrantsResponse -> Int

hash :: ListGrantsResponse -> Int

FromJSON ListGrantsResponse

Methods

parseJSON :: Value -> Parser ListGrantsResponse

parseJSONList :: Value -> Parser [ListGrantsResponse]

NFData ListGrantsResponse

Methods

rnf :: ListGrantsResponse -> ()

type Rep ListGrantsResponse

type Rep ListGrantsResponse = D1 (MetaData "ListGrantsResponse" "Network.AWS.KMS.Types.Product" "amazonka-kms-1.4.5-2CcuwPQYK1JBjEgZ8528Xg" False) (C1 (MetaCons "ListGrantsResponse'" PrefixI True) ((:*:) (S1 (MetaSel (Just Symbol "_lgTruncated") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Bool))) ((:*:) (S1 (MetaSel (Just Symbol "_lgGrants") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe [GrantListEntry]))) (S1 (MetaSel (Just Symbol "_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. If your results were truncated, you can use the Marker parameter to make a subsequent pagination request to retrieve more items in the list.

lgGrants :: Lens' ListGrantsResponse [GrantListEntry]

A list of grants.

lgNextMarker :: Lens' ListGrantsResponse (Maybe Text)

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