{-# LANGUAGE DataKinds #-} {-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE FlexibleInstances #-} {-# LANGUAGE GeneralizedNewtypeDeriving #-} {-# LANGUAGE LambdaCase #-} {-# LANGUAGE NoImplicitPrelude #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE TypeFamilies #-} {-# OPTIONS_GHC -fno-warn-unused-imports #-} -- Module : Network.AWS.Glacier.CreateVault -- Copyright : (c) 2013-2014 Brendan Hay -- License : This Source Code Form is subject to the terms of -- the Mozilla Public License, v. 2.0. -- A copy of the MPL can be found in the LICENSE file or -- you can obtain it at http://mozilla.org/MPL/2.0/. -- Maintainer : Brendan Hay -- Stability : experimental -- Portability : non-portable (GHC extensions) -- -- Derived from AWS service descriptions, licensed under Apache 2.0. -- | 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 . -- -- For conceptual information and underlying REST API, go to and in the /Amazon Glacier Developer Guide/. -- -- module Network.AWS.Glacier.CreateVault ( -- * Request CreateVault -- ** Request constructor , createVault -- ** Request lenses , cvAccountId , cvVaultName -- * Response , CreateVaultResponse -- ** Response constructor , createVaultResponse -- ** Response lenses , cvrLocation ) where import Network.AWS.Prelude import Network.AWS.Request.RestJSON import Network.AWS.Glacier.Types import qualified GHC.Exts data CreateVault = CreateVault { _cvAccountId :: Text , _cvVaultName :: Text } deriving (Eq, Ord, Read, Show) -- | 'CreateVault' constructor. -- -- The fields accessible through corresponding lenses are: -- -- * 'cvAccountId' @::@ 'Text' -- -- * 'cvVaultName' @::@ 'Text' -- createVault :: Text -- ^ 'cvAccountId' -> Text -- ^ 'cvVaultName' -> CreateVault createVault p1 p2 = CreateVault { _cvAccountId = p1 , _cvVaultName = p2 } -- | The 'AccountId' is the AWS Account ID. You can specify either the AWS Account -- ID or optionally a '-', 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 hyphens in it. cvAccountId :: Lens' CreateVault Text cvAccountId = lens _cvAccountId (\s a -> s { _cvAccountId = a }) -- | The name of the vault. cvVaultName :: Lens' CreateVault Text cvVaultName = lens _cvVaultName (\s a -> s { _cvVaultName = a }) newtype CreateVaultResponse = CreateVaultResponse { _cvrLocation :: Maybe Text } deriving (Eq, Ord, Read, Show, Monoid) -- | 'CreateVaultResponse' constructor. -- -- The fields accessible through corresponding lenses are: -- -- * 'cvrLocation' @::@ 'Maybe' 'Text' -- createVaultResponse :: CreateVaultResponse createVaultResponse = CreateVaultResponse { _cvrLocation = Nothing } -- | The URI of the vault that was created. cvrLocation :: Lens' CreateVaultResponse (Maybe Text) cvrLocation = lens _cvrLocation (\s a -> s { _cvrLocation = a }) instance ToPath CreateVault where toPath CreateVault{..} = mconcat [ "/" , toText _cvAccountId , "/vaults/" , toText _cvVaultName ] instance ToQuery CreateVault where toQuery = const mempty instance ToHeaders CreateVault instance ToJSON CreateVault where toJSON = const (toJSON Empty) instance AWSRequest CreateVault where type Sv CreateVault = Glacier type Rs CreateVault = CreateVaultResponse request = put response = headerResponse $ \h -> CreateVaultResponse <$> h ~:? "Location"