As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateTieringConfiguration
Cria uma configuração de camadas.
Uma configuração hierárquica permite a movimentação automática dos dados de backup para um nível de armazenamento de menor custo, com base na idade dos objetos de backup no cofre de backup.
Cada cofre só pode ter uma configuração de classificação por níveis específica do cofre, além de qualquer configuração global que se aplique a todos os cofres.
Sintaxe da Solicitação
PUT /tiering-configurations HTTP/1.1
Content-type: application/json
{
"CreatorRequestId": "string",
"TieringConfiguration": {
"BackupVaultName": "string",
"ResourceSelection": [
{
"Resources": [ "string" ],
"ResourceType": "string",
"TieringDownSettingsInDays": number
}
],
"TieringConfigurationName": "string"
},
"TieringConfigurationTags": {
"string" : "string"
}
}Parâmetros da solicitação de URI
A solicitação não usa nenhum parâmetro de URI.
Corpo da Solicitação
A solicitação aceita os dados a seguir no formato JSON.
- CreatorRequestId
-
Essa é uma string exclusiva que identifica a solicitação e permite que solicitações com falha sejam repetidas sem o risco de executar a operação duas vezes. Esse parâmetro é opcional. Se usado, esse parâmetro deve conter de 1 a 50 caracteres alfanuméricos ou “-_” .
Tipo: string
Obrigatório: não
- TieringConfiguration
-
Uma configuração de camadas deve conter uma
TieringConfigurationNamestring exclusiva criada por você e deve conter umBackupVaultNamee.ResourceSelectionOpcionalmente, você pode incluir umaCreatorRequestIdstring.A
TieringConfigurationNameé uma string exclusiva que é o nome da configuração de camadas. Ele não pode ser alterado após a criação e deve consistir somente em caracteres alfanuméricos e sublinhados.Tipo: objeto TieringConfigurationInputForCreate
Obrigatório: sim
- TieringConfigurationTags
-
As tags a serem atribuídas à configuração de camadas.
Tipo: mapa de string para string
Obrigatório: Não
Sintaxe da resposta
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"TieringConfigurationArn": "string",
"TieringConfigurationName": "string"
}Elementos de resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- CreationTime
-
A data e a hora em que uma configuração de camadas foi criada, no formato Unix e no Tempo Universal Coordenado (UTC). O valor de
CreationTimetem precisão de milissegundos. Por exemplo, o valor 1516925490,087 representa sexta-feira, 26 de janeiro de 2018, 0:11:30,087.Tipo: carimbo de data/hora
- TieringConfigurationArn
-
Um nome de recurso da Amazon (ARN) que identifica de forma exclusiva a configuração de camadas criada.
Tipo: string
- TieringConfigurationName
-
Essa string exclusiva é o nome da configuração de camadas.
O nome não poderá ser alterado após a criação. Ele só pode conter caracteres alfanuméricos e sublinhados. O comprimento máximo é 200.
Tipo: string
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- AlreadyExistsException
-
O recurso necessário já existe.
- Arn
- Context
- CreatorRequestId
- Type
Código de status HTTP: 400
- ConflictException
-
AWS Backup não pode realizar a ação que você solicitou até que termine de executar uma ação anterior. Tente novamente mais tarde.
- Context
- Type
Código de status HTTP: 400
- InvalidParameterValueException
-
Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.
- Context
- Type
Código de status HTTP: 400
- LimitExceededException
-
Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.
- Context
- Type
Código de status HTTP: 400
- MissingParameterValueException
-
Indica que um parâmetro necessário está ausente.
- Context
- Type
Código de status HTTP: 400
- ServiceUnavailableException
-
Houve falha na solicitação devido a um erro temporário do servidor.
- Context
- Type
Código de status HTTP: 500
Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
