{-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE DuplicateRecordFields #-} {-# LANGUAGE NamedFieldPuns #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE StrictData #-} {-# LANGUAGE TypeFamilies #-} {-# LANGUAGE NoImplicitPrelude #-} {-# OPTIONS_GHC -fno-warn-unused-binds #-} {-# OPTIONS_GHC -fno-warn-unused-imports #-} {-# OPTIONS_GHC -fno-warn-unused-matches #-} -- Derived from AWS service descriptions, licensed under Apache 2.0. -- | -- Module : Amazonka.IVSChat.CreateRoom -- Copyright : (c) 2013-2023 Brendan Hay -- License : Mozilla Public License, v. 2.0. -- Maintainer : Brendan Hay -- Stability : auto-generated -- Portability : non-portable (GHC extensions) -- -- Creates a room that allows clients to connect and pass messages. module Amazonka.IVSChat.CreateRoom ( -- * Creating a Request CreateRoom (..), newCreateRoom, -- * Request Lenses createRoom_loggingConfigurationIdentifiers, createRoom_maximumMessageLength, createRoom_maximumMessageRatePerSecond, createRoom_messageReviewHandler, createRoom_name, createRoom_tags, -- * Destructuring the Response CreateRoomResponse (..), newCreateRoomResponse, -- * Response Lenses createRoomResponse_arn, createRoomResponse_createTime, createRoomResponse_id, createRoomResponse_loggingConfigurationIdentifiers, createRoomResponse_maximumMessageLength, createRoomResponse_maximumMessageRatePerSecond, createRoomResponse_messageReviewHandler, createRoomResponse_name, createRoomResponse_tags, createRoomResponse_updateTime, createRoomResponse_httpStatus, ) where import qualified Amazonka.Core as Core import qualified Amazonka.Core.Lens.Internal as Lens import qualified Amazonka.Data as Data import Amazonka.IVSChat.Types import qualified Amazonka.Prelude as Prelude import qualified Amazonka.Request as Request import qualified Amazonka.Response as Response -- | /See:/ 'newCreateRoom' smart constructor. data CreateRoom = CreateRoom' { -- | Array of logging-configuration identifiers attached to the room. loggingConfigurationIdentifiers :: Prelude.Maybe [Prelude.Text], -- | Maximum number of characters in a single message. Messages are expected -- to be UTF-8 encoded and this limit applies specifically to -- rune\/code-point count, not number of bytes. Default: 500. maximumMessageLength :: Prelude.Maybe Prelude.Natural, -- | Maximum number of messages per second that can be sent to the room (by -- all clients). Default: 10. maximumMessageRatePerSecond :: Prelude.Maybe Prelude.Natural, -- | Configuration information for optional review of messages. messageReviewHandler :: Prelude.Maybe MessageReviewHandler, -- | Room name. The value does not need to be unique. name :: Prelude.Maybe Prelude.Text, -- | Tags to attach to the resource. Array of maps, each of the form -- @string:string (key:value)@. See -- -- for details, including restrictions that apply to tags and \"Tag naming -- limits and requirements\"; Amazon IVS Chat has no constraints beyond -- what is documented there. tags :: Prelude.Maybe (Prelude.HashMap Prelude.Text Prelude.Text) } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'CreateRoom' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'loggingConfigurationIdentifiers', 'createRoom_loggingConfigurationIdentifiers' - Array of logging-configuration identifiers attached to the room. -- -- 'maximumMessageLength', 'createRoom_maximumMessageLength' - Maximum number of characters in a single message. Messages are expected -- to be UTF-8 encoded and this limit applies specifically to -- rune\/code-point count, not number of bytes. Default: 500. -- -- 'maximumMessageRatePerSecond', 'createRoom_maximumMessageRatePerSecond' - Maximum number of messages per second that can be sent to the room (by -- all clients). Default: 10. -- -- 'messageReviewHandler', 'createRoom_messageReviewHandler' - Configuration information for optional review of messages. -- -- 'name', 'createRoom_name' - Room name. The value does not need to be unique. -- -- 'tags', 'createRoom_tags' - Tags to attach to the resource. Array of maps, each of the form -- @string:string (key:value)@. See -- -- for details, including restrictions that apply to tags and \"Tag naming -- limits and requirements\"; Amazon IVS Chat has no constraints beyond -- what is documented there. newCreateRoom :: CreateRoom newCreateRoom = CreateRoom' { loggingConfigurationIdentifiers = Prelude.Nothing, maximumMessageLength = Prelude.Nothing, maximumMessageRatePerSecond = Prelude.Nothing, messageReviewHandler = Prelude.Nothing, name = Prelude.Nothing, tags = Prelude.Nothing } -- | Array of logging-configuration identifiers attached to the room. createRoom_loggingConfigurationIdentifiers :: Lens.Lens' CreateRoom (Prelude.Maybe [Prelude.Text]) createRoom_loggingConfigurationIdentifiers = Lens.lens (\CreateRoom' {loggingConfigurationIdentifiers} -> loggingConfigurationIdentifiers) (\s@CreateRoom' {} a -> s {loggingConfigurationIdentifiers = a} :: CreateRoom) Prelude.. Lens.mapping Lens.coerced -- | Maximum number of characters in a single message. Messages are expected -- to be UTF-8 encoded and this limit applies specifically to -- rune\/code-point count, not number of bytes. Default: 500. createRoom_maximumMessageLength :: Lens.Lens' CreateRoom (Prelude.Maybe Prelude.Natural) createRoom_maximumMessageLength = Lens.lens (\CreateRoom' {maximumMessageLength} -> maximumMessageLength) (\s@CreateRoom' {} a -> s {maximumMessageLength = a} :: CreateRoom) -- | Maximum number of messages per second that can be sent to the room (by -- all clients). Default: 10. createRoom_maximumMessageRatePerSecond :: Lens.Lens' CreateRoom (Prelude.Maybe Prelude.Natural) createRoom_maximumMessageRatePerSecond = Lens.lens (\CreateRoom' {maximumMessageRatePerSecond} -> maximumMessageRatePerSecond) (\s@CreateRoom' {} a -> s {maximumMessageRatePerSecond = a} :: CreateRoom) -- | Configuration information for optional review of messages. createRoom_messageReviewHandler :: Lens.Lens' CreateRoom (Prelude.Maybe MessageReviewHandler) createRoom_messageReviewHandler = Lens.lens (\CreateRoom' {messageReviewHandler} -> messageReviewHandler) (\s@CreateRoom' {} a -> s {messageReviewHandler = a} :: CreateRoom) -- | Room name. The value does not need to be unique. createRoom_name :: Lens.Lens' CreateRoom (Prelude.Maybe Prelude.Text) createRoom_name = Lens.lens (\CreateRoom' {name} -> name) (\s@CreateRoom' {} a -> s {name = a} :: CreateRoom) -- | Tags to attach to the resource. Array of maps, each of the form -- @string:string (key:value)@. See -- -- for details, including restrictions that apply to tags and \"Tag naming -- limits and requirements\"; Amazon IVS Chat has no constraints beyond -- what is documented there. createRoom_tags :: Lens.Lens' CreateRoom (Prelude.Maybe (Prelude.HashMap Prelude.Text Prelude.Text)) createRoom_tags = Lens.lens (\CreateRoom' {tags} -> tags) (\s@CreateRoom' {} a -> s {tags = a} :: CreateRoom) Prelude.. Lens.mapping Lens.coerced instance Core.AWSRequest CreateRoom where type AWSResponse CreateRoom = CreateRoomResponse request overrides = Request.postJSON (overrides defaultService) response = Response.receiveJSON ( \s h x -> CreateRoomResponse' Prelude.<$> (x Data..?> "arn") Prelude.<*> (x Data..?> "createTime") Prelude.<*> (x Data..?> "id") Prelude.<*> ( x Data..?> "loggingConfigurationIdentifiers" Core..!@ Prelude.mempty ) Prelude.<*> (x Data..?> "maximumMessageLength") Prelude.<*> (x Data..?> "maximumMessageRatePerSecond") Prelude.<*> (x Data..?> "messageReviewHandler") Prelude.<*> (x Data..?> "name") Prelude.<*> (x Data..?> "tags" Core..!@ Prelude.mempty) Prelude.<*> (x Data..?> "updateTime") Prelude.<*> (Prelude.pure (Prelude.fromEnum s)) ) instance Prelude.Hashable CreateRoom where hashWithSalt _salt CreateRoom' {..} = _salt `Prelude.hashWithSalt` loggingConfigurationIdentifiers `Prelude.hashWithSalt` maximumMessageLength `Prelude.hashWithSalt` maximumMessageRatePerSecond `Prelude.hashWithSalt` messageReviewHandler `Prelude.hashWithSalt` name `Prelude.hashWithSalt` tags instance Prelude.NFData CreateRoom where rnf CreateRoom' {..} = Prelude.rnf loggingConfigurationIdentifiers `Prelude.seq` Prelude.rnf maximumMessageLength `Prelude.seq` Prelude.rnf maximumMessageRatePerSecond `Prelude.seq` Prelude.rnf messageReviewHandler `Prelude.seq` Prelude.rnf name `Prelude.seq` Prelude.rnf tags instance Data.ToHeaders CreateRoom where toHeaders = Prelude.const ( Prelude.mconcat [ "Content-Type" Data.=# ( "application/x-amz-json-1.1" :: Prelude.ByteString ) ] ) instance Data.ToJSON CreateRoom where toJSON CreateRoom' {..} = Data.object ( Prelude.catMaybes [ ("loggingConfigurationIdentifiers" Data..=) Prelude.<$> loggingConfigurationIdentifiers, ("maximumMessageLength" Data..=) Prelude.<$> maximumMessageLength, ("maximumMessageRatePerSecond" Data..=) Prelude.<$> maximumMessageRatePerSecond, ("messageReviewHandler" Data..=) Prelude.<$> messageReviewHandler, ("name" Data..=) Prelude.<$> name, ("tags" Data..=) Prelude.<$> tags ] ) instance Data.ToPath CreateRoom where toPath = Prelude.const "/CreateRoom" instance Data.ToQuery CreateRoom where toQuery = Prelude.const Prelude.mempty -- | /See:/ 'newCreateRoomResponse' smart constructor. data CreateRoomResponse = CreateRoomResponse' { -- | Room ARN, assigned by the system. arn :: Prelude.Maybe Prelude.Text, -- | Time when the room was created. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. createTime :: Prelude.Maybe Data.ISO8601, -- | Room ID, generated by the system. This is a relative identifier, the -- part of the ARN that uniquely identifies the room. id :: Prelude.Maybe Prelude.Text, -- | Array of logging configurations attached to the room, from the request -- (if specified). loggingConfigurationIdentifiers :: Prelude.Maybe [Prelude.Text], -- | Maximum number of characters in a single message, from the request (if -- specified). maximumMessageLength :: Prelude.Maybe Prelude.Natural, -- | Maximum number of messages per second that can be sent to the room (by -- all clients), from the request (if specified). maximumMessageRatePerSecond :: Prelude.Maybe Prelude.Natural, -- | Configuration information for optional review of messages. messageReviewHandler :: Prelude.Maybe MessageReviewHandler, -- | Room name, from the request (if specified). name :: Prelude.Maybe Prelude.Text, -- | Tags attached to the resource, from the request (if specified). tags :: Prelude.Maybe (Prelude.HashMap Prelude.Text Prelude.Text), -- | Time of the room’s last update. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. updateTime :: Prelude.Maybe Data.ISO8601, -- | The response's http status code. httpStatus :: Prelude.Int } deriving (Prelude.Eq, Prelude.Read, Prelude.Show, Prelude.Generic) -- | -- Create a value of 'CreateRoomResponse' with all optional fields omitted. -- -- Use or to modify other optional fields. -- -- The following record fields are available, with the corresponding lenses provided -- for backwards compatibility: -- -- 'arn', 'createRoomResponse_arn' - Room ARN, assigned by the system. -- -- 'createTime', 'createRoomResponse_createTime' - Time when the room was created. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. -- -- 'id', 'createRoomResponse_id' - Room ID, generated by the system. This is a relative identifier, the -- part of the ARN that uniquely identifies the room. -- -- 'loggingConfigurationIdentifiers', 'createRoomResponse_loggingConfigurationIdentifiers' - Array of logging configurations attached to the room, from the request -- (if specified). -- -- 'maximumMessageLength', 'createRoomResponse_maximumMessageLength' - Maximum number of characters in a single message, from the request (if -- specified). -- -- 'maximumMessageRatePerSecond', 'createRoomResponse_maximumMessageRatePerSecond' - Maximum number of messages per second that can be sent to the room (by -- all clients), from the request (if specified). -- -- 'messageReviewHandler', 'createRoomResponse_messageReviewHandler' - Configuration information for optional review of messages. -- -- 'name', 'createRoomResponse_name' - Room name, from the request (if specified). -- -- 'tags', 'createRoomResponse_tags' - Tags attached to the resource, from the request (if specified). -- -- 'updateTime', 'createRoomResponse_updateTime' - Time of the room’s last update. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. -- -- 'httpStatus', 'createRoomResponse_httpStatus' - The response's http status code. newCreateRoomResponse :: -- | 'httpStatus' Prelude.Int -> CreateRoomResponse newCreateRoomResponse pHttpStatus_ = CreateRoomResponse' { arn = Prelude.Nothing, createTime = Prelude.Nothing, id = Prelude.Nothing, loggingConfigurationIdentifiers = Prelude.Nothing, maximumMessageLength = Prelude.Nothing, maximumMessageRatePerSecond = Prelude.Nothing, messageReviewHandler = Prelude.Nothing, name = Prelude.Nothing, tags = Prelude.Nothing, updateTime = Prelude.Nothing, httpStatus = pHttpStatus_ } -- | Room ARN, assigned by the system. createRoomResponse_arn :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.Text) createRoomResponse_arn = Lens.lens (\CreateRoomResponse' {arn} -> arn) (\s@CreateRoomResponse' {} a -> s {arn = a} :: CreateRoomResponse) -- | Time when the room was created. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. createRoomResponse_createTime :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.UTCTime) createRoomResponse_createTime = Lens.lens (\CreateRoomResponse' {createTime} -> createTime) (\s@CreateRoomResponse' {} a -> s {createTime = a} :: CreateRoomResponse) Prelude.. Lens.mapping Data._Time -- | Room ID, generated by the system. This is a relative identifier, the -- part of the ARN that uniquely identifies the room. createRoomResponse_id :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.Text) createRoomResponse_id = Lens.lens (\CreateRoomResponse' {id} -> id) (\s@CreateRoomResponse' {} a -> s {id = a} :: CreateRoomResponse) -- | Array of logging configurations attached to the room, from the request -- (if specified). createRoomResponse_loggingConfigurationIdentifiers :: Lens.Lens' CreateRoomResponse (Prelude.Maybe [Prelude.Text]) createRoomResponse_loggingConfigurationIdentifiers = Lens.lens (\CreateRoomResponse' {loggingConfigurationIdentifiers} -> loggingConfigurationIdentifiers) (\s@CreateRoomResponse' {} a -> s {loggingConfigurationIdentifiers = a} :: CreateRoomResponse) Prelude.. Lens.mapping Lens.coerced -- | Maximum number of characters in a single message, from the request (if -- specified). createRoomResponse_maximumMessageLength :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.Natural) createRoomResponse_maximumMessageLength = Lens.lens (\CreateRoomResponse' {maximumMessageLength} -> maximumMessageLength) (\s@CreateRoomResponse' {} a -> s {maximumMessageLength = a} :: CreateRoomResponse) -- | Maximum number of messages per second that can be sent to the room (by -- all clients), from the request (if specified). createRoomResponse_maximumMessageRatePerSecond :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.Natural) createRoomResponse_maximumMessageRatePerSecond = Lens.lens (\CreateRoomResponse' {maximumMessageRatePerSecond} -> maximumMessageRatePerSecond) (\s@CreateRoomResponse' {} a -> s {maximumMessageRatePerSecond = a} :: CreateRoomResponse) -- | Configuration information for optional review of messages. createRoomResponse_messageReviewHandler :: Lens.Lens' CreateRoomResponse (Prelude.Maybe MessageReviewHandler) createRoomResponse_messageReviewHandler = Lens.lens (\CreateRoomResponse' {messageReviewHandler} -> messageReviewHandler) (\s@CreateRoomResponse' {} a -> s {messageReviewHandler = a} :: CreateRoomResponse) -- | Room name, from the request (if specified). createRoomResponse_name :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.Text) createRoomResponse_name = Lens.lens (\CreateRoomResponse' {name} -> name) (\s@CreateRoomResponse' {} a -> s {name = a} :: CreateRoomResponse) -- | Tags attached to the resource, from the request (if specified). createRoomResponse_tags :: Lens.Lens' CreateRoomResponse (Prelude.Maybe (Prelude.HashMap Prelude.Text Prelude.Text)) createRoomResponse_tags = Lens.lens (\CreateRoomResponse' {tags} -> tags) (\s@CreateRoomResponse' {} a -> s {tags = a} :: CreateRoomResponse) Prelude.. Lens.mapping Lens.coerced -- | Time of the room’s last update. This is an ISO 8601 timestamp; /note -- that this is returned as a string/. createRoomResponse_updateTime :: Lens.Lens' CreateRoomResponse (Prelude.Maybe Prelude.UTCTime) createRoomResponse_updateTime = Lens.lens (\CreateRoomResponse' {updateTime} -> updateTime) (\s@CreateRoomResponse' {} a -> s {updateTime = a} :: CreateRoomResponse) Prelude.. Lens.mapping Data._Time -- | The response's http status code. createRoomResponse_httpStatus :: Lens.Lens' CreateRoomResponse Prelude.Int createRoomResponse_httpStatus = Lens.lens (\CreateRoomResponse' {httpStatus} -> httpStatus) (\s@CreateRoomResponse' {} a -> s {httpStatus = a} :: CreateRoomResponse) instance Prelude.NFData CreateRoomResponse where rnf CreateRoomResponse' {..} = Prelude.rnf arn `Prelude.seq` Prelude.rnf createTime `Prelude.seq` Prelude.rnf id `Prelude.seq` Prelude.rnf loggingConfigurationIdentifiers `Prelude.seq` Prelude.rnf maximumMessageLength `Prelude.seq` Prelude.rnf maximumMessageRatePerSecond `Prelude.seq` Prelude.rnf messageReviewHandler `Prelude.seq` Prelude.rnf name `Prelude.seq` Prelude.rnf tags `Prelude.seq` Prelude.rnf updateTime `Prelude.seq` Prelude.rnf httpStatus