Go to main content
Guía de API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.7.0)

Salir de la Vista de impresión

Actualización: Marzo de 2017
 
 

Esquema

Gestiona las propiedades del esquema personalizado.

Tabla 93  Propiedades del esquema
Solicitud
Ruta /api/storage/v1
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 94  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: zfssa.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

Suprimir la propiedad del esquema.

Ejemplo de solicitud:

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

Resultado de ejemplo:

HTTP/1.1 204 No Content