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à.
CreateReportPlan
Crea un piano di report. Un piano di segnalazione è un documento che contiene informazioni sul contenuto del rapporto e su dove AWS Backup verrà consegnato.
Se chiami CreateReportPlan con un piano già esistente, ricevi un'eccezione AlreadyExistsException.
Sintassi della richiesta
POST /audit/report-plans HTTP/1.1
Content-type: application/json
{
"IdempotencyToken": "string",
"ReportDeliveryChannel": {
"Formats": [ "string" ],
"S3BucketName": "string",
"S3KeyPrefix": "string"
},
"ReportPlanDescription": "string",
"ReportPlanName": "string",
"ReportPlanTags": {
"string" : "string"
},
"ReportSetting": {
"Accounts": [ "string" ],
"FrameworkArns": [ "string" ],
"NumberOfFrameworks": number,
"OrganizationUnits": [ "string" ],
"Regions": [ "string" ],
"ReportTemplate": "string"
}
}URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- IdempotencyToken
-
Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a
CreateReportPlanInput. 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
-
Una struttura contenente informazioni su dove e come consegnare 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: sì
- ReportPlanDescription
-
Una descrizione facoltativa del piano di report, con 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
- ReportPlanName
-
Il nome univoco del piano di report. Il nome deve essere compreso tra 1 e 256 caratteri, deve iniziare con una lettera ed essere costituito da lettere (a-z, A-Z), numeri (0-9) e caratteri di sottolineatura (_).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z][_a-zA-Z0-9]*Campo obbligatorio: sì
- ReportPlanTags
-
I tag da assegnare al piano di report.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
- ReportSetting
-
Identifica 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_REPORTSe il modello di rapporto è
RESOURCE_COMPLIANCE_REPORToCONTROL_COMPLIANCE_REPORT, questa API risorsa descrive anche la copertura del rapporto Regioni AWS e i framework.Tipo: oggetto ReportSetting
Campo obbligatorio: sì
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"ReportPlanArn": "string",
"ReportPlanName": "string"
}Elementi di risposta
Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- CreationTime
-
Data e ora di creazione di un archivio di backup, in formato Unix e Coordinated Universal Time ()UTC. 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 Amazon Resource Name (ARN) che identifica in modo univoco una risorsa. Il formato di 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.
- AlreadyExistsException
-
La risorsa richiesta esiste già.
HTTPCodice di stato: 400
- InvalidParameterValueException
-
Indica che si è verificato un errore con il valore di un parametro. Ad esempio, il valore non è compreso nell'intervallo.
HTTPCodice di stato: 400
- LimitExceededException
-
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.
HTTPCodice di stato: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
HTTPCodice di stato: 400
- ServiceUnavailableException
-
La richiesta non è riuscita a causa di un errore temporaneo del server.
HTTPCodice di stato: 500
Vedi anche
Per ulteriori informazioni sull'utilizzo di questo API codice in una delle lingue specifiche AWS SDKs, consulta quanto segue:
