JavaScript is required to for searching.
Ignorer les liens de navigation
Quitter la vue de l'impression
Guide RESTful API des systèmes Oracle® ZFS Storage Appliance, version 2013.1.3.0
Oracle Technology Network
Bibliothèque
PDF
Vue de l'impression
Commentaires
search filter icon
search icon

Informations sur le document

Prise en main de l'API Oracle ZFS Storage Appliance RESTful

Utilisation de l'API RESTful

Service d'alerte API RESTful

Services Analytics

Services matériels

Commandes des journaux

Commandes réseau

Service des problèmes de l'API RESTful

Service des rôles de l'API RESTful

Service SAN de l'API RESTful

Commandes de service

Service de stockage de l'API RESTful

Opérations de pool de stockage

List Pools

Get Pool

Configure Pool

Add Storage to a Pool

Pool Scrub

Unconfigure Pool

Opérations relatives à des projets

List Projects

Get Project Properties

Create Project

Modify Project

Delete Project

Project Usage

Opérations liées aux systèmes de fichiers

List Filesystems

Get Filesystem

Create Filesystem

Modify Filesystem

Delete Filesystem

Quota et utilisation des systèmes de fichiers

Opérations LUN

List LUNS

Get LUN

Create a New LUN

Modify LUN

Delete Lun

Opérations liées aux instantanés et au clonage

List Snapshots

Get Snapshot

Create Snapshot

Rename Snapshot

Clone Snapshot

Rollback Snapshot

Delete a Snapshot

List Snapshot Dependents

Schema

List Properties

Get Property

Create Property

Modify Property

Delete Property

Réplication

Get Replication Service

Modify Replication Service State

Cibles de réplication

List Replication Targets

Get Replication Target

Create Replication Target

Delete Replication Target

Actions de réplication

List Replication Actions

Get Replication Action

Create Replication Action

Modify Replication Action

Cancel Update

Send Update

Delete a Replication Action

Packages de réplication

List Replication Sources

List Replication Packages

Modify Package

Delete Package

Cancel Update

Clone Package

Sever Package

Reverse Package

Commandes système

Service utilisateur de l'API RESTful

Commandes des workflows

Clients RESTful

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-35  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