Bases: object
Delete an existing project.
Raises keystone.exception.ProjectNotFound: | |
---|---|
if project_id does not exist |
Get a project by ID.
Returns: | project_ref |
---|---|
Raises keystone.exception.ProjectNotFound: | |
if project_id does not exist |
Check if a project is a leaf in the hierarchy.
Parameters: | project_id – the driver will check if this project is a leaf in the hierarchy. |
---|---|
Raises keystone.exception.ProjectNotFound: | |
if project_id does not exist |
List project ids for the provided list of domain ids.
Parameters: | domain_ids – list of domain ids |
---|---|
Returns: | a list of project ids owned by the specified domain ids. |
This method is used internally by the assignment manager to bulk read a set of project ids given a list of domain ids.
List all parents from a project by its ID.
Parameters: | project_id – the driver will list the parents of this project. |
---|---|
Returns: | a list of project_refs or an empty list. |
Raises keystone.exception.ProjectNotFound: | |
if project_id does not exist |
List projects in the system.
Parameters: | hints – filter hints which the driver should implement if at all possible. |
---|---|
Returns: | a list of project_refs or an empty list. |
List projects for the provided list of ids.
Parameters: | project_ids – list of ids |
---|---|
Returns: | a list of project_refs. |
This method is used internally by the assignment manager to bulk read a set of projects given their ids.
List projects in the domain.
Parameters: | domain_id – the driver MUST only return projects within this domain. |
---|---|
Returns: | a list of project_refs or an empty list. |
List all projects in the subtree of a given project.
Parameters: | project_id – the driver will get the subtree under this project. |
---|---|
Returns: | a list of project_refs or an empty list |
Raises keystone.exception.ProjectNotFound: | |
if project_id does not exist |
Update an existing project.
Raises: |
|
---|
Bases: keystone.resource.backends.base.ResourceDriverBase
Removed or redefined methods from V8.
Move the abstract methods of any methods removed or modified in later versions of the driver from ResourceDriverBase to here. We maintain this so that legacy drivers, which will be a subclass of ResourceDriverV8, can still reference them.
Create a new domain.
Raises keystone.exception.Conflict: | |
---|---|
if the domain_id or domain name already exists |
Create a new project.
Parameters: |
|
---|
Project schema:
type: object
properties:
id:
type: string
name:
type: string
domain_id:
type: string
description:
type: string
enabled:
type: boolean
parent_id:
type: string
is_domain:
type: boolean
required: [id, name, domain_id]
additionalProperties: true
If project doesn’t match the schema the behavior is undefined.
The driver can impose requirements such as the maximum length of a field. If these requirements are not met the behavior is undefined.
Raises keystone.exception.Conflict: | |
---|---|
if the project id already exists or the name already exists for the domain_id. |
Delete an existing domain.
Raises keystone.exception.DomainNotFound: | |
---|---|
if domain_id does not exist |
Get a domain by ID.
Returns: | domain_ref |
---|---|
Raises keystone.exception.DomainNotFound: | |
if domain_id does not exist |
Get a domain by name.
Returns: | domain_ref |
---|---|
Raises keystone.exception.DomainNotFound: | |
if domain_name does not exist |
Get a tenant by name.
Returns: | tenant_ref |
---|---|
Raises keystone.exception.ProjectNotFound: | |
if a project with the tenant_name does not exist within the domain |
List domains in the system.
Parameters: | hints – filter hints which the driver should implement if at all possible. |
---|---|
Returns: | a list of domain_refs or an empty list. |
List domains for the provided list of ids.
Parameters: | domain_ids – list of ids |
---|---|
Returns: | a list of domain_refs. |
This method is used internally by the assignment manager to bulk read a set of domains given their ids.
Update an existing domain.
Raises: |
|
---|
Bases: keystone.resource.backends.base.ResourceDriverBase
New or redefined methods from V8.
Add any new V9 abstract methods (or those with modified signatures) to this class.
Create a new project.
Parameters: |
|
---|
Project schema:
type: object
properties:
id:
type: string
name:
type: string
domain_id:
type: [string, null]
description:
type: string
enabled:
type: boolean
parent_id:
type: string
is_domain:
type: boolean
required: [id, name, domain_id]
additionalProperties: true
If the project doesn’t match the schema the behavior is undefined.
The driver can impose requirements such as the maximum length of a field. If these requirements are not met the behavior is undefined.
Raises keystone.exception.Conflict: | |
---|---|
if the project id already exists or the name already exists for the domain_id. |
Delete a given list of projects.
Deletes a list of projects. Ensures no project on the list exists after it is successfully called. If an empty list is provided, the it is silently ignored. In addition, if a project ID in the list of project_ids is not found in the backend, no exception is raised, but a message is logged.
Get a project by name.
Returns: | project_ref |
---|---|
Raises keystone.exception.ProjectNotFound: | |
if a project with the project_name does not exist within the domain |
Bases: keystone.resource.backends.base.ResourceDriverV9
Wrapper class to supported a V8 legacy driver.
In order to support legacy drivers without having to make the manager code driver-version aware, we wrap legacy drivers so that they look like the latest version. For the various changes made in a new driver, here are the actions needed in this wrapper:
This wrapper contains the following support for newer manager code:
List a project’s ancestors.
The current manager expects the ancestor tree to end with the project acting as the domain (since that’s now the top of the tree), but a legacy driver will not have that top project in their projects table, since it’s still in the domain table. Hence we lift the algorithm for traversing up the tree from the driver to here, so that our version of get_project() is called, which will fetch the “project” from the right table.
List projects and/or domains.
We use the hints filter to determine whether we are listing projects, domains or both.
If the filter includes domain_id==None, then we should only list domains (convert to a project acting as a domain) since regular projects always have a non-None value for domain_id.
Likewise, if the filter includes domain_id==<non-None value>, then we should only list projects.
If there is no domain_id filter, then we need to do a combained listing of domains and projects, converting domains to projects acting as a domain.