Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# CreateReportPlan
<a name="API_CreateReportPlan"></a>

Crea un plan de informe. Un plan de informes es un documento que contiene información sobre el contenido del informe y dónde AWS Backup se entregará.

Si llama a `CreateReportPlan` con un plan que ya existe, recibirá una excepción `AlreadyExistsException`.

## Sintaxis de la solicitud
<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"
   }
}
```

## Parámetros de solicitud del URI
<a name="API_CreateReportPlan_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_CreateReportPlan_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [IdempotencyToken](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-IdempotencyToken"></a>
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a `CreateReportPlanInput` que, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.  
Tipo: cadena  
Requerido: no

 ** [ReportDeliveryChannel](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportDeliveryChannel"></a>
Una estructura que contiene información sobre dónde y cómo entregar sus informes, específicamente el nombre del bucket de Amazon S3, el prefijo de clave de S3 y los formatos de sus informes.  
Tipo: objeto [ReportDeliveryChannel](API_ReportDeliveryChannel.md)  
Obligatorio: sí

 ** [ReportPlanDescription](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanDescription"></a>
Una descripción opcional del plan de informes con un máximo de 1024 caracteres.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.  
Patrón: `.*\S.*`   
Obligatorio: no

 ** [ReportPlanName](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanName"></a>
El nombre único del plan de informes. El nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (\$1).  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*`   
Obligatorio: sí

 ** [ReportPlanTags](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportPlanTags"></a>
Las etiquetas que se van a asignar al plan de informe.  
Tipo: mapa de cadena a cadena  
Obligatorio: no

 ** [ReportSetting](#API_CreateReportPlan_RequestSyntax) **   <a name="Backup-CreateReportPlan-request-ReportSetting"></a>
Identifica la plantilla para el informe. Los informes se crean mediante una plantilla. Las plantillas de informes son:  
 `RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT | SCAN_JOB_REPORT `   
Si la plantilla del informe es `RESOURCE_COMPLIANCE_REPORT` o`CONTROL_COMPLIANCE_REPORT`, este recurso de API también describe la cobertura del informe por marcos Regiones de AWS y marcos.  
Tipo: objeto [ReportSetting](API_ReportSetting.md)  
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_CreateReportPlan_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_CreateReportPlan_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [CreationTime](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-CreationTime"></a>
La fecha y la hora en que se creó la lista de dominios, en formato Unix y horario universal coordinado (UTC). El valor de `CreationTime` tiene una precisión de milisegundos. Por ejemplo, el valor 1516925490.087 representa el viernes 26 de enero de 2018 a las 12:11:30.087 h.  
Tipo: marca temporal

 ** [ReportPlanArn](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanArn"></a>
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.  
Tipo: cadena

 ** [ReportPlanName](#API_CreateReportPlan_ResponseSyntax) **   <a name="Backup-CreateReportPlan-response-ReportPlanName"></a>
El nombre único del plan de informes.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z][_a-zA-Z0-9]*` 

## Errores
<a name="API_CreateReportPlan_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AlreadyExistsException **   
El recurso ya existe.    
 ** Arn **   
  
 ** Context **   
  
 ** CreatorRequestId **   
  
 ** Type **   

Código de estado HTTP: 400

 ** InvalidParameterValueException **   
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** LimitExceededException **   
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** MissingParameterValueException **   
Indica que falta un parámetro obligatorio.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 400

 ** ServiceUnavailableException **   
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.    
 ** Context **   
  
 ** Type **   

Código de estado HTTP: 500

## Véase también
<a name="API_CreateReportPlan_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateReportPlan) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateReportPlan)