Guía de la API de RESTful de Oracle^® ZFS Storage Appliance (versión OS8.8.x)

Esquema

Gestiona las propiedades del esquema personalizado.

Tabla 53  Comandos de esquema

Solicitud Anexar a la ruta de acceso /api/storage/v{1|2} Descripción GET /schema Mostrar todos los objetos de propiedad del esquema NAS GET /schema/property Obtener las propiedades especificadas de la propiedad del esquema NAS POST /schema Crear una propiedad de esquema NAS nueva PUT /schema/property Modificar el objeto especificado de la propiedad del esquema NAS DELETE /schema/property Suprimir el objeto especificado de la propiedad del esquema NAS

Se puede configurar cada propiedad personalizada del esquema para los proyectos, los sistemas de archivos y los LUN agregando el prefijo custom:. al nombre de propiedad personalizado.

Por ejemplo, el siguiente cuerpo PUT modifica la propiedad int de un cliente denominada priority:

{"custom:priority": 5}

Tabla 54  Parámetros del esquema

Parámetro Descripción property Nombre de la propiedad (inmutable) description Descripción de la propiedad (para la interfaz de explorador) type Tipo (“String”, “Integer”, “PositiveInteger”, “Boolean”, “EmailAddress”, “Host”)

Mostrar propiedades

Mostrar las propiedades del esquema.

Ejemplo de solicitud:

GET /api/storage/v1/schema

Resultado de ejemplo:

{
    "properties": [{
        "description": "bob",
        "href": "/api/storage/v1/schema/bob",
        "property": "bob",
        "type": "String"
    },{
        "description": "boo",
        "href": "/api/storage/v1/schema/boo",
        "property": "boo",
        "type": "String"
    }]
}

Obtener propiedad

Obtener una propiedad del esquema.

Ejemplo de solicitud:

GET /api/storage/v1/schema/priority

Resultado de ejemplo:

{
    "property": {
        "description": "priority",
        "href": "/api/storage/v1/schema/priority",
        "property": "bob",
        "type": "Integer"
    }
}

Crear propiedad

Crear una propiedad de esquema nueva.

Ejemplo de solicitud:

POST /api/storage/v1/schema HTTP/1.1
Host: zfs-storage.example.com:215
Content-Type: application/json
Content-Length: 64

{"property":"priority", "type":"Integer", "description":"Oh my"}

Resultado de ejemplo:

HTTP/1.1 201 Created
Content-Length: 89
X-Zfssa-Nas-Api: 1.0
Content-Type: application/json
Location: /api/storage/v1/schema/priority

{
    "property": {
        "href": "/api/storage/v1/schema",
        "type": "Integer",
        "description": "Oh my"
    }
}

Modificar propiedad

Modificar la propiedad de esquema.

Ejemplo de solicitud:

PUT /api/storage/v1/schema/priority

{"description":"My custom priority level"}

Resultado de ejemplo:

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

{
    "property": {
        "href": "//api/storage/v1/schema/priority",
        "type": "Integer",
        "description": "My custom priority level"
    }
}

Suprimir propiedad

Este comando suprime una propiedad de esquema.

Ejemplo de solicitud:

DELETE /api/storage/v1/schema/me HTTP/1.1

Resultado de ejemplo:

HTTP/1.1 204 No Content