Amazonka.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 S3 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

data CreateVault

Provides options to create a vault.

See: newCreateVault smart constructor.

Constructors

CreateVault'

Fields

• accountId :: 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 S3 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.

• vaultName :: Text

  The name of the vault.

Instances

ToJSON CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

toJSON :: CreateVault -> Value

toEncoding :: CreateVault -> Encoding

toJSONList :: [CreateVault] -> Value

toEncodingList :: [CreateVault] -> Encoding

ToHeaders CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

toHeaders :: CreateVault -> [Header]

ToPath CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

toPath :: CreateVault -> ByteString

ToQuery CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

toQuery :: CreateVault -> QueryString

AWSRequest CreateVault

Defined in Amazonka.Glacier.CreateVault

Associated Types

type AWSResponse CreateVault

Methods

request :: (Service -> Service) -> CreateVault -> Request CreateVault

response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy CreateVault -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CreateVault)))

Generic CreateVault

Defined in Amazonka.Glacier.CreateVault

Associated Types

type Rep CreateVault :: Type -> Type

Methods

from :: CreateVault -> Rep CreateVault x

to :: Rep CreateVault x -> CreateVault

Read CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

readsPrec :: Int -> ReadS CreateVault

readList :: ReadS [CreateVault]

readPrec :: ReadPrec CreateVault

readListPrec :: ReadPrec [CreateVault]

Show CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

showsPrec :: Int -> CreateVault -> ShowS

show :: CreateVault -> String

showList :: [CreateVault] -> ShowS

NFData CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

rnf :: CreateVault -> ()

Eq CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

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

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

Hashable CreateVault

Defined in Amazonka.Glacier.CreateVault

Methods

hashWithSalt :: Int -> CreateVault -> Int

hash :: CreateVault -> Int

type AWSResponse CreateVault

Defined in Amazonka.Glacier.CreateVault

type AWSResponse CreateVault = CreateVaultResponse

type Rep CreateVault

Defined in Amazonka.Glacier.CreateVault

type Rep CreateVault = D1 ('MetaData "CreateVault" "Amazonka.Glacier.CreateVault" "amazonka-glacier-2.0-17Kmjv8nUJeKOtbrjLyy76" 'False) (C1 ('MetaCons "CreateVault'" 'PrefixI 'True) (S1 ('MetaSel ('Just "accountId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "vaultName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newCreateVault

Arguments

:: Text

$sel:accountId:CreateVault'

-> Text

CreateVault

-> CreateVault

Create a value of CreateVault with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:accountId:CreateVault', createVault_accountId - 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 S3 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.

CreateVault, createVault_vaultName - The name of the vault.

Request Lenses

createVault_accountId :: 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 S3 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.

createVault_vaultName :: Lens' CreateVault Text

The name of the vault.

Destructuring the Response

data CreateVaultResponse

Contains the Amazon S3 Glacier response to your request.

See: newCreateVaultResponse smart constructor.

Constructors

CreateVaultResponse'

Fields

• location :: Maybe Text

  The URI of the vault that was created.

• httpStatus :: Int

  The response's http status code.

Instances

Generic CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

Associated Types

type Rep CreateVaultResponse :: Type -> Type

Methods

from :: CreateVaultResponse -> Rep CreateVaultResponse x

to :: Rep CreateVaultResponse x -> CreateVaultResponse

Read CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

Methods

readsPrec :: Int -> ReadS CreateVaultResponse

readList :: ReadS [CreateVaultResponse]

readPrec :: ReadPrec CreateVaultResponse

readListPrec :: ReadPrec [CreateVaultResponse]

Show CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

Methods

showsPrec :: Int -> CreateVaultResponse -> ShowS

show :: CreateVaultResponse -> String

showList :: [CreateVaultResponse] -> ShowS

NFData CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

Methods

rnf :: CreateVaultResponse -> ()

Eq CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

Methods

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

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

type Rep CreateVaultResponse

Defined in Amazonka.Glacier.CreateVault

type Rep CreateVaultResponse = D1 ('MetaData "CreateVaultResponse" "Amazonka.Glacier.CreateVault" "amazonka-glacier-2.0-17Kmjv8nUJeKOtbrjLyy76" 'False) (C1 ('MetaCons "CreateVaultResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "location") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCreateVaultResponse

Arguments

:: Int

$sel:httpStatus:CreateVaultResponse'

-> CreateVaultResponse

Create a value of CreateVaultResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

CreateVaultResponse, createVaultResponse_location - The URI of the vault that was created.

$sel:httpStatus:CreateVaultResponse', createVaultResponse_httpStatus - The response's http status code.

Response Lenses

createVaultResponse_location :: Lens' CreateVaultResponse (Maybe Text)

The URI of the vault that was created.

createVaultResponse_httpStatus :: Lens' CreateVaultResponse Int

The response's http status code.