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à. # CreateBackupPlan Crea un piano di backup utilizzando il nome del piano di backup e le regole di backup. Un piano di backup è un documento che contiene informazioni che vengono AWS Backup utilizzate per pianificare attività che creano punti di ripristino per le risorse. Se chiami `CreateBackupPlan` con un piano già esistente, ricevi un'eccezione `AlreadyExistsException`. ## Sintassi della richiesta ``` PUT /backup/plans/ HTTP/1.1 Content-type: application/json { "BackupPlan": { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanName": "string", "Rules": [ { "CompletionWindowMinutes": number, "CopyActions": [ { "DestinationBackupVaultArn": "string", "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean } } ], "EnableContinuousBackup": boolean, "IndexActions": [ { "ResourceTypes": [ "string" ] } ], "Lifecycle": { "DeleteAfterDays": number, "DeleteAfterEvent": "string", "MoveToColdStorageAfterDays": number, "OptInToArchiveForSupportedResources": boolean }, "RecoveryPointTags": { "string" : "string" }, "RuleName": "string", "ScanActions": [ { "MalwareScanner": "string", "ScanMode": "string" } ], "ScheduleExpression": "string", "ScheduleExpressionTimezone": "string", "StartWindowMinutes": number, "TargetBackupVaultName": "string", "TargetLogicallyAirGappedBackupVaultArn": "string" } ], "ScanSettings": [ { "MalwareScanner": "string", "ResourceTypes": [ "string" ], "ScannerRoleArn": "string" } ] }, "BackupPlanTags": { "string" : "string" }, "CreatorRequestId": "string" } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [BackupPlan](#API_CreateBackupPlan_RequestSyntax) ** Il corpo di un piano di backup. Include un `BackupPlanName` e uno o più set di `Rules`. Tipo: oggetto [BackupPlanInput](API_BackupPlanInput.md) Obbligatorio: sì ** [BackupPlanTags](#API_CreateBackupPlan_RequestSyntax) ** I tag da assegnare al piano di backup. Tipo: mappatura stringa a stringa Obbligatorio: no ** [CreatorRequestId](#API_CreateBackupPlan_RequestSyntax) ** Identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte. Se la richiesta include un `CreatorRequestId` che corrisponde a un piano di backup esistente, tale piano viene restituito. Questo parametro è facoltativo. Se utilizzato, questo parametro deve contenere da 1 a 50 caratteri alfanumerici o '-\$1'. punti (.). ▬Tipo: stringa Obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "AdvancedBackupSettings": [ { "BackupOptions": { "string" : "string" }, "ResourceType": "string" } ], "BackupPlanArn": "string", "BackupPlanId": "string", "CreationDate": number, "VersionId": "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. ** [AdvancedBackupSettings](#API_CreateBackupPlan_ResponseSyntax) ** Le impostazioni per un tipo di risorsa. Questa opzione è disponibile solo per i processi di backup di Windows Volume Shadow Copy Service (VSS). Tipo: matrice di oggetti [AdvancedBackupSetting](API_AdvancedBackupSetting.md) ** [BackupPlanArn](#API_CreateBackupPlan_ResponseSyntax) ** Un nome della risorsa Amazon (ARN) che identifica in modo univoco un piano di backup, ad esempio `arn:aws:backup:us-east-1:123456789012:plan:8F81F553-3A74-4A3F-B93D-B3360DC80C50`. Tipo: String ** [BackupPlanId](#API_CreateBackupPlan_ResponseSyntax) ** L'ID del piano di backup. Tipo: String ** [CreationDate](#API_CreateBackupPlan_ResponseSyntax) ** La data e l'ora di creazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di `CreationDate` è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087. Tipo: Timestamp ** [VersionId](#API_CreateBackupPlan_ResponseSyntax) ** Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. e non possono essere modificati. Tipo: String ## Errori 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 Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/backup-2018-11-15/CreateBackupPlan) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/backup-2018-11-15/CreateBackupPlan)