UpdateReportPlan - AWS Backup
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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

UpdateReportPlan

Atualiza o plano de relatório especificado.

Sintaxe da Solicitação

PUT /audit/report-plans/reportPlanName HTTP/1.1
Content-type: application/json

{
   "IdempotencyToken": "string",
   "ReportDeliveryChannel": { 
      "Formats": [ "string" ],
      "S3BucketName": "string",
      "S3KeyPrefix": "string"
   },
   "ReportPlanDescription": "string",
   "ReportSetting": { 
      "Accounts": [ "string" ],
      "FrameworkArns": [ "string" ],
      "NumberOfFrameworks": number,
      "OrganizationUnits": [ "string" ],
      "Regions": [ "string" ],
      "ReportTemplate": "string"
   }
}

URIParâmetros de solicitação

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

reportPlanName

O nome exclusivo do plano de relatório. 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.

IdempotencyToken

Uma string escolhida pelo cliente que pode ser usada para distinguir entre chamadas idênticas para UpdateReportPlanInput. 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

ReportDeliveryChannel

As informações sobre onde entregar seus relatórios, especificamente o nome do bucket do Amazon S3, o prefixo da chave do S3 e os formatos dos seus relatórios.

Tipo: objeto ReportDeliveryChannel

Obrigatório: Não

ReportPlanDescription

Uma descrição opcional do plano de relatório 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

ReportSetting

O modelo de relatório para o relatório. Relatórios são criados utilizando um modelo de relatório. Os modelos de relatório são:

RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT

Se o modelo de relatório for RESOURCE_COMPLIANCE_REPORT ouCONTROL_COMPLIANCE_REPORT, esse API recurso também descreve a cobertura do relatório por Regiões da AWS estruturas.

Tipo: objeto ReportSetting

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "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 um plano de relatório é criado, no formato Unix e no Tempo Universal Coordenado (UTC). O valor de CreationTime tem 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

ReportPlanArn

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

Tipo: string

ReportPlanName

O nome exclusivo do plano de relatório.

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 retornados pelas ações, consulte Erros comuns.

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.

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

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: