4.1. Creating traits

PUT /traits/{name}

Insert a new custom trait. If the trait already exists, 204 is returned. This API call requires custom parameters that are only supported in Virtuozzo Hybrid Infrastructure.

There are two kinds of traits: the standard traits and the custom traits. The standard traits are interoperable across different OpenStack cloud deployments. The definition of standard traits comes from the os-traits library. The standard traits are read-only in the placement API which means that the user cannot modify any standard traits through API. The custom traits are used by admin users to manage the non-standard qualitative information of resource providers.

A custom trait name for Virtuozzo Hybrid Infrastructure looks like CUSTOM_HCI_<UUID>, where the <UUID> must be generated using Python’s uuid4() function as follows:

>>> str(uuid.uuid4()).upper().replace('-', '')

So a complete name would be


Source: https://docs.openstack.org/api-ref/placement/?expanded=update-resource-provider-traits-detail,delete-traits-detail,list-resource-provider-traits-detail#update-traits

4.1.1. Request

Name In Type Description
name path string The name of a trait.
display_name body string A human-readable trait name to be displayed in the admin panel.
description body string A human-readable trait description to be displayed in the admin panel. Example

curl -ks -X PUT -H 'Content-Type: application/json' -H 'OpenStack-API-Version: placement 1.32' -H 'X-Auth-Token: gAAAAA<...>' -d '
    "display_name": "placement2",
    "description": "Sample placement #2"
}' https://<node_IP_addr>:8780/traits/CUSTOM_HCI_0A7F6A35E650420CB30200A8359861D9

4.1.2. Response Status codes Success

Code Reason
201 - Created Resource was created and is ready to use.
204 - No Content The server has fulfilled the request. Error

Code Reason
400 - Bad Request Some content in the request was invalid.