View a markdown version of this page

UpdateReportPlan - AWS Backup

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateReportPlan

Aggiorna il piano di report specificato.

Sintassi della richiesta

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

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

reportPlanName

Il nome univoco del piano di report. Contiene da 1 a 256 caratteri, a partire da una lettera, ed è costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (_).

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z][_a-zA-Z0-9]*

Obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

IdempotencyToken

Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a UpdateReportPlanInput. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.

▬Tipo: stringa

Obbligatorio: no

ReportDeliveryChannel

Le informazioni su dove inviare i report, in particolare il nome del bucket Amazon S3, il prefisso della chiave S3 e i formati dei report.

Tipo: oggetto ReportDeliveryChannel

Obbligatorio: no

ReportPlanDescription

Descrizione facoltativa del piano di report, per un massimo di 1.024 caratteri.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.

Modello: .*\S.*

Obbligatorio: no

ReportSetting

Il modello di report per il report. I report vengono creati utilizzando un modello di report. I modelli di report sono:

RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT

Se il modello di report è RESOURCE_COMPLIANCE_REPORT oCONTROL_COMPLIANCE_REPORT, questa risorsa API descrive anche la copertura del report Regioni AWS e i framework.

Tipo: oggetto ReportSetting

Obbligatorio: no

Sintassi della risposta

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

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

CreationTime

La data e l'ora di creazione di un piano di report, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di CreationTime è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.

Tipo: Timestamp

ReportPlanArn

Un nome della risorsa Amazon (ARN) che identifica in modo univoco una risorsa. Il formato dell'ARN dipende dal tipo di risorsa.

Tipo: String

ReportPlanName

Il nome univoco del piano di report.

Tipo: String

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z][_a-zA-Z0-9]*

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Tipi di errore comuni.

ConflictException

AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.

Context

Type

Codice di stato HTTP: 400

InvalidParameterValueException

Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.

Context

Type

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Context

Type

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

Context

Type

Codice di stato HTTP: 400

ServiceUnavailableException

La richiesta non è riuscita a causa di un errore temporaneo del server.

Context

Type

Codice di stato HTTP: 500

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: