bb8b4bf5a5
While we should not start using this for cloning things in the gate yet, the opendev.org links provide for a nicer browsing experience already even though the service is in beta. Go ahead and swap our browsing links. While in there, remove some masakari references to github links to the source code. Masakari now publishes api docs to developer.openstack.org so there is no need to point people to source code for api docs. Change-Id: I14afa3476f9832ef433ec744e888348fc9a359e3
2.9 KiB
Managing Profiles
A profile type can be treated as the meta-type of a Profile object. A registry of profile types is built when the Cluster service starts. When creating a Profile object, you will indicate the profile type used in its spec property.
List Profiles
To examine the list of profiles:
../../examples/clustering/profile.py
When listing profiles, you can specify the sorting option using the
sort parameter and you can do pagination using the
limit and marker parameters.
Full example: manage profile
Create Profile
When creating a profile, you will provide a dictionary with keys and values specified according to the profile type referenced.
../../examples/clustering/profile.py
Optionally, you can specify a metadata keyword argument
that contains some key-value pairs to be associated with the
profile.
Full example: manage profile
Find Profile
To find a profile based on its name or ID:
../../examples/clustering/profile.py
The Cluster service doesn't allow updating the spec of a
profile. The only way to achieve that is to create a new profile.
Full example: manage profile
Get Profile
To get a profile based on its name or ID:
../../examples/clustering/profile.py
Full example: manage profile
Update Profile
After a profile is created, most of its properties are immutable.
Still, you can update a profile's name and/or
metadata.
../../examples/clustering/profile.py
The Cluster service doesn't allow updating the spec of a
profile. The only way to achieve that is to create a new profile.
Full example: manage profile
Delete Profile
A profile can be deleted after creation, provided that it is not referenced by any active clusters or nodes. If you attempt to delete a profile that is still in use, you will get an error message.
../../examples/clustering/profile.py