Project policy API

Summary

Project policies describe a set of actions one account can perform when it was associated with a grant for a project.

The following actions can be used in the projectActions fields of this API:

• ViewComponent grants read access to a template
• CreateComponent allows creating new templates in a project
• UpdateComponent allows uploading new versions for existing templates in a project
• DeleteComponent allows deleting templates from a project
• ViewInstance allows querying existing workers of a template belonging to the project
• CreateInstance allows launching new workers of a template in the project
• UpdateInstance allows manipulating existing workers of a template belonging to the project
• DeleteInstance allows deleting workers of a template belonging to the project
• ViewProjectGrants allows listing the existing grants of the project
• CreateProjectGrants allows creating new grants for the project
• DeleteProjectGrants allows deleting existing grants of the project

Get a project policy

Response format:

{


  "id": "2b41858e-a327-4e63-9539-ff9b123c88a2",


  "name": "a policy",


  "projectActions": ["ViewComponent", "ViewInstance"]


}

Explanation

Returns a given project policy by it’s ID. Project policy identifiers are used in project grants.

Example cURL:

curl 'https://release.api.golem.cloud/v1/project-policies/2b41858e-a327-4e63-9539-ff9b123c88a2'


     -H 'Authorization: Bearer 03f17466-202f-43ac-86cc-52e6c6a42d2d'

Create project policy

Request format:

{


  "name": "a policy",


  "projectActions": ["ViewComponent", "ViewInstance"]


}

Response format:

{


  "id": "2b41858e-a327-4e63-9539-ff9b123c88a2",


  "name": "a policy",


  "projectActions": ["ViewComponent", "ViewInstance"]


}

Explanation

Creates a new project policy and returns the object describing it, including the newly created policy’s id.

Example cURL:

curl -X POST


     'https://release.api.golem.cloud/v1/project-policies'


     -H 'Content-Type: application/json'


     -d '{"name": "a policy", "projectActions": ["ViewComponent", "ViewInstance"]}' 


     -H 'Authorization: Bearer 03f17466-202f-43ac-86cc-52e6c6a42d2d'

Project policy API errors

All project policy endpoints can return with the following errors: