Red Hat SummitConsole Developer Guide
Red Hat Gluster Storage 3.1
Red Hat Gluster Storage Console Developer Guide
Abstract
Using the Red Hat Gluster Storage Console Application Programming Interfaces.
Part I. Introduction
Copy linkLink copied to clipboard!
Chapter 1. Introduction
Copy linkLink copied to clipboard!
Red Hat Gluster Storage Console provides a Representational State Transfer (REST) API. The API provides software developers and system administrators with control over their Red Hat Gluster Storage environment outside of the standard web interface. The REST API is useful for developers and administrators who aim to integrate the functionality of a Red Hat Gluster Storage environment with custom scripts or external applications that access the API through the standard Hypertext Transfer Protocol (HTTP).
The benefits of the REST API are:
- Broad client support - Any programming language, framework, or system with support for HTTP protocol can use the API;
- Self descriptive - Client applications require minimal knowledge of the storage infrastructure as many details are discovered at runtime;
- Resource-based model - The resource-based REST model provides a natural way to manage a storage platform.
This provides developers and administrators with the ability to:
- Integrate with enterprise IT systems.
- Integrate with third-party software.
- Perform automated maintenance or error checking tasks.
- Automate repetitive tasks in a Red Hat Gluster Storage environment with scripts.
This documentation acts as a reference to the Red Hat Gluster Storage Console REST API. It aims to provide developers and administrators with instructions and examples to help harness the functionality of their Red Hat Gluster Storage environment through the REST API.
1.1. Representational State Transfer
Copy linkLink copied to clipboard!
Representational State Transfer (REST) is a design architecture that focuses on resources for a specific service and their representations. A resource representation is a key abstraction of information that corresponds to one specific managed element on a server. A client sends a request to a server element located at a Uniform Resource Identifier (URI) and performs operations with standard HTTP methods, such as
GET, POST, PUT, and DELETE. This provides a stateless communication between the client and server where each request acts independent of any other request and contains all necessary information to complete the request.
1.2. Prerequisites
Copy linkLink copied to clipboard!
This guide requires the following:
- An installation of Red Hat Gluster Storage Console, which includes the REST API;
- A client or programming library that initiates and receives HTTP requests from the REST API. As an example, this guide includes basic instructions on use with cURL in Appendix B, API Usage with cURL;
- Knowledge of Hypertext Transfer Protocol (HTTP), which is the protocol used for REST API interactions. The Internet Engineering Task Force provides a Request for Comments (RFC) explaining the Hypertext Transfer Protocol at http://www.ietf.org/rfc/rfc2616.txt; and,
- Knowledge of Extensible Markup Language (XML), which the API uses to construct resource representations. The W3C provides a full specification on XML at http://www.w3.org/TR/xml/.
Chapter 2. Authentication and Security
Copy linkLink copied to clipboard!
This chapter provides information on authorization through Red Hat Gluster Storage Console's security.
2.1. TLS/SSL Certification
Copy linkLink copied to clipboard!
The Red Hat Gluster Storage Console API requires Hypertext Transfer Protocol Secure (HTTPS) for secure interaction with client software, such as the Console's SDK and CLI components. This involves a process of attaining a certificate from your Red Hat Gluster Storage Console server and importing it into your client's certificate store.
Procedure 2.1. Attain a certificate
This process helps a user attain a certificate from the Red Hat Gluster Storage Console and transfer it to the client machine. A user achieves this using one of two methods:
- Method 1 - Use a command line tool to download the certificate from the server. Examples of command line tools include cURL and Wget; both are available for multiple platforms.
- If using cURL:
curl -o rhsc.cer http://[rhgsc-server]/ca.crt
curl -o rhsc.cer http://[rhgsc-server]/ca.crtCopy to Clipboard Copied! Toggle word wrap Toggle overflow - If using Wget:
wget -O rhsc.cer http://[rhgsc-server]/ca.crt
wget -O rhsc.cer http://[rhgsc-server]/ca.crtCopy to Clipboard Copied! Toggle word wrap Toggle overflow
- Method 2 - Use a web browser to navigate to the certificate located at:Depending on the chosen browser, the certificate either downloads or imports into the browser's keystore.
http://[rhgsc-server]/ca.crt
http://[rhgsc-server]/ca.crtCopy to Clipboard Copied! Toggle word wrap Toggle overflow - If the browser downloads the certificate: save the file as
rhsc.cer.If the browser imports the certificate: export it from the browser's certification options and save it asrhsc.cer.
Each of the above methods results in a certificate file named
rhsc.cer on your client machine. An API user imports this file into the client's certificate store.
Procedure 2.2. Import a certificate to your client
- A certificate import for your client relies on how the client itself stores and interprets certificates. This guide contains an example on importing to a Java keystore in Appendix D, Java Keystores. For clients not using Network Security Services (NSS) or Java KeyStore (JKS), please refer to your client documentation for more information on importing a certificate.
2.2. HTTP Authentication
Copy linkLink copied to clipboard!
Any user with a Red Hat Gluster Storage Console account has access to the REST API. An API user submits a mandatory Red Hat Gluster Storage Console username and password with all requests to the API and uses HTTP Basic Authentication [1]to encode these credentials. If a request does not include an appropriate
Authorization header, the API sends a 401 Authorization Required as a result:
Example 2.1. Access to the REST API without appropriate credentials
HEAD [base] HTTP/1.1 Host: [host] HTTP/1.1 401 Authorization Required
HEAD [base] HTTP/1.1
Host: [host]
HTTP/1.1 401 Authorization Required
Request are issued with an
Authorization header for the specified realm. An API user encodes an appropriate Red Hat Gluster Storage Console domain and user in the supplied credentials with the username@domain:password convention.
The following table shows the process for encoding credentials in base64.
| Item | Value |
|---|---|
| username | rhscadmin |
| domain | domain.example.com |
| password | 123456 |
| unencoded credentials | rhscadmin@domain.example.com:123456 |
| base64 encoded credentials | cmhzY2FkbWluQGRvbWFpbi5leGFtcGxlLmNvbToxMjM0NTYK |
An API user provides the base64 encoded credentials as shown:
Example 2.2. Access to the REST API with appropriate credentials
Important
Basic authentication involves potentially sensitive information, such as passwords, sent as plain text. REST API requires Hypertext Transfer Protocol Secure (HTTPS) for transport-level encryption of plain-text requests.
Important
Some base64 libraries break the result into multiple lines and terminate each line with a newline character. This breaks the header and causes a faulty request. The Authorization header requires the encoded credentials on a single line within the header.
2.3. Authentication Sessions
Copy linkLink copied to clipboard!
The API also provides the ability for authentication session support. An API user sends an initial request with authentication details, then sends all subsequent requests using a session cookie to authenticate. The following procedure demonstrates how to use an authenticated session.
To request an authenticated session:
- Send a request with the
AuthorizationandPrefer:persistent-auth.Copy to Clipboard Copied! Toggle word wrap Toggle overflow This returns a response with the following header:Set-Cookie: JSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK; Path=/api; Secure
Set-Cookie: JSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK; Path=/api; SecureCopy to Clipboard Copied! Toggle word wrap Toggle overflow Note theJSESSIONID=value. In this example the value isJSESSIONID=5dQja5ubr4yvI2MM2z+LZxrK. - Send all subsequent requests with the
Prefer:persistent-authand cookie header with theJSESSIONID=value. TheAuthorizationis no longer needed when using an authenticated session.Copy to Clipboard Copied! Toggle word wrap Toggle overflow - When the session is no longer required, perform a request to the sever without the
Prefer: persistent-authheader.Copy to Clipboard Copied! Toggle word wrap Toggle overflow
[1]
Basic Authentication is described in RFC 2617 HTTP Authentication: Basic and Digest Access Authentication.
Chapter 3. REST API Quick Start Examples
Copy linkLink copied to clipboard!
This chapter provides an example to demonstrate the REST API's ability to setup a basic trusted storage pool within the Red Hat Gluster Storage environment.
This example uses cURL to demonstrate REST requests with a client application. Find out more about cURL use with the REST API in Appendix B, API Usage with cURL. Note that any application capable of HTTP requests can substitute for cURL.
Important
For simplicity, the HTTP request headers in this example omit the
Host: and Authorization: fields. However, these fields are mandatory and require data specific to your installation of Red Hat Gluster Storage Console.
Important
All cURL examples include placeholders for authentication details (
USER:PASS) and certificate location (CERT). Ensure all requests performed with cURL fulfil certification and authentication requirements. See Chapter 2, Authentication and Security and Appendix B, API Usage with cURL for more information.
Note
Red Hat Gluster Storage Console generates a globally unique identifier (GUID) for the
id attribute for each resource. Identifier codes in this example might appear different to the identifier codes in your Red Hat Gluster Storage Console environment.
3.1. Example: Access API Entry Point
Copy linkLink copied to clipboard!
The following request retrieves a representation of the main entry point of the API.
Example 3.1. Access the API entry point
GET /api HTTP/1.1 Accept: application/xml
GET /api HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api
The API returns the following representation:
The entry point provides a user with links to the collections in a storage environment. The
rel= attribute of each collection link provides a reference point for each link. The next step in this example examines the cluster collection, which is available through the rel="cluster" link.
The entry point also contains other data such as
product_info and summary. This data is covered in chapters outside this example.
3.2. Example: List Cluster Collection
Copy linkLink copied to clipboard!
Red Hat Gluster Storage Console creates a
Default cluster on installation. This example uses the Default cluster to group resources in your Red Hat Gluster Storage environment.
The following request retrieves a representation of the cluster collection:
Example 3.2. List clusters collection
GET /api/clusters HTTP/1.1 Accept: application/xml
GET /api/clusters HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/clusters
The API returns the following representation:
Note the
id code of your Default cluster. This code identifies this cluster in relation to other resources of your storage environment.
3.3. Example: List Host Collection
Copy linkLink copied to clipboard!
This example retrieves a representation of the host collection and shows a Red Hat Gluster Storage server named
host1 registered with the default cluster.
Example 3.3. List hosts collection
GET /api/hosts HTTP/1.1 Accept: application/xml
GET /api/hosts HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/hosts
The API returns the following representation:
Note the
id code of your Default server. This code identifies this host in relation to other resources of your virtual environment.
3.4. Example: Add Host to Cluster
Copy linkLink copied to clipboard!
This example adds a host to the default cluster and shows a host named host1 registered with the storage environment.
Example 3.4. Add Server to Cluster
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC HOST]/api/hosts -d "<host><cluster id=\"99408929-82cf-4dc7-a532-9d998063fa95\"/><name>host1</name><address>IP_ADDRESS</address><root_password>ROOT_PASSWORD</root_password></host>"
The API returns the following representation of the newly created server:
3.5. Example: Create Volume
Copy linkLink copied to clipboard!
This example creates a volume
data, volume type DISTRIBUTE, and having two bricks in the default cluster.
Example 3.5. Creating a Volume
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes -d "<gluster_volume><name>data</name><volume_type>DISTRIBUTE</volume_type><bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick1</brick_dir></brick><brick><server_id>de173e6a-fb05-11e1-a2fc-0050568c4349</server_id><brick_dir>/export/data/brick2</brick_dir></brick></bricks></gluster_volume>"
The API returns the following representation of the newly created volume resource:
3.6. Example: List Volume Collection
Copy linkLink copied to clipboard!
This example retrieves a representation of the volume collection and shows a list of volumes present in the
Default cluster.
Example 3.6. List Volume Collection
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes HTTP/1.1 Accept: application/xml
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes
The API returns the following representation:
3.7. Example: Start Volume
Copy linkLink copied to clipboard!
This example retrieves a representation of starting a volume.
Example 3.7. Start Volume
POST api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/start HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
POST api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/start HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action/>
cURL Command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/start -d "<action/>"
The API returns the following representation:
3.8. Example: List Brick Collection
Copy linkLink copied to clipboard!
This example retrieves a representation of the brick collection and shows a list of bricks of a volume.
Example 3.8. List Brick Collection
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks HTTP/1.1 Accept: application/xml
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks
The API returns the following representation:
3.9. Example: Add Bricks to Volume
Copy linkLink copied to clipboard!
This example adds a brick to volume.
Example 3.9. Add Bricks to Volume
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks -d "<bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick3</brick_dir></brick></bricks>"
The API returns the following representation:
3.10. Example: Check System Events
Copy linkLink copied to clipboard!
The
login action for admin creates entries in the events collection. This example lists the events collection and identifies events specific to log in of the admin.
Example 3.10. List the events collection
GET /api/events HTTP/1.1 Accept: application/xml
GET /api/events HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/events
The API returns a representation that includes the following:
The following event occurs:
id="54"- The API authenticates with theadminuser's username and password.id="192"- The API, acting as theadminuser, startsVolume Dataon theDefaultclusterid="193"- The API logs out of theadminuser account.
Chapter 4. Python Quick Start Example
Copy linkLink copied to clipboard!
4.1. Python Quick Start Introduction
Copy linkLink copied to clipboard!
This chapter provides a series of examples demonstrating the steps to create a cluster within a basic Red Hat Gluster Storage environment using the Python Software Development Kit.
These examples use the
ovirtsdk Python library provided by the rhsc-sdk package. This package is available to systems subscribed to a Red Hat Gluster Storage pool if you use the certificate-based Red Hat Network, or the Red Hat Gluster Storage channel if you use the Red Hat Network classic. See the Red Hat Gluster Storage Console Installation Guide for more information on subscribing systems to download software from these locations.
Note
See the Red Hat Gluster Storage Console Installation Guide for specific channel names current to your system.
You will also need:
- A networked installation of Red Hat Gluster Storage Console.
- A networked and configured Red Hat Gluster Storage Server.
- A working understanding of both the logical and physical objects that make up a Red Hat Gluster Storage environment.
- A working understanding of the Python programming language.
Important
All Python examples include placeholders for authentication details (USER for user name, and PASS for password). Ensure all requests performed with Python fulfill the authentication requirements of your environment.
Note
Red Hat Gluster Storage generates a globally unique identifier (GUID) for the id attribute for each resource. Identifier codes in these examples might appear different to the identifier codes in your Red Hat Gluster Storage environment.
Note
These Python examples contain only basic exception and error handling logic. For more information on the exception handling specific to the SDK, see the pydoc for the
ovirtsdk.infrastructure.errors module.
4.2. Example: Accessing the API Entry Point using Python
Copy linkLink copied to clipboard!
The
ovirtsdk Python library provides the API class, which acts as the entry point for the API.
Example 4.1. Accessing the API entry point using Python
To connect the example creates an instance of the
API class. If connection is established successfully, a message is printed. Lastly, the disconnect() method of the API class is called to close the connection.
The parameters provided to the constructor for the API class in this example are:
- The
urlof the Console with which to connect. - The
usernameof the user to authenticate. - The
passwordof the user to authenticate. - The
ca_filethat is the path to a certificate. The certificate is expected to be a copy of the Console's Certificate Authority. It can be obtained fromhttps://[HOST]/ca.crt.
The constructor for the
API class supports other parameters. Only mandatory parameters are specified in this example.
If the connection attempt was successful, the example outputs the text:
Connected to Red Hat Gluster Storage Console successfully!
Connected to Red Hat Gluster Storage Console successfully!Example 4.2. Listing the Cluster Collection using Python
The
API class provides a cluster collection named default cluster. This collection contains all the clusters in the environment.
This Python example lists the clusters in the default cluster collection.
In an environment where only the
Default cluster exists, the example outputs:
Default (99408929-82cf-4dc7-a532-9d998063fa95)
Default (99408929-82cf-4dc7-a532-9d998063fa95)Example 4.3. Listing the Networks Collection using Python
The
API class provides access to a networks collection named Management Networks. This collection contains all the networks in the environment.
This Python example lists the networks in the
networks collection. It also outputs some basic information about each network in the collection.
In an environment where only the default management network exists, this example outputs the description of the network, the network ID and the name of the network:
Management Network 00000000-0000-0000-0000-000000000009 ovirtmgmt
Management Network
00000000-0000-0000-0000-000000000009
ovirtmgmtExample 4.4. Listing the Host Collection using Python
The
API class provides access to a host collection. This collection contains all the hosts in the storage cluster.
This Python example lists the hosts in the host collection.
The code snippet displays the list of hosts in the environment along with the associated host IDs.
host name: 10.70.37.49 (host ID: 5be18d62-e7b0-4407-8ff6-68290a92338f) host name: 10.70.37.50 (host ID: 3b202041-6e14-43df-a844-92a141bed1ed)
host name: 10.70.37.49 (host ID: 5be18d62-e7b0-4407-8ff6-68290a92338f)
host name: 10.70.37.50 (host ID: 3b202041-6e14-43df-a844-92a141bed1ed)Example 4.5. Listing the Volume Collection using Python
Example 4.6. Listing the Brick Collection from a Volume using Python
The function
getGlusterVolumeBrickDetails()lists the bricks of the volume that is assigned to the cluster.
Example 4.7. Listing hooks in a Red Hat Gluster Storage Console
You can view the volume lifecycle extensions in a Red Hat Gluster Storage Console using Gluster hooks. The function
getHookList(clusterName) lists the Gluster hooks created in the Console.
The code snippet displays the list of hook scripts in the console along with the associated hook IDs,
Part II. REST Application Programming Interface
Copy linkLink copied to clipboard!
Chapter 5. Entry Point
Copy linkLink copied to clipboard!
A user begins interacting with the API through a
GET request on the entry point URI consisting of a host and base.
Example 5.1. Accessing the API Entry Point
If the host is
www.example.com and the base is /api, the entry point appears with the following request:
Note
For simplicity, all other examples omit the
Host: and Authorization: request headers and assume the base is the default /api path. This base path differs depending on your implementation.
5.1. Product Information
Copy linkLink copied to clipboard!
The entry point contains a
product_info element to help an API user determine the legitimacy of the Red Hat Gluster Storage environment. This includes the name of the product, the vendor and the version.
Example 5.2. Verify a genuine Red Hat Gluster Storage environment
The follow elements identify a genuine Red Hat Gluster Storage 3.0 environment:
5.2. Link elements
Copy linkLink copied to clipboard!
Access to the Entry Point provides
link elements and URIs for all of the resource collections the API exposes. Each collection uses a relation type to identify the URI a client needs.
| Relationship | Description |
|---|---|
capabilities | Supported capabilities of the Red Hat Gluster Storage Console. |
clusters | Clusters. |
events | Events. |
hosts | Hosts. |
networks | Virtual networks. |
roles | Roles. |
tags | Tags. |
users | Users. |
groups | Imported identity service groups. |
domains | Identity service domains. |
The
link elements also contain a set of search URIs for certain collections. These URIs use URI templates [2] to integrate search queries. The purpose of the URI template is to accept a search expression using the natural HTTP pattern of a query parameter. The client does not require prior knowledge of the URI structure. Thus clients should treat these templates as being opaque and access them with a URI template library.
Each search query URI template is identified with a relation type using the convention
"collection/search".
| Relationship | Description |
|---|---|
clusters/search | Query clusters. |
events/search | Query events. |
hosts/search | Query hosts. |
users/search | Query users. |
groups/search | Query groups. |
5.3. Summary element
Copy linkLink copied to clipboard!
The summary element shows a high level summary of the system's statistics.
| Element | Description |
|---|---|
hosts | Total number of hosts and total number of active hosts. |
users | Total number of users and total number of active users. |
5.4. RESTful Service Description Language (RSDL)
Copy linkLink copied to clipboard!
RESTful Service Description Language (RSDL) provides a description of the structure and elements in the the REST API in one whole XML specification. Invoke the RSDL using the following request.
GET /api?rsdl HTTP/1.1 Accept: application/xml
GET /api?rsdl HTTP/1.1
Accept: application/xml
This produces an XML document in the following format:
| Element | Description |
|---|---|
| description | A plain text description of the RSDL document. |
| version | The API version, including major release, minor release, build and revision. |
| schema | A link to the XML schema (XSD) file. . |
| links | Defines each link in the API. |
Each link element contains the following a structure:
| Element | Description |
|---|---|
link | A URI for API requests. Includes a URI attribute (href) and a relationship type attribute (rel). |
request | Defines the request properties required for the link. |
http_method | The method type to access this link. Includes the standard HTTP methods for REST API access: GET, POST, PUT and DELETE. |
headers | Defines the headers for the HTTP request. Contains a series of header elements, which each contain a header name and value to define the header. |
body | Defines the body for the HTTP request. Contains a resource type and a parameter_set, which contains a sets of parameter elements with attributes to define whether they are required for a request and the data type. The parameter element also includes a name element to define the Red Hat Gluster Storage Console property to modify and also a further parameter_set subset if type is set to collection. |
response | Defines the output for the HTTP request. Contains a type element to define the resource structure to output. |
Use the RSDL in your applications as a method to map all links and parameter requirements for controlling a Red Hat Gluster Storage environment.
[2]
The Internet-Draft describing the format of a URI Template is available at http://tools.ietf.org/html/draft-gregorio-uritemplate-03.
Chapter 6. Capabilities
Copy linkLink copied to clipboard!
The capabilities collection provides information about the supported capabilities of a Red Hat Gluster Storage Console version. These capabilities include active features and available enumerated values for specific properties. An API user accesses this information through the
rel="capabilities" link obtained from the entry point URI.
6.1. Version-Dependent Capabilities
Copy linkLink copied to clipboard!
The capabilities element contains any number of version elements that describe capabilities dependent on a compatibility level.
The version element includes attributes for major and minor version numbers. This indicates the current version level.
The following representation shows capabilities specific to Red Hat Gluster Storage Console 3.0 and 2.1 respectively:
Each
version contains a series of capabilities dependent on the version specified.
6.2. Current Version
Copy linkLink copied to clipboard!
The current element signifies if the version specified is the most recent supported compatibility level. The value is either a Boolean
true or false.
6.3. Red Hat Gluster Storage Volume Types
Copy linkLink copied to clipboard!
The
gluster_volume_types element lists the available type of Red Hat Gluster Storage volumes.
6.4. Red Hat Gluster Storage Transport Types
Copy linkLink copied to clipboard!
The
transport_types element lists the available transport types for Red Hat Gluster Storage volumes.
6.5. Step Type
Copy linkLink copied to clipboard!
The
step_type element lists the available type of job steps while monitoring a jobs on Red Hat Gluster Storage volumes.
6.6. Gluster Hook Content Type
Copy linkLink copied to clipboard!
The
content_type element lists the Gluster Hook content types.
<content_types>
<content_type>text</content_type>
<content_type>binary</content_type>
</content_types>
<content_types>
<content_type>text</content_type>
<content_type>binary</content_type>
</content_types>6.7. Gluster Hook Stage
Copy linkLink copied to clipboard!
The
hook_states element lists the available status of the hooks.
<hook_states>
<hook_state>enabled</hook_state>
<hook_state>disabled</hook_state>
<hook_state>missing</hook_state>
</hook_states>
<hook_states>
<hook_state>enabled</hook_state>
<hook_state>disabled</hook_state>
<hook_state>missing</hook_state>
</hook_states>6.8. Resource Status States
Copy linkLink copied to clipboard!
Each version contains a set of states for resource statuses. These resource status elements include
creation_states, host_states, host_non_operational_details, gluster_volume_states, and brick_states.
Chapter 7. Common Features
Copy linkLink copied to clipboard!
This chapter examines features common to resources and collections.
Note
Throughout this guide, the elements of each resource are detailed in tables. These tables include a properties column, displaying icons depicting element properties. The meaning of these icons is shown in Table 7.1, “Element property icons”
| Property | Description | Icon |
|---|---|---|
| Required for creation | These elements must be included in the client-provided representation of a resource on creation, but are not mandatory for an update of a resource. | 
|
| Non-updateable | These elements cannot have their value changed when updating a resource. Include these elements in a client-provided representation on update only if their values are not altered by the API user. If altered, the API reports an error. | 
|
| Read-only | These elements are read-only. Values for read-only elements are not created or modified. | 
|
7.1. Representations
Copy linkLink copied to clipboard!
The API structures resource representations in the following XML document structure:
<resource id="resource_id" href="/api/collection/resource_id">
<name>Resource-Name</name>
...
</resource>
<resource id="resource_id" href="/api/collection/resource_id">
<name>Resource-Name</name>
...
</resource><gluster_volume href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554" id="83101900-2f12-4855-838e-36b8a9e04554">
<name>vol1</name>
...
</gluster_volume>
<gluster_volume href="/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554" id="83101900-2f12-4855-838e-36b8a9e04554">
<name>vol1</name>
...
</gluster_volume>
All resource representations contain a set of common attributes
| Attribute | Type | Description | Properties |
|---|---|---|---|
id | GUID | Each resource in the storage infrastructure contains an id, which acts as a globally unique identifier (GUID). The GUID is the primary method of resource identification. |
|
href | string | The canonical location of the resource as an absolute path. |
|
7.2. Collections
Copy linkLink copied to clipboard!
A collection is a set of resources of the same type. The API provides both top-level collections and sub-collections. This section examines common features for collections.
7.2.1. Listing All Resources in a Collection
Copy linkLink copied to clipboard!
A listing of the resources in a collection is obtained by issuing a
GET request on the collection URI obtained from the entry point.
7.2.2. Listing Extended Resource Sub-Collections
Copy linkLink copied to clipboard!
The API extends collection representations to include sub-collections when the
Accept header includes the detail parameter.
GET /api/collection HTTP/1.1 Accept: application/xml; detail=subcollection
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection
This includes multiple sub-collection requests using either separated
detail parameters:
GET /api/collection HTTP/1.1 Accept: application/xml; detail=subcollection1; detail=subcollection2
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1; detail=subcollection2
Or one
detail parameter that separates the sub-collection with the + operator:
GET /api/collection HTTP/1.1 Accept: application/xml; detail=subcollection1+subcollection2+subcollection3
GET /api/collection HTTP/1.1
Accept: application/xml; detail=subcollection1+subcollection2+subcollection3
The API supports extended sub-collections for the following main collections.
| Collection | Extended Sub-Collection Support |
|---|---|
hosts | statistics |
bricks | statistics |
step | statistics |
Example 7.1. An request for extended statistics in the servers collection
GET /api/hosts HTTP/1.1 Accept: application/xml; detail=statistics
GET /api/hosts HTTP/1.1
Accept: application/xml; detail=statistics7.2.3. Searching Collections with Queries
Copy linkLink copied to clipboard!
A
GET request on a "collection/search" link results in a search query of that collection. The API only returns resources within the collection that satisfy the search query constraints.
7.2.3.1. Query Syntax
Copy linkLink copied to clipboard!
The API uses the URI templates to perform a search
query with a GET request:
GET /api/collection?search={query} HTTP/1.1
Accept: application/xml
GET /api/collection?search={query} HTTP/1.1
Accept: application/xml
The
query template value refers to the search query the API directs to the collection. This query uses the same format as Red Hat Gluster Storage Console search query language:
(criteria) [sortby (element) asc|desc]
The
sortby clause is optional and only needed when ordering results.
| Collection | Criteria | Result |
|---|---|---|
volumes | type=REPLICATE | Displays a list of all replicate volumes |
events | severity>normal sortby time | Displays the list of all events with severity higher than normal and sorted by the time element values. |
events | severity>normal sortby time desc | Displays the list of all events with severity higher than normal and sorted by the time element values in descending order. |
The API requires the
query template to be URL-encoded to translate reserved characters, such as operators and spaces.
Example 7.2. URL-encoded search query
GET /api/events?search=severity%3Derror HTTP/1.1 Accept: application/xml
GET /api/events?search=severity%3Derror HTTP/1.1
Accept: application/xmlImportant
All search queries are case-sensitive.
7.2.3.2. Wildcards
Copy linkLink copied to clipboard!
Search queries substitute part of a value with an asterisk as a wildcard.
Example 7.3. Wildcard search query for name=server*
GET /api/hosts?search=name%3Dserver* HTTP/1.1 Accept: application/xml
GET /api/hosts?search=name%3Dserver* HTTP/1.1
Accept: application/xml
This query would result in all servers with names beginning with
server, such as server-1, server-2, or server-data.
Example 7.4. Wildcard search query for name=s*1
GET /api/hosts?search=name%3D*1 HTTP/1.1 Accept: application/xml
GET /api/hosts?search=name%3D*1 HTTP/1.1
Accept: application/xml
This query would result in all servers with names beginning with
s and ending with 1, such as server1 or server-1 .
7.2.3.3. Pagination
Copy linkLink copied to clipboard!
Some Red Hat Gluster Storage environments contain large collections of resources. However, the API only displays a default number of resources for one search query to a collection. To display more than the default, the API separates collections into pages via a search query containing the
page command.
Example 7.5. Paginating resources
This example paginates resources in a collection. The URL-encoded request is:
GET /api/collection?search=page%201 HTTP/1.1 Accept: application/xml
GET /api/collection?search=page%201 HTTP/1.1
Accept: application/xml
Increase the
page value to view the next page of results.
GET /api/collection?search=page%202 HTTP/1.1 Accept: application/xml
GET /api/collection?search=page%202 HTTP/1.1
Accept: application/xml
Use the
page command also in conjunction with other commands in a search query. For example:
GET /api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1 Accept: application/xml
GET /api/collection?search=sortby%20element%20asc%20page%202 HTTP/1.1
Accept: application/xml
This query displays the second page in a collection listing ordered by a chosen element.
7.2.4. Creating a Resource in a Collection
Copy linkLink copied to clipboard!
The API creates a new resource with a
POST request to the collection URI containing a representation of the new resource.
A
POST request requires a Content-Type: application/xml header. This informs the API of the XML representation in the body content as part of the request.
Each resource type has its own specific required properties. The client supplies these properties as XML elements when creating a new resource. Refer to the individual resource type documentation for more details. If a required property is absent, the creation fails with a
fault representation indicating the missing elements.
The
Location header in the response gives the URI of the queried resource. The response body contains either a complete representation, partial representation or no representation of the resource. It is recommended that clients rely only on fetching the representation via the URI in the response header.
7.3. Resources
Copy linkLink copied to clipboard!
This section examines common features for resources.
7.3.1. Retrieving a Resource
Copy linkLink copied to clipboard!
The API retrieves the state of a resource with a
GET request on a URI obtained from a collection listing.
7.3.2. Updating a Resource
Copy linkLink copied to clipboard!
The API modifies resource properties with a
PUT request containing an updated description from a previous GET request for the resource URI. Details on modifiable properties are found in the individual resource type documentation.
A
PUT request requires a Content-Type: application/xml header. This informs the API of the XML representation in the body content as part of the request.
This does not include immutable resource properties that an API user has attempted to modify. If an attempt is made to modify a strictly immutable resource property, the API reports a
409 Conflict error with a fault representation in the response body.
Properties omitted from the representation are ignored and not changed.
7.3.3. Deleting a Resource
Copy linkLink copied to clipboard!
The API deletes a resource with a
DELETE request sent to its URI.
DELETE /api/collection/resource_id HTTP/1.1 Accept: application/xml HTTP/1.1 204 No Content
DELETE /api/collection/resource_id HTTP/1.1
Accept: application/xml
HTTP/1.1 204 No Content
Some cases require optional body content in the
DELETE request to specify additional properties. A DELETE request with optional body content requires a Content-Type: application/xml header to inform the API of the XML representation in the body content. If a DELETE request contains no body content, omit the Content-Type: application/xml header.
7.3.4. Sub-Collection Relationships
Copy linkLink copied to clipboard!
A sub-collection relationship defines a hierarchical link between a resource and a sub-collection. The sub-collection exists or has some meaning in the context of a parent resource. For example, a volume contains bricks, which means the API maps the relationship between the volume resource and the bricks sub-collection.
Sub-collections are used to model the following relationships types:
- 1:N mappings, where mapped resources are dependent on a parent resources. Without the parent resource, the dependent resource cannot exist. For example, the link between a volume and its bricks.
- 1:N mappings, where mapped resources exist independently from parent resources but data is still associated with the relationship. For example, the link between a network and a cluster.
The API defines a relationship between a resource and a sub-collection using the
link rel= attribute:
The API user now queries the sub-collection.
7.3.5. XML Element Relationships
Copy linkLink copied to clipboard!
XML element links act as an alternative to sub-collections to express relationships between resources. XML element links are simply elements with a "href" attribute that points to the linked element.
XML element links are used to model simple 1:N mappings between resources without a dependency and without data associated with the relationship. For example, the relationship between a host and a cluster.
Examples of such relationships include:
- Backlinks from a resource in a sub-collection to a parent resource; or
- Links between resources with an arbitrary relationship.
Example 7.6. Backlinking from a sub-collection resource to a resource using an XML element
7.3.6. Actions
Copy linkLink copied to clipboard!
Most resources include a list of action links to provide functions not achieved through the standard HTTP methods.
The API invokes an action with a
POST request to the supplied URI. The body of the POST requires an action representation encapsulating common and task-specific parameters.
| Element | Description |
|---|---|
async | If true, the server responds immediately with 202 Accepted and an action representation contains a href link to be polled for completion. |
grace_period | a grace period in milliseconds, which must expire before the action is initiated. |
Individual actions and their parameters are documented in the individual resource type's documentation. Some parameters are mandatory for specific actions and their absence is indicated with a
fault response.
An action also requires a
Content-Type: application/xml header since the POST request requires an XML representation in the body content.
When the action is initiated asynchronously, the immediate
202 Accepted response provides a link to monitor the status of the task:
A subsequent
GET on the action URI provides an indication of the status of the asynchronous task.
| Status | Description |
|---|---|
pending | Task has not yet started. |
in_progress | Task is in operation. |
complete | Task completed successfully. |
failed | Task failed. The returned action representation would contain a fault describing the failure. |
Once the task has completed, the action is retained for an indeterminate period. Once this has expired, subsequent
GETs are 301 Moved Permanently redirected back to the target resource.
An action representation also includes some links that are identified by the
rel attribute:
| Type | Description |
|---|---|
parent | A link back to the resource of this action. |
replay | A link back to the original action URI. POSTing to this URI causes the action to be re-initiated. |
7.3.7. Permissions
Copy linkLink copied to clipboard!
Each resource contains a
permissions sub-collection. Each permission contains a user, an assigned role and the specified resource. For example:
A resource acquires a new permission when an API user sends a
POST request with a permission representation and a Content-Type: application/xml header to the resource's permissions sub-collection. Each new permission requires a role and a user:
7.3.8. Handling Errors
Copy linkLink copied to clipboard!
Some errors require further explanation beyond a standard HTTP status code. For example, the API reports an unsuccessful resource state update or action with a
fault representation in the response entity body. The fault contains a reason and detail strings. Clients must accommodate failed requests via extracting the fault or the expected resource representation depending on the response status code. Such cases are clearly indicated in the individual resource documentation.
Chapter 8. Clusters
Copy linkLink copied to clipboard!
The
clusters collection provides information about clusters in a Red Hat Gluster Storage environment. An API user accesses this information through the rel="clusters" link obtained from the entry point URI (see Chapter 5, Entry Point).
The following table shows specific elements contained in a cluster resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="networks" | relationship | A link to the sub-collection for networks associated with this cluster. | |
link rel="permissions" | relationship | A link to the sub-collection for cluster permissions. See Section 7.3.7, “Permissions”. | |
version major= minor= | complex | The compatibility level of the cluster. |
|
supported_versions | complex | A list of possible version levels for the cluster. |
|
gluster_service | boolean | defines whether gluster services are enabled on the cluster. Is always true in Red Hat Gluster Storage Console | |
virt_service | boolean | defines whether virtualization services are enabled on the cluster. Is always false in Red Hat Gluster Storage Console. |
Example 8.1. An XML representation of a cluster
Creation of a new cluster requires the
name and server elements. Identify the server with id attribute and name element. name element is mandatory. See Section 7.2.4, “Creating a Resource in a Collection” for more information.
Example 8.2. Creating a cluster
Example 8.3. Updating a cluster
Removal of a cluster requires a
DELETE request.
Example 8.4. Removing a cluster
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95 HTTP/1.1
HTTP/1.1 204 No Content8.1. Networks Sub-Collection
Copy linkLink copied to clipboard!
Networks associated with a cluster are represented with the
networks sub-collection. Every host within a cluster connects to these associated networks.
The representation of a cluster's
network sub-collection is the same as a standard network resource with an additional cluster id= to signify a relationship to the cluster and a display element to represent the display network status in the cluster.
An API user manipulates the
networks sub-collection as described in Chapter 7, Common Features. POSTing a network id or name reference to the networks sub-collection associates the network with the cluster.
Example 8.5. Associating a network resource with a cluster
The display network status is set using a
PUT request to specify the Boolean value (true or false) of the display element.
Example 8.6. Setting the display network status
An association is removed with a
DELETE request to the appropriate element in the collection.
Example 8.7. Removing a network association from a cluster
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/networks/da05ac09-00be-45a1-b0b5-4a6a2438665f HTTP/1.1
8.2. Gluster Hooks
Copy linkLink copied to clipboard!
The
glusterhooks collection provides information about Gluster Hooks in a Red Hat Gluster Storage environment. An API user accesses this information through the rel="glusterhooks" link obtained from the entry point URI (see Chapter 5, Entry Point).
Note
Gluster Hooks data from the storage cluster is collected periodically every two hours.
The following table shows specific elements contained in a Gluster Hooks resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
cluster | relationship | A reference to the cluster that includes this hook. | locked |
name | string | The name of the hook script | Read only |
gluster_command | string | gluster volume command for which the hook is executed | read only |
stage | string | stage of the command; PRE or POST | read only |
content_type | string | TEXT or BINARY | read only |
checksum | string | md5 checksum of the hook script | read only |
content | string | content of the hook script | read only |
conflict_status | integer | bit representation of the conflict detected for the hook. First bit is for content, second is for status and third is for missing hooks. | read only |
conflicts | string | comma separated list of conflict | read only |
status | One of enabled or disabled | The status of the hook. | update |
Example 8.8. An XML representation of Gluster Hook Collection
8.2.1. Managing Gluster Hooks
Copy linkLink copied to clipboard!
This section describes the Gluster Hooks operations of the Red Hat Gluster Storage Console API such as listing, enabling, resolving, and removing them from a cluster.
8.2.1.1. Listing Gluster Hooks
Copy linkLink copied to clipboard!
A listing of hooks in the cluster along with conflict status is obtained by issuing a
GET request on the volume URI.
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glusterhooks HTTP/1.1 Accept: application/xml
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glusterhooks HTTP/1.1
Accept: application/xml
The API returns the following representation:
8.2.1.2. Enabling Gluster Hooks
Copy linkLink copied to clipboard!
A Gluster Hook is enabled by issuing a
POST request to its URI.
POST /api/clusters/419590b8-5aa0-473b-9651-aa41f1372c59/glusterhooks/747bbb9e-ace6-424b-be31-16b33e02d882/enable HTTP/1.1 Accept: application/xml
POST /api/clusters/419590b8-5aa0-473b-9651-aa41f1372c59/glusterhooks/747bbb9e-ace6-424b-be31-16b33e02d882/enable
HTTP/1.1
Accept: application/xml
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/419590b8-5aa0-473b-9651-aa41f1372c59/glusterhooks/747bbb9e-ace6-424b-be31-16b33e02d882/enable -d "<action/>"
The API returns the following representation:
8.2.1.3. Resolving Gluster Hook Conflict
Copy linkLink copied to clipboard!
Gluster Hooks conflict is resolved by issuing a
POST request. MISSING_HOOK, CONTENT_CONFLICT, and STATUS_CONFLICT are the types of conflict that can be resolved on a cluster.
- Missing Hook Conflict:
MISSING_HOOKconflict can be resolved either by adding the hook to the host where it is missing or by removing it from all hosts and from the Red Hat Gluster Storage Console by issuing aDELETErequest.cURL command to resolve missing hook conflict by adding hook:curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glusterhooks/59ecbacb-1ce3-43f7-82e4-55db8ed74f56/resolve -d "<action><resolution_type>ADD</resolution_type></action>"The API returns the following representation:Copy to Clipboard Copied! Toggle word wrap Toggle overflow cURL command to resolve missing hook conflict by deleting hook:curl -X DELETE -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glusterhooks/18782869-3e62-42a5-a59d-91f896afd5d7<action> <job href="/api/jobs/3dd9800f-a8c6-4f58-a3cf-dff190d2f06f" id="3dd9800f-a8c6-4f58-a3cf-dff190d2f06f"/> <status><state>complete</state> </status> </action>
<action> <job href="/api/jobs/3dd9800f-a8c6-4f58-a3cf-dff190d2f06f" id="3dd9800f-a8c6-4f58-a3cf-dff190d2f06f"/> <status><state>complete</state> </status> </action>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Content ConflictThis conflict can be resolved with the
resolution_type = copy. If the version of the hook is incorrect in Red Hat Gluster Storage Console, the content is copied from a host by passing the host.name parameter. If the host.name parameter is empty, then the content is copied from Red Hat Gluster Storage Console to all host where content is differentcURL command:curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glusterhooks/59ecbacb-1ce3-43f7-82e4-55db8ed74f56/resolve -d "<action><resolution_type>COPY</resolution_type><host><name>host.name</name></host></action>"The API returns the following representation:Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Status ConflictThis conflict is resolved by either enabling or disabling a hook in a cluster.
Chapter 9. Hosts
Copy linkLink copied to clipboard!
The
hosts collection provides information about the hosts in a Red Hat Gluster Storage environment. An API user accesses this information through the rel="hosts" link obtained from the entry point URI (see Chapter 5, Entry Point).
The following table shows specific elements contained in a hosts resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
link rel="nics" | relationship | A link to the nics sub-collection for host network interfaces. | |
link rel="tags" | relationship | A link to the tags sub-collection for host tags. | |
link rel="permissions" | relationship | A link to the permissions sub-collection for host permissions. See Chapter 7, Common Features. | |
link rel="statistics" | relationship | A link to the statistics sub-collection for host statistics. |
|
address | string | The IP address or hostname of the host. |
|
status | See below | The host status. |
|
cluster id= | GUID | A reference to the cluster that includes this host. | |
port | integer | The listen port of the VDSM daemon running on this host. |
|
iscsi | complex | The SCSI initiator for the host. |
|
cpu | complex | Statistics for the host CPU. Includes sub-elements for the CPU's name, topology cores=, topology sockets= and speed. The topology cores= aggregates the total cores while the topology sockets= aggregates the total physical CPUs. |
|
version major= minor= | complex | The compatibility level of the host. |
|
root_password | string | The root password of this host, by convention only included in the client-provided host representation on creation. |
|
The
status contains one of the following enumerative values: down, error, initializing, installing, install_failed, maintenance, non_operational, non_responsive, pending_approval, preparing_for_maintenance, connecting, reboot, unassigned and up. These states are listed in host_states under capabilities.
Example 9.1. An XML representation of a host
Creation of a new host requires the
name, address and root_password elements. See Section 7.2.4, “Creating a Resource in a Collection” for more information.
Example 9.2. Creating a host
New host creation applies only to the addition of Red Hat Enterprise Linux hosts.
The
root_password element is only included in the client-provided initial representation and is not exposed in the representations returned from subsequent requests.
The
name and cluster elements are updatable post-creation. See Section 7.3.2, “Updating a Resource” for more information.
Example 9.3. Updating a host
Removal of a host requires a
DELETE request.
Example 9.4. Removing a host
DELETE /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3 HTTP/1.1 204 No Content
DELETE /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3
HTTP/1.1 204 No Content9.1. Network Interface Sub-Collection
Copy linkLink copied to clipboard!
The
nics sub-collection represents a host's physical network interfaces. Each host_nic element in the representation acts as a network interface and contains the following elements:
Note
The icons used in the properties column of this table are described in Table 7.1, “Element property icons”
| Element | Type | Description | Properties |
|---|---|---|---|
name | string | The name of the host network interface, e.g. eth0 |
[a]
|
link rel="statistics" | relationship | A link to the statistics sub-collection for a host's network interface statistics. |
|
link rel="master" | relationship | A reference to the master bonded interface, if this is a slave interface. |
|
host id= | GUID | A reference to the host. |
|
network id= | GUID | A reference to the network, if any, that the interface is attached. |
[b] |
mac address= | string | The MAC address of the interface. |
|
ip address= netmask= gateway= | complex | The IP level configuration of the interface. | |
boot_protocol | enumerated | The protocol for IP address assignment when the host is booting. A list of enumerated values is available in capabilities. | |
speed | integer | The network interface speed in bits per second. |
|
status | enumerated | The link status for the network interface. These states are listed in host_nic_states under capabilities. |
|
vlan id | integer | The VLAN which this interface represents. |
|
bonding | complex | A list of options and slave NICs for bonded interfaces. |
[c]
|
[a]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[b]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[c]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
| |||
Example 9.5. An XML representation of a network interface on a host
An API user creates only bonded interfaces (see Section 9.1.1, “Bonded Interfaces”). All other network interfaces contain updatable
network, ip and boot_protocol elements using a PUT request.
When adding a new network interface, the
name and network elements are required. Identify the network element with the id attribute or name element.
An API user modifies a network interface with a
PUT request.
An API user removes a network interface with a
DELETE request.
DELETE /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/nics/ e8f02fdf-3d7b-4135-86e1-1bf185570cd8 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/nics/
e8f02fdf-3d7b-4135-86e1-1bf185570cd8 HTTP/1.1
HTTP/1.1 204 No Content
9.1.1. Bonded Interfaces
Copy linkLink copied to clipboard!
A bonded interface is represented as a
host_nic resource containing a bonding element.
| Element | Type | Description | Properties |
|---|---|---|---|
options | complex | A list of option elements for a bonded interface. Each option contains property name and value attributes. |
[a]
|
slaves | complex | A list of slave host_nic id= elements for a bonded interface. |
[b]
|
[a]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
[b]
Only required when adding bonded interfaces. Other interfaces are read-only and cannot be added.
| |||
An API user creates a new bond when
POSTing to a host_nic with bonding options and slave interfaces. The name, network and bonded elements are required when creating a new bonded interface. Either the id or name elements identify the network and slave host_nics.
Example 9.6. Creating a bonded interface
Important
bond0, bond1, bond2, bond3 and bond4 are the only valid names for a bonded interface.
Like other resources, a
DELETE request to a bonded interface URI deletes it.
Important
Changes to bonded interface configuration must be explicitly committed. See Section 9.3.5, “Commit Network Configuration Action”.
9.1.2. Network Interface Statistics
Copy linkLink copied to clipboard!
Each host's network interface exposes a
statistics sub-collection for a host's network interface statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
host_nic id= | relationship | A relationship to the containing host_nic resource. |
The following table lists the statistic types for network interfaces on hosts.
|
Name
|
Description
|
|---|---|
data.current.rx |
The rate in bytes per second of data received.
|
data.current.tx |
The rate in bytes per second of data transmitted.
|
errors.total.rx |
Total errors from receiving data.
|
errors.total.tx |
Total errors from transmitting data.
|
Example 9.7. An XML representation of a host's network interface statistics sub-collection
Note
This
statistics sub-collection is read-only.
9.1.3. Attach Action
Copy linkLink copied to clipboard!
A host network interface is attached to a network, indicating the given network is accessible over the interface. Either the
id or name elements identify the network.
Example 9.8. Action to attach a host network interface to a network
Important
This networking configuration change must be explicitly committed. See Section 9.3.5, “Commit Network Configuration Action”.
9.1.4. Detach Action
Copy linkLink copied to clipboard!
Detach an interface from a network. Either the
id or name elements identify the network.
Example 9.9. Action to detach a host network interface to a network
Important
This networking configuration change must be explicitly committed. See Section 9.3.5, “Commit Network Configuration Action”.
9.2. Statistics Sub-Collection
Copy linkLink copied to clipboard!
Each host resource exposes a
statistics sub-collection for host-specific statistics. Each statistic contains the following elements:
| Element | Type | Description |
|---|---|---|
name | string | The unique identifier for the statistic entry. |
description | string | A plain text description of the statistic. |
unit | string | The unit or rate to measure the statistical values. |
type | One of GAUGE or COUNTER | The type of statistic measures. |
values type= | One of INTEGER or DECIMAL | The data type for the statistical values that follow. |
value | complex | A data set that contains datum. |
datum | see values type | An individual piece of data from a value. |
host id= | relationship | A relationship to the containing host resource. |
The following table lists the statistic types for hosts.
|
Name
|
Description
|
|---|---|
memory.total |
Total memory in bytes on the host.
|
memory.used |
Memory in bytes used on the host.
|
memory.free |
Memory in bytes free on the host.
|
memory.buffers |
I/O buffers in bytes.
|
memory.cached |
OS caches in bytes.
|
swap.total |
Total swap memory in bytes on the host.
|
swap.free |
Swap memory in bytes free on the host.
|
swap.used |
Swap memory in bytes used on the host.
|
swap.cached |
Swap memory in bytes also cached in host's memory.
|
ksm.cpu.current |
Percentage of CPU usage for Kernel SamePage Merging.
|
cpu.current.user |
Percentage of CPU usage for users.
|
cpu.current.system |
Percentage of CPU usage for system.
|
cpu.current.idle |
Percentage of idle CPU usage.
|
cpu.load.avg.5m |
CPU load average per five minutes.
|
Example 9.10. An XML representation of the host's statistics sub-collection
Note
A host's
statistics sub-collection is read-only.
9.3. Actions
Copy linkLink copied to clipboard!
The following sections describe the actions associated with
host resources.
The API contains a number of possible actions for hosts:
install, activate, fence, deactivate, approve, iscsilogin, iscsidiscover and commitnetconfig.
9.3.1. Install Action
Copy linkLink copied to clipboard!
Install VDSM and related software on the host. The host type defines additional parameters for the action.
- Red Hat Enterprise Linux host - This host type requires a
root_passwordelement that refers to the password for the host'srootuser.
Example 9.11. Action to install VDSM to a Red Hat Enterprise Linux host
9.3.2. Activate Action
Copy linkLink copied to clipboard!
Activate the host for use, such as creating bricks.
Example 9.12. Action to activate a host
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/activate HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/activate HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action/>9.3.3. Fence Action
Copy linkLink copied to clipboard!
An API user controls a host's power management device with the
fence action. The capabilities lists available fence_type options.
Example 9.13. Action to fence a host
9.3.4. Deactivate Action
Copy linkLink copied to clipboard!
Deactivate the host to perform maintenance tasks.
Example 9.14. Action to deactivate a host
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/deactivate HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/deactivate HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action/>9.3.5. Commit Network Configuration Action
Copy linkLink copied to clipboard!
An API user commits the network configuration to persist a host network interface attachment or detachment, or persist the creation and deletion of a bonded interface.
Example 9.15. Action to commit network configuration
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/commitnetconfig HTTP/1.1 Accept: application/xml Content-type: application/xml <action/>
POST /api/hosts/2ab5e1da-b726-4274-bbf7-0a42b16a0fc3/commitnetconfig HTTP/1.1
Accept: application/xml
Content-type: application/xml
<action/>Important
Networking configuration is only committed after the Red Hat Gluster Storage Console has established that host connectivity is not lost as a result of the configuration changes. If host connectivity is lost, the host requires a reboot and automatically reverts to the previous networking configuration.
Chapter 10. Volumes
Copy linkLink copied to clipboard!
The
volumes collection provides information about volumes in a Red Hat Gluster Storage environment.
The following table shows specific elements contained in a volume resource representation.
| Element | Type | Description | Properties |
|---|---|---|---|
volumeName | relationship | Name of the volume to be created. |
|
volumeType | relationship | DISTRIBUTE, REPLICATE, DISTRIBUTED_REPLICATE. |
|
replicaCount | complex | replicaCount is mandatory if volumeType is REPLICATE or DISTRIBUTED_REPLICATE |
|
bricks | complex | list of bricks of a volume. You can add/remove bricks to/from a volume. |
|
| options | complex | list of options of the volume |
Example 10.1. An XML representation of a volume
10.1. Creating a Volume
Copy linkLink copied to clipboard!
Creation of a new volume requires the
volumeName, volumeType,transportType and brick elements. The API creates a new volume with a POST request to the URI containing a representation of the new volume
.
Example 10.2. Creating a volume
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes -d "<gluster_volume><name>data</name><volume_type>DISTRIBUTE</volume_type><bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick1</brick_dir></brick><brick><server_id>de173e6a-fb05-11e1-a2fc-0050568c4349</server_id><brick_dir>/export/data/brick2</brick_dir></brick></bricks></gluster_volume>"
The API returns the following representation of the newly created volume resource:
10.2. Listing Volumes
Copy linkLink copied to clipboard!
A listing of volumes in a cluster is obtained by issuing a
GET request on the cluster URI.
Example 10.3. Listing Volumes
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes HTTP/1.1 Accept: application/xml
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes HTTP/1.1
Accept: application/xml
cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes
The API returns the following representation:
10.3. Managing Volumes
Copy linkLink copied to clipboard!
The API starts, stops, re-balances, and set volume option of your volume in your cluster by issuing a
POST request to the URI.
10.3.1. Starting a Volume
Copy linkLink copied to clipboard!
The API starts a volume with a
POST request to the volumes URI.
Example 10.4. Starting a Volume
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/start -d "<action/>"
The API returns the following representation:
<action>
<status>
<state>complete</state>
</status>
</action>
<action>
<status>
<state>complete</state>
</status>
</action>10.3.2. Stopping a Volume
Copy linkLink copied to clipboard!
Stopping of a volume requires a
POST request.
Example 10.5. Stopping a Volume
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/stop -d "<action/>"
The API returns the following representation:
<action>
<status>
<state>complete</state>
</status>
</action>
<action>
<status>
<state>complete</state>
</status>
</action>10.3.3. Removing a Volume
Copy linkLink copied to clipboard!
Removal of a volume requires a
DELETE request.
Example 10.6. Removing a Volume
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27 HTTP/1.1 HTTP/1.1 204 No Content
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27 HTTP/1.1
HTTP/1.1 204 No Content
cURL command:
curl -X DELETE -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554"
10.3.4. Setting a Volume Option
Copy linkLink copied to clipboard!
The API sets a volume option with a
POST request to the volume URI.
Example 10.7. Setting a Volume Option
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS]https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/setOption -d "<action><option name="key" value="value" /></action>"
10.3.5. Resetting a Volume Option
Copy linkLink copied to clipboard!
Resetting volume options requires a
POST request.
Example 10.8. Resetting a Volume Option
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532- 9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/resetOption -d "<action><option name="key" value="value"/><force>true</force></action>"
The API returns the following representation:
<action>
<status>
<state>complete</state>
</status>
</action>
<action>
<status>
<state>complete</state>
</status>
</action>10.3.6. Resetting all Volume Options
Copy linkLink copied to clipboard!
You can reset all volume options with a single
POST request.
POST /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27/resetAllOptions HTTP/1.1 Accept: application/xml Content-type: application/xml
POST /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27/resetAllOptions HTTP/1.1
Accept: application/xml
Content-type: application/xml
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/resetAllOptions -d "<action/>"
The API returns the following representation:
<action>
<status>
<state>complete</state>
</status>
</action>
<action>
<status>
<state>complete</state>
</status>
</action>10.3.7. Rebalancing Volume
Copy linkLink copied to clipboard!
You can rebalance the volume by issuing a
POST request. The status of rebalance operation can be monitored by job id returned by this API.
POST /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27/rebalance -d "<action/>" HTTP/1.1 Accept: application/xml Content-type: application/xml
POST /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/ceb59bbb-173d-4a5a-9b92-0189a17eae27/rebalance -d "<action/>"
HTTP/1.1
Accept: application/xml
Content-type: application/xml
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glustervolumes/380474af-360b-48fa-a210-9c08b913ffa3/rebalance -d "<action/>"
The API returns the following representation:
The status of rebalance is monitored using the job ID and its corresponding step ID by looking at the re-balancing step.
/api/jobs/<job_id>/steps /api/jobs/<job_id>/steps/<step_id> --for step type rebalance /api/jobs/<job_id>/steps/<step_id>/statistics -- for detail information of rebalance status per node
/api/jobs/<job_id>/steps
/api/jobs/<job_id>/steps/<step_id> --for step type rebalance
/api/jobs/<job_id>/steps/<step_id>/statistics -- for detail information of rebalance status per nodeExample 10.9. Monitoring Rebalance
You can stop a rebalance operation by issuing a POST request.
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC-Host]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glustervolumes/380474af-360b-48fa-a210-9c08b913ffa3/stoprebalance -d "<action/>"
10.4. Managing Bricks
Copy linkLink copied to clipboard!
This section describes the brick operations of the Red Hat Gluster Storage Console API such as adding and removing them from a volume.
10.4.1. Listing of Bricks
Copy linkLink copied to clipboard!
A listing of bricks in a volume is obtained by issuing a
GET request on the volume URI.
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks HTTP/1.1 Accept: application/xml
GET /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks HTTP/1.1
Accept: application/xml
The API returns the following representation:
10.4.2. Adding a Brick
Copy linkLink copied to clipboard!
The API adds a new brick to a volume in your cluster with a
POST request to its URI.
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks -d "<bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick3</brick_dir></brick></bricks>"
The API returns the following representation:
10.4.3. Removing a Brick
Copy linkLink copied to clipboard!
The API removes a brick(s) from a volume with a
DELETE request sent to its URI. Before removing a brick, data must be migrated to ensure there is no data loss with a POST request sent to its URI.
POST /api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glustervolumes/380474af-360b-48fa-a210-9c08b913ffa3/bricks/migrate -d "<action><bricks><brick><name>host:brick_dir</name></brick></bricks></action>"
POST /api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glustervolumes/380474af-360b-48fa-a210-9c08b913ffa3/bricks/migrate -d "<action><bricks><brick><name>host:brick_dir</name></brick></bricks></action>"
cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" [USER:PASS] https://[RHGSC HOST]/api/clusters/44571c63-a110-4fba-9a8c-7b30446ba8bf/glustervolumes/380474af-360b-48fa-a210-9c08b913ffa3/bricks/migrate -d "<action><bricks><brick><name>host:brick_dir</name></brick></bricks></action>"
The API returns the following representation:
The status of remove brick (with data migration) is monitored using the job ID and its corresponding step ID by looking at the remove brick step.
/api/jobs/<job_id>/steps /api/jobs/<job_id>/steps/<step_id> --for step type remove brick /api/jobs/<job_id>/steps/<step_id>/statistics -- for detail information of remove brick
/api/jobs/<job_id>/steps
/api/jobs/<job_id>/steps/<step_id> --for step type remove brick
/api/jobs/<job_id>/steps/<step_id>/statistics -- for detail information of remove brick
Now, you can delete the migrated bricks by issuing a
DELETE request for a brick(s).
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks
DELETE /api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks
cURL command:
curl -X DELETE -u [USER:PASS] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes/83101900-2f12-4855-838e-36b8a9e04554/bricks -d "<bricks><brick><name>host:brick_dir</brick></bricks>"
Chapter 11. Groups
Copy linkLink copied to clipboard!
The
groups collection contains imported groups from directory services.
A
group resource contains a set of elements.
| Element | Type | Description |
|---|---|---|
link rel="tags" | relationship | A link to the tags sub-collection for tags attached to this group. |
link rel="permissions" | relationship | A link to the permissions sub-collection for permissions attached to this group. |
link rel="roles" | relationship | A link to the roles sub-collection for roles attached to this group. |
Example 11.1. An XML representation of a group resource
Chapter 12. Roles
Copy linkLink copied to clipboard!
The
rel="roles" link obtained from the entry point URI (see Chapter 5, Entry Point) provides access to a static set of system roles.
Each individual
role element contains the following:
| Element | Type | Description | Properties |
|---|---|---|---|
link="permits" | relationship | A link to the permits sub-collection for role permits. |
|
mutable | Boolean: true or false | Defines the ability to update or delete the role. Roles with mutable set to false are roles built into the Red Hat Gluster Storage Console environment. |
|
administrative | Boolean: true or false | Defines the role as administrative-only. |
Example 12.1. An XML representation of the roles collection
Creation of a role requires values for
name, administrative and a list of initial permits. See Section 7.2.4, “Creating a Resource in a Collection” for more information.
Example 12.2. Creating a role
The
name, description and administrative elements are updatable post-creation. See Section 7.3.2, “Updating a Resource” for more information.
Example 12.3. Updating a role
Removal of a role requires a
DELETE request.
Example 12.4. Removing a role
DELETE /api/roles/8de42ad7-f307-408b-80e8-9d28b85adfd7 HTTP/1.1 204 No Content
DELETE /api/roles/8de42ad7-f307-408b-80e8-9d28b85adfd7
HTTP/1.1 204 No Content12.1. Permits Sub-Collection
Copy linkLink copied to clipboard!
Each role contains a set of allowable actions, or
permits, which the API lists in capabilities.
A role's
permits are listed as a sub-collection:
Example 12.5. Listing a role's permits
Assign a
permit to a role with a POST request to the permits sub-collection. Use either an id attribute or a name element to specify the permit to assign.
Example 12.6. Assign a permit to a role
Remove a
permit from a role with a DELETE request to the permit resource.
Example 12.7. Remove a permit from a role
DELETE /api/roles/b67dfbe2-0dbc-41e4-86d3-a2fbef02cfa9/permits/ HTTP/1.1 204 No Content
DELETE /api/roles/b67dfbe2-0dbc-41e4-86d3-a2fbef02cfa9/permits/
HTTP/1.1 204 No ContentChapter 13. Users
Copy linkLink copied to clipboard!
Users are exposed in a top-level collection and are referenced with the
rel="users" link. Individual user elements contain the following:
| Element | Type | Description | Properties |
|---|---|---|---|
user_name | string | The user principal name (UPN). The UPN is used as a more convenient identifier when adding a new user. |
|
link rel="tags" | relationship | A link to the tags sub-collection for user resources. | |
link rel="roles" | relationship | A link to the roles sub-collection for user resources. | |
name | string | A free-text name for the user. |
|
domain | string | The containing directory service domain. |
|
groups | complex | A list of directory service groups for this user. |
|
Example 13.1. An XML representation of a user resource
The API adds an existing directory service user to the Red Hat Gluster Storage Console database with a
POST request to the users collection. The client-provided new user representation includes an embedded roles list with at least one initial role to assign to the user. For example, the following request assigns two initial roles to the user joe@domain.example.com:
Example 13.2. Adding a user from directory service and assigning two roles
The new user is identified either by Red Hat Gluster Storage Console user ID or via the directory service user principal name (UPN). The user ID format reported from the directory service domain might be different to the expected Red Hat Gluster Storage Console format, such as in LDIF, [3]the ID has the opposite byte order and is base-64 encoded. Hence it is usually more convenient to refer to the new user by UPN.
Note
The user exists in the directory service domain before it is added to the Red Hat Gluster Storage Console database. An API user has the option to query this domain through the
domains collection prior to creation of the user.
Roles are identified either by name or ID. The example above shows both approaches.
Further roles are attached or detached with
POST or DELETE requests to the roles sub-collection of an individual user. The example below illustrates how the API adds the RHSCUser role to the role assignments for a particular user.
Note
The embedded user roles list of the
user element is only used for the initial creation. All interactions post-creation with the user's role assignments go through the roles sub-collection.
Example 13.3. Adding roles to a user
Note
Users are not updated with the
PUT verb. The only changes allowed post-creation are in the user's role assignments.
The API removes users from the Red Hat Gluster Storage Console database with a
DELETE request on the users collection. The directory service domain remains unchanged after such a deletion.
Chapter 14. Events
Copy linkLink copied to clipboard!
The
rel="events" link obtained from the entry point URI accesses the events collection and lists system events from Red Hat Gluster Storage Console.
| Element | Type | Description |
|---|---|---|
description | string | A description of the system event. |
code | integer | The integer event code. |
severity | One of normal, warning, error or alert | The level of severity for the event. |
time | xsd:dateTime format: YYYY-MM-DDThh:mm:ss | The timestamp indicating when the event happened. |
user id | GUID | The identification code for the user who triggered the event. |
Example 14.1. An XML representation of the events collection
In addition to
user, an event representation also contains a set of XML element relationships to resources relevant to the event.
Example 14.2. An XML representation of a volume start event
This example provides an XML element representation of starting a volume on the
Default cluster .
Note
The
events collection is read-only.
14.1. Searching Events
Copy linkLink copied to clipboard!
The
events collection provides search queries similar to other resource collections (see Section 7.2.3, “Searching Collections with Queries”). An additional feature when searching the events collection is the ability to search from a certain event. This queries all of events since a specified event.
Querying from an event requires an additional
from argument added to the URI after the query. This from argument references an event id code.
Example 14.3. Searching from an event
GET /api/events?search=type%3D30&from=1012 HTTP/1.1 Accept: application/xml
GET /api/events?search=type%3D30&from=1012 HTTP/1.1
Accept: application/xml
This displays all events with
type set to 30 since id="1012"
14.2. Paginating Events
Copy linkLink copied to clipboard!
A storage environment generates a large amount of events after a period of time. However, the API only displays a default number of events for one search query. To display more than the default, the API separates results into pages with the
page command in a search query.
The following search query tells the API to paginate results using a
page value in combination with the sortby clause:
sortby time asc page 1
The
sortby clause defines the base element to order of the results and whether the results are ascending or descending. For search queries of events, set the base element to time and the order to ascending (asc) so the API displays all events from the creation of your storage environment.
The
page condition defines the page number. One page equals the default number of events to list. Pagination begins at page 1. To view more pages, increase the page value:
sortby time asc page 2
sortby time asc page 3
sortby time asc page 4
Example 14.4. Paginating events
This example paginates
event resources. The URL-encoded request is:
GET /api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1 Accept: application/xml
GET /api/events?search=sortby%20time%20asc%20page%201 HTTP/1.1
Accept: application/xml
Increase the
page value to view the next page of results.
GET /api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1 Accept: application/xml
GET /api/events?search=sortby%20time%20asc%20page%202 HTTP/1.1
Accept: application/xml
Use an additional
from argument to set the starting id.
GET /api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1 Accept: application/xml
GET /api/events?search=sortby%20time%20asc%20page%202&from=30 HTTP/1.1
Accept: application/xml
Part III. Python Software Development Kit
Copy linkLink copied to clipboard!
Chapter 15. Software Development Kit Overview
Copy linkLink copied to clipboard!
15.1. Introduction to the Red Hat Gluster Storage Software Development Kit
Copy linkLink copied to clipboard!
The software development kit provides programming language specific libraries for interacting with the REST API provided by Red Hat Gluster Storage Console. These libraries include classes to represent resources made available by the API and methods for interacting with those classes. This allows you to concentrate on writing code specific to what you are trying to achieve rather than hand crafting appropriately formatted HTTP requests and manually orchestrating their delivery.
The software development kit includes collections and methods mapping directly to all aspects of the REST API. As a result, this software development kit documentation focuses on providing examples written in the supported programming language. For a complete reference of all supported collections, resources, actions, and attributes, refer to the REST API material.
15.2. Software Development Kit Prerequisites
Copy linkLink copied to clipboard!
To install the software development kit you must have:
- A system with Red Hat Enterprise Linux 6, or later, installed. Both the Server and Workstation variants are supported.
- A subscription to Red Hat Gluster Storage entitlements.
When you install the
rhsc-sdk package, the Python 2.6 interpreter will be installed if it does not already exist on the system.
Important
To run scripts that use the libraries provided by the software development kit, the
rhsc-sdk package must be installed. As a result, the prerequisites listed here must be met both on the systems being used to develop scripts using the software development kit, and on those systems on which the scripts are intended to run.
15.3. Installing the Software Development Kit
Copy linkLink copied to clipboard!
Summary
The software development kit is provided by the rhsc-sdk package. This package includes all of the Python bindings for the Red Hat Gluster Storage Console API. To begin using the software development kit, you must install the rhsc-sdk package on the system that you wish to use for script development. The instructions that appear here are intended for use on a system running Red Hat Enterprise Linux 6 or later.
Procedure 15.1. Installing the Python SDK
- Ensure that your system has the required entitlements:
- When using certificate-based Red Hat Network, you must subscribe to the
Red Hat Gluster Storageentitlement to install therhsc-sdkpackage. - When using Red Hat Network classic, you must subscribe to the
Red Hat Gluster Storage Consolechannel to install therhsc-sdkpackage. Refer to the Red Hat Gluster Storage Console Installation Guide for specific channel names current to your system.
- Ensure that you are logged in as the
rootuser. - Install the
rhsc-sdkpackage using theyumcommand.yum install rhsc-sdk
# yum install rhsc-sdkCopy to Clipboard Copied! Toggle word wrap Toggle overflow ResultTherhsc-sdkpackage is now installed. TheovirtsdkPython library is now available for use on the local system.
Chapter 16. Using the Software Development Kit
Copy linkLink copied to clipboard!
16.1. Connecting to the API Using Python
Copy linkLink copied to clipboard!
To connect to the REST API using Python, you must create an instance of the
API class from the ovirtsdk.api module. To be able to do this, it is necessary to first import the class at the start of the script:
from ovirtsdk.api import API
from ovirtsdk.api import API
The constuctor of the
API class takes a number of arguments. Supported arguments are:
-
url - Specifies the URL of the Manager to connect to, including the
/apipath. This parameter is mandatory. -
username - Specifies the user name to use when connecting, in the User Principle Name (UPN) format. This parameter is mandatory.
-
password - Specifies the password for the user provided by the
usernameparameter. This parameter is mandatory. -
key_file - Specifies a PEM-formatted key file containing the private key associated with the certificate specified by
cert_file. This parameter is optional. -
cert_file - Specifies a PEM-formatted client certificate to be used for establishing the identity of the client on the server. This parameter is optional.
-
ca_file - Specifies the certificate file of the certificate authority for the server. This parameter is mandatory unless the
insecureparameter is set toTrue. -
port - Specifies the port to use when connecting, where it has not been provided as component of the
urlparameter. This parameter is optional. -
timeout - Specifies the amount of time in seconds that is allowed to pass before a request is considered to be timed out. This parameter is optional.
-
persistent_auth - Specifies whether persistent authentication is enabled for this connection. Valid values are
TrueandFalse. This parameter is optional and defaults toFalse. -
insecure - Allows a connection via SSL without a certificate authority. Valid values are
TrueandFalse, and the default isFalse. If theinsecureparameter is set toFalsethen the ca_file must be supplied to secure the connection.This option should be used with caution, as it may allow man-in-the-middle (MITM) attackers to spoof the identity of the server. -
filter - Specifies whether or not the user permission based filter is on or off. Valid values are
TrueandFalse, and the default isFalse. If thefilterparameter is set toFalse, the authentication credentials provided must be those of an administrative user. If thefilterparameter is set toTrue, any user can be used and the Console will filter the actions available to the user based on their permissions. -
debug - Specifies whether debug mode is enabled for this connection. Valid values are
TrueandFalse. This parameter is optional.
You can communicate with multiple Red Hat Gluster Storage Console by creating and manipulating separate instances of the
ovirtsdk.API Python class.
For a full list of methods supported by the
API class, refer to the PyDoc output for the ovirtsdk.api package.
16.2. Listing the Public Attributes of a Resource
Copy linkLink copied to clipboard!
The
dir() method returns a list of public variables, modules, and functions of a resource. The private attribute names start with an underscore character. To get a list of all the public attributes of a resource, use the following code snippet:
for name in (e for e in dir(api) if not e.startswith('_')):
print name
for name in (e for e in dir(api) if not e.startswith('_')):
print name
Figure 16.1. Object Hierarchy
Figure 16.2. Relationship between a brick and a host
Figure 16.3. Relationship between a host and a cluster
16.3. Resources and Collections
Copy linkLink copied to clipboard!
The RESTful nature of the API is evident throughout the Python bindings for both philosophical and practical reasons. All RESTful APIs have two key concepts:
- Collections
- A collection is a set of resources of the same type. The API provides both top-level collections and sub-collections. An example of a top-level collection is the volume collection which contains all bricks in the environment. An example of a sub-collection is the
volume.brickscollection which contains resources for CPUs attached to a cluster.The interface for interacting with collections provides methods for adding resources (add), getting resources (get), and listing resources (list). - Resources
- A resource in a RESTful API is an object with a fixed interface that also contains a set of attributes that are relevant to the specific type of resource being represented. The interface for interacting with resources provides methods for updating (
update) and deleting (delete) resources. Additionally, some resources support actions specific to the resource type. One example of this is theapprovemethod ofHostresources.
16.4. Retrieving Resources from a Collection
Copy linkLink copied to clipboard!
Resources are retrieved from a collection using the
get and list methods.
-
get - Retrieves a single resource from the collection. The item to retrieve is determined based on the name provided as an argument. The
getmethod takes these arguments:name- The name of the resource to retrieve from the collection.id- The globally unique identifier (GUID) of the resource to retrieve from the collection.
-
list - Retrieves any number of resources from the collection. The items to retrieve are determined based on the criteria provided. The
listmethod takes these arguments:**kwargs- A dictionary of additional arguments allowing keyword-based filtering.query- A query written in the same format as that used for searches executed using the Red Hat Gluster Storage Console.max- The maximum number of resources to retrieve.case_sensitive- Whether or not search terms are to be treated as case sensitive (TrueorFalse, the default isTrue).
Example 16.1. Retrieving a List of Resources in a Collection Matching a Keyword Based Filter
The example below lists all the volumes that have the volume type set to distribute.
16.4.1. Retrieving a Specific Resource from a Collection
Copy linkLink copied to clipboard!
In this example, a specific resource is retrieved from a collection using the
get method.
To retrieve the Default cluster from the clusters collection using the
name parameter of the get method:
cl = api.clusters.get("Default")
cl = api.clusters.get("Default")
This syntax is equivalent to:
cl = api.clusters.get(name="Default")
cl = api.clusters.get(name="Default")16.4.2. Retrieving a List of Resources from a Collection
Copy linkLink copied to clipboard!
In these examples, a list of resources is retrieved from a collection using the
list method.
In the following example, a list of all resources is retrieved from the clusters collection. The query parameter of the list method allows the use of engine-based queries. In this way the SDK supports the use of queries in the same format as those executed in the Administration and User Portals. The query parameter is also the mechanism for providing pagination arguments while iterating through the collection.
Example 16.2. Listing All Clusters
Executing this code on a Python engine will show a list of clusters in the Red Hat Gluster Storage Console:
In this example, the
get_name() method provides the name of the cluster and the get_gluster_service() returns true or false based on glusterFS support in the cluster:
Example 16.3. Listing All Hosts
In this example,
api.hosts.list() provides a dictionary list that contains the host name and the host ID.
Executing this code on a Python engine will show a list of hosts in the Red Hat Gluster Storage Console:
h1 (51b29199-3a7f-49e4-b0d5-92afdeea1f15) h2 (4e8c3642-e654-456c-9dff-a240c8a43b1f) host1 (14e3823d-d557-4635-bd9f-0c6157ab7f07)
h1 (51b29199-3a7f-49e4-b0d5-92afdeea1f15)
h2 (4e8c3642-e654-456c-9dff-a240c8a43b1f)
host1 (14e3823d-d557-4635-bd9f-0c6157ab7f07)Important
The
list method of a collection is restricted to returning only as many elements as allowed by the SearchResultsLimit configuration key in the Red Hat Gluster Storage Console. To ensure that all records in a the list are returned, it is recommended to paginate through the results as illustrated in this example. Alternatively, set the max parameter of the list method to the maximum number of records that you wish to retrieve.
Example 16.4. Listing All Red Hat Gluster Storage Volumes
Executing this code on a Python engine will show a list of Red Hat Gluster Storage Volumes in the Red Hat Gluster Storage Console:
VolumeName: vol1
VolumeName: vol1Example 16.5. Listing All Users
Including this code snippet in the program will return a list of Red Hat Gluster Storage Console users:
User name: admin (User ID: fdfc627c-d875-11e0-90f0-83df133b58cc)
User name: admin (User ID: fdfc627c-d875-11e0-90f0-83df133b58cc)Example 16.6. Listing All Roles
The
getUsers() function lists all the roles in the Red Hat Gluster Storage Console.
Including this code snippet in the program will return a list of roles defined in the Red Hat Gluster Storage Console:
for i in api.roles.list(): print i.name
for i in api.roles.list():
print i.nameExample 16.7. Listing All Network Details
The
nic.get_status().get_state() returns the network status as either up or down.
Executing this code on a Python engine will show the network details:
NIC Name: eth0 IPAddress: 10.70.37.194 MAC Address: 00:1a:4a:46:24:9e netStatus: up
NIC Name: eth0
IPAddress: 10.70.37.194
MAC Address: 00:1a:4a:46:24:9e
netStatus: up
You can also set values for a few configurations like IP, netmask, gateway bonding, enabling or disabling the bridge using the following methods:
nic.get_ip().set_address()nic.get_ip()set_netmask()nic.get_ip().set_gateway()nic.set_bridged()
16.5. Adding a Resource to a Collection
Copy linkLink copied to clipboard!
The
add method adds a resource to a collection. The resource to be added is created based on the parameters provided. Parameters are provided to the add method using an instance of an object from the ovirtsdk.xml.params module. Selecting the specific class from the module to use varies based on the type of resource being created.
Example 16.8. Adding a Resource to a Collection
In this example, a brick is added to the
GlusterBricks collection.
While the brick created in this example is not yet ready to run, it illustrates the process for creating any Red Hat Gluster Storage resource:
Procedure 16.1. Creating a Red Hat Gluster Storage Resource
- Create an instance of the parameter object for the type of resource being created.
- Identify the collection to which the resource will be added.
- Call the
addmethod of the collection passing the parameter object as a parameter.
16.6. Updating a Resource in a Collection
Copy linkLink copied to clipboard!
To update a resource, you must retrieve it from the collection it resides in, modify the desired parameters, and then call the
update method for the resource to save the changes. Parameter modification is performed by using the set_* methods on the retrieved resource:
Example 16.9. Updating a Network Address
def setHostIp(hostName, hostIP):
host = API.hosts.get(hostName)
host.set_address(hostIP)
host.update()
def setHostIp(hostName, hostIP):
host = API.hosts.get(hostName)
host.set_address(hostIP)
host.update()16.7. Removing a Resource from a Collection
Copy linkLink copied to clipboard!
To remove a resource, you must retrieve it from the collection that contains it and call the
delete method on the resource.
Example 16.10. Removing a Resource from a Collection
Deleting a cluster named DemoCluster from the clusters collection:
cl = api.clusters.get("DemoCluster")
cl.delete()
cl = api.clusters.get("DemoCluster")
cl.delete()16.8. Handling Errors
Copy linkLink copied to clipboard!
Where errors are encountered, the Software Development Kit uses exceptions to highlight them. The Software Development Kit defines exception types in addition to those defined by the Python interpreter itself. These exceptions are located in the
ovirtsdk.infrastructure.errors module:
- ConnectionError
- Raised when a transport layer error has occurred.
- DisconnectedError
- Raised when attempting to use SDK after it was explicitly disconnected.
- ImmutableError
- Raised when initiating SDK while an SDK instance already exists under the same domain. Applicable to SDK versions before 3.2.
- NoCertificatesError
- Raised when no CA certificate is provided and
insecureisFalse. - UnsecuredConnectionAttemptError
- Raised when HTTP protocol is used while the server is running HTTPS.
- MissingParametersError
- Raised when using the
get()method without providingidorname.
These exceptions can be caught and handled like any other Python exception:
Example 16.11. ConnectionError Exception
Chapter 17. Python Reference Documentation
Copy linkLink copied to clipboard!
17.1. Python Reference Documentation
Copy linkLink copied to clipboard!
Documentation generated using pydoc is available for these modules provided by the rhsc-sdk package:
ovirtsdk.apiovirtsdk.infrastructure.brokers
If instead you wish to view the
pydoc generated documentation on your local machine provide the name of the module you are interested in as an argument to the pydoc command:
pydoc MODULE
$ pydoc MODULEAppendix A. SDK Examples
Copy linkLink copied to clipboard!
A.1. Common Functions and Wrappers
Copy linkLink copied to clipboard!
Header
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
disconnect
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
getApi
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
waitForState
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
newState
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
objectDescr
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
A.2. Python SDK Example: Hosts
Copy linkLink copied to clipboard!
createHost
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
waitForTasks
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
removeHost
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
activeDeactivateHost
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
checkHostStatus
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
configureHostNetwork
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
waitForHostUpState
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
A.3. Python SDK Example: Cluster
Copy linkLink copied to clipboard!
createCluster
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
Example A.1. Building a cluster object
You can build a cluster object by passing the required parameters to the
api.clusters.add() function.
api.clusters.add(params.Cluster(name="mytest.cluster.3", cpu=params.CPU(id="Intel Nehalem Family"), data_center=dc, virt_service=False, gluster_service=True))
api.clusters.add(params.Cluster(name="mytest.cluster.3", cpu=params.CPU(id="Intel Nehalem Family"),
data_center=dc, virt_service=False, gluster_service=True))
removeCluster
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
A.4. Python SDK Example: Volumes
Copy linkLink copied to clipboard!
Create Volume
When a volume is created, the volume object needs a Red Hat Gluster Storage volume name, volume type and the bricks to be associated with the volume. Before creating a volume, you need to build a corresponding cluster object and associate that cluster with brick objects.
You can retrieve the server ID using the
api.host collection.
glusterVolume Delete
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
glusterVolumeStart
To start a volume, you need to pass the cluster name with which the Red Hat Gluster Storage volume is associated and the corresponding volume name to the
glusterVolumeStart() function.
glusterVolumeStop
To stop a volume, you need to pass the cluster name with which the Red Hat Gluster Storage volume is associated and the corresponding volume name to the
glusterVolumeStart() function.
Rebalance operations: startRebalance, stopRebalance, and rebalanceStatus
To rebalance data among the servers, you need to pass the cluster name and the volume name to the
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
startRebalance and stopRebalance functions and the jobID to the rebalanceStatus function.
A.5. Python SDK Example: Bricks
Copy linkLink copied to clipboard!
add_Brick
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
remove_Brick
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
Remove brick operations:
startRemoveBrick and removeBrickStatus
You can start a remove brick operation and query the brick status using the code snippet below:
Note
Commit is not an action that can be performed on a brick. Commit happens as part of the delete action. If a remove brick action is in finished state, it commits the changes else it perform a force delete operation.
Important
The code snippet above forcefully remove the brick without migrating the data on the brick.
A.6. Python SDK Example: Permissions
Copy linkLink copied to clipboard!
getRoles
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def getRoles():
""" Return list of all roles """
return [role.get_name() for role in API.roles.list()]
def getRoles():
""" Return list of all roles """
return [role.get_name() for role in API.roles.list()]
getRolePermissions
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def getRolePermissions(roleName):
""" Return permissions of role """
role = API.roles.get(roleName)
return [perm.get_name() for perm in role.get_permits().list()]
def getRolePermissions(roleName):
""" Return permissions of role """
role = API.roles.get(roleName)
return [perm.get_name() for perm in role.get_permits().list()]
getSuperUserPermissions
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def getSuperUserPermissions():
""" Return SuperUser permissions(all possible permissions) """
return getRolePermissions('SuperUser')
def getSuperUserPermissions():
""" Return SuperUser permissions(all possible permissions) """
return getRolePermissions('SuperUser')
addRoleToUser
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
removeAllRolesFromUser
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
removeRoleFromUser
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
givePermissionsToGroup
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
givePermissionToObject
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
givePermissionToCluster
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def removeAllPermissionFromCluster(clusterName):
cluster = getObjectByName(API.clusters, clusterName)
removeAllPermissionFromObject(cluster)
def removeAllPermissionFromCluster(clusterName):
cluster = getObjectByName(API.clusters, clusterName)
removeAllPermissionFromObject(cluster)
removeAllPermissionFromObject
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
removeAllPermissionFromCluster
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def removeAllPermissionFromCluster(clusterName):
cluster = getObjectByName(API.clusters, clusterName)
removeAllPermissionFromObject(cluster)
def removeAllPermissionFromCluster(clusterName):
cluster = getObjectByName(API.clusters, clusterName)
removeAllPermissionFromObject(cluster)A.7. Python SDK Example: Users
Copy linkLink copied to clipboard!
getFilterHeader
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def getFilterHeader():
""" Has user admin role or user role? """
return contextmanager.get('filter')
def getFilterHeader():
""" Has user admin role or user role? """
return contextmanager.get('filter')
loginAsUser
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
loginAsAdmin
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
def loginAsAdmin():
loginAsUser(config.OVIRT_USERNAME,
config.OVIRT_DOMAIN,
config.OVIRT_PASSWORD,
filter_=False)
def loginAsAdmin():
loginAsUser(config.OVIRT_USERNAME,
config.OVIRT_DOMAIN,
config.OVIRT_PASSWORD,
filter_=False)
editObject
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
hasUserPermissions
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
hasPermissions
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
A.8. Python SDK Example: Hooks
Copy linkLink copied to clipboard!
Hook operations: getGlusterHook, enableHook, disableHook, resolveHook,glusterHookDetails, and glusterHookList
Note
The status of enable hook, disable hook, and resolve hook can be retrieved using
get_status().state. And it will raise an ovirtsdk.infrastructure.errors.RequestError when there is a failure.
Appendix B. API Usage with cURL
Copy linkLink copied to clipboard!
This appendix provides instructions on adapting REST requests for use with cURL. cURL is a command line tool for transferring data across various protocols, including HTTP, and supports multiple platforms such as Linux, Windows, Mac OS and Solaris. Most Linux distributions include cURL as a package.
Installing cURL
A Red Hat Enterprise Linux user installs cURL with the following terminal command:
yum install curl
For other platforms, seek installation instructions on the cURL website (http://curl.haxx.se/).
Using cURL
cURL uses a command line interface to send requests to a HTTP server. Integrating a request requires the following command syntax:
Usage: curl [options]uri
Usage: curl [options]uri
The
uri refers to target HTTP address to send the request. This is a location on your Red Hat Gluster Storage Console host within the API entry point path (/api).
cURL options
- -X COMMAND, --request COMMAND
- The request command to use. In the context of the REST API, use
GET,POST,PUTorDELETE.Example:-X GET - -H LINE, --header LINE
- HTTP header to include with the request. Use multiple header options if more than one header is required.Example:
-H "Accept: application/xml" -H "Content-Type: application/xml" - -u USERNAME:PASSWORD, --user USERNAME:PASSWORD
- The username and password of the Red Hat Gluster Storage Console user. This attribute acts as a convenient replacement for the
Authorization:header.Example:-u admin@internal:p@55w0rd! - --cacert CERTIFICATE
- The location of the certificate file for SSL communication to the REST API. The certificate file is saved locally on the client machine. Use the
-kattribute to bypass SSL. See Chapter 2, Authentication and Security for more information on obtaining a certificate.Example:--cacert ~/Certificates/rhsc.cer - -d BODY, --data BODY
- The body to send for requests. Use with
POST,PUTandDELETErequests. Ensure to specify theContent-Type: application/xmlheader if a body exists in the request.Example:-d "<bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick3</brick_dir></brick></bricks>"
Examples
The following examples show how to adapt REST requests to cURL command syntax:
Example B.1. GET request
The following
GET request lists the clusters in the cluster collection. Note that a GET request does not contain a body.
GET /api/clusters HTTP/1.1 Accept: application/xml
GET /api/clusters HTTP/1.1
Accept: application/xml
Adapt the method (
GET), header (Accept: application/xml) and URI (https://[RHGSC Host]/api/clusters) into the following cURL command:
curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/clusters
$ curl -X GET -H "Accept: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/clusters
An XML representation of the
clusters collection displays.
Example B.2. POST request
The following
POST request creates a volume in the server collection. Note that a POST request requires a body.
Adapt the method (
POST), headers (Accept: application/xml and Content-type: application/xml), URI (https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes) and request body into the following cURL command:
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes -d "<gluster_volume><name>data</name><volume_type>DISTRIBUTE</volume_type><bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick1</brick_dir></brick><brick><server_id>de173e6a-fb05-11e1-a2fc-0050568c4349</server_id><brick_dir>/export/data/brick2</brick_dir></brick></bricks></gluster_volume>"
curl -X POST -H "Accept: application/xml" -H "Content-Type: application/xml" -u [USER:PASS] --cacert [CERT] https://[RHGSC HOST]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95/glustervolumes -d "<gluster_volume><name>data</name><volume_type>DISTRIBUTE</volume_type><bricks><brick><server_id>fcb46b88-f32e-11e1-918a-0050568c4349</server_id><brick_dir>/export/data/brick1</brick_dir></brick><brick><server_id>de173e6a-fb05-11e1-a2fc-0050568c4349</server_id><brick_dir>/export/data/brick2</brick_dir></brick></bricks></gluster_volume>"
The REST API creates a new volume and displays an XML representation of the resource.
Example B.3. PUT request
The following
PUT request updates the cluster. Note that a PUT request requires a body.
Adapt the method (
PUT), headers (Accept: application/xml and Content-type: application/xml), URI (https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95) and request body into the following cURL command:
curl -X PUT -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<cluster><description>Cluster 1</description></cluster>" https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95
$ curl -X PUT -H "Accept: application/xml" -H "Content-type: application/xml" -u [USER:PASS] --cacert [CERT] -d "<cluster><description>Cluster 1</description></cluster>" https://[RHGSC Host]/api/clusters/99408929-82cf-4dc7-a532-9d998063fa95
The REST API updates the cluster with a new description.
Example B.4. DELETE request
The following
DELETE request removes a cluster resource.
DELETE /api/clusters/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
DELETE /api/clusters/082c794b-771f-452f-83c9-b2b5a19c0399 HTTP/1.1
Adapt the method (
DELETE) and URI (https://[RHGSC Host]/api/clusters/082c794b-771f-452f-83c9-b2b5a19c0399) into the following cURL command:
curl -X DELETE -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/clusters/082c794b-771f-452f-83c9-b2b5a19c0399
$ curl -X DELETE -u [USER:PASS] --cacert [CERT] https://[RHGSC Host]/api/clusters/082c794b-771f-452f-83c9-b2b5a19c0399
The REST API removes the cluster. Note the
Accept: application/xml request header is optional due to the empty result of DELETE requests.
cURL Library (libcurl)
In addition the the standard command line tools, cURL also features libcurl, a library for programming language integration. For more information on supported programming languages and integration methods, see the libcurl website (http://curl.haxx.se/libcurl/).
Appendix C. Event Codes
Copy linkLink copied to clipboard!
C.1. Event Codes
Copy linkLink copied to clipboard!
| Code | Description |
|---|---|
| 0 | UNASSIGNED |
| 1 | VDC_START |
| 2 | VDC_STOP |
| 12 | VDS_FAILURE |
| 13 | VDS_DETECTED |
| 14 | VDS_RECOVER |
| 15 | VDS_MAINTENANCE |
| 16 | VDS_ACTIVATE |
| 17 | VDS_MAINTENANCE_FAILED |
| 18 | VDS_ACTIVATE |
| 19 | VDS_RECOVER_FAILED |
| 123 | VDS_SLOW_STORAGE_RESPONSE_TIME |
| 493 | VDS_ALREADY_IN_REQUESTED_STATUS |
| 494 | VDS_MANUAL_FENCE_STATUS |
| 495 | VDS_MANUAL_FENCE_STATUS_FAILED |
| 530 | VDS_MANUAL_FENCE_FAILED_CALL_FENCE_SPM |
| 531 | VDS_LOW_MEM |
| 532 | VDS_HIGH_MEM_USE |
| 533 | VDS_HIGH_NETWORK_USE |
| 534 | VDS_HIGH_CPU_USE |
| 535 | VDS_HIGH_SWAP_USE |
| 536 | VDS_LOW_SWAP |
| 496 | VDS_FENCE_STATUS |
| 497 | VDS_FENCE_STATUS_FAILED |
| 498 | VDS_APPROVE |
| 499 | VDS_APPROVE_FAILED |
| 500 | VDS_FAILED_TO_RUN_VMS |
| 504 | VDS_INSTALL |
| 505 | VDS_INSTALL_FAILED |
| 506 | VDS_INITIATED_RUN_VM |
| 537 | VDS_INITIATED_RUN_VM_AS_STATELESS |
| 507 | VDS_INITIATED_RUN_VM_FAILED |
| 509 | VDS_INSTALL_IN_PROGRESS |
| 510 | VDS_INSTALL_IN_PROGRESS_WARNING |
| 511 | VDS_INSTALL_IN_PROGRESS_ERROR |
| 513 | VDS_RECOVER_FAILED_VMS_UNKNOWN |
| 514 | VDS_INITIALIZING |
| 515 | VDS_CPU_LOWER_THAN_CLUSTER |
| 516 | VDS_CPU_RETRIEVE_FAILED |
| 517 | VDS_FAILED_TO_GET_HOST_HARDWARE_INFO |
| 533 | VDS_STORAGE_CONNECTION_FAILED_BUT_LAST_VDS |
| 535 | VDS_STORAGES_CONNECTION_FAILED |
| 534 | VDS_STORAGE_VDS_STATS_FAILED |
| 517 | VDS_SET_NONOPERATIONAL |
| 518 | VDS_SET_NONOPERATIONAL_FAILED |
| 519 | VDS_SET_NONOPERATIONAL_NETWORK |
| 603 | VDS_SET_NONOPERATIONAL_IFACE_DOWN |
| 522 | VDS_SET_NONOPERATIONAL_DOMAIN |
| 523 | VDS_SET_NONOPERATIONAL_DOMAIN_FAILED |
| 524 | VDS_DOMAIN_DELAY_INTERVAL |
| 23 | VDS_LOW_DISK_SPACE |
| 24 | VDS_LOW_DISK_SPACE_ERROR |
| 600 | USER_VDS_MAINTENANCE |
| 601 | CPU_FLAGS_NX_IS_MISSING |
| 602 | USER_VDS_MAINTENANCE_MIGRATION_FAILED |
| 121 | SYSTEM_VDS_RESTART |
| 122 | SYSTEM_FAILED_VDS_RESTART |
| 604 | VDS_TIME_DRIFT_ALERT |
| 605 | PROXY_HOST_SELECTION |
| 606 | HOST_REFRESHED_CAPABILITIES |
| 607 | HOST_REFRESH_CAPABILITIES_FAILED |
| 22 | IRS_FAILURE |
| 26 | IRS_DISK_SPACE_LOW |
| 201 | IRS_DISK_SPACE_LOW_ERROR |
| 204 | IRS_HOSTED_ON_VDS |
| 30 | USER_VDC_LOGIN |
| 114 | USER_VDC_LOGIN_FAILED |
| 31 | USER_VDC_LOGOUT |
| 815 | USER_VDC_LOGOUT_FAILED |
| 150 | USER_INITIATED_RUN_VM |
| 156 | USER_INITIATED_RUN_VM_AND_PAUSE |
| 153 | USER_STARTED_VM |
| 151 | USER_INITIATED_RUN_VM_FAILED |
| 32 | USER_RUN_VM |
| 538 | USER_RUN_VM_AS_STATELESS |
| 54 | USER_FAILED_RUN_VM |
| 70 | USER_RUN_VM_AS_STATELESS_FINISHED_FAILURE |
| 171 | USER_RUN_VM_AS_STATELESS_WITH_DISKS_NOT_ALLOWING_SNAPSHOT |
| 1001 | USER_RUN_VM_FAILURE_STATELESS_SNAPSHOT_LEFT |
| 152 | USER_RUN_VM_ON_NON_DEFAULT_VDS |
| 33 | USER_STOP_VM |
| 111 | USER_STOP_SUSPENDED_VM |
| 112 | USER_STOP_SUSPENDED_VM_FAILED |
| 56 | USER_FAILED_STOP_VM |
| 34 | USER_ADD_VM |
| 37 | USER_ADD_VM_STARTED |
| 53 | USER_ADD_VM_FINISHED_SUCCESS |
| 60 | USER_ADD_VM_FINISHED_FAILURE |
| 57 | USER_FAILED_ADD_VM |
| 35 | USER_UPDATE_VM |
| 58 | USER_FAILED_UPDATE_VM |
| 250 | USER_UPDATE_VM_CLUSTER_DEFAULT_HOST_CLEARED |
| 113 | USER_REMOVE_VM_FINISHED |
| 172 | USER_REMOVE_VM_FINISHED_WITH_ILLEGAL_DISKS |
| 149 | USER_ADD |
| 59 | USER_FAILED_REMOVE_VM |
| 38 | USER_CHANGE_DISK_VM |
| 102 | USER_FAILED_CHANGE_DISK_VM |
| 72 | USER_CHANGE_FLOPPY_VM |
| 75 | USER_FAILED_CHANGE_FLOPPY_VM |
| 39 | USER_PAUSE_VM |
| 55 | USER_FAILED_PAUSE_VM |
| 501 | USER_SUSPEND_VM |
| 512 | USER_SUSPEND_VM_FINISH_SUCCESS |
| 521 | USER_SUSPEND_VM_FINISH_FAILURE |
| 532 | USER_SUSPEND_VM_FINISH_FAILURE_WILL_TRY_AGAIN |
| 502 | USER_FAILED_SUSPEND_VM |
| 503 | USER_SUSPEND_VM_OK |
| 40 | USER_RESUME_VM |
| 103 | USER_FAILED_RESUME_VM |
| 73 | USER_INITIATED_SHUTDOWN_VM |
| 74 | USER_FAILED_SHUTDOWN_VM |
| 76 | USER_STOPPED_VM_INSTEAD_OF_SHUTDOWN |
| 77 | USER_FAILED_STOPPING_VM_INSTEAD_OF_SHUTDOWN |
| 78 | USER_ADD_DISK_TO_VM |
| 97 | USER_ADD_DISK_TO_VM_FINISHED_SUCCESS |
| 98 | USER_ADD_DISK_TO_VM_FINISHED_FAILURE |
| 79 | USER_FAILED_ADD_DISK_TO_VM |
| 80 | USER_REMOVE_DISK_FROM_VM |
| 81 | USER_FAILED_REMOVE_DISK_FROM_VM |
| 91 | USER_MOVED_VM |
| 92 | USER_MOVED_VM_FINISHED_SUCCESS |
| 83 | USER_MOVED_VM_FINISHED_FAILURE |
| 84 | USER_FAILED_MOVE_VM |
| 93 | USER_MOVED_TEMPLATE |
| 94 | USER_MOVED_TEMPLATE_FINISHED_SUCCESS |
| 85 | USER_MOVED_TEMPLATE_FINISHED_FAILURE |
| 86 | USER_FAILED_MOVE_TEMPLATE |
| 95 | USER_COPIED_TEMPLATE |
| 96 | USER_COPIED_TEMPLATE_FINISHED_SUCCESS |
| 87 | USER_COPIED_TEMPLATE_FINISHED_FAILURE |
| 88 | USER_FAILED_COPY_TEMPLATE |
| 89 | USER_UPDATE_VM_DISK |
| 2000 | USER_FAILED_UPDATE_VM_DISK |
| 2001 | USER_HOTPLUG_DISK |
| 2002 | USER_FAILED_HOTPLUG_DISK |
| 2003 | USER_HOTUNPLUG_DISK |
| 2004 | USER_FAILED_HOTUNPLUG_DISK |
| 2005 | USER_COPIED_TEMPLATE_DISK |
| 2006 | USER_COPIED_TEMPLATE_DISK_FINISHED_SUCCESS |
| 2007 | USER_COPIED_TEMPLATE_DISK_FINISHED_FAILURE |
| 2008 | USER_MOVED_VM_DISK |
| 2009 | USER_FAILED_MOVED_VM_DISK |
| 2010 | USER_MOVED_VM_DISK_FINISHED_SUCCESS |
| 2011 | USER_MOVED_VM_DISK_FINISHED_FAILURE |
| 2014 | USER_FINISHED_REMOVE_DISK |
| 2015 | USER_FINISHED_FAILED_REMOVE_DISK |
| 2016 | USER_ATTACH_DISK_TO_VM |
| 2017 | USER_FAILED_ATTACH_DISK_TO_VM |
| 2018 | USER_DETACH_DISK_FROM_VM |
| 2019 | USER_FAILED_DETACH_DISK_FROM_VM |
| 2020 | USER_ADD_DISK |
| 2021 | USER_ADD_DISK_FINISHED_SUCCESS |
| 2022 | USER_ADD_DISK_FINISHED_FAILURE |
| 2023 | USER_FAILED_ADD_DISK |
| 2024 | USER_RUN_UNLOCK_ENTITY_SCRIPT |
| 2025 | USER_MOVE_IMAGE_GROUP_FAILED_TO_DELETE_SRC_IMAGE |
| 2026 | USER_MOVE_IMAGE_GROUP_FAILED_TO_DELETE_DST_IMAGE |
| 3000 | USER_ADD_QUOTA |
| 3001, 3002 | USER_FAILED_ADD_QUOTA |
| 3003 | USER_FAILED_UPDATE_QUOTA |
| 3004 | USER_DELETE_QUOTA |
| 3005 | USER_FAILED_DELETE_QUOTA |
| 3006 | USER_EXCEEDED_QUOTA_VDS_GROUP_GRACE_LIMIT |
| 3007 | USER_EXCEEDED_QUOTA_VDS_GROUP_LIMIT |
| 3008 | USER_EXCEEDED_QUOTA_VDS_GROUP_THRESHOLD |
| 3009 | USER_EXCEEDED_QUOTA_STORAGE_GRACE_LIMIT |
| 3010 | USER_EXCEEDED_QUOTA_STORAGE_LIMIT |
| 3011 | USER_EXCEEDED_QUOTA_STORAGE_THRESHOLD |
| 3012 | QUOTA_STORAGE_RESIZE_LOWER_THEN_CONSUMPTION |
| 3013 | MISSING_QUOTA_STORAGE_PARAMETERS_PERMISSIVE_MODE |
| 3014 | MISSING_QUOTA_CLUSTER_PARAMETERS_PERMISSIVE_MODE |
| 4000 | GLUSTER_VOLUME_CREATE |
| 4001 | GLUSTER_VOLUME_CREATE_FAILED |
| 4002 | GLUSTER_VOLUME_OPTION_ADDED |
| 4003 | GLUSTER_VOLUME_OPTION_SET_FAILED |
| 4004 | GLUSTER_VOLUME_START |
| 4005 | GLUSTER_VOLUME_START_FAILED |
| 4006 | GLUSTER_VOLUME_STOP |
| 4007 | GLUSTER_VOLUME_STOP_FAILED |
| 4008 | GLUSTER_VOLUME_OPTIONS_RESET |
| 4009 | GLUSTER_VOLUME_OPTIONS_RESET_FAILED |
| 4010 | GLUSTER_VOLUME_DELETE |
| 4011 | GLUSTER_VOLUME_DELETE_FAILED |
| 4012 | GLUSTER_VOLUME_REBALANCE_START |
| 4013 | GLUSTER_VOLUME_REBALANCE_START_FAILED |
| 4014 | GLUSTER_VOLUME_REMOVE_BRICKS |
| 4015 | GLUSTER_VOLUME_REMOVE_BRICKS_FAILED |
| 4016 | GLUSTER_VOLUME_REPLACE_BRICK_FAILED |
| 4017 | GLUSTER_VOLUME_REPLACE_BRICK_START |
| 4018 | GLUSTER_VOLUME_REPLACE_BRICK_START_FAILED |
| 4019 | GLUSTER_VOLUME_ADD_BRICK |
| 4020 | GLUSTER_VOLUME_ADD_BRICK_FAILED |
| 4021 | GLUSTER_SERVER_REMOVE_FAILED |
| 4022 | GLUSTER_VOLUME_PROFILE_START |
| 4023 | GLUSTER_VOLUME_PROFILE_START_FAILED |
| 4024 | GLUSTER_VOLUME_PROFILE_STOP |
| 4025 | GLUSTER_VOLUME_PROFILE_STOP_FAILED |
| 4026 | GLUSTER_VOLUME_CREATED_FROM_CLI |
| 4027 | GLUSTER_VOLUME_DELETED_FROM_CLI |
| 4028 | GLUSTER_VOLUME_OPTION_SET_FROM_CLI |
| 4029 | GLUSTER_VOLUME_OPTION_RESET_FROM_CLI |
| 4030 | GLUSTER_VOLUME_PROPERTIES_CHANGED_FROM_CLI |
| 4031 | GLUSTER_VOLUME_BRICK_ADDED_FROM_CLI |
| 4032 | GLUSTER_VOLUME_BRICK_REMOVED_FROM_CLI |
| 4033 | GLUSTER_SERVER_REMOVED_FROM_CLI |
| 4034 | GLUSTER_VOLUME_INFO_FAILED |
| 4035 | GLUSTER_COMMAND_FAILED |
| 4036 | GLUSTER_SERVER_ADD_FAILED |
| 4037 | GLUSTER_SERVERS_LIST_FAILED |
| 4038 | GLUSTER_SERVER_REMOVE |
| 4039 | GLUSTER_VOLUME_STARTED_FROM_CLI |
| 4040 | GLUSTER_VOLUME_STOPPED_FROM_CLI |
| 4041 | GLUSTER_VOLUME_OPTION_CHANGED_FROM_CLI |
| 4042 | GLUSTER_HOOK_ENABLE |
| 4043 | GLUSTER_HOOK_ENABLE_FAILED |
| 4044 | GLUSTER_HOOK_ENABLE_PARTIAL |
| 4045 | GLUSTER_HOOK_DISABLE |
| 4046 | GLUSTER_HOOK_DISABLE_FAILED |
| 4047 | GLUSTER_HOOK_DISABLE_PARTIAL |
| 4048 | GLUSTER_HOOK_LIST_FAILED |
| 4049 | GLUSTER_HOOK_CONFLICT_DETECTED |
| 4050 | GLUSTER_HOOK_DETECTED_NEW |
| 4051 | GLUSTER_HOOK_DETECTED_DELETE |
| 4052 | GLUSTER_VOLUME_OPTION_MODIFIED |
| 4053 | GLUSTER_HOOK_GETCONTENT_FAILED |
| 4054 | GLUSTER_SERVICES_LIST_FAILED |
| 4055 | GLUSTER_SERVICE_TYPE_ADDED_TO_CLUSTER |
| 4056 | GLUSTER_CLUSTER_SERVICE_STATUS_CHANGED |
| 4057 | GLUSTER_SERVICE_ADDED_TO_SERVER |
| 4058 | GLUSTER_SERVER_SERVICE_STATUS_CHANGED |
| 4059 | GLUSTER_HOOK_UPDATED |
| 4060 | GLUSTER_HOOK_UPDATE_FAILED |
| 4061 | GLUSTER_HOOK_ADDED |
| 4062 | GLUSTER_HOOK_ADD_FAILED |
| 4063 | GLUSTER_HOOK_REMOVED |
| 4064 | GLUSTER_HOOK_REMOVE_FAILED |
| 4065 | GLUSTER_HOOK_REFRESH |
| 4066 | GLUSTER_HOOK_REFRESH_FAILED |
| 4067 | GLUSTER_SERVICE_STARTED |
| 4068 | GLUSTER_SERVICE_START_FAILED |
| 4069 | GLUSTER_SERVICE_STOPPED |
| 4070 | GLUSTER_SERVICE_STOP_FAILED |
| 4071 | GLUSTER_SERVICES_LIST_NOT_FETCHED |
| 4072 | GLUSTER_SERVICE_RESTARTED |
| 4073 | GLUSTER_SERVICE_RESTART_FAILED |
| 4074 | GLUSTER_VOLUME_OPTIONS_RESET_ALL |
| 4075 | GLUSTER_HOST_UUID_NOT_FOUND |
| 4076 | GLUSTER_VOLUME_BRICK_ADDED |
| 4077 | GLUSTER_CLUSTER_SERVICE_STATUS_ADDED |
| 41 | USER_VDS_RESTART |
| 107 | USER_FAILED_VDS_RESTART |
| 20 | USER_VDS_START |
| 118 | USER_FAILED_VDS_START |
| 21 | USER_VDS_STOP |
| 137 | USER_FAILED_VDS_STOP |
| 42 | USER_ADD_VDS |
| 104 | USER_FAILED_ADD_VDS |
| 43 | USER_UPDATE_VDS |
| 105 | USER_FAILED_UPDATE_VDS |
| 44 | USER_REMOVE_VDS |
| 106 | USER_FAILED_REMOVE_VDS |
| 45 | USER_CREATE_SNAPSHOT |
| 68 | USER_CREATE_SNAPSHOT_FINISHED_SUCCESS |
| 69 | USER_CREATE_SNAPSHOT_FINISHED_FAILURE |
| 170 | USER_CREATE_LIVE_SNAPSHOT_FINISHED_FAILURE |
| 117 | USER_FAILED_CREATE_SNAPSHOT |
| 342 | USER_REMOVE_SNAPSHOT |
| 343 | USER_FAILED_REMOVE_SNAPSHOT |
| 356 | USER_REMOVE_SNAPSHOT_FINISHED_SUCCESS |
| 357 | USER_REMOVE_SNAPSHOT_FINISHED_FAILURE |
| 46 | USER_TRY_BACK_TO_SNAPSHOT |
| 71 | USER_TRY_BACK_TO_SNAPSHOT_FINISH_SUCCESS |
| 99 | USER_TRY_BACK_TO_SNAPSHOT_FINISH_FAILURE |
| 115 | USER_FAILED_TRY_BACK_TO_SNAPSHOT |
| 47 | USER_RESTORE_FROM_SNAPSHOT |
| 1190 | USER_RESTORE_FROM_SNAPSHOT_START |
| 100 | USER_RESTORE_FROM_SNAPSHOT_FINISH_SUCCESS |
| 101 | USER_RESTORE_FROM_SNAPSHOT_FINISH_FAILURE |
| 116 | USER_FAILED_RESTORE_FROM_SNAPSHOT |
| 48 | USER_ADD_VM_TEMPLATE |
| 51 | USER_ADD_VM_TEMPLATE_FINISHED_SUCCESS |
| 52 | USER_ADD_VM_TEMPLATE_FINISHED_FAILURE |
| 108 | USER_FAILED_ADD_VM_TEMPLATE |
| 49 | USER_UPDATE_VM_TEMPLATE |
| 109 | USER_FAILED_UPDATE_VM_TEMPLATE |
| 50 | USER_REMOVE_VM_TEMPLATE |
| 251 | USER_REMOVE_VM_TEMPLATE_FINISHED |
| 110 | USER_FAILED_REMOVE_VM_TEMPLATE |
| 135 | TEMPLATE_IMPORT |
| 136 | TEMPLATE_IMPORT_FAILED |
| 520 | USER_ATTACH_USER_TO_VM |
| 360 | USER_DETACH_USER_FROM_VM |
| 361 | USER_FAILED_DETACH_USER_FROM_VM |
| 182 | USER_FAILED_ATTACH_USER_TO_VM |
| 325 | USER_REMOVE_ADUSER |
| 326 | USER_FAILED_REMOVE_ADUSER |
| 327 | USER_FAILED_ADD_ADUSER |
| 346 | USER_PASSWORD_CHANGED |
| 347 | USER_PASSWORD_CHANGE_FAILED |
| 348 | USER_CLEAR_UNKNOWN_VMS |
| 349 | USER_FAILED_CLEAR_UNKNOWN_VMS |
| 528 | USER_EJECT_VM_DISK |
| 529 | USER_EJECT_VM_FLOPPY |
| 61 | VM_DOWN |
| 119 | VM_DOWN_ERROR |
| 62 | VM_MIGRATION_START |
| 63 | VM_MIGRATION_DONE |
| 64 | VM_MIGRATION_ABORT |
| 65 | VM_MIGRATION_FAILED |
| 66 | VM_FAILURE |
| 67 | VM_MIGRATION_START_SYSTEM_INITIATED |
| 120 | VM_MIGRATION_FAILED_FROM_TO |
| 128 | VM_MIGRATION_TRYING_RERUN |
| 161 | VM_CANCEL_MIGRATION |
| 162 | VM_CANCEL_MIGRATION_FAILED |
| 163 | VM_STATUS_RESTORED |
| 140 | VM_MIGRATION_FAILED_DURING_MOVE_TO_MAINTENANCE |
| 142 | VM_SET_TO_UNKNOWN_STATUS |
| 143 | VM_WAS_SET_DOWN_DUE_TO_HOST_REBOOT_OR_MANUAL_FENCE |
| 131 | USER_EXPORT_VM |
| 132 | USER_EXPORT_VM_FAILED |
| 133 | USER_EXPORT_TEMPLATE |
| 134 | USER_EXPORT_TEMPLATE_FAILED |
| 124 | VM_IMPORT |
| 125 | VM_IMPORT_FAILED |
| 126 | VM_NOT_RESPONDING |
| 127 | VDS_RUN_IN_NO_KVM_MODE |
| 141 | VDS_VERSION_NOT_SUPPORTED_FOR_CLUSTER |
| 129 | VM_CLEARED |
| 138 | VM_PAUSED_ENOSPC |
| 139 | VM_PAUSED_ERROR |
| 144 | VM_IMPORT_INFO |
| 145 | VM_PAUSED_EIO |
| 146 | VM_PAUSED_EPERM |
| 147 | VM_POWER_DOWN_FAILED |
| 300 | USER_ADD_VM_POOL |
| 301 | USER_ADD_VM_POOL_FAILED |
| 302 | USER_ADD_VM_POOL_WITH_VMS |
| 303 | USER_ADD_VM_POOL_WITH_VMS_FAILED |
| 320 | USER_ADD_VM_POOL_WITH_VMS_ADD_VDS_FAILED |
| 304 | USER_REMOVE_VM_POOL |
| 305 | USER_REMOVE_VM_POOL_FAILED |
| 306 | USER_ADD_VM_TO_POOL |
| 307 | USER_ADD_VM_TO_POOL_FAILED |
| 308 | USER_REMOVE_VM_FROM_POOL |
| 309 | USER_REMOVE_VM_FROM_POOL_FAILED |
| 310 | USER_ATTACH_USER_TO_POOL |
| 472 | USER_ATTACH_USER_TO_POOL_INTERNAL |
| 311 | USER_ATTACH_USER_TO_POOL_FAILED |
| 473 | USER_ATTACH_USER_TO_POOL_FAILED_INTERNAL |
| 312 | USER_DETACH_USER_FROM_POOL |
| 313 | USER_DETACH_USER_FROM_POOL_FAILED |
| 314 | USER_UPDATE_VM_POOL |
| 315 | USER_UPDATE_VM_POOL_FAILED |
| 316 | USER_ATTACH_USER_TO_VM_FROM_POOL |
| 318 | USER_ATTACH_USER_TO_VM_FROM_POOL_FINISHED_SUCCESS |
| 319 | USER_ATTACH_USER_TO_VM_FROM_POOL_FINISHED_FAILURE |
| 317 | USER_ATTACH_USER_TO_VM_FROM_POOL_FAILED |
| 344 | USER_UPDATE_VM_POOL_WITH_VMS |
| 345 | USER_UPDATE_VM_POOL_WITH_VMS_FAILED |
| 358 | USER_VM_POOL_MAX_SUBSEQUENT_FAILURES_REACHED |
| 328 | USER_ATTACH_USER_TO_TIME_LEASED_POOL |
| 329 | USER_ATTACH_USER_TO_TIME_LEASED_POOL_FAILED |
| 330 | USER_DETACH_USER_FROM_TIME_LEASED_POOL |
| 331 | USER_ATTACH_USER_FROM_TIME_LEASED_POOL_FAILED |
| 332 | USER_ATTACH_AD_GROUP_FROM_TIME_LEASED_POOL |
| 333 | USER_ATTACH_AD_GROUP_TO_TIME_LEASED_POOL_FAILED |
| 334 | USER_DETACH_AD_GROUP_FROM_TIME_LEASED_POOL |
| 335 | USER_DETACH_AD_GROUP_FROM_TIME_LEASED_POOL_FAILED |
| 336 | USER_UPDATE_USER_TO_TIME_LEASED_POOL |
| 337 | USER_UPDATE_USER_TO_TIME_LEASED_POOL_FAILED |
| 338 | USER_UPDATE_AD_GROUP_TO_TIME_LEASED_POOL |
| 337 | USER_UPDATE_AD_GROUP_TO_TIME_LEASED_POOL_FAILED |
| 338 | USER_UPDATE_AD_GROUP_TO_TIME_LEASED_POOL |
| 339 | USER_UPDATE_AD_GROUP_TO_TIME_LEASED_POOL_FAILED |
| 350 | USER_ADD_BOOKMARK |
| 351 | USER_ADD_BOOKMARK_FAILED |
| 352 | USER_UPDATE_BOOKMARK |
| 353 | USER_UPDATE_BOOKMARK_FAILED |
| 354 | USER_REMOVE_BOOKMARK |
| 355 | USER_REMOVE_BOOKMARK_FAILED |
| 400 | USER_ATTACH_VM_TO_AD_GROUP |
| 401 | USER_ATTACH_VM_TO_AD_GROUP_FAILED |
| 402 | USER_DETACH_VM_TO_AD_GROUP |
| 403 | USER_DETACH_VM_TO_AD_GROUP_FAILED |
| 404 | USER_ATTACH_VM_POOL_TO_AD_GROUP |
| 470 | USER_ATTACH_VM_POOL_TO_AD_GROUP_INTERNAL |
| 405 | USER_ATTACH_VM_POOL_TO_AD_GROUP_FAILED |
| 471 | USER_ATTACH_VM_POOL_TO_AD_GROUP_FAILED_INTERNAL |
| 406 | USER_DETACH_VM_POOL_TO_AD_GROUP |
| 407 | USER_DETACH_VM_POOL_TO_AD_GROUP_FAILED |
| 408 | USER_REMOVE_AD_GROUP |
| 409 | USER_REMOVE_AD_GROUP_FAILED |
| 430 | USER_UPDATE_TAG |
| 431 | USER_UPDATE_TAG_FAILED |
| 432 | USER_ADD_TAG |
| 433 | USER_UPDATE_TAG_FAILED |
| 434 | USER_REMOVE_TAG |
| 435 | USER_REMOVE_TAG_FAILED |
| 436 | USER_ATTACH_TAG_TO_USER |
| 437 | USER_ATTACH_TAG_TO_USER_FAILED |
| 438 | USER_ATTACH_TAG_TO_USER_GROUP |
| 439 | USER_ATTACH_TAG_TO_USER_GROUP_FAILED |
| 440 | USER_ATTACH_TAG_TO_VM |
| 441 | USER_ATTACH_TAG_TO_VM_FAILED |
| 442 | USER_ATTACH_TAG_TO_VDS |
| 443 | USER_ATTACH_TAG_TO_VDS_FAILED |
| 444 | USER_DETACH_VDS_FROM_TAG |
| 445 | USER_DETACH_VDS_FROM_TAG_FAILED |
| 446 | USER_DETACH_VM_FROM_TAG |
| 447 | USER_DETACH_VM_FROM_TAG_FAILED |
| 448 | USER_DETACH_USER_FROM_TAG |
| 449 | USER_DETACH_USER_FROM_TAG_FAILED |
| 450 | USER_DETACH_USER_GROUP_FROM_TAG |
| 451 | USER_DETACH_USER_GROUP_FROM_TAG_FAILED |
| 452 | USER_ATTACH_TAG_TO_USER_EXISTS |
| 453 | USER_ATTACH_TAG_TO_USER_GROUP_EXISTS |
| 454 | USER_ATTACH_TAG_TO_VM_EXISTS |
| 455 | USER_ATTACH_TAG_TO_VDS_EXISTS |
| 555 | USER_MOVE_TAG |
| 556 | USER_MOVE_TAG_FAILED |
| 456 | USER_LOGGED_IN_VM |
| 457 | USER_LOGGED_OUT_VM |
| 458 | USER_LOCKED_VM |
| 459 | USER_UNLOCKED_VM |
| 460 | USER_DETACH_USER_FROM_TIME_LEASED_POOL_INTERNAL |
| 461 | USER_DETACH_USER_FROM_TIME_LEASED_POOL_FAILED_INTERNAL |
| 462 | USER_DETACH_AD_GROUP_FROM_TIME_LEASED_POOL_INTERNAL |
| 463 | USER_DETACH_AD_GROUP_FROM_TIME_LEASED_POOL_FAILED_INTERNAL |
| 467 | UPDATE_TAGS_VM_DEFAULT_DISPLAY_TYPE |
| 468 | UPDATE_TAGS_VM_DEFAULT_DISPLAY_TYPE_FAILED |
| 809 | USER_ADD_VDS_GROUP |
| 810 | USER_ADD_VDS_GROUP_FAILED |
| 811 | USER_UPDATE_VDS_GROUP |
| 812 | USER_UPDATE_VDS_GROUP_FAILED |
| 835 | SYSTEM_UPDATE_VDS_GROUP |
| 836 | SYSTEM_UPDATE_VDS_GROUP_FAILED |
| 813 | USER_REMOVE_VDS_GROUP |
| 814 | USER_REMOVE_VDS_GROUP_FAILED |
| 816 | MAC_POOL_EMPTY |
| 833 | MAC_ADDRESS_IS_IN_USE |
| 838 | MAC_ADDRESS_IS_IN_USE_UNPLUG |
| 817 | CERTIFICATE_FILE_NOT_FOUND |
| 818 | RUN_VM_FAILED |
| 837 | MAC_ADDRESSES_POOL_NOT_INITIALIZED |
| 819 | VDS_REGISTER_ERROR_UPDATING_HOST |
| 820 | VDS_REGISTER_ERROR_UPDATING_HOST_ALL_TAKEN |
| 821 | VDS_REGISTER_HOST_IS_ACTIVE |
| 822 | VDS_REGISTER_ERROR_UPDATING_NAME |
| 823 | VDS_REGISTER_ERROR_UPDATING_NAMES_ALL_TAKEN |
| 824 | VDS_REGISTER_NAME_IS_ACTIVE |
| 825 | VDS_REGISTER_AUTO_APPROVE_PATTERN |
| 826 | VDS_REGISTER_FAILED |
| 827 | VDS_REGISTER_EXISTING_VDS_UPDATE_FAILED |
| 828 | VDS_REGISTER_SUCCEEDED |
| 834 | VDS_REGISTER_EMPTY_ID |
| 829 | VM_MIGRATION_ON_CONNECT_CHECK_FAILED |
| 830 | VM_MIGRATION_ON_CONNECT_CHECK_SUCCEEDED |
| 920 | NETWORK_ATTACH_NETWORK_TO_VDS |
| 921 | NETWORK_ATTACH_NETWORK_TO_VDS_FAILED |
| 922 | NETWORK_DETACH_NETWORK_FROM_VDS |
| 923 | NETWORK_DETACH_NETWORK_FROM_VDS_FAILED |
| 924 | NETWORK_ADD_BOND |
| 925 | NETWORK_ADD_BOND_FAILED |
| 926 | NETWORK_REMOVE_BOND |
| 927 | NETWORK_REMOVE_BOND_FAILED |
| 928 | NETWORK_VDS_NETWORK_MATCH_CLUSTER |
| 929 | NETWORK_VDS_NETWORK_NOT_MATCH_CLUSTER |
| 930 | NETWORK_REMOVE_VM_INTERFACE |
| 931 | NETWORK_REMOVE_VM_INTERFACE_FAILED |
| 932 | NETWORK_ADD_VM_INTERFACE |
| 933 | NETWORK_ADD_VM_INTERFACE_FAILED |
| 934 | NETWORK_UPDATE_VM_INTERFACE |
| 935 | NETWORK_UPDATE_VM_INTERFACE_FAILED |
| 936 | NETWORK_ADD_TEMPLATE_INTERFACE |
| 937 | NETWORK_ADD_TEMPLATE_INTERFACE_FAILED |
| 938 | NETWORK_REMOVE_TEMPLATE_INTERFACE |
| 939 | NETWORK_REMOVE_TEMPLATE_INTERFACE_FAILED |
| 940 | NETWORK_UPDATE_TEMPLATE_INTERFACE |
| 941 | NETWORK_UPDATE_TEMPLATE_INTERFACE_FAILED |
| 942 | NETWORK_ADD_NETWORK |
| 943 | NETWORK_ADD_NETWORK_FAILED |
| 944 | NETWORK_REMOVE_NETWORK |
| 945 | NETWORK_REMOVE_NETWORK_FAILED |
| 946 | NETWORK_ATTACH_NETWORK_TO_VDS_GROUP |
| 947 | NETWORK_ATTACH_NETWORK_TO_VDS_GROUP_FAILED |
| 948 | NETWORK_DETACH_NETWORK_TO_VDS_GROUP |
| 949 | NETWORK_DETACH_NETWORK_TO_VDS_GROUP_FAILED |
| 1102 | NETWORK_ACTIVATE_VM_INTERFACE_SUCCESS |
| 1103 | NETWORK_ACTIVATE_VM_INTERFACE_FAILURE |
| 1104 | NETWORK_DEACTIVATE_VM_INTERFACE_SUCCESS |
| 1105 | NETWORK_DEACTIVATE_VM_INTERFACE_FAILURE |
| 1100 | NETWORK_UPDATE_DISPLAY_TO_VDS_GROUP |
| 1101 | NETWORK_UPDATE_DISPLAY_TO_VDS_GROUP_FAILED |
| 1102 | NETWORK_UPDATE_NETWORK_TO_VDS_INTERFACE |
| 1103 | NETWORK_UPDATE_NETWORK_TO_VDS_INTERFACE_FAILED |
| 1104 | NETWORK_COMMINT_NETWORK_CHANGES |
| 1105 | NETWORK_COMMINT_NETWORK_CHANGES_FAILED |
| 1106 | NETWORK_HOST_USING_WRONG_CLUSER_VLAN |
| 1107 | NETWORK_HOST_MISSING_CLUSER_VLAN |
| 1108 | VDS_NETWORK_MTU_DIFFER_FROM_LOGICAL_NETWORK |
| 1109 | BRIDGED_NETWORK_OVER_MULTIPLE_INTERFACES |
| 1110 | VDS_NETWORKS_OUT_OF_SYNC |
| 1112 | NETWORK_UPDTAE_NETWORK_ON_CLUSTER |
| 1113 | NETWORK_UPDTAE_NETWORK_ON_CLUSTER_FAILED |
| 1114 | NETWORK_UPDATE_NETWORK |
| 1115 | NETWORK_UPDATE_NETWORK_FAILED |
| 1116 | NETWORK_UPDATE_VM_INTERFACE_LINK_UP |
| 1117 | NETWORK_UPDATE_VM_INTERFACE_LINK_DOWN |
| 1118 | INVALID_INTERFACE_FOR_MANAGEMENT_NETWORK_CONFIGURATION |
| 1119 | VLAN_ID_MISMATCH_FOR_MANAGEMENT_NETWORK_CONFIGURATION |
| 1120 | SETUP_NETWORK_FAILED_FOR_MANAGEMENT_NETWORK_CONFIGURATION |
| 1121 | PERSIST_NETWORK_FAILED_FOR_MANAGEMENT_NETWORK |
| 1162 | IMPORTEXPORT_STARTING_EXPORT_VM |
| 1150 | IMPORTEXPORT_EXPORT_VM |
| 1151 | IMPORTEXPORT_EXPORT_VM_FAILED |
| 1165 | IMPORTEXPORT_STARTING_IMPORT_VM |
| 1152 | IMPORTEXPORT_IMPORT_VM |
| 1153 | IMPORTEXPORT_IMPORT_VM_FAILED |
| 1166 | IMPORTEXPORT_STARTING_REMOVE_TEMPLATE |
| 1154 | IMPORTEXPORT_REMOVE_TEMPLATE |
| 1155 | IMPORTEXPORT_REMOVE_TEMPLATE_FAILED |
| 1156 | IMPORTEXPORT_EXPORT_TEMPLATE |
| 1164 | IMPORTEXPORT_STARTING_EXPORT_TEMPLATE |
| 1157 | IMPORTEXPORT_EXPORT_TEMPLATE_FAILED |
| 1163 | IMPORTEXPORT_STARTING_IMPORT_TEMPLATE |
| 1158 | IMPORTEXPORT_IMPORT_TEMPLATE |
| 1159 | IMPORTEXPORT_IMPORT_TEMPLATE_FAILED |
| 1167 | IMPORTEXPORT_STARTING_REMOVE_VM |
| 1160 | IMPORTEXPORT_REMOVE_VM |
| 1161 | IMPORTEXPORT_REMOVE_VM_FAILED |
| 1162 | IMPORTEXPORT_GET_VMS_INFO_FAILED |
| 1168 | IMPORTEXPORT_FAILED_TO_IMPORT_VM |
| 1169 | IMPORTEXPORT_FAILED_TO_IMPORT_TEMPLATE |
| 1170 | IMPORTEXPORT_IMPORT_TEMPLATE_INVALID_INTERFACES |
| 850 | USER_ADD_PERMISSION |
| 851 | USER_ADD_PERMISSION_FAILED |
| 852 | USER_REMOVE_PERMISSION |
| 853 | USER_REMOVE_PERMISSION_FAILED |
| 854 | USER_ADD_ROLE |
| 855 | USER_ADD_ROLE_FAILED |
| 856 | USER_UPDATE_ROLE |
| 857 | USER_UPDATE_ROLE_FAILED |
| 858 | USER_REMOVE_ROLE859 |
| 859 | USER_REMOVE_ROLE_FAILED |
| 860 | USER_ATTACHED_ACTION_GROUP_TO_ROLE |
| 861 | USER_ATTACHED_ACTION_GROUP_TO_ROLE_FAILED |
| 962 | USER_DETACHED_ACTION_GROUP_FROM_ROLE |
| 863 | USER_DETACHED_ACTION_GROUP_FROM_ROLE_FAILED |
| 864 | USER_ADD_ROLE_WITH_ACTION_GROUP |
| 865 | USER_ADD_ROLE_WITH_ACTION_GROUP_FAILED |
| 900 | AD_COMPUTER_ACCOUNT_SUCCEEDED |
| 901 | AD_COMPUTER_ACCOUNT_FAILED |
| 950 | USER_ADD_STORAGE_POOL |
| 951 | USER_ADD_STORAGE_POOL_FAILED |
| 952 | USER_UPDATE_STORAGE_POOL |
| 953 | USER_UPDATE_STORAGE_POOL_FAILED |
| 954 | USER_REMOVE_STORAGE_POOL |
| 955 | USER_REMOVE_STORAGE_POOL_FAILED |
| 918 | USER_FORCE_REMOVE_STORAGE_POOL |
| 919 | USER_FORCE_REMOVE_STORAGE_POOL_FAILED |
| 956 | USER_ADD_STORAGE_DOMAIN |
| 957 | USER_ADD_STORAGE_DOMAIN_FAILED |
| 958 | USER_UPDATE_STORAGE_DOMAIN |
| 959 | USER_UPDATE_STORAGE_DOMAIN_FAILED |
| 960 | USER_REMOVE_STORAGE_DOMAIN |
| 961 | USER_REMOVE_STORAGE_DOMAIN_FAILED |
| 962 | USER_ATTACH_STORAGE_DOMAIN_TO_POOL |
| 963 | USER_ATTACH_STORAGE_DOMAIN_TO_POOL_FAILED |
| 964 | USER_DETACH_STORAGE_DOMAIN_FROM_POOL |
| 965 | USER_DETACH_STORAGE_DOMAIN_FROM_POOL_FAILED |
| 966 | USER_ACTIVATED_STORAGE_DOMAIN |
| 967 | USER_ACTIVATE_STORAGE_DOMAIN_FAILED |
| 968 | USER_DEACTIVATED_STORAGE_DOMAIN |
| 969 | USER_DEACTIVATE_STORAGE_DOMAIN_FAILED |
| 970 | SYSTEM_DEACTIVATED_STORAGE_DOMAIN |
| 971 | SYSTEM_DEACTIVATE_STORAGE_DOMAIN_FAILED |
| 972 | USER_EXTENDED_STORAGE_DOMAIN |
| 973 | USER_EXTENDED_STORAGE_DOMAIN_FAILED |
| 974 | USER_REMOVE_VG |
| 975 | USER_REMOVE_VG_FAILED |
| 976 | USER_ACTIVATE_STORAGE_POOL |
| 977 | USER_ACTIVATE_STORAGE_POOL_FAILED |
| 978 | SYSTEM_FAILED_CHANGE_STORAGE_POOL_STATUS |
| 979 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_NO_HOST_FOR_SPM |
| 980 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC |
| 981 | USER_FORCE_REMOVE_STORAGE_DOMAIN |
| 982 | USER_FORCE_REMOVE_STORAGE_DOMAIN_FAILED |
| 983 | RECONSTRUCT_MASTER_FAILED_NO_MASTER |
| 984 | RECONSTRUCT_MASTER_DONE |
| 985 | RECONSTRUCT_MASTER_FAILED |
| 986 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_SEARCHING_NEW_SPM |
| 987 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_WITH_ERROR |
| 988 | USER_CONNECT_HOSTS_TO_LUN_FAILED |
| 989 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_PROBLEMATIC_FROM_NON_OPERATIONAL |
| 990 | SYSTEM_MASTER_DOMAIN_NOT_IN_SYNC |
| 991 | RECOVERY_STORAGE_POOL |
| 992 | RECOVERY_STORAGE_POOL_FAILED |
| 993 | SYSTEM_CHANGE_STORAGE_POOL_STATUS_RESET_IRS |
| 994 | CONNECT_STORAGE_SERVERS_FAILED |
| 995 | CONNECT_STORAGE_POOL_FAILED |
| 996 | STORAGE_DOMAIN_ERROR |
| 997 | REFRESH_REPOSITORY_FILE_LIST_FAILED |
| 998 | REFRESH_REPOSITORY_FILE_LIST_SUCCEEDED |
| 999 | STORAGE_ALERT_VG_METADATA_CRITICALLY_FULL |
| 1000 | STORAGE_ALERT_SMALL_VG_METADATA |
| 1002 | USER_ATTACH_STORAGE_DOMAINS_TO_POOL |
| 1003 | USER_ATTACH_STORAGE_DOMAINS_TO_POOL_FAILED |
| 1004 | STORAGE_DOMAIN_TASKS_ERROR |
| 1005 | UPDATE_OVF_FOR_STORAGE_POOL_FAILED |
| 1006 | UPGRADE_STORAGE_POOL_ENCOUNTERED_PROBLEMS |
| 1010 | RELOAD_CONFIGURATIONS_SUCCESS |
| 1101 | RELOAD_CONFIGURATIONS_FAILURE |
| 1100 | USER_ACCOUNT_DISABLED_OR_LOCKED |
| 1101 | USER_ACCOUNT_PASSWORD_EXPIRED |
| 1150 | PROVIDER_ADDED |
| 1151 | PROVIDER_ADDITION_FAILED |
| 1152 | PROVIDER_UPDATED |
| 1153 | PROVIDER_UPDATE_FAILED |
| 1154 | PROVIDER_REMOVED |
| 1155 | PROVIDER_REMOVAL_FAILED |
| 1156 | PROVIDER_CERTIFICATE_CHAIN_IMPORTED |
| 1157 | PROVIDER_CERTIFICATE_CHAIN_IMPORT_FAILED |
| 1200 | ENTITY_RENAMED |
| 9000 | VDS_ALERT_FENCE_IS_NOT_CONFIGURED |
| 9001 | VDS_ALERT_FENCE_TEST_FAILED |
| 9002 | VDS_ALERT_FENCE_OPERATION_FAILED |
| 9003 | VDS_ALERT_FENCE_OPERATION_SKIPPED |
| 9004 | VDS_ALERT_FENCE_NO_PROXY_HOST |
| 9005 | VDS_ALERT_FENCE_STATUS_VERIFICATION_FAILED |
| 9006 | CANNOT_HIBERNATE_RUNNING_VMS_AFTER_CLUSTER_CPU_UPGRADE |
| 9007 | VDS_ALERT_SECONDARY_AGENT_USED_FOR_FENCE_OPERATION |
| 9500 | TASK_STOPPING_ASYNC_TASK |
| 9501 | TASK_CLEARING_ASYNC_TASK |
| 9502 | VDS_ACTIVATE_ASYNC |
| 9503 | VDS_ACTIVATE_FAILED_ASYNC |
| 9504 | STORAGE_ACTIVATE_ASYNC |
| 9505 | USER_ACTIVATED_STORAGE_DOMAIN_ASYNC |
| 9506 | USER_ACTIVATE_STORAGE_DOMAIN_FAILED_ASYNC |
| 9600 | IMPORTEXPORT_IMPORT_VM_INVALID_INTERFACES |
| 9601 | VDS_SET_NON_OPERATIONAL_VM_NETWORK_IS_BRIDGELESS |
| 9604 | EMULATED_MACHINES_INCOMPATIBLE_WITH_CLUSTER |
| 9602 | HA_VM_FAILED |
| 9603 | HA_VM_RESTART_FAILED |
| 9701 | DWH_STOPPED |
| 9700 | DWH_STARTED |
| 9704 | DWH_ERROR |
| 9801 | EXTERNAL_EVENT_NORMAL |
| 9802 | EXTERNAL_EVENT_WARNING |
| 9803 | EXTERNAL_EVENT_ERROR |
| 9804 | EXTERNAL_ALERT |
| 9901 | WATCHDOG_EVENT |
| 10000 | VDS_UNTRUSTED |
Appendix D. Java Keystores
Copy linkLink copied to clipboard!
This appendix demonstrates how to import the X.509 certificate exported from the Red Hat Gluster Storage Console server (See Section 2.1, “TLS/SSL Certification” for information on certificate exports) into a new Java keystore file.
Procedure D.1. Import a certificate into a new Java keystore
This process helps a user import the
rhsc.cer certificate from Section 2.1, “TLS/SSL Certification” into a Java keystore. This procedure requires the keytool management utility from the Java Development Kit (JDK) available for Linux and Windows systems.
- Access your client machine and locate the
rhsc.cercertificate. - Import the
rhsc.cercertificate using the Java keytool management utility.keytool -importcert -v -trustcacerts -keystore restapi.jks -noprompt -alias rhsc -file rhsc.cer
keytool -importcert -v -trustcacerts -keystore restapi.jks -noprompt -alias rhsc -file rhsc.cerCopy to Clipboard Copied! Toggle word wrap Toggle overflow The keytool utility creates a new keystore file namedrestapi.jks. - keytool asks for the keystore password. Enter a password and keytool asks to verify it.
- keytool adds the
rhsc.cercertificate to therestapi.jkskeystore. Use keytool -list command to view the certificate's entry in the keystore:keytool -list -keystore restapi.jks -storepass [password]
keytool -list -keystore restapi.jks -storepass [password]Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Important
Some versions of keytool parse the certificate incorrectly. If keytool does not recognize the certificate, convert it to a different X.509 format with the openssl tool:
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
This creates a file called
openssl x509 -in rhsc.cer -out rhsc.new -outform [pem|der]
openssl x509 -in rhsc.cer -out rhsc.new -outform [pem|der]rhsc.new to use in place of rhsc.cer.
Appendix E. Certificates
Copy linkLink copied to clipboard!
E.1. Creating SSL/TLS Certificates
Copy linkLink copied to clipboard!
Summary
SSL/TLS certificates provide a layer of security for accessing your installation over HTTPS. This procedure provides instructions for creating certificates and configuring your server with them.
The following procedure requires
Copy to Clipboard
Copied!
Toggle word wrap
Toggle overflow
openssl. To install this tool, run the following command on your server:
#yum install openssl
#yum install openssl
A Certificate Authority (CA) signs certificates to provide verifification of their validity. Web browsers contain a number of CA certificates for verifying HTTPS communication with secure websites. Some of these CAs require a fee to provide a CA pair for your server, while some are open and provide free CA pairs. This procedure describes how to generate your own Certificate Authority (CA) certificate and key for your own internal network usage.
Procedure E.1. Creating a Certificate Authority
- Run the following command:
#openssl req -new -x509 -keyout ca.key -out ca.crt -days 3650
#openssl req -new -x509 -keyout ca.key -out ca.crt -days 3650Copy to Clipboard Copied! Toggle word wrap Toggle overflow This command requests a new CA pair valid for 3650 days. - Enter a password to protect your CA:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Enter the following details about your organization:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow This information forms the Distinguished Name (DN) in your certificate.
Conclusion
You have created a Certificate Authority. openssl creates two files: ca.key, which is a key that administrators use to sign certificates, and ca.crt, which is the public CA certificate that users obtain to verify the validity of signed certificates they receive. Make sure users accessing your server have a copy of ca.crt so that they can import it into their client's trusted CA store.
E.2. Creating an SSL Certificate
Copy linkLink copied to clipboard!
Summary
The following procedure creates an SSL certificate and signs it with the CA key. SSL/TLS certificates provide a layer of security for accessing your installation over HTTPS. This procedure provides instructions for creating certificates and configuring the server with them.
The following procedure requires
openssl. To install this tool, run the following command on your server:
#yum install openssl
#yum install opensslProcedure E.2. Creating an SSL Certificate
- Create a key for your server:
#openssl genrsa -out ssl.key
#openssl genrsa -out ssl.keyCopy to Clipboard Copied! Toggle word wrap Toggle overflow This creates anssl.keyfile. - Use the key to create a signing request for your certificate:
#openssl req -new -key ssl.key -out ssl.csr
#openssl req -new -key ssl.key -out ssl.csrCopy to Clipboard Copied! Toggle word wrap Toggle overflow The signing request asks for some organization details to form the Distinguished Name (DN) in your certificate.Copy to Clipboard Copied! Toggle word wrap Toggle overflow This creates anssl.csrsigning request file. - Create the signed SSL certificate:
Create the signed SSL certificate:
Create the signed SSL certificate:Copy to Clipboard Copied! Toggle word wrap Toggle overflow opensslasks for your CA key's password.This creates a certificate file namedssl.crt.
Important
The above command may result in the following error:
Procedure E.3. Resolving this error
- Create the index.txt file.
#touch /etc/pki/CA/index.txt
#touch /etc/pki/CA/index.txtCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Create a serial file to label the CA and all subsequent certificates.
#echo '1000' > /etc/pki/CA/serial
#echo '1000' > /etc/pki/CA/serialCopy to Clipboard Copied! Toggle word wrap Toggle overflow
You will only need to do this the first time you set up the SSL certificate. Re-run the command:
#openssl ca -cert ca.crt -keyfile ca.key -out ssl.crt -infiles ssl.csr
#openssl ca -cert ca.crt -keyfile ca.key -out ssl.crt -infiles ssl.csr
The
ssl.crt and ssl.key form the certificate pair that your server uses to encrypt data via HTTPS.
Conclusion
You have created an SSL certificate and signed it with the CA key. openssl creates two files: ca.key, which is a key that administrators use to sign certificates, and ca.crt, which is the public CA certificate that users obtain to verify the validity of signed certificates they receive. Make sure users accessing your server have a copy of the ca.crt so that they can import it into their client's trusted CA store.
E.3. Configuring HTTPS Communication
Copy linkLink copied to clipboard!
Summary
Configure HTTPS to use the SSL certificate key on your system.
Procedure E.4. Configuring HTTPS Communication
- Edit the
/etc/httpd/conf.d/ssl.conffile and modify the following settings:SSLCertificateFile [location of your ssl.crt] SSLCertificateKeyFile [location of your ssl.key]
SSLCertificateFile [location of your ssl.crt] SSLCertificateKeyFile [location of your ssl.key]Copy to Clipboard Copied! Toggle word wrap Toggle overflow - After editing these settings, restart your web server:
#service httpd restart
#service httpd restartCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Conclusion
You have configured HTTPS to use the SSL certificate key on your system.
E.4. Network Security Services (NSS) Database
Copy linkLink copied to clipboard!
Network Security Services (NSS) is a set of open-source cryptography libraries that support SSL. Several Linux tools, such as
cURL, use NSS to verify trusted SSL communication. This process helps a user import the rhsc.cer certificate into the local NSS database.
For an individual user, import the
rhsc.cer certificate using the following command:
$certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "zz Console" -i rhsc.cer
$certutil -d sql:$HOME/.pki/nssdb -A -t TC -n "zz Console" -i rhsc.cer
For all users on a system, import the
rhsc.cer certificate as root using the following command:
#certutil -d sql:/etc/pki/nssdb -A -t TC -n "Red Hat Gluster Storage Console" -i rhsc.cer
#certutil -d sql:/etc/pki/nssdb -A -t TC -n "Red Hat Gluster Storage Console" -i rhsc.cerE.5. Java Keystores
Copy linkLink copied to clipboard!
This appendix demonstrates how to import the X.509 certificate exported from the Red Hat Gluster Storage Console into a new Java keystore file.
This procedure helps a user import the rhsc.cer certificate into a Java keystore. This procedure requires the
keytool management utility from the Java Development Kit (JDK) available for Linux and Windows systems.
Procedure E.5. Import a Certificate into a New Java Keystore
- Access your client machine and locate the
rhsc.cercertificate. - Import the
rhsc.cercertificate using the Javakeytoolmanagement utility.keytool -importcert -v -trustcacerts -keystore restapi.jks -noprompt -alias rhsc -file rhsc.cer
keytool -importcert -v -trustcacerts -keystore restapi.jks -noprompt -alias rhsc -file rhsc.cerCopy to Clipboard Copied! Toggle word wrap Toggle overflow Thekeytoolutility creates a new keystore file namedrestapi.jks. keytoolasks for thekeystorepassword. Enter a password andkeytoolasks to verify it.keytooladds therhsc.cercertificate to the restapi.jks keystore. Usekeytool -listcommand to view the certificate's entry in the keystore:keytool -list -keystore restapi.jks -storepass [password]
keytool -list -keystore restapi.jks -storepass [password]Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Important
Some versions of
keytool parse the certificate incorrectly. If keytool does not recognize the certificate, convert it to a different X.509 format with the openssl tool:
openssl x509 -in rhsc.cer -out rhsc.new -outform [pem|der]
openssl x509 -in rhsc.cer -out rhsc.new -outform [pem|der]Appendix F. Revision History
Copy linkLink copied to clipboard!
| Revision History | |||
|---|---|---|---|
| Revision 3.1-2 | Wed July 29 2015 | ||
| |||
| Revision 3-1-1 | Wed Jul 29 2015 | ||
| |||
| Revision 3.1-0 | Tue July 28 2015 | ||
| |||
Legal Notice
Copy linkLink copied to clipboard!
Copyright © 2013-2014 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}