Actions
The actions operations of the v1 API.
Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
The org cache: Actions cache and BuildKit cache usage, the free part, the limit and the monthly estimate. Only usage above the free part is billed.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
Usage, limit and cost
application/json- response
The org cache, as the public API shows it. Sizes in bytes (1 GB = 1e9), amounts in EUR.
actions_bytes*integerBytes of actions/cache entries.
int64build_cache_bytes*integerBytes of the BuildKit layer cache of the org's builds.
int64custom_limit*booleanThe org picked its own limit (otherwise the free amount).
demo*booleanA demo organization: a fixed 1 GB limit, never billed.
free_bytes*integerNever billed.
int64limit_bytes*integerWhat the cache is held to; unused for 7 days or over it, the oldest items are removed.
int64limit_monthly_estimate*stringEUR a month with the cache filled to the limit.
max_bytes*integerThe highest limit the org may pick.
int64monthly_estimate*stringEUR a month at the current usage.
price_per_gb_month?|EUR per GB-month above the free part; absent when unpriced.
total_bytes*integerBoth together: what the limit holds.
int64curl 'https://api.a-line.cloud/v1/actions/cache' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key'{ "actions_bytes": 0, "build_cache_bytes": 0, "custom_limit": true, "demo": true, "free_bytes": 0, "limit_bytes": 0, "limit_monthly_estimate": "string", "max_bytes": 0, "monthly_estimate": "string", "price_per_gb_month": "string", "total_bytes": 0}Try it: use a key with the least scope; requests go straight from your browser to the API. The key stays in this tab's memory and is gone on reload.
Lowering it evicts the oldest items at once.
api_keyAuthorizationBearer <alc_ API key>An A-Line.cloud API key, sent as Authorization: Bearer alc_.... Create keys in the dashboard; sessions are not accepted on /v1.
A new org cache limit.
application/json- body
A new org cache limit.
cache_limit_gb*integerWhole GB, at least the free amount and at most the max.
int64The cache at the new limit
application/json- response
The org cache, as the public API shows it. Sizes in bytes (1 GB = 1e9), amounts in EUR.
actions_bytes*integerBytes of actions/cache entries.
int64build_cache_bytes*integerBytes of the BuildKit layer cache of the org's builds.
int64custom_limit*booleanThe org picked its own limit (otherwise the free amount).
demo*booleanA demo organization: a fixed 1 GB limit, never billed.
free_bytes*integerNever billed.
int64limit_bytes*integerWhat the cache is held to; unused for 7 days or over it, the oldest items are removed.
int64limit_monthly_estimate*stringEUR a month with the cache filled to the limit.
max_bytes*integerThe highest limit the org may pick.
int64monthly_estimate*stringEUR a month at the current usage.
price_per_gb_month?|EUR per GB-month above the free part; absent when unpriced.
total_bytes*integerBoth together: what the limit holds.
int64curl -X PATCH 'https://api.a-line.cloud/v1/actions/cache' \ -H 'Authorization: Bearer alc_test_EXAMPLE_not_a_real_key' \ -H 'Content-Type: application/json' \ -d '{"cache_limit_gb":1}'{ "actions_bytes": 0, "build_cache_bytes": 0, "custom_limit": true, "demo": true, "free_bytes": 0, "limit_bytes": 0, "limit_monthly_estimate": "string", "max_bytes": 0, "monthly_estimate": "string", "price_per_gb_month": "string", "total_bytes": 0}