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
<a name="API_CreateReportPlan"></a>

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
<a name="API_CreateReportPlan_RequestSyntax"></a>

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

## Parametri della richiesta URI:
<a name="API_CreateReportPlan_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateReportPlan_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
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: stringa  
Obbligatorio: no

 ** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
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](API_ReportDeliveryChannel.md)  
Obbligatorio: sì

 ** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
Una descrizione facoltativa del piano di report, con un massimo di 1.024 caratteri.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.  
Modello: `.*\S.*`   
Obbligatorio: no

 ** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
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 (\$1).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z][_a-zA-Z0-9]*`   
Obbligatorio: sì

 ** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
I tag da assegnare al piano di report.  
Tipo: mappatura stringa a stringa  
Obbligatorio: no

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
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_REPORT | SCAN_JOB_REPORT `   
Se il modello di report è `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, questa risorsa API descrive anche la copertura del report Regioni AWS e i framework.  
Tipo: oggetto [ReportSetting](API_ReportSetting.md)  
Obbligatorio: sì

## Sintassi della risposta
<a name="API_CreateReportPlan_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "ReportPlanArn": "string",
   "ReportPlanName": "string"
}
```

## Elementi di risposta
<a name="API_CreateReportPlan_ResponseElements"></a>

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

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

 ** [CreationTime](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-CreationTime"></a>
La data e l'ora di creazione di un vault di backup, 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](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
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](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
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
<a name="API_CreateReportPlan_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AlreadyExistsException **   
La risorsa richiesta esiste già.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** 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

 ** LimitExceededException **   
È stato superato un limite nella richiesta, ad esempio il numero massimo di elementi consentiti in una richiesta.    
 ** Context **   
  
 ** Type **   

Codice di stato HTTP: 400

 ** MissingParameterValueException **   
Indica che manca un parametro obbligatorio.    
 ** 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
<a name="API_CreateReportPlan_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateReportPlan)