Get Project

Get Project

Retrieves a project by id.

Request
URI
GET
https://vra-interop-222-139.lvn.broadcom.net/project-service/api/projects/{id}
COPY
Path Parameters
string
id
Required

The id of the project.

Query Parameters
string of array
withAnyPermission
Optional

Optional permissions that, if granted to the users, allow them access to the proper set of projects. If the user actually has any of those permissions, the 'excludeViewer' parameter has no effect.

string
apiVersion
Optional
Constraints: default: 2019-01-15

The version of the API in yyyy-MM-dd format. For versioning information refer to /project-service/api/about.


Authentication
This operation uses the following authentication methods.
Responses
200

'Success' with the Project

Returns Project of type(s) */*
{
    "id": "string",
    "name": "my-name",
    "description": "my-description",
    "orgId": "string",
    "administrators": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "members": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "viewers": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "supervisors": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "users": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "auditors": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "advancedUsers": [
        {
            "email": "[email protected]",
            "type": "user"
        }
    ],
    "constraints": {
        "network": {
            "conditions": [
                {
                    "type": "TAG",
                    "enforcement": "HARD",
                    "occurrence": "MUST_OCCUR",
                    "expression": {
                        "key": "key",
                        "value": "value"
                    }
                }
            ]
        }
    },
    "properties": {
        "myproperty": "enforcement",
        "__projectPlacementPolicy": "SPREAD",
        "__namingTemplate": "my-resource-template",
        "__allowTerraformCloudzoneMapping": "true"
    },
    "cost": {
        "cost": "number",
        "costSyncTime": "2011-12-03T10:15:30Z",
        "costUnit": "USD",
        "message": "string",
        "code": "string"
    },
    "operationTimeout": 0,
    "sharedResources": false
}
string
id
Optional

Id of the project.

string
name
Required
Constraints: minLength: 0 maxLength: 255

A human-friendly name used as an identifier in APIs that support this option.

string
description
Optional
Constraints: minLength: 0 maxLength: 2000

A human-friendly description.

string
orgId
Optional

The id of the org this project belongs to.

array of object
administrators
Optional

List of administrator users associated with the project. Only administrators can manage project's configuration.

array of object
members
Optional

List of member users associated with the project.

array of object
viewers
Optional

List of viewer users associated with the project.

array of object
supervisors
Optional

List of supervisor users associated with the project.

array of object
users
Optional

List of users associated with the project.

array of object
auditors
Optional

List of auditor users associated with the project.

array of object
advancedUsers
Optional

List of advanced user users associated with the project.

object
constraints
Optional

List of constraints of the project.

object
properties
Optional

List of properties of the project, to be applied to any resource provisioned within the project.

The property with key __projectPlacementPolicy shows what is the placement policy for the resources provisioned in this project, which can be 1 of only 2 possible values DEFAULT or SPREAD. If not specified, it is set as DEFAULT.

The property with key __namingTemplate specifies a custom naming template for resources provisioned in this project.

The property with key __allowTerraformCloudzoneMapping shows if the project allows Terraform cloudzone mapping. It can be set to either true or false. By default, it is set to false.

object
cost
Optional

A representation of a project cost.

integer As int64 As int64
operationTimeout
Optional

The timeout that should be used for Blueprint operations and Provisioning tasks. The timeout is in seconds.

boolean
sharedResources
Optional

Specifies whether the resources in this projects are shared or not. Only allowed for classic tenants.


403

Forbidden, the user lacks permissions

Operation doesn't return any data structure

404

'Not found' if no project with the provided id

Operation doesn't return any data structure

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/project-service/api/projects/{id}