Recursos, colecciones de recursos y métodos

Un recurso individual gestionado por el sistema se representa en la interfaz de línea de mandatos mediante un objeto Jython. Este objeto tiene los mismos atributos que el recurso Cloud Pak System en la interfaz gráfica, con algunos métodos y atributos adicionales para facilitar el trabajo en el entorno de la interfaz de línea de mandatos . Hay ayuda disponible para los objetos de recursos, en general, y para cada tipo de recurso. Se puede obtener ayuda sobre los recursos entrando el mandato siguiente:

>>> help(deployer.resource)

Hay objetos Jython adicionales que representan recopilaciones de recursos en el sistema. Estas colecciones de recursos (objetos de Jython) se pueden utilizar para llevar a cabo acciones como la creación de un recurso nuevo o la búsqueda de un recurso existente. Hay ayuda disponibles para los objetos de colección de recurso, en general, y para cada tipo de colección de recursos. Se puede obtener ayuda sobre las colecciones de recursos entrando el mandato siguiente:

>>> help(deployer.resourcecollection)

Los métodos de los objetos Jython tienen soporte para las operaciones que se pueden realizar sobre el recurso del sistema. Cuando llama a uno de estos métodos en la herramienta interfaz de línea de mandatos , la solicitud se envía a través de HTTPS a la instancia de Cloud Pak System donde se ejecuta. El resultado pasa de nuevo a través de la conexión HTTPS a la herramienta interfaz de línea de mandatos y se muestra de una de las maneras siguientes:

• Como valores de retorno de los métodos
• Como estado actualizado en los objetos de Jython
• Como excepciones de Jython (si el resultado indica una condición de error)

Todas las clases, objetos y campos Jython dentro de la interfaz de línea de mandatos se documentan utilizando series de documentos Jython estándar. La función help() proporcionada en la interfaz de línea de mandatos se puede utilizar para visualizar las series doc, tal como se muestra en los ejemplos siguientes:

>>> help(deployer.ipgroups)
An IPGroups object represents the collection of IP groups defined to the
Cloud Pak System.  Objects of this type are used to create, delete,
iterate over, list and search for IP groups on the system.

Additional help is available for the following methods:
   __contains__, create, delete, __delitem__, __getattr__, __getitem__,
   __iter__, __len__, list, __lshift__, __repr__, __rshift__, __str__,
   __unicode__

>>> help(deployer.ipgroup) 
An IPGroup object represents a particular IP group defined on the
Cloud Pak System.  Use the IP group object to query and
manipulate the IP group definition on the Cloud Pak System.  Attributes of
the IP group and relationships between the IP group and other
resources on the Cloud Pak System are represented as Jython
attributes on the IPGroup object.  Manipulate these Jython
attributes using standard Jython mechanisms to make changes to the
corresponding data on the Cloud Pak System.

Additional help is available for the following methods:
   __contains__, __delattr__, delete, __eq__, __hash__, isStatusTransient,
   __nonzero__, refresh, __repr__, __str__, __unicode__, waitFor

Additional help is available for the following properties:
   created, gateway, id, ips, name, netmask, networks, primarydns,
   secondarydns, subnetaddress, updated

Remember to append an underscore to the property name when asking for
help using a specific instance of a resource rather than the class.
For example, "help(deployer.pattern.name)" or "help(mypattern.name_)"
will work, but "help(mypattern.name)" will resolve the name of the pattern
referenced by mypattern and attempt to provide help for the resulting
string rather than the property itself.

>>> help(deployer.ipgroup.subnetaddress)
Subnet address associated with the IP group, represented as a string in
dotted decimal notation ('192.168.98.0', for example).