Go to main content

Guía de la API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.8.x)

Salir de la Vista de impresión

Actualización: Agosto de 2021
 
 

Operaciones de copia de seguridad de instantáneas

Utilice las operaciones de copia de seguridad de instantáneas para gestionar las copias de seguridad de instantáneas de recursos compartidos en Oracle Cloud Infrastructure Object Storage. Para crear una instantánea, consulte Operaciones de clonación e instantánea.

Se puede realizar una copia de seguridad de las instantáneas que tienen el mismo nombre en diferentes sistemas locales en el mismo destino en la nube ya que a cada copia de seguridad de instantánea se le asigna un identificador único.

La misma instantánea del sistema de archivos se puede utilizar para dos copias de seguridad en la nube en dos formatos diferentes.

Puede suprimir una instantánea local después de haber realizado una copia de seguridad de esa instantánea en la nube. No obstante, conserve las instantáneas locales que puedan ser instantáneas principales de futuras instantáneas incrementales.

Tabla 30  Comandos de copia de seguridad de instantáneas
Solicitud
Anexar a la ruta de acceso:
/api/storage/v2/pools/pool/projects/project
Más uno de los siguientes:
  • /filesystems/fs

  • /luns/lun

Descripción
GET
/snapshots/snapshot/backups
Enumerar todas las copias de seguridad de instantáneas en cualquier formato
GET
/snapshots/snapshot/backups/format/backup-id/target-id
Enumerar la instantánea especificada
DELETE
/snapshots/snapshot/backups/format/backup-id/target-id
Suprimir la copia de seguridad de la instantánea especificada
POST
/snapshots/snapshot/backups
Crear una nueva copia de seguridad de instantánea

Enumerar copias de seguridad de instantáneas

En el siguiente ejemplo, se enumeran todas las copias de seguridad en la nube de cualquier formato de instantánea snap0 en el sistema de archivos f-1.

Ejemplo de solicitud:

GET /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap0/backups HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
User-Agent: curl/7.54.0
Accept: */*

Resultado de ejemplo:

HTTP/1.1 200 OK
Date: Wed, 07 Jan 2020 20:54:47 GMT
Content-Length: 708
X-Zfssa-Storage-Api: 2.0
Content-Type: application/json; charset=utf-8
X-Zfssa-Api-Version: 2.0

{
    "backups": [{
        "finished": "2020-01-07T21:02:14Z",
        "format": "tar",
        "href": "/api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap0/backups/tar/backup-id/target-id",
        "id": "backup-id",
        "status": "completed",
        "target": "target-id",
        "targetName": "oci-ashburn"
    }]
}

La siguiente solicitud enumera la copia de seguridad de la instantánea especificada.

GET /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap0/backups/format/backup-id/target-id HTTP/1.1

Crear una copia de seguridad de instantánea

En el siguiente ejemplo, se crea una copia de seguridad de la instantánea snap0 en formato tar y se almacena la copia de seguridad en el destino oci-phoenix. Si no se especifica el formato, la copia de seguridad se crea en formato zfs. Para ver el progreso de la copia de seguridad de instantáneas, consulte Mostrar trabajos para ver el trabajo con la job-id devuelta.

Si se define la propiedad writelimit para el destino, no se leen más de writelimit bytes por segundo del destino. Consulte Crear un destino.

Ejemplo de solicitud:

POST /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap0/backups HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
{
    "target": "oci-phoenix",
    "format": "tar"
}

Resultado de ejemplo:

{
    "action": "job-id"
}

Crear una copia de seguridad de instantánea incremental

Para crear una copia de seguridad de instantánea incremental, especifique true como el valor de la propiedad incremental y especifique la instantánea principal que se utilizará en la comparación.

  • La instantánea principal debe existir en el mismo sistema local y en el mismo destino de nube que la copia de seguridad de instantánea incremental especificada. En el siguiente ejemplo, la instantánea snap0 debe existir en el sistema de archivos f-1 tanto en el sistema local como en el destino en la nube.

  • Las instantáneas principales e incrementales del sistema de archivos deben tener el mismo formato: zfs o tar.

La siguiente solicitud crea una copia de seguridad del sistema de archivos f-1, la cual es la diferencia entre snap0 y el estado actual del sistema de archivos f-1 . La copia de seguridad incremental de instantáneas, snap1, se almacena en el destino oci-ashburn. La copia de seguridad de la instantánea incremental tiene el mismo formato que la copia de seguridad de la instantánea principal.

Ejemplo de solicitud:

POST /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap1/backups HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

{
    "target":  "oci-ashburn",
    "incremental": true,
    "parent": "snap0"
}

Resultado de ejemplo:

{
    "action": "job-id"
}

Encuentra los principales de una copia de seguridad de instantánea incremental

En el siguiente ejemplo, se identifican a los principales de la copia de seguridad de instantánea incremental especificada en el destino indicado. En este ejemplo, los principales de la copia de seguridad de la instantánea snap2 en el destino oci-ashburn son instantáneas snap1 y snap0. El resultado muestra que este dispositivo tiene acceso a ambos destinos: oci-ashburn y oci-phoenix. No se muestran resultados para oci-phoenix porque se solicitan resultados para oci-ashburn .

Ejemplo de solicitud:

POST /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/backups?props=true HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

{
    "target": "oci-ashburn"
}

Resultado de ejemplo:

HTTP/1.1 200 OK
Date: Wed, 22 Jan 2020 22:02:17 GMT
Content-Length: 316
X-Zfssa-Storage-Api: 2.0
Content-Type: application/json; charset=utf-8
X-Zfssa-Api-Version: 2.0

{
    "props": [{
        "choices": [
            "oci-ashburn",
            "oci-phoenix"
        ],
        "data_type": "string",
        "label": "Backup target",
        "name": "target"
    },{
        "choices": [
            "zfs",
            "tar"
        ],
        "data_type": "string",
        "label": "format",
        "name": "format"
    },{
        "choices": [
            true,
            false
        ],
        "data_type": "boolean",
        "label": "Incremental",
        "name": "incremental"
    },{
        "choices": [
            "snap1",
            "snap0"
        ],
        "data_type": "string",
        "label": "Parent",
        "name": "parent"
    }]
}

El siguiente ejemplo usa GET en lugar de POST como una forma alternativa de identificar a los principales de la copia de seguridad de instantánea incremental especificada. En este formulario, no es necesario especificar el destino. Los resultados no muestran los principales de snap2 sobre el destino oci-phoenix, lo que significa que no puede crear una copia de seguridad incremental de snap2 en oci-phoenix. Puede crear una copia de seguridad completa de snap2 en oci-phoenix.

Ejemplo de solicitud:

GET /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/targets HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

Resultado de ejemplo:

HTTP/1.1 200 OK
Date: Wed, 07 Jan 2020 22:04:08 GMT
Content-Length: 329
X-Zfssa-Storage-Api: 2.0
Content-Type: application/json; charset=utf-8
X-Zfssa-Api-Version: 2.0

{
    "targets": [{
        "format": "zfs",
        "href": "/api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/targets/zfs/target-id1",
        "id": "target-id1",
        "name": "oci-ashburn",
        "parents": [
            "snap0",
            "snap1"
        ]
    },{
        "format": "tar",
        "href": "/api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/targets/tar/target-id1",
        "id": "target-id1",
        "name": "oci-ashburn",
        "parents": [
            "snap0",
            "snap1"
        ]
    },{
        "id": "target-id2",
        "name": "oci-phoenix",
        "parents": [],
        "href": "/api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/targets/target-id2"
    }]
}

Utilice la siguiente solicitud para visualizar los principales de una copia de seguridad de instantánea específica:

GET /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap2/targets/format/target-id1 HTTP/1.1

Suprimir una copia de seguridad de instantánea

En el siguiente ejemplo, se suprime la copia de seguridad de la instantánea especificada. Para ver el progreso de la supresión de la copia de seguridad, consulte Mostrar trabajos para ver el trabajo con la job-id devuelta.

Ejemplo de solicitud:

DELETE /api/storage/v2/pools/p1/projects/default/filesystems/f-1/snapshots/snap0/backups/format/backup-id/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*

Resultado de ejemplo:

{
    "action": "job-id"
}