DescribeRecoveryPoint

Restituisce i metadati associati a un punto di ripristino, inclusi ID, stato, crittografia e ciclo di vita.

Sintassi della richiesta

GET /backup-vaults/backupVaultName/recovery-points/recoveryPointArn?backupVaultAccountId=BackupVaultAccountId HTTP/1.1

Parametri della richiesta URI

La richiesta utilizza i seguenti parametri URI.

BackupVaultAccountId

L'ID dell'account del vault di backup specificato.

Modello: ^[0-9]{12}$

backupVaultName

Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione AWS in cui sono stati creati. Consistono di minuscole, numeri e trattini.

Modello: ^[a-zA-Z0-9\-\_]{2,50}$

Campo obbligatorio: sì

recoveryPointArn

Un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino, ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

Campo obbligatorio: sì

Corpo della richiesta

La richiesta non ha un corpo della richiesta.

Sintassi della risposta

HTTP/1.1 200
Content-type: application/json

{
   "BackupSizeInBytes": number,
   "BackupVaultArn": "string",
   "BackupVaultName": "string",
   "CalculatedLifecycle": { 
      "DeleteAt": number,
      "MoveToColdStorageAt": number
   },
   "CompletionDate": number,
   "CompositeMemberIdentifier": "string",
   "CreatedBy": { 
      "BackupPlanArn": "string",
      "BackupPlanId": "string",
      "BackupPlanVersion": "string",
      "BackupRuleId": "string"
   },
   "CreationDate": number,
   "EncryptionKeyArn": "string",
   "IamRoleArn": "string",
   "IsEncrypted": boolean,
   "IsParent": boolean,
   "LastRestoreTime": number,
   "Lifecycle": { 
      "DeleteAfterDays": number,
      "MoveToColdStorageAfterDays": number,
      "OptInToArchiveForSupportedResources": boolean
   },
   "ParentRecoveryPointArn": "string",
   "RecoveryPointArn": "string",
   "ResourceArn": "string",
   "ResourceName": "string",
   "ResourceType": "string",
   "SourceBackupVaultArn": "string",
   "Status": "string",
   "StatusMessage": "string",
   "StorageClass": "string",
   "VaultType": "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.

BackupSizeInBytes

La dimensione, in byte, di un backup.

Tipo: long

BackupVaultArn

Un ARN che identifica in modo univoco un vault di backup, ad esempio arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault.

▬Tipo: stringa

BackupVaultName

Il nome di un container logico in cui vengono archiviati i backup. I vault di backup sono identificati da nomi univoci per l'account utilizzato per crearli e per la Regione in cui sono stati creati. Consistono di minuscole, numeri e trattini.

Tipo: stringa

Modello: ^[a-zA-Z0-9\-\_]{2,50}$

CalculatedLifecycle

Un oggetto CalculatedLifecycle contenente i timestamp DeleteAt e MoveToColdStorageAt.

Tipo: oggetto CalculatedLifecycle

CompletionDate

La data e l'ora di completamento del processo di creazione di un punto di ripristino, nel formato Unix e nell'ora UTC (Coordinated Universal Time). Il valore di CompletionDate è preciso al millisecondo. Ad esempio, il valore 1516925490.087 rappresenta venerdì 26 gennaio 2018 alle ore 12:11:30.087.

Tipo: Timestamp

CompositeMemberIdentifier

L'identificatore di una risorsa all'interno di un gruppo composito, ad esempio un punto di ripristino annidato (figlio) appartenente a uno stack composito (principale). L'ID viene trasferito dall'ID logico all'interno di uno stack.

▬Tipo: stringa

CreatedBy

Contiene informazioni di identificazione sulla creazione di un punto di ripristino, tra cui BackupPlanArn, BackupPlanId, BackupPlanVersion e BackupRuleId del piano backup utilizzato per crearlo.

Tipo: oggetto RecoveryPointCreator

CreationDate

La data e l'ora di creazione di un punto di ripristino, 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

EncryptionKeyArn

La chiave di crittografia lato server utilizzata per proteggere i backup, ad esempio arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

▬Tipo: stringa

IamRoleArn

Specifica l'ARN del ruolo IAM utilizzato per creare il punto di ripristino di destinazione; ad esempio, arn:aws:iam::123456789012:role/S3Access.

▬Tipo: stringa

IsEncrypted

Un valore booleano che viene restituito come TRUE se il punto di ripristino specificato è crittografato o FALSE se il punto di ripristino non è crittografato.

Tipo: Booleano

IsParent

Ciò restituisce il valore booleano di cui un punto di ripristino è un processo padre (composito).

Tipo: Booleano

LastRestoreTime

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

Tipo: Timestamp

Lifecycle

Il ciclo di vita definisce quando una risorsa protetta viene trasferita alla conservazione a freddo e quando scade. AWS Backup esegue automaticamente le transizioni e le scadenze dei backup in base al ciclo di vita definito dall'utente.

I backup che vengono trasferiti allo storage dei dati inattivi devono essere archiviati nello storage per un minimo di 90 giorni. Pertanto, l'impostazione "conservazione" deve essere 90 giorni maggiore dell'impostazione "transizione a inattivo dopo". L'impostazione "transizione a inattivo dopo" non può essere modificata dopo che è stata eseguita la transizione di un backup a inattivo.

I tipi di risorse che possono passare alla conservazione a freddo sono elencati nella tabella Disponibilità delle funzionalità per risorsa. AWS Backup ignora questa espressione per altri tipi di risorse.

Tipo: oggetto Lifecycle

ParentRecoveryPointArn

Questo è un ARN che identifica in modo univoco un punto di ripristino (composito) padre, ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

▬Tipo: stringa

RecoveryPointArn

Un ARN che identifica in modo univoco un punto di ripristino; ad esempio arn:aws:backup:us-east-1:123456789012:recovery-point:1EB3B5E7-9EB0-435A-A80B-108B488B0D45.

▬Tipo: stringa

ResourceArn

Un ARN identifica in modo univoco una risorsa salvata. Il formato dell'ARN dipende dal tipo di risorsa.

▬Tipo: stringa

ResourceName

Il nome della risorsa che appartiene al backup specificato.

▬Tipo: stringa

ResourceType

Il tipo di AWS risorsa da salvare come punto di ripristino; ad esempio, un volume Amazon Elastic Block Store (Amazon EBS) o un database Amazon Relational Database Service (Amazon RDS).

Tipo: stringa

Modello: ^[a-zA-Z0-9\-\_\.]{1,50}$

SourceBackupVaultArn

Un nome della risorsa Amazon (ARN) che identifica in modo univoco il vault di origine in cui è stato originariamente eseguito il backup della risorsa, ad esempio arn:aws:backup:us-east-1:123456789012:backup-vault:aBackupVault. Se il ripristino viene ripristinato nello stesso AWS account o nella stessa regione, questo valore sarà. null

▬Tipo: stringa

Status

Un codice di stato che specifica lo stato del punto di ripristino.

PARTIALlo stato indica che non è stato AWS Backup possibile creare il punto di ripristino prima della chiusura della finestra di backup. Per aumentare la finestra del piano di backup utilizzando l'API, vedi UpdateBackupPlan. Puoi anche aumentare la finestra del piano di backup utilizzando la console scegliendo e modificando il piano di backup.

EXPIREDlo stato indica che il punto di ripristino ha superato il periodo di conservazione, ma non AWS Backup dispone dell'autorizzazione o non è altrimenti in grado di eliminarlo. Per eliminare manualmente questi punti di ripristino, consulta Passaggio 3: Eliminare i punti di ripristino nella sezione Pulizia delle risorse di Nozioni di base.

Lo stato STOPPED si verifica in un backup continuo in cui un utente ha eseguito alcune azioni che causano la disabilitazione del backup continuo. Ciò può essere causato dalla rimozione delle autorizzazioni, dalla disattivazione del controllo delle versioni, dalla disattivazione degli eventi a EventBridge cui vengono inviati o dalla disabilitazione delle EventBridge regole messe in atto da. AWS Backup

Per risolvere lo stato STOPPED, assicurati che tutte le autorizzazioni richieste siano in essere e che il controllo delle versioni sia abilitato sul bucket S3. Una volta soddisfatte queste condizioni, l'istanza successiva di una regola di backup in esecuzione comporterà la creazione di un nuovo punto di ripristino continuo. Non è necessario eliminare i punti di ripristino con stato STOPPED.

Per SAP HANA su Amazon EC2, lo stato STOPPED si verifica a causa dell'azione utente, della configurazione errata dell'applicazione o di un errore di backup. Per garantire il successo dei backup continui futuri, fai riferimento allo stato del punto di ripristino e controlla SAP HANA per i dettagli.

▬Tipo: stringa

Valori validi: COMPLETED | PARTIAL | DELETING | EXPIRED

StatusMessage

Un messaggio di stato che spiega lo stato del punto di ripristino.

▬Tipo: stringa

StorageClass

Specifica la classe di storage del punto di ripristino. I valori validi sono WARM e COLD.

▬Tipo: stringa

Valori validi: WARM | COLD | DELETED

VaultType

Il tipo di archivio in cui è archiviato il punto di ripristino descritto.

▬Tipo: stringa

Valori validi: BACKUP_VAULT | LOGICALLY_AIR_GAPPED_BACKUP_VAULT

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 uno degli AWS SDK specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• AWS SDK per.NET

• AWS SDK per C++

• AWS SDK per Go v2

• AWS SDK per Java V2

• AWS SDK per V3 JavaScript

• AWS SDK per PHP V3

• AWS SDK per Python

• AWS SDK per Ruby V3