Showing project details

GET /v3/projects/{project_id}

Show details of a project with the specified ID.

Source: https://docs.openstack.org/api-ref/identity/v3/index.html?expanded=show-project-details-detail#show-project-details

Request

Parameters

Name	In	Type	Description
`project_id`	path	string	The project ID.
`parents_as_list` (Optional)	query	key-only, no value expected	The parent hierarchy will be included as a list in the response. This list will contain the projects found by traversing up the hierarchy to the top-level project. The returned list will be filtered against the projects the user has an effective role assignment on. New in version 3.4
`subtree_as_list` (Optional)	query	key-only, no value expected	The child hierarchy will be included as a list in the response. This list will contain the projects found by traversing down the hierarchy. The returned list will be filtered against the projects the user has an effective role assignment on. New in version 3.4
`parents_as_ids` (Optional)	query	key-only, no value expected	The entire parent hierarchy will be included as nested dictionaries in the response. It will contain all projects ids found by traversing up the hierarchy to the top-level project. New in version 3.4
`subtree_as_ids` (Optional)	query	key-only, no value expected	The entire child hierarchy will be included as nested dictionaries in the response. It will contain all the projects ids found by traversing down the hierarchy. New in version 3.4
`include_limits` (Optional)	query	key-only, no value expected	It should be used together with `parents_as_list` or `subtree_as_list` filter to add the related project’s limits into the response body.

Example

# curl -ks -H 'Content-Type: application/json' -H 'X-Auth-Token: gAAAAA<...>' \
https://<node_IP_addr>:5000/v3/projects/ec35eb7ceb594ad696839fc867817e4c

Response

Parameters

Name	In	Type	Description
`project`	body	object	A `project` object.
`name`	body	string	The unique name of the project within the owning domain.
`is_domain`	body	boolean	Indicates whether the project also acts as a domain. If set to `true`, this project acts as both a project and domain. As a domain, the project provides a name space in which you can create users, groups, and other projects. If set to `false`, this project behaves as a regular project that contains only resources. New in version 3.6
`description`	body	string	The description of the project.
`domain_id`	body	string	The ID of the domain for the project.
`enabled`	body	boolean	If set to `true`, project is enabled. If set to `false`, project is disabled.
`id`	body	string	The ID for the project.
`links`	body	object	The link to the `project` resource.
`parent_id`	body	string	The ID of the parent for the project. New in version 3.4
`options`	body	object	The resource options for the project. Available resource options are `immutable`.

Status codes

Success

Code	Reason
`200 - OK`	Request was successful.

Error

Code	Reason
`400 - Bad Request`	Some content in the request was invalid.
`401 - Unauthorized`	User must authenticate before making a request.
`403 - Forbidden`	Policy does not allow current user to do this operation.
`404 - Not Found`	The requested resource could not be found.

Example

{
  "project": {
    "is_domain": false,
    "description": "Project description",
    "links": {
      "self": "https://<node_IP_addr>:5000/v3/projects/ec35eb7ceb594ad696839fc867817e4c"
    },
    "tags": [],
    "enabled": true,
    "domain_id": "f2eeaaf15c254d4fa10255796122c8ec",
    "parent_id": "f2eeaaf15c254d4fa10255796122c8ec",
    "id": "ec35eb7ceb594ad696839fc867817e4c",
    "name": "project1"
  }
}