Network.AWS.Glacier.CreateVault

This operation creates a new vault with the specified name. The name of the vault must be unique within a region for an AWS account. You can create up to 1,000 vaults per account. If you need to create more vaults, contact Amazon Glacier.

You must use the following guidelines when naming a vault.

• Names can be between 1 and 255 characters long.
• Allowed characters are a-z, A-Z, 0-9, '_' (underscore), - (hyphen), and . (period).

This operation is idempotent.

An AWS account has full permission to perform all operations (actions). However, AWS Identity and Access Management (IAM) users don't have any permissions by default. You must grant them explicit permission to perform specific actions. For more information, see Access Control Using AWS Identity and Access Management (IAM) .

For conceptual information and underlying REST API, see Creating a Vault in Amazon Glacier and Create Vault in the Amazon Glacier Developer Guide .

Creating a Request

createVault

Arguments

:: Text

cvAccountId

-> Text

cvVaultName

-> CreateVault

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

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

• cvAccountId - The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '- ' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens (-) in the ID.
• cvVaultName - The name of the vault.

data CreateVault

Provides options to create a vault.

See: createVault smart constructor.

Instances

Eq CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

(==) :: CreateVault -> CreateVault -> Bool

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

Data CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

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

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

toConstr :: CreateVault -> Constr

dataTypeOf :: CreateVault -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

readsPrec :: Int -> ReadS CreateVault

readList :: ReadS [CreateVault]

readPrec :: ReadPrec CreateVault

readListPrec :: ReadPrec [CreateVault]

Show CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

showsPrec :: Int -> CreateVault -> ShowS

show :: CreateVault -> String

showList :: [CreateVault] -> ShowS

Generic CreateVault

Defined in Network.AWS.Glacier.CreateVault

Associated Types

type Rep CreateVault :: Type -> Type

Methods

from :: CreateVault -> Rep CreateVault x

to :: Rep CreateVault x -> CreateVault

Hashable CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

hashWithSalt :: Int -> CreateVault -> Int

hash :: CreateVault -> Int

ToJSON CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

toJSON :: CreateVault -> Value

toEncoding :: CreateVault -> Encoding

toJSONList :: [CreateVault] -> Value

toEncodingList :: [CreateVault] -> Encoding

AWSRequest CreateVault

Defined in Network.AWS.Glacier.CreateVault

Associated Types

type Rs CreateVault :: Type

Methods

request :: CreateVault -> Request CreateVault

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

ToHeaders CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

toHeaders :: CreateVault -> [Header]

ToPath CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

toPath :: CreateVault -> ByteString

ToQuery CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

toQuery :: CreateVault -> QueryString

NFData CreateVault

Defined in Network.AWS.Glacier.CreateVault

Methods

rnf :: CreateVault -> ()

type Rep CreateVault

Defined in Network.AWS.Glacier.CreateVault

type Rep CreateVault = D1 (MetaData "CreateVault" "Network.AWS.Glacier.CreateVault" "amazonka-glacier-1.6.1-1jk94OYE8nZKrGhzWrcb8m" False) (C1 (MetaCons "CreateVault'" PrefixI True) (S1 (MetaSel (Just "_cvAccountId") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text) :*: S1 (MetaSel (Just "_cvVaultName") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Text)))

type Rs CreateVault

Defined in Network.AWS.Glacier.CreateVault

type Rs CreateVault = CreateVaultResponse

Request Lenses

cvAccountId :: Lens' CreateVault Text

The AccountId value is the AWS account ID. This value must match the AWS account ID associated with the credentials used to sign the request. You can either specify an AWS account ID or optionally a single '- ' (hyphen), in which case Amazon Glacier uses the AWS account ID associated with the credentials used to sign the request. If you specify your account ID, do not include any hyphens (-) in the ID.

cvVaultName :: Lens' CreateVault Text

The name of the vault.

Destructuring the Response

createVaultResponse

Arguments

:: Int

cvrsResponseStatus

-> CreateVaultResponse

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

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

• cvrsLocation - The URI of the vault that was created.
• cvrsResponseStatus - -- | The response status code.

data CreateVaultResponse

Contains the Amazon Glacier response to your request.

See: createVaultResponse smart constructor.

Instances

Eq CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Methods

(==) :: CreateVaultResponse -> CreateVaultResponse -> Bool

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

Data CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Methods

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

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

toConstr :: CreateVaultResponse -> Constr

dataTypeOf :: CreateVaultResponse -> DataType

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

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

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

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

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

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

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

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

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

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

Read CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Methods

readsPrec :: Int -> ReadS CreateVaultResponse

readList :: ReadS [CreateVaultResponse]

readPrec :: ReadPrec CreateVaultResponse

readListPrec :: ReadPrec [CreateVaultResponse]

Show CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Methods

showsPrec :: Int -> CreateVaultResponse -> ShowS

show :: CreateVaultResponse -> String

showList :: [CreateVaultResponse] -> ShowS

Generic CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Associated Types

type Rep CreateVaultResponse :: Type -> Type

Methods

from :: CreateVaultResponse -> Rep CreateVaultResponse x

to :: Rep CreateVaultResponse x -> CreateVaultResponse

NFData CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

Methods

rnf :: CreateVaultResponse -> ()

type Rep CreateVaultResponse

Defined in Network.AWS.Glacier.CreateVault

type Rep CreateVaultResponse = D1 (MetaData "CreateVaultResponse" "Network.AWS.Glacier.CreateVault" "amazonka-glacier-1.6.1-1jk94OYE8nZKrGhzWrcb8m" False) (C1 (MetaCons "CreateVaultResponse'" PrefixI True) (S1 (MetaSel (Just "_cvrsLocation") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 (Maybe Text)) :*: S1 (MetaSel (Just "_cvrsResponseStatus") NoSourceUnpackedness SourceStrict DecidedStrict) (Rec0 Int)))

Response Lenses

cvrsLocation :: Lens' CreateVaultResponse (Maybe Text)

The URI of the vault that was created.

cvrsResponseStatus :: Lens' CreateVaultResponse Int

• - | The response status code.