This endpoint is used to create, update, search or delete global variables information inside a Terrakube organizations, this variables will be injected inside the jobs, workspace variables have priority over global variables if the same name is used.
You need to be part of the administrator Active Directory Group to work with this endpoint
data.attributes.hcl
boolean
Terraform HCL variable type
data.attributes.category
string
Variable type could be TERRAFORM or ENV (Environment Variable)
data.attributes.description
string
Free text
data.type
string
Should be "variable"
data.attributes.key
string
Unique variable name
data.attributes.value
string
Key value
data.attributes.sensitive
boolean
To hide the value when the output is sensitive
{
"data": {
"type": "globalvar",
"attributes": {
"key": "tag_name",
"value": "HolaMundo",
"sensitive": false,
"hcl": false,
"category": "TERRAFORM",
"description": "Azure RG Tag"
}
}
}Creates an item of type globalvar and adds it to globalvar
organization Identifier
Successful response
Deletes an instance of type globalvar
organization Identifier
globalvar Identifier
Successful response
Successful response
No content
Modifies an instance of type globalvar
organization Identifier
globalvar Identifier
Successful response
DELETE /api/v1/organization/{organizationId}/globalvar/{globalvarId} HTTP/1.1
Host:
Accept: */*
Successful response
Successful response
No content
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": "TERRAFORM",
"description": "text",
"hcl": true,
"key": "text",
"sensitive": true,
"value": "text"
},
"relationships": {
"organization": {
"id": "text",
"type": "organization"
}
}
}
}POST /api/v1/organization/{organizationId}/globalvar HTTP/1.1
Host:
Content-Type: application/vnd.api+json
Accept: */*
Content-Length: 220
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": "TERRAFORM",
"description": "text",
"hcl": true,
"key": "text",
"sensitive": true,
"value": "text"
},
"relationships": {
"organization": {
"id": "text",
"type": "organization"
}
}
}
}PATCH /api/v1/organization/{organizationId}/globalvar/{globalvarId} HTTP/1.1
Host:
Content-Type: application/vnd.api+json
Accept: */*
Content-Length: 220
{
"data": {
"type": "text",
"id": "text",
"attributes": {
"category": "TERRAFORM",
"description": "text",
"hcl": true,
"key": "text",
"sensitive": true,
"value": "text"
},
"relationships": {
"organization": {
"id": "text",
"type": "organization"
}
}
}
}Returns the relationship globalvar
organization Identifier
Filters the collection of globalvar using a 'disjoint' RSQL expression
Number of pages to return. Can be used with page[size]
Number of elements per page. Can be used with page[number]
Offset from 0 to start paginating. Can be used with page[limit]
Maximum number of items to return. Can be used with page[offset]
For requesting total pages/records be included in the response page meta data
Successful response
Successful response
{
"data": [
{
"type": "text",
"id": "text",
"attributes": {
"category": null,
"description": null,
"hcl": null,
"key": null,
"sensitive": null,
"value": null
},
"relationships": {
"organization": {
"data": [
null
]
}
}
}
],
"included": [
{
"type": "text",
"id": "text",
"attributes": {},
"relationships": {}
}
]
}GET /api/v1/organization/{organizationId}/globalvar HTTP/1.1
Host:
Accept: */*