Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
EN ESTA PÁGINA
 

OBTENGA /backup_and_restore/backups/{id}

RESUMEN Recupera una copia de seguridad individual por ID.

Recupera una copia de seguridad individual por ID.

Tabla 1: Detalles del recurso GET /backup_and_restore/backups/{id}:

GET /backup_and_restore/backups/{id} detalles del recurso
Tipo MIME

Application/JSON

Tabla 2: Detalles del parámetro de solicitud GET /backup_and_restore/backups/{id}:

GET /backup_and_restore/backups/{id} detalles del parámetro de solicitud
Tipo de parámetro Opcionalidad Tipo de datos Tipo MIME Descripción

ID

ruta

Obligatorio

Número (entero)

Texto/sin formato

Obligatorio. El ID de la copia de seguridad que se va a recuperar.

Campos

Consulta

Opcional

Cadena

Texto/sin formato

Opcional: utilice este parámetro para especificar los campos que desea recuperar en la respuesta. Se excluyen los campos que no tienen nombre. Especifique subcampos entre paréntesis y varios campos en el mismo objeto están separados por comas.
Tabla 3: Códigos de respuesta GET /backup_and_restore/backups/{id}:

Obtener códigos de respuesta /backup_and_restore/backups/{id}
Código de respuesta HTTP Descripción de código único

200

Se recuperó la copia de seguridad.

404

1001

La copia de seguridad no existe.

500

1000

Se produjo un error durante el intento de recuperar la copia de seguridad.

Descripción de la respuesta

Un objeto de copia de seguridad. El objeto de copia de seguridad contiene los siguientes campos:
  • id - Long - El ID de la copia de seguridad.
  • configuration_id - Long - El ID de la configuración. Esto siempre será 1. Consulte las API de configuración de copia de seguridad para obtener más información:
    • api/config/backup_and_restore/scheduled_backup_configurations
    • api/staged_config/backup_and_restore/scheduled_backup_configurations
  • host_id - Largo: el host que corresponde con la copia de seguridad. Para obtener más información, consulte la siguiente API de hosts:
    • api/config/deployment/hosts
  • name - String - El nombre de la copia de seguridad.
  • description - String - Una descripción opcional de la copia de seguridad.
  • type - Enumeración - El tipo de copia de seguridad. Están disponibles los siguientes valores: CONFIG, DATA.
  • version - Cadena: la versión de JSA que corresponde a la copia de seguridad.
  • time_initiated - Largo - El número de milisegundos desde la época en que se inició la copia de seguridad.
  • time_completed - Largo - El número de milisegundos desde la época en que se completó la copia de seguridad.
  • initiated_by - Cadena: el usuario o servicio autorizado que inició la copia de seguridad.
  • status - Enumeración - El estado de la copia de seguridad. Están disponibles los siguientes valores: INICIALIZING, IN_PROGRESS, FAILED, SUCCESS, CANCELLING, DEBORRING, MISSING.
    • INITIALIZING: El estado inicial de la copia de seguridad cuando se crea. En este estado, se crea un objeto de copia de seguridad y se envía una solicitud al motor de copia de seguridad y restauración.
    • IN_PROGRESS: Cuando el motor de copia de seguridad y restauración recibe la solicitud de copia de seguridad, el estado se actualiza IN_PROGRESS.
    • FAILED: Si la copia de seguridad se ha completado con errores, el estado se actualiza a FAILED.
    • SUCCESS: Si la copia de seguridad se ha completado sin errores, el estado se actualiza a SUCCESS.
    • CANCELLING: CANCELLING: Si se envía una solicitud desde la API para eliminar una copia de seguridad que está en curso, después de que el motor de copia de seguridad y restauración reciba la solicitud, el estado de la copia de seguridad se actualiza a CANCELLING.
    • ELIMINAR: Si se envía una solicitud para eliminar una copia de seguridad, después de que el motor de copia de seguridad y restauración reciba la solicitud, el estado de la copia de seguridad se actualiza a ELIMINAR. El registro de copia de seguridad, junto con el archivo de copia de seguridad, se elimina.
    • MISSING: Si el archivo de copia de seguridad de un registro de copia de seguridad se mueve o elimina fuera del control del motor de copia de seguridad y restauración, el estado de ese registro se actualiza a MISSING.
  • size_on_disk - Long - El tamaño de la copia de seguridad en bytes.
  • content_file_path - Cadena - La ruta del archivo que corresponde al contenido de la copia de seguridad.
  • is_valid - Booleano - Si el archivo de copia de seguridad asociado, el manifiesto de copia de seguridad y sus propiedades funcionan correctamente, la condición se establece en 'true'; de lo contrario, la condición se establece en 'false'.  Estos son algunos ejemplos de por qué la copia de seguridad podría no ser válida:
    • Al manifiesto de copia de seguridad le faltan propiedades.
    • No se puede recuperar el manifiesto de copia de seguridad.
    • La copia de seguridad de un sistema en espera que no sea de alta disponibilidad no se puede restaurar en una consola configurada como sistema en espera de alta disponibilidad.
    • Los nombres de los productos de copia de seguridad y de host no coinciden.
    • Los nombres de la copia de seguridad y del dispositivo de host no coinciden.
    • La copia de seguridad utiliza la dirección IP actual de la consola para el host administrado que no es de consola.
  • is_version_compatible - Boolean - Si la versión de copia de seguridad asociada es compatible con el sistema, la condición se establece en 'true'; de lo contrario, la condición se establece en 'false'.

Ejemplo de respuesta