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" }

Parâmetros da Solicitação de URI

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

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. Comprimento máximo de 256.

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

Exigido: Sim

Corpo da Solicitação

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

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: sequência

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

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

CreationTime

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

Tipo: carimbo de data/hora

FrameworkArn

Um Nome do recurso da Amazon (ARN) que identifica de forma exclusiva um recurso. O formato do ARN depende do tipo de recurso.

Tipo: sequência

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: sequência

Restrições de Tamanho: Tamanho Mínimo 1. Comprimento 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.

Código de Status HTTP: 400

ConflictException

AWS Backup não pode realizar a ação que você solicitou até que ela termine de executar uma ação anterior. Tente novamente mais tarde.

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.

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.

Código de Status HTTP: 400

MissingParameterValueException

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

Código de Status HTTP: 400

ResourceNotFoundException

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

Código de Status HTTP: 400

ServiceUnavailableException

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

Código de Status HTTP: 500

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: