a3aff12f3e
The List and Get Allocation API allows cloud admin to query with reservation_id in their request. When the parameter is specified in API requests, the API returns allocations related to the reservation. Partially Implements: blueprint resource-allocation-api Change-Id: I87ed410c23f04a17f6c1deeb9ad1e4ab0756a549
535 lines
11 KiB
YAML
535 lines
11 KiB
YAML
# variables in path
|
|
host_id_path:
|
|
description: |
|
|
The ID of the host.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
lease_id_path:
|
|
description: |
|
|
The UUID of the lease.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
|
|
|
|
# variables in query
|
|
allocation_lease_id_query:
|
|
description: |
|
|
Filter allocations results by lease id
|
|
in: query
|
|
required: false
|
|
type: string
|
|
allocation_reservation_id_query:
|
|
description: |
|
|
Filter allocations results by reservation id
|
|
in: query
|
|
required: false
|
|
type: string
|
|
|
|
|
|
# variables in body
|
|
allocation:
|
|
description: |
|
|
An ``allocation`` object. This object describes a mapping
|
|
between resource_id and reservations.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
allocations:
|
|
description: |
|
|
A list of ``allocation`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
created_at:
|
|
description: |
|
|
The date and time when the object was created.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
event:
|
|
description: |
|
|
An ``event`` object.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
event_id:
|
|
description: |
|
|
The UUID of the event.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
event_lease_id:
|
|
description: |
|
|
The UUID of the lease to which the event belongs.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
event_status:
|
|
description: |
|
|
The status of the event.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
event_time:
|
|
description: |
|
|
The date and time of the event.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
event_type:
|
|
description: |
|
|
The type of the event.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
events:
|
|
description: |
|
|
A list of ``event`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
events_optional:
|
|
description: |
|
|
A list of ``event`` objects.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
host:
|
|
description: |
|
|
A ``host`` object.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
host_cpu_info:
|
|
description: |
|
|
Information of the CPU of the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_extra_capability:
|
|
description: |
|
|
The extra capability of the host.
|
|
|
|
.. note:: Any key-value pair can be stored as one of extra capabilities of
|
|
the host.
|
|
in: body
|
|
required: false
|
|
type: any
|
|
host_hypervisor_hostname:
|
|
description: |
|
|
The hypervisor name of the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_hypervisor_type:
|
|
description: |
|
|
The hypervisor type the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_hypervisor_version:
|
|
description: |
|
|
The hypervisor version of the host.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
host_id:
|
|
description: |
|
|
The ID of the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_local_gb:
|
|
description: |
|
|
Gigabytes of the disk of the host.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
host_memory_mb:
|
|
description: |
|
|
Megabytes of the memory of the host.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
host_name:
|
|
description: |
|
|
The name of the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_reservable:
|
|
description: |
|
|
The flag which represents whether the host is reservable or not.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
host_service_name:
|
|
description: |
|
|
The compute service name of the host.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_status:
|
|
description: |
|
|
The status of the host.
|
|
|
|
.. note:: This is null currently.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_trust_id:
|
|
description: |
|
|
The UUID of the trust of the host operator.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
host_vcpus:
|
|
description: |
|
|
The number of the VCPUs of the host.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
hosts:
|
|
description: |
|
|
A list of ``host`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
lease:
|
|
description: |
|
|
A ``lease`` object.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
lease_before_end_date:
|
|
description: |
|
|
The date and time for the before-end-action of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_before_end_date_optional:
|
|
description: |
|
|
The date and time for the before-end-action of the lease.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
lease_degraded:
|
|
description: |
|
|
The flag for reserved resources of the lease.
|
|
This is set True while *missing_resources* or *resources_changed* of
|
|
reservations is set True.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
lease_end_date:
|
|
description: |
|
|
The end date and time of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_end_date_optional:
|
|
description: |
|
|
The end date and time of the lease.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
lease_id:
|
|
description: |
|
|
The UUID of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_name:
|
|
description: |
|
|
The name of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_name_optional:
|
|
description: |
|
|
The name of the lease.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
lease_project_id:
|
|
description: |
|
|
The UUID the project which owns the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_start_date:
|
|
description: |
|
|
The start date and time of the lease.
|
|
|
|
.. note:: If ``now`` is specified, the lease starts immediately.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_start_date_optional:
|
|
description: |
|
|
The start date and time of the lease.
|
|
|
|
.. note:: If ``now`` is specified, the lease starts immediately.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
lease_start_date_resp:
|
|
description: |
|
|
The start date and time of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_status:
|
|
description: |
|
|
The status of the lease.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_trust_id:
|
|
description: |
|
|
The UUID of the trust of the lease owner.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
lease_user_id:
|
|
description: |
|
|
The UUID of the lease owner.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
leases:
|
|
description: |
|
|
A list of ``lease`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
reservation:
|
|
description: |
|
|
A ``reservation`` object.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
reservation_affinity:
|
|
description: |
|
|
The affinity of instances to reserve.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
reservation_affinity_optional:
|
|
description: |
|
|
The affinity of instances to reserve.
|
|
in: body
|
|
required: false
|
|
type: boolean
|
|
reservation_aggregate_id:
|
|
description: |
|
|
The aggregate ID of the reservation.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_allocation:
|
|
description: |
|
|
A list of ``reservation allocation`` objects. The object consists of
|
|
reservation id and its lease_id.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
reservation_amount:
|
|
description: |
|
|
The amount of instances to reserve.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_amount_optional:
|
|
description: |
|
|
The amount of instances to reserve.
|
|
in: body
|
|
required: false
|
|
type: integer
|
|
reservation_before_end:
|
|
description: |
|
|
The before-end-action of the reservation.
|
|
|
|
.. note:: ``default`` and ``snapshot`` actions are supported.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_before_end_optional:
|
|
description: |
|
|
The before-end-action of the reservation.
|
|
|
|
.. note:: ``default`` and ``snapshot`` actions are supported.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
reservation_disk_gb:
|
|
description: |
|
|
Gigabytes of the local disk per the instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_disk_gb_optional:
|
|
description: |
|
|
Gigabytes of the local disk per the instance.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
reservation_flavor_id:
|
|
description: |
|
|
The flavor ID used for launching instances on reserved resources.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_hypervisor_properties:
|
|
description: |
|
|
Properties of the hypervisor to reserve.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_hypervisor_properties_optional:
|
|
description: |
|
|
Properties of the hypervisor to reserve.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_id:
|
|
description: |
|
|
The UUID of the reservation.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_lease_id:
|
|
description: |
|
|
The UUID of the lease to which the reservation belongs.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_max:
|
|
description: |
|
|
The maximum number of hosts to reserve.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_max_optional:
|
|
description: |
|
|
The maximum number of hosts to reserve.
|
|
in: body
|
|
required: false
|
|
type: integer
|
|
reservation_memory_mb:
|
|
description: |
|
|
Megabytes of memory per the instance.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_memory_mb_optional:
|
|
description: |
|
|
Megabytes of memory per the instance.
|
|
in: body
|
|
required: false
|
|
type: integer
|
|
reservation_min:
|
|
description: |
|
|
The minimum number of hosts to reserve.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_min_optional:
|
|
description: |
|
|
The minimum number of hosts to reserve.
|
|
in: body
|
|
required: false
|
|
type: integer
|
|
reservation_missing_resources:
|
|
description: |
|
|
The flag for the capacity of reserved resources.
|
|
It is set True while the amount of reserved resources is less than the
|
|
request.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
reservation_resource_id:
|
|
description: |
|
|
The ID of the resource object of the reservation.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_resource_properties:
|
|
description: |
|
|
Properties of the resource to reserve.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_resource_properties_optional:
|
|
description: |
|
|
Properties of the resource to reserve.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
reservation_resource_type:
|
|
description: |
|
|
The type of the resource to reserve.
|
|
|
|
.. note:: ``physical:host`` and ``virtual:instance`` types are supported.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_resource_type_resp:
|
|
description: |
|
|
The type of the resource to reserve.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_resources_changed:
|
|
description: |
|
|
The flag for changes of reserved resources.
|
|
If it is set True if reserved resources were changed after the lease
|
|
started.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
reservation_server_group_id:
|
|
description: |
|
|
The server group ID specified when launch instances on reserved resources.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_status:
|
|
description: |
|
|
The status of the reservation.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
reservation_vcpus:
|
|
description: |
|
|
The number of VCPUs per the instance.
|
|
in: body
|
|
required: true
|
|
type: integer
|
|
reservation_vcpus_optional:
|
|
description: |
|
|
The number of VCPUs per the instance.
|
|
in: body
|
|
required: false
|
|
type: integer
|
|
reservations:
|
|
description: |
|
|
A list of ``reservation`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
reservations_optional:
|
|
description: |
|
|
A list of ``reservation`` objects.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
updated_at:
|
|
description: |
|
|
The date and time when the object was updated.
|
|
in: body
|
|
required: true
|
|
type: string
|