Modify Project Principals

Modify Project Principals

Modifies principals assigned to a project by id.

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

The id of the project.

Query Parameters
boolean
validatePrincipals
Optional

If true, a limit of 20 principals is enforced. Additionally each principal is validated in the Identity provider and important rules for group email formats are enforced.

boolean
syncPrincipals
Optional
Constraints: default: true

syncPrincipals

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.


Request Body

Principals

ProjectPrincipalsAssignment of type(s) application/json
Required
{
    "modify": [
        {
            "id": "c493a95e-c4d1-4496-8595-e73902701c95:fe69d7ca-40a6-4de5-8f33-d462f4656938",
            "email": "[email protected]",
            "type": "user",
            "role": "member"
        }
    ],
    "remove": [
        {
            "id": "c493a95e-c4d1-4496-8595-e73902701c95:fe69d7ca-40a6-4de5-8f33-d462f4656938",
            "email": "[email protected]",
            "type": "user",
            "role": "member"
        }
    ]
}
array of object
modify
Optional

Principal to add or change role in project.

array of object
remove
Optional

Principal to remove from project.

Authentication
This operation uses the following authentication methods.
Responses
200

'Success' with the Project

Returns Project of type(s) */*
"Project Object"
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.


400

Invalid Request - bad data

Operation doesn't return any data structure

403

Forbidden, the user lacks permissions

Operation doesn't return any data structure

404

'Not found' if no project with the provided id

Returns Project of type(s) */*
"Project Object"
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.


Code Samples
COPY
                    curl -X PATCH -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '{}'