Utilice operaciones de servicio en la nube para gestionar copias de seguridad de instantáneas de dispositivos en Oracle Cloud Infrastructure Object Storage. Puede enumerar destinos y copias de seguridad en Oracle Cloud Infrastructure Object Storage, suprimir un destino, suprimir una copia de seguridad, restaurar una copia de seguridad como un nuevo recurso compartido de dispositivo y cancelar o reiniciar un trabajo de servicio en la nube.
Para crear una copia de seguridad, consulte Crear una copia de seguridad de instantánea en Operaciones de copia de seguridad de instantáneas.. Las copias de seguridad son copias de seguridad completas o incrementales de instantáneas de recursos compartidas. Para crear una instantánea, consulte Operaciones de clonación e instantánea.
Los siguientes parámetros se utilizan en la tabla de operaciones del servicio en la nube:
El formato en el que se guardó la copia de seguridad en Oracle Cloud Infrastructure Object Storage.
El valor de format es zfs o tar. Si no se especifica un format para la creación de copias de seguridad de instantáneas, zfs es el valor por defecto. El formato zfs admite tanto el sistema de archivos como las instantáneas de LUN; el formato tar solo admite instantáneas del sistema de archivos. Para obtener más información sobre los formatos zfs ytar, consulte Creación de una copia de seguridad en la nube (CLI) de Guía de administración de Oracle® ZFS Storage Appliance, versión OS8.8.x.
El identificador de una copia de una instantánea de dispositivo que se guarda en Oracle Cloud Infrastructure Object Storage. El valor de backup-id es el valor de la propiedad id cuando enumera las copias de seguridad tal como se muestra en Enumerar copias de seguridad en la nube.
Para una copia de seguridad de instantánea completa, el valor de backup-id es pool_id/snapshot_id, tal como se muestra en el siguiente ejemplo:
3e035b7e546e0d02/1cbfdb5ff2259b76
Para una copia de seguridad de instantánea incremental, el valor de backup-id es pool_id/child_snapshot_id-parent_snapshot_id, como se muestra en el siguiente ejemplo:
6913a5703bee98dc/46be95ced54e99d9-667f3eb88fd209e1
La ubicación de Oracle Cloud Infrastructure Object Storage donde se guarda una copia de seguridad. Una copia de seguridad determinada se puede guardar en varios destinos. Es decir, la misma backup-id puede aparecer en diferentes ubicaciones de target-id.
El valor de target-id es el valor de la propiedad target cuando enumera las copias de seguridad.
El identificador de un trabajo en ejecución. El valor de job-id es el valor de la propiedad id cuando enumera los trabajos tal como se muestra en Mostrar trabajos.
|
Para activar el servicio en la nube, configure el status a enable tal como se muestra en el siguiente ejemplo.
Ejemplo de solicitud:
PUT /api/service/v2/services/cloud HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Type: application/json
Content-Length: 22
{ "<status>": "enable" }
Utilice la siguiente solicitud para ver el archivo log del servicio en la nube:
GET /api/log/v1/logs/appliance-kit-cloud:default HTTP/1.1
Ejemplo de solicitud:
GET /api/service/v2/services/cloud HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
HTTP/1.1 200 OK
Date: Wed, 24 Jul 2019 20:30:59 GMT
Content-Length: 843
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
{
"service": {
"href": "/api/service/v2/services/cloud",
"<status>": "online",
"tls_version": [
"TLSv1.1",
"TLSv1.2"
],
"ciphers": [
"ECDHE-RSA-AES128-GCM-SHA256",
"ECDHE-RSA-AES256-GCM-SHA384",
"DHE-RSA-AES128-GCM-SHA256",
"DHE-RSA-AES256-GCM-SHA384",
"AES128-SHA",
"AES256-SHA",
"DES-CBC3-SHA"
],
"targets": {
"href": "/api/service/v2/services/cloud/targets",
"entries": 2
},
"backups": {
"href": "/api/service/v2/services/cloud/backups",
"entries": 2548
},
"jobs": {
"href": "/api/service/v2/services/cloud/jobs",
"entries": 0
}
}
}
Ejemplo de solicitud:
PUT /api/service/v2/services/cloud HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Type: application/json
Content-Length: 48
{
"tls_version": [
"TLSv1.0","TLSv1.1","TLSv1.2"
]
}
En el siguiente ejemplo, se enumeran todos los destinos.
Ejemplo de solicitud:
GET /api/service/v2/services/cloud/targets HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
HTTP/1.1 200 OK
Date: Wed, 24 Jul 2019 21:06:18 GMT
Content-Length: 1086
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
{
"targets": [{
"bucket": "pl-test",
"href": "/api/service/v2/services/cloud/targets/target-id1",
"id": "target-id1",
"key": true,
"location": "https://objectstorage.us-ashburn-1.oraclecloud.com",
"name": "oci-ashburn",
"online": true,
"proxy_host": "",
"proxy_on": false,
"proxy_password": false,
"proxy_user": "",
"tenancy": "ocid1.tenancy.oc1..tenancy-id",
"user": "ocid1.user.oc1..user-id"
},{
"bucket": "pl-test2",
"href": "/api/service/v2/services/cloud/targets/target-id2",
"id": "target-id2",
"key": true,
"location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
"name": "oci-phoenix",
"online": true,
"proxy_host": "www-proxy.example.com:80",
"proxy_on": true,
"proxy_password": false,
"proxy_user": "",
"tenancy": "ocid1.tenancy.oc1..tenancy-id",
"user": "ocid1.user.oc1..user-id"
}]
}
En el siguiente ejemplo, se enumera el destino especificado:
GET /api/service/v2/services/cloud/targets/target-id HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Se requieren los siguientes parámetros para crear un destino en la nube.
|
El siguiente ejemplo crea un destino.
Ejemplo de solicitud:
POST /api/service/v2/services/cloud/targets HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
{
"name": "oci4",
"location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
"user": "ocid1.user.oc1..user-id",
"bucket": "test-bucket3",
"tenancy": "ocid1.tenancy.oc1..tenancy-id",
"key": "key",
"proxy_on": false,
"readlimit": -1,
"writelimit": -1
}
Resultado de ejemplo:
HTTP/1.1 201 Created
Date: Wed, 24 Jul 2019 21:14:39 GMT
Content-Length: 568
X-Zfssa-Service-Api: 2.0
Location: /api/service/v2/services/cloud/targets/target-id
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
{
"target": {
"bucket": "test-bucket3",
"href": "/api/service/v2/services/cloud/targets/target-id",
"id": "target-id",
"key": true,
"location": "https://objectstorage.us-phoenix-1.oraclecloud.com",
"name": "oci4",
"proxy_on": false,
"readlimit": -1,
"state": "offline",
"tenancy": "ocid1.tenancy.oc1..tenancy-id",
"user": "ocid1.user.oc1..user-id",
"writelimit": -1
}
}
En la siguiente tabla, se muestran las propiedades que se pueden modificar para un destino en la nube.
|
Ejemplo de solicitud:
PUT /api/service/v2/services/cloud/targets/target-id HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
User-Agent: curl/7.54.0
Accept: */*
Content-Type: application/json
Content-Length: 19
{
"proxy_on": true,
"proxy_host": "www-proxy.example.com:80",
"readlimit": 4194304,
"writelimit": 5242880
}
Antes de suprimir un destino, realice las siguientes comprobaciones:
Compruebe si se está realizando una copia de seguridad de este destino. Consulte Mostrar trabajos.
Determine si este destino tiene copias de seguridad. Utilizar el filtro target como se muestra en Enumerar copias de seguridad en la nube para enumerar las copias de seguridad que se almacenan en este destino.
En el siguiente ejemplo, se muestra cómo se quita del servicio el destino de nube especificado.
Ejemplo de solicitud:
DELETE /api/service/v2/services/cloud/targets/target-id HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
HTTP/1.1 204 No Content Date: Wed, 24 Jul 2019 21:20:27 GMT X-Content-Type-Options: nosniff X-Zfssa-Service-Api: 2.0 X-Zfssa-Api-Version: 2.0 Content-Type: application/json; charset=utf-8
Utilice la siguiente consulta para enumerar todas las copias de seguridad completadas de cualquier formato, con las copias de seguridad más recientes en primer lugar. Para obtener información sobre las copias de seguridad en curso, consulte Mostrar trabajos.
Ejemplo de solicitud:
GET /api/service/v2/services/cloud/backups HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
En este ejemplo, la primera copia de seguridad enumerada es la secundaria de la segunda copia de seguridad enumerada. El valor de parent de la primera copia de seguridad es el mismo que el valor de dataset de la segunda copia de seguridad (app-data-fullsnap), y el valor de parent de la segunda copia de seguridad es nulo. Una copia de seguridad secundaria tendrá el mismo format que la principal. En este ejemplo, tanto las copias de seguridad secundarias como las principales están en formato tar.
HTTP/1.1 200 OK
Date: Wed, 22 Jan 2020 21:22:40 GMT
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
{
"backups": [{
"target": "target-id2",
"parent": "app-data-fullsnap",
"started": "2020-01-06T20:03:32Z",
"completed": "2020-01-06T20:04:36Z",
"id": "backup-id2",
"source": "cloudsnap0",
"href": "/api/service/v2/services/cloud/backups/tar/backup-id2/target-id2",
"tier": "standard",
"dataset": "p1/local/default/app-data@app-data-incsnap",
"format": "tar",
"size": 3224982536.0
},{
"target": "target-id1",
"parent": "",
"started": "2020-01-06T20:01:16Z",
"completed": "2020-01-06T20:01:17Z",
"id": "backup-id1",
"source": "cloudsnap0",
"href": "/api/service/v2/services/cloud/backups/tar/backup-id1/target-id1",
"tier": "standard",
"dataset": "p1/local/default/app-data@app-data-fullsnap",
"format": "tar",
"size": 2149988056.0
}]
}
Utilice la siguiente solicitud para enumerar la copia de seguridad especificada:
GET /api/service/v2/services/cloud/backups/format/backup-id/target-id HTTP/1.1
Enumerar parámetros de consulta de copias de seguridad en la nube
Los siguientes parámetros de consulta son compatibles para filtrar la lista de copias de seguridad en la nube. Todos los parámetros se pueden utilizar en la misma consulta. Utilice una operación AND (&) entre los parámetros de consulta, tal como se muestra en los ejemplos que siguen a la tabla.
|
En el siguiente ejemplo, se enumeran las copias de seguridad más antiguas a partir de la copia de seguridad con el número de índice 2000. Si el valor de la propiedad entries en la sección backups de la lista de propiedades del servicio en la nube es 2865, en el siguiente ejemplo, se muestran 865 copias de seguridad: copia de seguridad 2000 a través de copia de seguridad 2864.
GET /api/service/v2/services/cloud/backups?start=2000
En el siguiente ejemplo, se enumera solo la copia de seguridad con el número de índice 2000:
GET /api/service/v2/services/cloud/backups?start=2000&limit=1
En el siguiente ejemplo, se enumeran las 500 copias de seguridad más antiguas que se crearon a la hora especificada o después de esa hora:
GET /api/service/v2/services/cloud/backups?start=2019-07-12T00:00:00Z&limit=500
En el siguiente ejemplo, se enumeran las 500 copias de seguridad más recientes que se crearon a la hora especificada o antes de esa hora:
GET /api/service/v2/services/cloud/backups?end=2019-07-12T00:00:00Z&limit=500
En el siguiente ejemplo, se enumeran todas las copias de seguridad que se crearon a la hora start, o después de esa hora, pero no más tarde que la hora end especificada:
GET /api/service/v2/services/cloud/backups?start=2019-07-11T00:00:00Z&end=2019-07-12T00:00:00Z
En el siguiente ejemplo, se enumeran las copias de seguridad más recientes de cualquier juego de datos con app-data en el nombre, en el formato de copia de seguridad tar:
GET /api/service/v2/services/cloud/backups?dataset=app-data&format=tar
En el siguiente ejemplo, se enumeran las copias de seguridad más recientes de cualquier juego de datos con app-data en el nombre, en el destino target-id:
GET /api/service/v2/services/cloud/backups?dataset=app-data&target=target-id
En el siguiente ejemplo, se enumeran las copias de seguridad más recientes de cualquier juego de datos con app-data en el nombre, en el destino target-id que tenga el origen cloudsnap0:
GET /api/service/v2/services/cloud/backups?dataset=app-data&target=target-id&source=cloudsnap0
Antes de suprimir una copia de seguridad en la nube, realice las siguientes comprobaciones:
Compruebe si se está realizando una restauración de esta copia de seguridad. Consulte Mostrar trabajos.
Determine si esta copia de seguridad tiene copias de seguridad secundarias. No puede suprimir una copia de seguridad que tenga copias de seguridad secundarias. Las copias de seguridad secundarias de esta copia de seguridad tienen un valor de parent que es el mismo que el valor de dataset de la copia de seguridad que desea suprimir. Consulte Enumerar copias de seguridad en la nube.
En el siguiente ejemplo, se envía una solicitud de trabajo para suprimir la copia de seguridad especificada en el destino especificado de Oracle Cloud Infrastructure Object Storage. Un dispositivo puede funcionar con cualquier copia de seguridad en cualquier destino al que pueda acceder el dispositivo, incluso si esa copia de seguridad se creó en un dispositivo diferente.
Compare esta operación con Suprimir una copia de seguridad de instantánea, que muestra cómo suprimir una copia de seguridad de una instantánea de recurso compartido en el dispositivo..
Ejemplo de solicitud:
DELETE /api/service/v2/services/cloud/backups/format/backup-id/target-id HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
{
"action": "job-id"
}
Para ver el progreso de la supresión de la copia de seguridad en la nube, use Mostrar trabajos para ver el trabajo con la job-id mencionada anteriormente.
Una copia de seguridad en la nube se puede restaurar como un recurso compartido recién clonado en cualquier dispositivo que tenga acceso al destino en la nube.
En el siguiente ejemplo, se envía una solicitud de trabajo para restaurar la copia de seguridad especificada. Especificar el pool y el proyecto donde desea restaurar la copia de seguridad y especificar un nombre para el recurso compartido nuevo. Para ver el progreso de la restauración, consulte Mostrar trabajos para ver el trabajo con la job-id devuelta.
Si se define la propiedad readlimit para el destino, no se leen más de readlimit bytes por segundo del destino. Consulte Crear un destino.
Ejemplo de solicitud:
POST /api/service/v2/services/cloud/backups/format/backup-id/target-id/restore HTTP/1.1
Host: hostname:215
Authorization: Basic Tm8gcGVla2luZyE=
Accept: */*
Content-Length: 55
{
"pool":"p1",
"project":"default",
"share": "restore6"
}
Resultado de ejemplo:
{
"action": "job-id"
}
En el siguiente ejemplo, se enumeran todos los trabajos en ejecución y los trabajos completados recientemente, con el trabajo más nuevo en primer lugar.
Ejemplo de solicitud:
GET /api/service/v2/services/cloud/jobs HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
En este ejemplo, dos trabajos de copia de seguridad guardan dos copias de seguridad diferentes en el mismo destino.
HTTP/1.1 200 OK
Date: Wed, 22 Jan 2020 21:37:52 GMT
Content-Length: 983
X-Zfssa-Service-Api: 2.0
X-Zfssa-Api-Version: 2.0
Content-Type: application/json; charset=utf-8
{
"jobs": [{
"href": "/api/service/v2/services/cloud/jobs/job-id2",
"op": "backup",
"target": "target-id",
"targetName": "oci-ashburn",
"created": "2020-02-06T16:52:42Z",
"updated": "2020-02-06T16:52:48Z",
"id": "job-id2",
"status": "in-progress",
"rate": 10002432,
"transferred": 80019456,
"estimated_size": 43088792088,
"dataset": "p1/local/default/f-1",
"backup": "backup-id2",
"snapshot": "snap3",
"format": "tar",
"details": "uploading backup to zfs/backups/tar/backup-id2/000000001"
},{
"href": "/api/service/v2/services/cloud/jobs/job-id1",
"op": "backup",
"target": "target-id",
"targetName": "oci-ashburn",
"created": "2020-02-06T16:52:28Z",
"updated": "2020-02-06T16:52:48Z",
"id": "job-id1",
"status": "in-progress",
"rate": 1942,
"transferred": 3884,
"estimated_size": 0,
"dataset": "p1/local/default/f-1",
"backup": "backup-id1",
"snapshot": "snap2",
"format": "zfs",
"details": "uploading backup to zfs/backups/zfs/backup-id1/000000001"
}]
}
En el siguiente ejemplo, se enumera el trabajo especificado:
GET /api/service/v2/services/cloud/jobs/job-id2 HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Enumerar parámetros de consulta de trabajos de copias de seguridad en la nube
Los parámetros de consulta start y limit son compatibles para filtrar la lista de trabajos de copia de seguridad en la nube.
El valor del parámetro start es el índice de trabajo. Los valores de este índice son de 0 a uno menos que el valor de la propiedad entries en la sección jobs de la solicitud que se muestra en Mostrar propiedades del servicio en la nube.
El valor del parámetro limit es el número máximo de trabajos que se deben enumerar.
Ambos parámetros se pueden utilizar en la misma consulta. Use una operación AND (&) entre los parámetros de consulta, tal como se muestra en los siguientes ejemplos.
En el siguiente ejemplo, se enumeran los 100 trabajos en ejecución más nuevos y los trabajos completados recientemente, con el trabajo más reciente en primer lugar.
GET /api/service/v2/services/cloud/jobs?limit=100
En el siguiente ejemplo, se enumera solo el trabajo más antiguo en ejecución o completado recientemente.
GET /api/service/v2/services/cloud/jobs?start=0&limit=1
En el siguiente ejemplo, se enumeran todos los trabajos en ejecución y los trabajos completados recientemente con un número de índice de trabajo igual o superior a 4, con el trabajo más reciente en primer lugar.
GET /api/service/v2/services/cloud/jobs?start=4
En el siguiente ejemplo, se cancela el trabajo de servicio en la nube especificado.
Ejemplo de solicitud:
PUT /api/service/v2/services/cloud/jobs/job-id/cancel HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= Accept: */*
Resultado de ejemplo:
HTTP/1.1 202 Accepted Date: Wed, 24 Jul 2019 21:50:29 GMT Content-Length: 0 X-Zfssa-Service-Api: 2.0 X-Zfssa-Api-Version: 2.0 Content-Type: application/json; charset=utf-8
En el siguiente ejemplo, se reinicia el trabajo de servicio en la nube especificado.
Ejemplo de solicitud:
PUT /api/service/v2/services/cloud/jobs/job-id/restart HTTP/1.1 Host: hostname:215 Authorization: Basic Tm8gcGVla2luZyE= User-Agent: curl/7.54.0 Accept: */*
Resultado de ejemplo:
HTTP/1.1 202 Accepted Date: Wed, 24 Jul 2019 21:51:08 GMT Content-Length: 0 X-Zfssa-Service-Api: 2.0 X-Zfssa-Api-Version: 2.0 Content-Type: application/json; charset=utf-8