CreateBackupPlan - AWS Backup
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 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,
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "IndexActions": [ 
               { 
                  "ResourceTypes": [ "string" ]
               }
            ],
            "Lifecycle": { 
               "DeleteAfterDays": number,
               "MoveToColdStorageAfterDays": number,
               "OptInToArchiveForSupportedResources": boolean
            },
            "RecoveryPointTags": { 
               "string" : "string" 
            },
            "RuleName": "string",
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "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

Il corpo di un piano di backup. Include un BackupPlanName e uno o più set di Rules.

Tipo: oggetto BackupPlanInput

Campo obbligatorio: sì

BackupPlanTags

I tag da assegnare al piano di backup.

Tipo: mappatura stringa a stringa

Campo obbligatorio: no

CreatorRequestId

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 '-_'. punti (.).

Tipo: string

Campo 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

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

BackupPlanArn

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: stringa

BackupPlanId

L'ID del piano di backup.

Tipo: stringa

CreationDate

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

Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. e non possono essere modificati.

Tipo: stringa

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AlreadyExistsException

La risorsa richiesta esiste già.

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

LimitExceededException

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

Codice di stato HTTP: 400

MissingParameterValueException

Indica che manca un parametro obbligatorio.

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: