Acciones de replicación

Las acciones de replicación definen las reglas para replicar datos a destinos de replicación. Los siguientes comandos gestionan las acciones de replicación.

Tabla 12-35  Comandos de la acción de replicación

Solicitud /api/storage/v1 Descripción GET /replication/actions Mostrar todos los objetos de la acción de replicación. GET /replication/actions/<ra_id> Obtener las propiedades de la acción de replicación especificada. POST /replication/actions Crear una acción de replicación nueva. PUT /replication/actions/<ra_id> Modificar el objeto de la acción de replicación especificado. DELETE /replication/actions/<ra_id> Suprimir el objeto de la acción de replicación especificada. PUT /replication/actions/<ra_id> /sendupdate Iniciar la acción de replicación seleccionada. PUT /replication/actions/<ra_id> /cancelupdate Detener la acción de replicación seleccionada. GET /replication/actions/<ra_id> /schedules Mostrar todos los objetos del programa de la acción de replicación. GET /replication/actions/<ra_id> /schedules/<ra_schedule> Obtener las propiedades del programa de la acción de replicación especificada. POST /replication/actions/<ra_id> /schedules Crear un programa de acción de replicación nuevo. PUT /replication/actions/<ra_id> /schedules/<ra_schedule> Modificar el objeto del programa de la acción de replicación especificado. DELETE /replication/actions/<ra_id> /schedules/<ra_schedule> Suprimir el objeto del programa de la acción de replicación especificada. GET /pools/<pool>/projects /<project>/replication/actions Mostrar todos los objetos de la acción de replicación. GET /pools/<pool>/projects /<project>/replication/actions /<ra_id> Obtener las propiedades de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/replication/actions Crear una acción de replicación nueva. PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id> Modificar el objeto de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/replication/actions /<ra_id> Suprimir el objeto de la acción de replicación especificada. PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/sendupdate Iniciar la acción de replicación seleccionada. PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/cancelupdate Detener la acción de replicación seleccionada. GET /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules Mostrar todos los objetos del programa de la acción de replicación. GET /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Obtener las propiedades del programa de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules Crear un programa de acción de replicación nuevo. PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Modificar el objeto del programa de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Suprimir el objeto del programa de la acción de replicación especificada. GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions Mostrar todos los objetos de la acción de replicación. GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Obtener las propiedades de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions Crear una acción de replicación nueva. PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Modificar el objeto de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Suprimir el objeto de la acción de replicación especificada. GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication Obtener la configuración de la acción de replicación del sistema de archivos. PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication Modificar la configuración de la acción de replicación del sistema de archivos. PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/sendupdate Iniciar la acción de replicación seleccionada. PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/cancelupdate Detener la acción de replicación seleccionada. GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules Mostrar todos los objetos del programa de la acción de replicación. GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Obtener las propiedades del programa de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules Crear un programa de acción de replicación nuevo. PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Modificar el objeto del programa de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Suprimir el objeto del programa de la acción de replicación especificada. GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions Mostrar todos los objetos de la acción de replicación. GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Obtener las propiedades de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/luns/<lun> /replication/actions Crear una acción de replicación nueva. PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Modificar el objeto de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Suprimir el objeto de la acción de replicación especificada. GET /pools/<pool>/projects /<project>/luns/<lun> /replication Obtener la configuración de la acción de replicación del LUN. PUT /pools/<pool>/projects /<project>/luns/<lun> /replication Modificar la configuración de la acción de replicación del LUN. PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /sendupdate Iniciar la acción de replicación seleccionada. PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /cancelupdate Detener la acción de replicación seleccionada. GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules Mostrar todos los objetos del programa de la acción de replicación. GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Obtener las propiedades del programa de la acción de replicación especificada. POST /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules Crear un programa de acción de replicación nuevo. PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Modificar el objeto del programa de la acción de replicación especificado. DELETE /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Suprimir el objeto del programa de la acción de replicación especificada.

Mostrar acciones de replicación

Obtener una lista de todas las acciones de replicación disponibles.

Ejemplo de solicitud:

GET /api/storage/v1/replication/actions HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Accept: application/json

Ejemplo de respuesta:

HTTP/1.1 200 OK
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 529

{
    "actions": [{
        "href": ""
        ...
    }, {
        "href": "",
        ...
    }]
}

Obtener acción de replicación

El comando de obtención del estado de la acción de replicación devuelve el estado de una sola acción de replicación otorgada por su ID.

Ejemplo de solicitud:

GET /api/storage/v1/replication/actions/1438ed7f-aad3-c631-d869-9e85cd7f15b4 HTTP/1.1
Authorization: Basic ab6rt4psMWE=
Accept: application/json

Ejemplo de respuesta:

HTTP/1.1 200 OK
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 529

{
    "action": {
        "average_throughput": 0.0,
        "bytes_sent": 0.0,
        "collection": "local",
        "continuous": false,
        "enabled": true,
        "estimated_size": 0.0,
        "estimated_time_left": 0.0,
        "href": "/api/storage/v1/replication/actions",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "include_snaps": true,
        "last_sync": "20130916T21:36:50",
        "last_try": "20130916T21:36:50",
        "max_bandwidth": 0,
        "pool": "gold",
        "project": "blah1",
        "share": "fs1",
        "state": "sending",
        "target": "38094753-6c90-49ed-aa92-995a296d432a",
        "use_ssl": true
    }
}

Crear acción de replicación

Crear una acción de replicación nueva.

Crear propiedades:

Initial values:
                   target = (unset)
                     pool = (unset)
                  enabled = true
               continuous = false
            include_snaps = true
            max_bandwidth = unlimited
               bytes_sent = 0
           estimated_size = 0
      estimated_time_left = 0
       average_throughput = 0
                  use_ssl = true

Ejemplo de solicitud:

POST /api/storage/v1/replication/actions HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json
Content-Length: 121
Accept: application/json

{
    "pool": "gold",
    "project": "blue1",
    "share": "fs1",
    "target_pool": "pool1",
    "target": "38094753-6c90-49ed-aa92-995a296d432a"
}

Ejemplo de respuesta:

HTTP/1.1 201 Created
Content-Length: 506
Content-Type: application/json
Location: /api/storage/v1/replication/action/8373d331-de60-e590-90e8-9ad69fcb4aec
X-Zfssa-Replication-Api: 1.0

{
    "action": {
        "project": "blue1",
        "target": "38094753-6c90-49ed-aa92-995a296d432a",
        "bytes_sent": 0.0,
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "collection": "local",
        "estimated_size": 0.0,
        "state": "idle",
        "href": "/api/storage/v1/replication/pools/gold/projects/blah1/shares/fs1/
                  actions/8373d331-de60-e590-90e8-9ad69fcb4aec",
        "average_throughput": 0.0,
        "use_ssl": true,
        "estimated_time_left": 0.0,
        "share": "fs1",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "pool": "gold",
        "include_snaps": true
    }
}

Modificar acción de replicación

Modificar una acción de replicación existente.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc HTTP/1.1
Host: zfs-storage.example.com:215
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json

{"use_ssl": false}

Ejemplo de respuesta:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 620

{
    "action": {
        "target_id": "407642ae-91b5-681c-de5e-afcd5cbf2974",
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "dedup": false,
        "use_ssl": false,
        "id": "c141d88d-ffd2-6730-d489-b71905f340cc",
        "include_snaps": true
    }
}

Cancelar actualización

Cancela una actualización de replicación en progreso.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc/cancelupdate HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

Ejemplo de respuesta:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0

Enviar actualización

Programa una actualización de replicación para que se inicie tan pronto como sea posible.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/actions/c141d88d-ffd2-6730-d489-b71905f340cc/sendupdate HTTP/1.1
Authorization: Basic ab6rt4psMWE=

Ejemplo de respuesta:

HTTP/1.1 202 Accepted
X-Zfssa-Replication-Api: 1.0

Suprimir una acción de replicación

Suprimir una acción de replicación existente.

Ejemplo de solicitud:

DELETE /api/storage/v1/replication/actions/e7e688b1-ff07-474f-d5cd-cac08293506e
       HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

La supresión satisfactoria devuelve HTTP Status 204 (No Content) (estado HTTP 204 [sin contenido]).

Ejemplo de respuesta:

HTTP/1.1 204 No-Content
X-Zfssa-Replication-Api: 1.0