# variables in header
openstack-request-id:
  description: >
    A unique ID for tracking the request. The request ID associated with the request
    appears in the log lines for that request.
  in: header
  required: false
  type: string
valence-api-header-version:
  description: |
    Specific API microversion used to generate this response.
  in: header
  required: true
  type: string
x-openstack-valence-api-version:
  description: >
    A request SHOULD include this header to indicate to the Valence API controller what
    version the client supports. The controller will transform the response object into
    compliance with the requested version, if it is supported, or return a
    406 Not Supported error.
    If this header is not supplied, the server will default to ``min_version``
    in all responses.
  in: header
  required: true
  type: string
node_ident:
  description: |
    The UUID or name of composed node.
  in: path
  required: true
  type: string
pod_uuid:
  description: |
    The UUID of pod manager.
  in: path
  required: true
  type: string
node_index:
  description: |
    The redfish index of composed node.
  in: path
  required: true
  type: string
system_ident:
  description: |
    The UUID or name of Compute System.
  in: path
  required: true
  type: string
#
fields:
  description: |
    One or more fields to be returned in response.
    For example, the following request return only the "uuid", "node_state"
    for each node

    ::
    GET /v1/nodes?fields=uuid,node-state
  in: query
  required: true
  type: array

# variables in common
created_at:
  description: |
    The date and time when the resource was created. The date and time
    stamp format is `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
    ::

        CCYY-MM-DDThh:mm:ss±hh:mm

    For example, ``2015-08-27T09:49:58-05:00``. The ``±hh:mm``
    value, if included, is the time zone as an offset from UTC.  In
    the previous example, the offset value is ``-05:00``.
  in: body
  required: true
  type: string
flavor_uuid:
  description: |
    UUID for flavor.
  in: body
  required: false
  type: string
flavor_name:
  description: |
    Name for specified flavor.
  in: body
  required: false
  type: string
flavor_ram:
  description: |
    RAM requirement for flavor.
  in: body
  required: false
  type: string
flavor_processor_model:
  description: |
    Processor model specified by flavor.
  in: body
  required: false
  type: string
flavor_cores:
  description: |
    Number of processor cores specified by flavor.
  in: body
  required: false
  type: string
id:
  description: |
    Major API version, eg, "v1"
  in: body
  required: true
  type: string
links:
  description: |
    A list of relative links, includes the slef and bookmark links.
  in: body
  required: true
  type: array
node_attach_type:
  description: |
    type of action , including "attach" or "detach".
  in: body
  required: true
  type: string
node_boot_enabled:
  description: |
    The value of this describe the state of boot source override feature,
    including "Once", "Continuous".
  in: body
  required: true
  type: string
node_boot_source:
  description: |
    The value of this contain the source to boot the composed node, including
    "Pxe", "Hdd", "None".
  in: body
  required: true
  type: string
node_chassis_id:
  description: |
    The chassis id show the location id of a composed node.
    ex: Rack12
  in: body
  required: true
  type: string
node_description:
  description: |
    Description for new created composed node
  in: body
  required: true
  type: string
node_health_status:
  description: |
    Composed node health status, support "ok", "warning", "critical"
  in: body
  required: true
  type: string
node_memory_asset:
  description: |
    Memory asset (Object) info.
  in: body
  required: true
  type: array
node_metadata:
  description: |
    Metadata of composed system, usually admin use this info to do basic
    deployment in DataCenter.
  in: body
  required: true
  type: array
node_name:
  description: |
    Name of composed name (a human-readable string)
  in: body
  required: true
  type: string
node_network_asset:
  description: |
    Network asset (Object) info.
  in: body
  required: true
  type: array
node_power_state:
  description: |
    The current composed node power state including
    "On", "Off", "PoweringOn" ,"PoweringOff"
  in: body
  required: true
  type: string
node_processor_asset:
  description: |
    Processor asset (Object) info.
  in: body
  required: true
  type: array
node_properties:
  description: |
    Dictionary of properties of a composed node.
  in: body
  required: false
  type: dictionary
node_property:
  description: |
    Property of composed node including processor , memory , storage info.
  in: body
  required: true
  type: array
node_provision_state:
  description: |
    The composed node state value set by other orchestration tool, use this value
    to help with orchestration software know its proviision progress.
  in: body
  required: true
  type: string
node_request_description:
   description: |
     A description for a new composed node
   in: body
   required: false
   type: string
node_request_name:
  description: |
    Name of new composed node
  in: body
  required: true
  type: string
node_reset_type:
  description: |
    Reset type for a composed , supported "ForceOn", "On", "ForceOff", "GracefulRestart"
  in: body
  required: true
  type: string
node_state:
  description: |
    The current composed node state including
    "Assembling", "Allocating", "Assembling" ,"Failed", "Assembled"
  in: body
  required: true
  type: string
node_storage_asset:
  description: |
    Storage asset (Object) info.
  in: body
  required: true
  type: array
node_target_boot_source:
  description: |
    The target ( pending ) boot source for next power reset.
  in: body
  required: true
  type: string
node_url_id:
  description: |
    The URL id point to redfish API.
    Ex: while url_id is "node1" ,the full path talk to redfish service should be  "/redfish/v1/Nodes/node1"
  in: body
  required: true
  type: string
node_uuid:
  description: |
    UUID of composed node
  in: body
  required: true
  type: string
pod_auth_info:
  description: |
    Authentication info for Pod manager
  in: body
  required: true
  type: string
pod_description:
  description: |
    Pod manager description.
  in: body
  required: true
  type: string
pod_location_id:
  description: |
    Pod manager location id string info.
  in: body
  required: true
  type: string
pod_name:
  description: |
    UUID of Pod manager.
  in: body
  required: true
  type: string
pod_redfish_link:
  description: |
    Redfish link of this Pod manager, come from PodM redfish API.
    Ex: "/redfish/v1/Chassis/pod1"
  in: body
  required: true
  type: string
pod_status:
  description: |
    Pod manager status
rack_id:
  description: |
    The ID of a hardware rack.
    in: body
    required: true
    type: string
rack_name:
  description: |
    Name of a hardware rack.
  in: body
  required: true
  type: string
rack_systems:
  description: |
    Compute systems contained by a rack.
  in: body
  required: true
  type: string
rack_manufacturer:
  description: |
    The manufacturer for a rack.
  in: body
  required: true
  type: string
rack_model:
  description: |
    The model for a rack.
  in: body
  required: true
  type: string
rack_description:
  description: |
    The description of a rack.
  in: body
  required: true
  type: string
rack_serial_number:
  description: |
    The serial number of a rack.
  in: body
  required: true
  type: string
pooled_group_id:
  description: |
    The group id of pooled resource, resource can only be assigned to composed node while id matched.
    This id combine with Switch doamin id + Fabric Id as a unique id
  in: body
  required: true
  type: string
resource_entity_capability:
  description: |
   The resource capability , includes volume size, protocol
  in: body
  required: true
  type: array
resource_health_status:
  description: |
    The healt status of pooled resource, supported "OK" , "Critical" , "Warning"
  in: body
  required: true
  type: string
resource_link:
  description: |
    The Entity link of resource, this keep the string of EntityLink in EndPoint schema of Redfish.
  in: body
  required: true
  type: string
resource_state:
  description: |
    The resource state , supported "allocated", "available", "busy", "failed"
  in: body
  required: true
  type: string
resource_type:
  description: |
    The resource type , supported "storage", "network"
  in: body
  required: true
  type: string
resource_uuid:
  description: |
    UUID of pooled resources, each pooled resources come with generated UUID.
  in: body
  required: true
  type: string
system_assettag:
  description: |
    Asset Tag value of Compute System
  in: body
  required: true
  type: string
system_chassis_id:
  description: |
    The chassis id that contained Compute system can be used to support location id
    allocation if user want to specific a resource send to redfish service, ex: Sled2, meaning
    it point to "/redfish/v1/Chassis/Sled2".
  in: body
  required: true
  type: string
system_memory_object:
  description: |
    The memory (object) inventory of Compute system
  in: body
  required: true
  type: array
system_name:
  description: |
    Name of Compute System (a human-readable string)
  in: body
  required: true
  type: string
system_network_object:
  description: |
    The network (object) inventory of Compute System.
  in: body
  required: true
  type: array
system_power_state:
  description: |
    The current Compute System power state including "On","Off"
    "PoweredOn", "PoweredOff"
  in: body
  required: true
  type: array
system_processor_object:
  description: |
    The Processor (object) inventory of a Compute System.
  in: body
  required: true
  type: array
system_storage_object:
  description: |
    The Storage (object) inventory of a Compute System.
  in: body
  required: string
  type: array
system_url_id:
  description: |
    The URL id point to  redfish API.
    For example, while url_id is "system1" ,the full path talk to redfish service should be  "/redfish/v1/Systems/system1"
  in: body
  required: true
  type: string
system_uuid:
  description: |
    UUID of Compute System
  in: body
  required: true
  type: string
updated_at:
  description: |
    The date and time when the resource was created. The date and time
    stamp format is `ISO 8601 <https://en.wikipedia.org/wiki/ISO_8601>`_
    ::

        CCYY-MM-DDThh:mm:ss±hh:mm

    For example, ``2015-08-27T09:49:58-05:00``. The ``±hh:mm``
    value, if included, is the time zone as an offset from UTC.  In
    the previous example, the offset value is ``-05:00``.
  in: body
  required: true
  type: string
version:
  description: |
    Versioning of this API response, eg. "1.0".
  in: body
  required: true
  type: string
versions:
  description: |
    Array of information about currently supported versions.
  in: body
  required: true
  type: array
x-openstack-valence-api-max-version:
  description: |
    Maximum API microversion supported by this endpoint, eg. "1.2"
  in: body
  required: true
  type: string
x-openstack-valence-api-min-version:
  description: |
    Minimum API microversion supported by this endpoint, eg. "1.0"
  in: body
  required: true
  type: string