rw-project - User documentation

Schema Globals

Global Schema Type
rw_ypbc_Rwmon_RwProject_t_schema
Global Schema Pointer
rw_ypbc_Rwmon_RwProject_g_schema

rw-project data

This yang module defines project-based tenancy for RIFT.ware. Authorization for project access is defined in terms of RIFT.ware's Role-Based Access Control (RBAC) model.

rw-project:project

Configuration and state for individual projects. RIFT.ware applications and projects are expected to augment this list in order to add configuration for projects that is specific to the product or application. As such, this list contains minimal data defined in this yang module. When augmenting this element, other yang modules should prefer to define containers with the same name as the augmenting module. (Augmenting RIFT.ware modules should prefer to augment without the rw prefix [for new features], or should prefer to augment the augmented container of an existing augment, to ease future adoption and/or standardization.)

Key Identifiers:
XPath Path
/rw-project:project
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']
RW.REST URI Path
/rw-project:project/STRING

Fields
NameTypeDescription
nameSTRINGName of the project.
descriptionSTRINGInformation about project
project-configCONTAINERGeneral Project configuration supported by all products.
project-stateCONTAINERGeneral Project operational state supported by all products.
nfvi-metricsCONTAINER
alarmCONTAINER

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rw-project:project-config

General Project configuration supported by all products.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-config
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-config
RW.REST URI Path
/rw-project:project/STRING/project-config

Fields
NameTypeDescription
userLISTThe list of Users who have been assigned Roles within this Project.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rw-project:user

The list of Users who have been assigned Roles within this Project.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-config/rw-project:user
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-config/rw-project:user[rw-project:user-name='STRING'][rw-project:user-domain='STRING']
RW.REST URI Path
/rw-project:project/STRING/project-config/user/STRING,STRING

Fields
NameTypeDescription
user-domainLEAFREFThe user domain. This is the source of the user identity. Different domains may duplicate a user-name, but such users would be considered distinct by RIFT.ware.
user-nameLEAFREFThe user name. The syntax of this name depends on the domain. For example, if the domain is a login name, it might be limited to alphanumeric characters. However, if the domain is email address, the syntax could include additional characters, such as the at(@) sign.
roleLISTThe list of Roles the User has been assigned.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rw-project:role

The list of Roles the User has been assigned.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-config/rw-project:user/rw-project:role
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-config/rw-project:user[rw-project:user-name='STRING'][rw-project:user-domain='STRING']/rw-project:role[rw-project:role='STRING']
RW.REST URI Path
/rw-project:project/STRING/project-config/user/STRING,STRING/role/STRING

Fields
NameTypeDescription
roleSTRINGThe Role, independent of Keys.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rw-project:project-state

General Project operational state supported by all products.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-state
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-state
RW.REST URI Path
/rw-project:project/STRING/project-state

Fields
NameTypeDescription
userLISTThe state of Users who have been assigned Roles within this Project.
roleLISTThe set of Roles that may be configured into /rw-project:project/rw-project:config/rw-project:user/ rw-project:role.

JSON Sample

XML Sample

rw-project:user

The state of Users who have been assigned Roles within this Project.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-state/rw-project:user
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-state/rw-project:user[rw-project:user-name='STRING'][rw-project:user-domain='STRING']
RW.REST URI Path
/rw-project:project/STRING/project-state/user/STRING,STRING

Fields
NameTypeDescription
user-domainSTRINGThe user domain. This is the source of the user identity. Different domains may duplicate a user-name, but such users would be considered distinct by RIFT.ware.
user-nameSTRINGThe user name. The syntax of this name depends on the domain. For example, if the domain is a login name, it might be limited to alphanumeric characters. However, if the domain is some kind of email address, the syntax could include assitional characters, such as the at sign.
roleLISTThe state of the Roles the User has been assigned.

JSON Sample

XML Sample

rw-project:role

The state of the Roles the User has been assigned.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-state/rw-project:user/rw-project:role
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-state/rw-project:user[rw-project:user-name='STRING'][rw-project:user-domain='STRING']/rw-project:role[rw-project:role='STRING']
RW.REST URI Path
/rw-project:project/STRING/project-state/user/STRING,STRING/role/STRING

Fields
NameTypeDescription
roleSTRINGThe Role, independent of Keys.
stateSTRINGThe assignment of a User to a Role may be an asynchronous operation. This value indicates whether the Role assignment is active. If the value is 'active', then the assignment is complete and active. Any other value indicates that Role assignment is in a transitional or failed state, as described in the value.

JSON Sample

XML Sample

rw-project:role

The set of Roles that may be configured into /rw-project:project/rw-project:config/rw-project:user/ rw-project:role.

Key Identifiers:
XPath Path
/rw-project:project/rw-project:project-state/rw-project:role
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rw-project:project-state/rw-project:role[rw-project:role='STRING']
RW.REST URI Path
/rw-project:project/STRING/project-state/role/STRING

Fields
NameTypeDescription
roleSTRINGThe Role, independent of Keys.
descriptionSTRINGA description of the Role.

JSON Sample

XML Sample

rwmon:nfvi-metrics

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics

Fields
NameTypeDescription
timestampDECIMAL64This is the time when the metric was captured. The timestamp is represented as the number of seconds since the beginning of the Unix epoch.
vcpuCONTAINER
memoryCONTAINER
storageCONTAINER
external-portsCONTAINER
internal-portsCONTAINER
networkCONTAINER

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:vcpu

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:vcpu
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:vcpu
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/vcpu

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
totalUINT64The total number of VCPUs available.
utilizationDECIMAL64The VCPU utilization (percentage).

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:memory

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:memory
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:memory
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/memory

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
usedUINT64The amount of memory (bytes) currently in use.
totalUINT64The amount of memory (bytes) available.
utilizationDECIMAL64The memory utilization (percentage).

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:storage

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:storage
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:storage
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/storage

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
usedUINT64The amount of storage (bytes) currently in use.
totalUINT64The amount of storage (bytes) available.
utilizationDECIMAL64The storage utilization (percentage).

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:external-ports

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:external-ports
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:external-ports
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/external-ports

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
totalUINT64The total number of external ports.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:internal-ports

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:internal-ports
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:internal-ports
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/internal-ports

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
totalUINT64The total number of internal ports.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:network

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:network
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:network
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/network

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
incomingCONTAINER
outgoingCONTAINER

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:incoming

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:network/rwmon:incoming
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:network/rwmon:incoming
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/network/incoming

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
bytesUINT64The cumulative number of incoming bytes.
packetsUINT64The cumulative number of incoming packets.
byte-rateDECIMAL64The current incoming byte-rate (bytes per second).
packet-rateDECIMAL64The current incoming packet (packets per second).

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:outgoing

Key Identifiers:
XPath Path
/rw-project:project/rwmon:nfvi-metrics/rwmon:network/rwmon:outgoing
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:nfvi-metrics/rwmon:network/rwmon:outgoing
RW.REST URI Path
/rw-project:project/STRING/rwmon:nfvi-metrics/network/outgoing

Fields
NameTypeDescription
labelSTRINGLabel to show in UI
bytesUINT64The cumulative number of outgoing bytes.
packetsUINT64The cumulative number of outgoing packets.
byte-rateDECIMAL64The current outgoing byte-rate (bytes per second).
packet-rateDECIMAL64The current outgoing packet (packets per second).

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:alarm

Key Identifiers:
XPath Path
/rw-project:project/rwmon:alarm
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:alarm
RW.REST URI Path
/rw-project:project/STRING/rwmon:alarm

Fields
NameTypeDescription
alarm-idSTRINGThis field is reserved for the identifier assigned by the VIM provider
nameSTRINGA human readable string to identify the alarm
descriptionSTRINGA description of this alarm
vdur-idSTRINGThe identifier of the VDUR that the alarm is associated with
actionsCONTAINER
repeatBOOLEANThis flag indicates whether the alarm should be repeatedly emitted while the associated threshold has been crossed.
enabledBOOLEANThis flag indicates whether the alarm has been enabled or disabled.
severityENUMA measure of the importance or urgency of the alarm
metricENUMThe metric to be tracked by this alarm.
statisticENUMThe type of metric statistic that is tracked by this alarm
operationENUMThe relational operator used to define whether an alarm should be triggered in certain scenarios, such as if the metric statistic goes above or below a specified value.
valueDECIMAL64This value defines the threshold that, if crossed, will trigger the alarm.
periodUINT32The period defines the length of time (seconds) that the metric data are collected over in oreder to evaluate the chosen statistic.
evaluationsUINT32Defines the length of time (seconds) in which metric data are collected in order to evaluate the chosen statistic.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:actions

Key Identifiers:
XPath Path
/rw-project:project/rwmon:alarm/rwmon:actions
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:alarm/rwmon:actions
RW.REST URI Path
/rw-project:project/STRING/rwmon:alarm/actions

Fields
NameTypeDescription
okLIST
insufficient-dataLIST
alarmLIST

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:ok

Key Identifiers:
XPath Path
/rw-project:project/rwmon:alarm/rwmon:actions/rwmon:ok
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:alarm/rwmon:actions/rwmon:ok[rwmon:url='STRING']
RW.REST URI Path
/rw-project:project/STRING/rwmon:alarm/actions/ok/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:insufficient-data

Key Identifiers:
XPath Path
/rw-project:project/rwmon:alarm/rwmon:actions/rwmon:insufficient-data
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:alarm/rwmon:actions/rwmon:insufficient-data[rwmon:url='STRING']
RW.REST URI Path
/rw-project:project/STRING/rwmon:alarm/actions/insufficient-data/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon:alarm

Key Identifiers:
XPath Path
/rw-project:project/rwmon:alarm/rwmon:actions/rwmon:alarm
XPath Keyed Path
/rw-project:project[rw-project:name='STRING']/rwmon:alarm/rwmon:actions/rwmon:alarm[rwmon:url='STRING']
RW.REST URI Path
/rw-project:project/STRING/rwmon:alarm/actions/alarm/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

rwmon - User documentation

Schema Globals

Global Schema Type
rw_ypbc_Rwmon_Rwmon_t_schema
Global Schema Pointer
rw_ypbc_Rwmon_Rwmon_g_schema