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à.
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]*
Campo 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: string
Campo 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
Campo obbligatorio: no
- ReportPlanDescription
-
Descrizione facoltativa del piano di report, per un massimo di 1.024 caratteri.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.
Modello:
.*\S.*
Campo 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
Campo 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: stringa
- ReportPlanName
-
Il nome univoco del piano di report.
Tipo: stringa
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 Errori comuni.
- ConflictException
-
AWS Backup non può eseguire l'azione richiesta finché non termina l'esecuzione di un'azione precedente. Riprova più tardi.
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.
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
Codice di stato HTTP: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
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: