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/?MaxScheduledRunsPreview=MaxScheduledRunsPreview&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ì
- MaxScheduledRunsPreview
-
Numero di future esecuzioni di backup pianificate da visualizzare in anteprima. Se impostato su 0 (impostazione predefinita), nella risposta non è inclusa alcuna anteprima delle esecuzioni pianificate. L'intervallo valido è 0-10.
Intervallo valido: valore minimo di 0. valore massimo pari a 10.
- 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,
"ScheduledRunsPreview": [
{
"ExecutionTime": number,
"RuleExecutionType": "string",
"RuleId": "string"
}
],
"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
BackupOptionsper 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
BackupPlanNamee uno o più set diRules.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
- ScheduledRunsPreview
-
Elenco delle prossime esecuzioni di backup pianificate. Incluso solo quando
MaxScheduledRunsPreviewil parametro è maggiore di 0. Contiene fino a 10 future esecuzioni di backup con i tempi pianificati, i tipi di esecuzione e le regole IDs associate.Tipo: matrice di oggetti ScheduledPlanExecutionMember
- 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.
- Context
- Type
Codice di stato HTTP: 400
- MissingParameterValueException
-
Indica che manca un parametro obbligatorio.
- Context
- Type
Codice di stato HTTP: 400
- ResourceNotFoundException
-
Una risorsa necessaria per l'azione non esiste.
- 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:
