Resource Attributes

This page lists the available attributes when creating resources with the REST API


Arbitration Profile Attributes

POST /api/arbitration_profiles

Required attributes:

Attribute Type Description

name

string

Name

provider

hash

Provider for the Arbitration Profile, requires an href or id attribute in the hash

Optional attributes:

Attribute Type Description

description

string

Description

availability_zone

hash

Availability Zone for the Arbitration Profile, requires an href or id attribute in the hash


Arbitration Rule Attributes

POST /api/arbitration_rules

Required attributes:

Attribute Type Description

operation

string

Operation

expression

hash

Expression hash

Optional attributes:

Attribute Type Description

description

string

Description

arbitration_profile_id

integer

Id of the Arbitration Profile


Arbitration Settings Attributes

POST /api/arbitration_settings

Required attributes:

Attribute Type Description

name

string

Name

display_name

string

Display Name

Optional attributes:

Attribute Type Description

value

text

Value of Setting (nil if unspecified)


Category Attributes

POST /api/categories

Required attributes:

Attribute Type Description

name

string

Name

description

string

Description

Optional attributes:

Attribute Type Description

example_text

string

Detailed description

show

boolean

Show Category flag

single_value

boolean

Single Value flag

syntax

string

Syntax of value, string, integer or boolean


Blueprint Attributes

POST /api/blueprints
Attribute Type Description

name

string

Name

description

string

Description

Optional attributes:

Attribute Type Description

ui_properties

hash

Blueprint details

status

string

Status

version

string

Version


Chargeback Rate Attributes

POST /api/rates

Required attributes:

Attribute Type Description

chargeback_rate_id

integer

Reference to parent Chargeback

group

string

Group rate belongs to, i.e. cpu, memory, net_io, disk_io, etc.

source

string

The input value for calculation, i.e. allocated, used, etc.

Optional attributes:

Attribute Type Description

description

string

Description of the chargeback rate

enabled

boolean

Rate enabled flag

friendly_rate

string

Friendly name of the rate

metric

string

Metrics, i.e. derived_memory_available, etc.

per_time

string

Measured per time, hourly, daily, weekly, monthly or yearly

per_unit

string

Measured per unit, i.e. megabytes, gigabytes, etc.


Group Attributes

POST /api/groups

Required attributes:

Attribute Type Description

description

string

Description

role

hash

Role the group is assigned to, requires an href, id or name attribute in the hash

tenant

hash

Tenant the group belongs to, requires an href or id attribute in the hash

Optional attributes:

Attribute Type Description

filters

hash

Hash that contains the belongsto and managed arrays of filters to assign to the group.


Orchestration Templates

POST /api/orchestration_templates

Required attributes:

Attribute Type Description

name

string

Name

content

text

Template content

Optional attributes:

Attribute Type Description

type

string

Type

description

string

Description

ems_id

integer

Id of the provider

draft

boolean

true or false

orderable

boolean

true or false


Provider Attributes

POST /api/providers

Required attributes:

Attribute Type Description

name

string

Name of the provider

type

string

Provider class

hostname

string

Hostname of the Provider

Optional attributes:

Attribute Type Description

api_version

string

API Version for communicating with the Provider

credentials

hash

Credentials to use for communicating with the Provider, see Provider Support for examples

host_default_vnc_port_start

integer

Starting VNC port

host_default_vnc_port_end

integer

Ending VNC port

ipaddress

string

IP Address of the Provider

realm

string

Realm of the Provider

zone

hash

In which zone to add provider to, hash needs to include an href or id attribute.

Credentials hash specification attributes are:

Type Auth Types Auth Attributes

ManageIQ::Providers::Amazon::CloudManager

default

userid, password

ManageIQ::Providers::Atomic::ContainerManager

default, password, bearer

userid, password

ManageIQ::Providers::Azure::CloudManager

default

userid, password

ManageIQ::Providers::Kubernetes::ContainerManager

default, password, bearer

userid, password

ManageIQ::Providers::Microsoft::InfraManager

default

userid, password

ManageIQ::Providers::Openshift::ContainerManager

default, password, bearer

userid, password, auth_key

ManageIQ::Providers::Openstack::InfraManager

default, amqp, ssh_keypair

userid, password, auth_key

ManageIQ::Providers::Openstack::CloudManager

default, amqp

userid, password

ManageIQ::Providers::Redhat::InfraManager

default, metrics

userid, password

ManageIQ::Providers::Vmware::InfraManager

default

userid, password

ManageIQ::Providers::Foreman::Provider

default

userid, password

ManageIQ::Providers::Openstack::Provider

default

userid, password


Role Attributes

POST /api/roles

Required Attributes:

Attribute Type Description

name

string

Name of user role

Optional Attributes:

Attribute Type Description

features

array

Features to assign to the role. Array of { "identifier" OR "href" OR "id" : …​ }

settings

hash

Settings for the role, normally: { "restrictions" : { "vms" : "user" OR "user_or_group" } }


Service Attributes

POST /api/services

Required attributes:

Attribute Type Description

name

string

Name

Optional attributes:

Attribute Type Description

description

string

Description

parent_service

hash

Parent service href or id reference


Service Catalog Attributes

POST /api/service_catalogs
Attribute Type Description

name

string

Name of service catalog

description

string

Description of service catalog

Optional attributes:

Attribute Type Description

service_templates

array

Array of Service Template hashes to assign to the new Service Catalog. Hash entries to include the href of the service_templates to assign and must not currently be assigned to any Service Catalog.


Tag Attributes

POST /api/tags

Required attributes:

Attribute Type Description

name

string

Name of tag

description

string

Description of tag

category

hash

Category identifier for which the tag is getting added to, requires an href, id or name attribute in the hash

When adding with a create action on the tags subcollection of the category via /api/categories/:id/tags, the category should not be specified in the resource.


Tenant Attributes

POST /api/tenants

Required attributes:

Attribute Type Description

name

string

Name of Tenant

parent

hash

Parent tenant identifier for which the sub-tenant is getting added to, requires an href or id attribute in the hash

Optional attributes:

Attribute Type Description

description

string

Description of Tenant

domain

string

Domain

logo_file_name

string

Logo file name, must be available via /uploads/logo_file_name

login_logo_file_name

string

Login Logo file name, must be available via /uploads/login_logo_file_name

login_text

string

Login text

subdomain

string

Subdomain


User Attributes

POST /api/users

Required attributes:

Attribute Type Description

userid

string

Username

password

string

Password

name

string

Full Name

group

hash

Group the user belongs to, requires a description, href or id attribute in the hash

Optional attributes:

Attribute Type Description

email

string

E-mail Address