Network.AWS.CloudWatchLogs.CreateLogGroup

Creates a log group with the specified name.

You can create up to 5000 log groups per account.

You must use the following guidelines when naming a log group:

• Log group names must be unique within a region for an AWS account.
• Log group names can be between 1 and 512 characters long.
• Log group names consist of the following characters: a-z, A-Z, 0-9, '_' (underscore), - (hyphen), / (forward slash), and . (period).

If you associate a AWS Key Management Service (AWS KMS) customer master key (CMK) with the log group, ingested data is encrypted using the CMK. This association is stored as long as the data encrypted with the CMK is still within Amazon CloudWatch Logs. This enables Amazon CloudWatch Logs to decrypt this data whenever it is requested.

If you attempt to associate a CMK with the log group but the CMK does not exist or the CMK is disabled, you will receive an InvalidParameterException error.

Creating a Request

createLogGroup

Arguments

:: Text

clgLogGroupName

-> CreateLogGroup

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

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

• clgKmsKeyId - The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS) .
• clgTags - The key-value pairs to use for the tags.
• clgLogGroupName - The name of the log group.

data CreateLogGroup

See: createLogGroup smart constructor.

Instances

Eq CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

(==) :: CreateLogGroup -> CreateLogGroup -> Bool

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

Data CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

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

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

toConstr :: CreateLogGroup -> Constr

dataTypeOf :: CreateLogGroup -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

readsPrec :: Int -> ReadS CreateLogGroup

readList :: ReadS [CreateLogGroup]

readPrec :: ReadPrec CreateLogGroup

readListPrec :: ReadPrec [CreateLogGroup]

Show CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

showsPrec :: Int -> CreateLogGroup -> ShowS

show :: CreateLogGroup -> String

showList :: [CreateLogGroup] -> ShowS

Generic CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Associated Types

type Rep CreateLogGroup :: Type -> Type

Methods

from :: CreateLogGroup -> Rep CreateLogGroup x

to :: Rep CreateLogGroup x -> CreateLogGroup

Hashable CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

hashWithSalt :: Int -> CreateLogGroup -> Int

hash :: CreateLogGroup -> Int

ToJSON CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

toJSON :: CreateLogGroup -> Value

toEncoding :: CreateLogGroup -> Encoding

toJSONList :: [CreateLogGroup] -> Value

toEncodingList :: [CreateLogGroup] -> Encoding

AWSRequest CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Associated Types

type Rs CreateLogGroup :: Type

Methods

request :: CreateLogGroup -> Request CreateLogGroup

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

ToHeaders CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

toHeaders :: CreateLogGroup -> [Header]

ToPath CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

toPath :: CreateLogGroup -> ByteString

ToQuery CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

toQuery :: CreateLogGroup -> QueryString

NFData CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

rnf :: CreateLogGroup -> ()

type Rep CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

type Rep CreateLogGroup = D1 (MetaData "CreateLogGroup" "Network.AWS.CloudWatchLogs.CreateLogGroup" "amazonka-cloudwatch-logs-1.6.1-3MDuvRaDmjeBjiAkGx8qXs" False) (C1 (MetaCons "CreateLogGroup'" PrefixI True) (S1 (MetaSel (Just "_clgKmsKeyId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 (MetaSel (Just "_clgTags") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe (Map Text Text))) :*: S1 (MetaSel (Just "_clgLogGroupName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text))))

type Rs CreateLogGroup

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

type Rs CreateLogGroup = CreateLogGroupResponse

Request Lenses

clgKmsKeyId :: Lens' CreateLogGroup (Maybe Text)

The Amazon Resource Name (ARN) of the CMK to use when encrypting log data. For more information, see Amazon Resource Names - AWS Key Management Service (AWS KMS) .

clgTags :: Lens' CreateLogGroup (HashMap Text Text)

The key-value pairs to use for the tags.

clgLogGroupName :: Lens' CreateLogGroup Text

The name of the log group.

Destructuring the Response

createLogGroupResponse :: CreateLogGroupResponse

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

data CreateLogGroupResponse

See: createLogGroupResponse smart constructor.

Instances

Eq CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

(==) :: CreateLogGroupResponse -> CreateLogGroupResponse -> Bool

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

Data CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

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

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

toConstr :: CreateLogGroupResponse -> Constr

dataTypeOf :: CreateLogGroupResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

readsPrec :: Int -> ReadS CreateLogGroupResponse

readList :: ReadS [CreateLogGroupResponse]

readPrec :: ReadPrec CreateLogGroupResponse

readListPrec :: ReadPrec [CreateLogGroupResponse]

Show CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

showsPrec :: Int -> CreateLogGroupResponse -> ShowS

show :: CreateLogGroupResponse -> String

showList :: [CreateLogGroupResponse] -> ShowS

Generic CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Associated Types

type Rep CreateLogGroupResponse :: Type -> Type

Methods

from :: CreateLogGroupResponse -> Rep CreateLogGroupResponse x

to :: Rep CreateLogGroupResponse x -> CreateLogGroupResponse

NFData CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

Methods

rnf :: CreateLogGroupResponse -> ()

type Rep CreateLogGroupResponse

Defined in Network.AWS.CloudWatchLogs.CreateLogGroup

type Rep CreateLogGroupResponse = D1 (MetaData "CreateLogGroupResponse" "Network.AWS.CloudWatchLogs.CreateLogGroup" "amazonka-cloudwatch-logs-1.6.1-3MDuvRaDmjeBjiAkGx8qXs" False) (C1 (MetaCons "CreateLogGroupResponse'" PrefixI False) (U1 :: Type -> Type))