Guide RESTful API des systèmes Oracle® ZFS Storage Appliance, version 2013.1.4.0

Quitter la vue de l'impression

 
Mis à jour : Avril 2015
 
 

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 12-37  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",
        "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
    }
}

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

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

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",
        "continuous": false,
        "enabled": true,
        "max_bandwidth": 0,
        "dedup": false,
        "use_ssl": false,
        "id": "c141d88d-ffd2-6730-d489-b71905f340cc",
        "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
Copyright © 2015, Oracle et/ou ses affiliés. Tous droits réservés. Mentions légales
Précédent
Suivant