GetBackupPlan - AWS Backup
Sintassi della richiestaParametri della richiesta URICorpo 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à.

GetBackupPlan

Restituisce i dettagli BackupPlan per il BackupPlanId specificato. I dettagli sono il corpo di un piano di backup in formato JSON, in aggiunta ai metadati del piano.

Sintassi della richiesta

GET /backup/plans/backupPlanId/?versionId=VersionId HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

backupPlanId

Identifica in modo univoco un piano di backup.

Campo obbligatorio: sì

VersionId

Stringhe con codifica UTF-8 Unicode univoche generate casualmente con lunghezza massimo di 1.024 byte. La versione IDs non può essere modificata.

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "AdvancedBackupSettings": [ 
      { 
         "BackupOptions": { 
            "string" : "string" 
         },
         "ResourceType": "string"
      }
   ],
   "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" 
            },
            "RuleId": "string",
            "RuleName": "string",
            "ScheduleExpression": "string",
            "ScheduleExpressionTimezone": "string",
            "StartWindowMinutes": number,
            "TargetBackupVaultName": "string"
         }
      ]
   },
   "BackupPlanArn": "string",
   "BackupPlanId": "string",
   "CreationDate": number,
   "CreatorRequestId": "string",
   "DeletionDate": number,
   "LastExecutionDate": 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

Contiene un elenco di BackupOptions per ogni tipo di risorsa. L'elenco viene compilato solo se l'opzione avanzata è impostata per il piano di backup.

Tipo: matrice di oggetti AdvancedBackupSetting

BackupPlan

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

Tipo: oggetto BackupPlan

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

Identifica in modo univoco un 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

CreatorRequestId

Una stringa univoca che identifica la richiesta e consente di riprovare le richieste non riuscite senza il rischio di eseguire l'operazione due volte.

Tipo: stringa

DeletionDate

La data e ora di eliminazione di un piano di backup, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di DeletionDate è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.

Tipo: Timestamp

LastExecutionDate

L'ultima volta che è stato eseguito questo piano di backup. Una data e ora, in formato UNIX e nell'ora Universal Coordinated Time (UTC). Il valore di LastExecutionDate è 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. La versione IDs non può essere modificata.

Tipo: stringa

Errori

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

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

MissingParameterValueException

Indica che manca un parametro obbligatorio.

Codice di stato HTTP: 400

ResourceNotFoundException

Una risorsa necessaria per l'azione non esiste.

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: