Actions de réplication

Les actions de réplication définissent les règles pour la réplication des données associées aux cibles de réplication. Les commandes suivantes gèrent les actions de réplication.

Table 97  Commandes d'action de réplication

Demande /api/storage/v1 Description GET /replication/actions Enumération de tous les objets de l'action de réplication GET /replication/actions/<ra_id> Obtention des propriétés de l'action de réplication spécifiée POST /replication/actions Création d'une nouvelle action de réplication PUT /replication/actions/<ra_id> Modification de l'objet de l'action de réplication spécifiée DELETE /replication/actions/<ra_id> Suppression de l'objet de l'action de réplication spécifiée PUT /replication/actions/<ra_id> /sendupdate Démarrage de l'action de réplication sélectionnée PUT /replication/actions/<ra_id> /cancelupdate Interruption de l'action de réplication sélectionnée GET /replication/actions/<ra_id> /schedules Enumération de tous les objets de planification de l'action de réplication GET /replication/actions/<ra_id> /schedules/<ra_schedule> Obtention des propriétés de planification de l'action de réplication spécifiée POST /replication/actions/<ra_id> /schedules Création d'une nouvelle planification de l'action de réplication PUT /replication/actions/<ra_id> /schedules/<ra_schedule> Modification de l'objet de planification de l'action de réplication spécifiée DELETE /replication/actions/<ra_id> /schedules/<ra_schedule> Suppression de l'objet de planification de l'action de réplication spécifiée GET /pools/<pool>/projects /<project>/replication/actions Enumération de tous les objets de l'action de réplication GET /pools/<pool>/projects /<project>/replication/actions /<ra_id> Obtention des propriétés de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/replication/actions Création d'une nouvelle action de réplication PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id> Modification de l'objet de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/replication/actions /<ra_id> Suppression de l'objet de l'action de réplication spécifiée PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/sendupdate Démarrage de l'action de réplication sélectionnée PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/cancelupdate Interruption de l'action de réplication sélectionnée GET /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules Enumération de tous les objets de planification de l'action de réplication GET /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Obtention des propriétés de planification de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules Création d'une nouvelle planification de l'action de réplication PUT /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Modification de l'objet de planification de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/replication/actions /<ra_id>/schedules /<ra_schedule> Suppression de l'objet de planification de l'action de réplication spécifiée GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions Enumération de tous les objets de l'action de réplication GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Obtention des propriétés de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions Création d'une nouvelle action de réplication PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Modification de l'objet de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id> Suppression de l'objet de l'action de réplication spécifiée GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication Obtention des paramètres de l'action de réplication du système de fichiers PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication Modification des paramètres de l'action de réplication du système de fichiers PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/sendupdate Démarrage de l'action de réplication sélectionnée PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/cancelupdate Interruption de l'action de réplication sélectionnée GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules Enumération de tous les objets de planification de l'action de réplication GET /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Obtention des propriétés de planification de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules Création d'une nouvelle planification de l'action de réplication PUT /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Modification de l'objet de planification de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/filesystems /<filesystem>/replication /actions/<ra_id>/schedules /<ra_schedule> Suppression de l'objet de planification de l'action de réplication spécifiée GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions Enumération de tous les objets de l'action de réplication GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Obtention des propriétés de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/luns/<lun> /replication/actions Création d'une nouvelle action de réplication PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Modification de l'objet de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> Suppression de l'objet de l'action de réplication spécifiée GET /pools/<pool>/projects /<project>/luns/<lun> /replication Obtention des paramètres de l'action de réplication de LUN PUT /pools/<pool>/projects /<project>/luns/<lun> /replication Modification des paramètres de l'action de réplication de LUN PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /sendupdate Démarrage de l'action de réplication sélectionnée PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /cancelupdate Interruption de l'action de réplication sélectionnée GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules Enumération de tous les objets de planification de l'action de réplication GET /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Obtention des propriétés de planification de l'action de réplication spécifiée POST /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules Création d'une nouvelle planification de l'action de réplication PUT /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Modification de l'objet de planification de l'action de réplication spécifiée DELETE /pools/<pool>/projects /<project>/luns/<lun> /replication/actions/<ra_id> /schedules/<ra_schedule> Suppression de l'objet de planification de l'action de réplication spécifiée

List Replication Actions

Obtient une liste de toutes les actions de réplication disponibles.

Exemple de demande :

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

Exemple de réponse :

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

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

Get Replication Action

La commande d'obtention du statut de l'action de réplication renvoie le statut d'une action de réplication unique fourni par son ID.

Exemple de demande :

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

Exemple de réponse :

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",
        "compression": true,
        "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_clone_origin_as_data": false,
        "include_snaps": true,
        "last_sync": "20130916T21:36:50",
        "last_try": "20130916T21:36:50",
        "max_bandwidth": 0,
        "pool": "gold",
        "project": "blah1",
        "retain_user_snaps_on_target": false,
        "share": "fs1",
        "state": "sending",
        "target": "38094753-6c90-49ed-aa92-995a296d432a",
        "use_ssl": true
    }
}

Create Replication Action

Crée une nouvelle action de réplication.

Propriétés de création :

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
                 compression = true
 retain_user_snaps_on_target = false
include_clone_origin_as_data = false

Exemple de demande :

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"
}

Exemple de réponse :

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,
        "compression": true,
        "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,
        "retain_user_snaps_on_target": false,
        "share": "fs1",
        "id": "8373d331-de60-e590-90e8-9ad69fcb4aec",
        "pool": "gold",
        "include_clone_origin_as_data": false,
        "include_snaps": true
    }
}

Modify Replication Action

Modifie une action de réplication existante.

Exemple de demande :

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}

Exemple de réponse :

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",
        "compression": true,
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "dedup": false,
        "retain_user_snaps_on_target": false,
        "use_ssl": false,
        "id": "c141d88d-ffd2-6730-d489-b71905f340cc",
        "include_clone_origin_as_data": false,
        "include_snaps": true
    }
}

Cancel Update

Annule une mise à jour de réplication en cours.

Exemple de demande :

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

Exemple de réponse :

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

Send Update

Planifie le démarrage au plus tôt d'une mise à jour de réplication.

Exemple de demande :

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

Exemple de réponse :

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

Delete a Replication Action

Supprime une action de réplication existante.

Exemple de demande :

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

Une suppression réussie renvoie le code HTTP 204 (No Content).

Exemple de réponse :

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