CreateBackupPlan - AWS Backup
Sintassi della richiestaURIParametri della richiestaCorpo 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 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,
                     "MoveToColdStorageAfterDays": number,
                     "OptInToArchiveForSupportedResources": boolean
                  }
               }
            ],
            "EnableContinuousBackup": boolean,
            "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"
}

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

AdvancedBackupSettings

Le impostazioni per un tipo di risorsa. Questa opzione è disponibile solo per i job di backup di Windows Volume Shadow Copy Service (VSS).

Tipo: matrice di oggetti AdvancedBackupSetting

BackupPlanArn

Un Amazon Resource Name (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

Data e ora di creazione di un piano di backup, in formato Unix e Coordinated Universal Time (UTC). 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 uniche, generate casualmente, con codifica Unicode a UTF -8, lunghe al massimo 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à.

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: