Paquetes de replicación

Fuente de replicación y comandos de paquetes.

Tabla 12-36  Fuente de replicación y comandos de paquetes.

Solicitud /api/storage/v1 Descripción GET /replication/sources Mostrar fuentes de replicación. GET /replication/sources/<source> Mostrar detalles de la fuente de replicación. GET /replication/sources/<source> /packages/<package> Obtener el paquete de replicación especificada. PUT /replication/sources/<source> /packages/<package> Modificar el paquete de replicación especificada. DELETE /replication/sources/<source> /packages/<package> Destruir el paquete de replicación especificada. PUT /replication/sources/<source> /packages/<package> /cancelupdate Ejecutar cancelupdate en el paquete especificado. PUT /replication/sources/<source> /packages/<package>/sever Ejecutar corte en el paquete especificado. PUT /replication/sources/<source> /packages/<package>/reverse Ejecutar inversión en el paquete especificado. PUT /replication/sources/<source> /packages/<package>/clone Clonar el paquete especificado. GET /replication/sources/<source> /packages/<package>/clone /conflicts Mostrar conflictos de propiedad de recursos compartidos. GET /replication/sources/<source> /packages/<package>/projects Mostrar proyectos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project> Obtener proyecto del paquete. PUT /replication/sources/<source> /packages/<package>/projects /<project> Modificar proyecto del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/usage/groups Obtener uso de grupo de proyectos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/usage/users Obtener uso de usuarios del proyecto del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/snapshots Crear una instantánea nueva. GET /replication/sources/<source> /packages/<package>/projects /<project>/snapshots/<snapshot> Obtener las propiedades de instantánea especificadas. GET /replication/sources/<source> /packages/<package>/projects /<project>/snapshots Mostrar todos los objetos del proyecto. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/snapshots/<snapshot> Destruir el objeto de instantánea especificado. PUT /replication/sources/<source> /packages/<package>/projects /<project>/snapshots/<snapshot> Renombrar la instantánea del proyecto del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/automatic Crear una instantánea automática de un proyecto de paquete nuevo. GET /replication/sources/<source> /packages/<package>/projects /<project>/automatic /<automatic> Obtener las propiedades de la instantánea automática del proyecto del paquete especificado. GET /replication/sources/<source> /packages/<package>/projects /<project>/automatic Mostrar todos los objetos de las instantáneas automáticas de todos los paquetes de proyectos. PUT /replication/sources/<source> /packages/<package>/projects /<project>/automatic /<automatic> Modificar el objeto de la instantánea automática del proyecto del paquete especificado. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/automatic /<automatic> Destruir el objeto automático especificado. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems Mostrar los sistemas de archivos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem> Obtener sistema de archivos del paquete. PUT /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem> Modificar sistema de archivos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/usage/groups Obtener uso del grupo del sistema de archivos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/usage/users Obtener uso de los usuarios del sistema de archivos del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/snapshots Crear una instantánea nueva. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/snapshots /<snapshot> Obtener las propiedades de instantánea especificadas. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/snapshots Mostrar todos los objetos del proyecto. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/snapshots /<snapshot> Destruir el objeto de instantánea especificado. PUT /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/snapshots /<snapshot> Renombrar la instantánea del sistema de archivos del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/automatic Crear una instantánea automática nueva del sistema de archivos del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/automatic /<automatic> Obtener las propiedades de la instantánea automática del sistema de archivos del paquete especificado. GET /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/automatic Mostrar todos los objetos de las instantáneas automáticas del sistema de archivos del paquete. PUT /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/automatic /<automatic> Modificar el objeto de la instantánea automática del sistema de archivos del paquete especificado. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/filesystems /<filesystem>/automatic /<automatic> Destruir el objeto automático especificado. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns Mostrar los LUN del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun> Obtener LUN del paquete. PUT /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun> Modificar LUN del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/usage /groups Obtener uso del grupo del LUN del paquete. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/usage /users Obtener uso de los usuarios del LUN del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/snapshots Crear una instantánea nueva. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/snapshots /<snapshot> Obtener las propiedades de instantánea especificadas. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/snapshots Mostrar todos los objetos del proyecto. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/snapshots /<snapshot> Destruir el objeto de instantánea especificado. PUT /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/snapshots /<snapshot> Renombrar la instantánea del LUN del paquete. POST /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/automatic Crear una instantánea automática del LUN del paquete nuevo. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/automatic /<automatic> Obtener las propiedades de la instantánea automática del LUN del paquete especificado. GET /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/automatic Mostrar todos los objetos de las instantáneas automáticas de los LUN del paquete. PUT /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/automatic /<automatic> Modificar el objeto de la instantánea automática del LUN del paquete especificado. DELETE /replication/sources/<source> /packages/<package>/projects /<project>/luns/<lun>/automatic /<automatic> Destruir el objeto automático especificado.

Mostrar fuentes de replicación

Mostrar todas las fuentes de replicación disponibles.

Ejemplo de solicitud:

GET /api/storage/v1/replication/sources HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Ejemplo de salida:

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

{
    "sources": [{
        "asn": "314d252e-c42b-e844-dab1-a3bca680b563",
        "href": "/api/storage/v1/replication/sources/zfssa-repl-host",
        "ip_address": "10.80.231.58:216",
        "name": "zfssa-repl-host",
        "source": "source-000"
    }]
}

Mostrar paquetes de replicación

Mostrar todos los paquetes de replicación de la fuente de replicación especificada.

Ejemplo de solicitud:

GET /api/storage/v1/replication/sources/zfssa-repl/packages HTTP/1.1
Host: zfs-storage.example.com
Accept: application/json

Resultado de ejemplo:

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

{
    "packages": [{
        "enabled": true,
        "href": "/api/v1/storage/replication/sources/zfssa-repl/packages/package-008",
        "id": "b2d8b35a-a5a0-6c74-f7e9-b75c357e841f",
        "last_result": "unknown",
        "last_sync": "unknown",
        "last_try": "unknown",
        "state": "idle",
        "state_description": "Idle (no update in progress)"
    }, {
        "enabled": true,
        "href": "/api/storage/v1/replication/sources/zfssa-repl/packages/package-009",
        "id": "2643a0eb-648d-6ad7-d405-b690d06f6cf6",
        "last_result": "success",
        "last_sync": "Wed Jul 31 2013 21:58:02 GMT+0000 (UTC)",
        "last_try": "Wed Jul 31 2013 21:58:02 GMT+0000 (UTC)",
        "state": "idle",
        "state_description": "Idle (no update in progress)",
        "project": "gold/nas-rr-2643a0eb-648d-6ad7-d405-b690d06f6cf6/default",
    }
]}

Modificar paquete

Modificar propiedades del paquete.

Tabla 12-37  Modificar propiedades del paquete

Tipo Nombre Descripción boolean enabled Estado actual de las actualizaciones de la replicación

Ejemplo de solicitud:

PUT /api/storage/v1/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=
Content-Type: application/json

{"enabled": false}

Resultado de ejemplo:

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

Suprimir paquete

Destruye un paquete de replicación.

Ejemplo de solicitud:

DELETE /api/storage/v1/replication/sources/zfssa-repl/packages
       /8373d331-de60-e590-90e8-9ad69fcb4aec 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

Cancelar actualización

Cancela una actualización en curso para ese paquete.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec/cancelupdate HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

Si no hay actualización en progreso, se devuelve HTTP Status 409 (Conflict) (estado HTTP 409 [conflicto]).

Ejemplo de respuesta:

HTTP/1.1 409 Conflict
X-Zfssa-Replication-Api: 1.0
Content-Type: application/json
Content-Length: 137

{
    "cancelupdate": {
        "AKSH_ERROR": "EAK_NAS_REPL_BADSTATE",
        "message": "operation illegal for state"
    }
}

Ejemplo de respuesta:

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

Clonar paquete

Clona el proyecto del paquete.

Ejemplo de solicitud:

PUT /api/v1/storage/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec/clone 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

La clonación satisfactoria devuelve HTTP Status 202 (Accepted) (estado HTTP 202 [aceptado]). Se puede usar un comando auxiliar para determinar si hay conflictos con la operación de clonación.

Ejemplo de solicitud de conflictos de clonación:

GET /api/storage/v1/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec/clone/conflicts HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

Clonar/conflictos devuelve conflictos:

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

{
    "conflicts": "There are no conflicts.\n"
}

Properties:

Default settings:
            target_project = (unset)
       original_mountpoint = /export
       override_mountpoint = false
                mountpoint =

Cortar paquete

Corta una conexión de replicación y mueve el contenido del paquete a un nuevo proyecto. Esta acción corta permanentemente este paquete y sus réplicas compartidas desde el sistema de origen, lo que los convierte en proyectos locales en este sistema. Las actualizaciones de replicación subsiguientes en cualquier dirección requieren la definición de nuevas acciones y el envío de una actualización total.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec/sever HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

{"projname":"restsev"}

Respuesta satisfactoria:

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

Invertir paquete

Invierte la dirección de la replicación. Esta acción desactiva la replicación para este paquete y mueve el contenido de este paquete a un proyecto local nuevo configurado para replicar nuevamente al origen. Cualquier cambio realizado en los metadatos o los datos del origen a partir de la última actualización correcta se pierden cuando el proyecto nuevo se replica primero de nuevo en el origen.

Ejemplo de solicitud:

PUT /api/storage/v1/replication/sources/zfssa-repl/packages/
    8373d331-de60-e590-90e8-9ad69fcb4aec/reverse HTTP/1.1
Host: zfs-storage.example.com
Authorization: Basic ab6rt4psMWE=

{"projname":"restrev"}

Respuesta satisfactoria:

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