UpdateFramework - AWS Backup

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á.

UpdateFramework

Atualiza a estrutura especificada.

Sintaxe da Solicitação

PUT /audit/frameworks/frameworkName HTTP/1.1 Content-type: application/json { "FrameworkControls": [ { "ControlInputParameters": [ { "ParameterName": "string", "ParameterValue": "string" } ], "ControlName": "string", "ControlScope": { "ComplianceResourceIds": [ "string" ], "ComplianceResourceTypes": [ "string" ], "Tags": { "string" : "string" } } } ], "FrameworkDescription": "string", "IdempotencyToken": "string" }

URIParâmetros de solicitação

A solicitação usa os seguintes URI parâmetros.

frameworkName

O nome exclusivo de uma framework. Esse nome tem entre 1 e 256 caracteres, começando com uma letra, e consiste em letras (a-z, A-Z), números (0-9) e sublinhados (_).

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Padrão: [a-zA-Z][_a-zA-Z0-9]*

Exigido: Sim

Corpo da Solicitação

A solicitação aceita os seguintes dados no JSON formato.

FrameworkControls

Os controles que compõem a estrutura. Cada controle na lista tem um nome, parâmetros de entrada e escopo.

Tipo: matriz de objetos FrameworkControl

Obrigatório: Não

FrameworkDescription

Uma descrição opcional da framework com no máximo 1.024 caracteres.

Tipo: string

Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 1.024.

Padrão: .*\S.*

Obrigatório: Não

IdempotencyToken

Uma string escolhida pelo cliente que você pode usar para distinguir entre chamadas idênticas para UpdateFrameworkInput. Tentar novamente uma solicitação com êxito com o mesmo token de idempotência resultará em uma mensagem de êxito sem nenhuma ação tomada.

Tipo: string

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200 Content-type: application/json { "CreationTime": number, "FrameworkArn": "string", "FrameworkName": "string" }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.

Os dados a seguir são retornados em JSON formato pelo serviço.

CreationTime

A data e a hora em que uma estrutura é criada, na representação ISO 8601. O valor de CreationTime tem precisão de milissegundos. Por exemplo, 2020-07-10T 15:00:00.000-08:00 representa o dia 10 de julho de 2020 às 15:00 com 8 horas de atraso. UTC

Tipo: carimbo de data/hora

FrameworkArn

Um nome de recurso da Amazon (ARN) que identifica exclusivamente um recurso. O formato do ARN depende do tipo de recurso.

Tipo: string

FrameworkName

O nome exclusivo de uma framework. Esse nome tem entre 1 e 256 caracteres, começando com uma letra, e consiste em letras (a-z, A-Z), números (0-9) e sublinhados (_).

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256.

Padrão: [a-zA-Z][_a-zA-Z0-9]*

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

AlreadyExistsException

O recurso necessário já existe.

HTTPCódigo de status: 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.

HTTPCódigo de status: 400

InvalidParameterValueException

Indica que há algo errado com o valor de um parâmetro. Por exemplo, o valor está fora do intervalo.

HTTPCódigo de status: 400

LimitExceededException

Um limite na solicitação foi excedido; por exemplo, o número máximo de itens permitidos em uma solicitação.

HTTPCódigo de status: 400

MissingParameterValueException

Indica que um parâmetro necessário está ausente.

HTTPCódigo de status: 400

ResourceNotFoundException

Um recurso necessário para a ação não existe.

HTTPCódigo de status: 400

ServiceUnavailableException

Houve falha na solicitação devido a um erro temporário do servidor.

HTTPCódigo de status: 500

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: