Share this page

# URIs

Resources are identified by URIs. This topic explains how to use URIs when working with the ALM Octane REST API.

In this topic:

## URI syntax

Resources are identified by URIs:

- URIs are used to uniquely identify ALM Octane resources.

- URIs follow STD66 / RFC 3986.

- URIs are case sensitive, including entity and field names. For example, the field id is correct, but ID is incorrect.

- URIs have the following generic syntax:

  <scheme name>:<hierarchical identifier>[?<query>]

Note: For the syntax for specifying parameters in URIs, see Variables and values.

Back to top

## Scheme name

Scheme is mandatory.

The http/https schemes are the only ones supported.

Back to top

## Hierarchical identifiers

The hierarchical identifier is mandatory.

The hierarchical identifier has the following generic syntax:

//<authority><path>

Begins with two slashes ("//").

Authority | Authority is mandatory. Authority has the following generic syntax: <host name>[:<port number>] Host name is separated from the port number with a colon ( : ).
Host name | Host name is mandatory. Host name can be defined by the domain name (DNS domain). Host name can be defined by an IP.
Port number | Port number is optional. Port number is a 16-bit integer. Port number is separated from host name by a colon (:).
Path | Path is mandatory. Path has the following generic syntax: [[/<Segment Name>]] Path represents a sequence of segments. Segments are separated by a slash (/).

Back to top

## Queries and other URI clauses

Here are guidelines for using queries and other clauses in the URI.

- Queries and other clauses are optional.

- Queries have the following generic syntax:

  ?<parameter name>=<parameter value>[[&<parameter name>=<parameter value>]]

- Separated from hierarchical part by a question mark (?).

- Queries are organized in parameter name/value pairs.

- Pairs are separated by ampersands (&).

Parameters | Parameters contain a name and a value. Parameter names and parameter values are separated by an equals sign (=) Parameter names are case sensitive. Parameter values are generally not case sensitive.

The following clauses can also be appended to a URI:

- Select fields (fields)

- Sort results (order_by)

- Query

Back to top

See also:

- Interactive API client
- The ALM Octane model
- Collections
- Instances (Entities)
- Relations

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ValueEdge & ALM Octane Help Center ValueEdge ALM Octane Help 16.0.100-16.0.400 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: