b15a7a7120
Now we just have using V2 API, and we have no plans to add other versions of the API, the current API page entry is redundant [1], this patch will remove it. [1] https://docs.openstack.org/api-ref/accelerator/ Change-Id: Idd6aa49b3d63b4acbda2444d892e28158b011ad5
156 lines
4.6 KiB
YAML
156 lines
4.6 KiB
YAML
# variables in path
|
|
accelerator_request_uuid:
|
|
description: |
|
|
The UUID of one accelerator request.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
deployable_uuid:
|
|
description: |
|
|
The UUID of the deployable.
|
|
This must be a valid UUID otherwise API will return 400.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
device_profile_name:
|
|
description: |
|
|
The display name of a device profile.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
device_profile_uuid:
|
|
description: |
|
|
The UUID of the device_profile for your accelerator request.
|
|
This must be a valid UUID otherwise API will return 400.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
device_uuid:
|
|
description: |
|
|
The UUID of the device.
|
|
This must be a valid UUID otherwise API will return 400.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
|
|
# variables in body
|
|
created:
|
|
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
|
|
device_prof_groups_req:
|
|
description: |
|
|
This is a list of dictionaries to describe requested accelerator resource
|
|
by users, where users use keys to describe the resource_classes or traits
|
|
and values to indicate its quantity or property. This is intentionally
|
|
similar to extra_specs in nova flavor, and uses the same keywords for
|
|
resources and traits. The key-value pair can either be a resource/trait
|
|
or a Cyborg property. Cyborg property is of the form
|
|
"accel:<key>": "<value>". The valid key-value pairs can be found
|
|
`below <https://opendev.org/openstack/cyborg-specs/src/branch/master/specs/train/approved/device-profiles.rst#valid-accel-keys>`_.
|
|
in: body
|
|
required: true
|
|
type: a list of dictionaries
|
|
device_prof_groups_resp:
|
|
description: |
|
|
This is a list of dictionaries to describe returned accelerator resource
|
|
by users, where users use keys to describe the resource_classes or traits
|
|
and values to indicate its quantity or property. This is intentionally
|
|
similar to extra_specs in nova flavor, and uses the same keywords for
|
|
resources and traits. The key-value pair can either be a resource/trait
|
|
or a Cyborg property. Cyborg property is of the form
|
|
"accel:<key>": "<value>". The valid key-value pairs can be found
|
|
`below <https://opendev.org/openstack/cyborg-specs/src/branch/master/specs/train/approved/device-profiles.rst#valid-accel-keys>`_.
|
|
in: body
|
|
required: true
|
|
type: a list of dictionaries
|
|
device_prof_name_req:
|
|
description: |
|
|
The display name of a device profile.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
device_prof_name_resp:
|
|
description: |
|
|
The display name of a device profile.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
device_profile:
|
|
description: |
|
|
A list of ``device profile`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
device_profile_description:
|
|
description: |
|
|
A free form description of the device profile. Limited to 255 characters
|
|
in length.
|
|
type: string
|
|
in: body
|
|
required: false
|
|
device_profiles:
|
|
description: |
|
|
A list of ``device profiles`` objects.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
device_rp_uuid_bind_unbind_req:
|
|
description: |
|
|
UUID of the target accelerator (resource provider) for bind or unbind of
|
|
one accelerator request.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
hostname_bind_unbind_req:
|
|
description: |
|
|
The name of the target host for bind or unbind of one accelerator request.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
instance_project_id_bind_unbind_req:
|
|
description: |
|
|
Project id of the target instance for bind or unbind of one accelerator request.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
min_version: 2.1
|
|
instance_uuid_bind_unbind_req:
|
|
description: |
|
|
UUID of the target instance for bind or unbind of one accelerator request.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
links:
|
|
description: |
|
|
Links to the resources in question.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
updated:
|
|
description: |
|
|
The date and time when the resource was updated. 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
|