Skip to content

Release 4.145.0 #764

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 9 commits into from
Feb 21, 2023
152 changes: 131 additions & 21 deletions openapi.yaml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
openapi: 3.0.1
info:
version: 4.144.1
version: 4.145.0

title: Linode API
description: |
Expand Down Expand Up @@ -6029,7 +6029,7 @@ paths:
type: string
pattern: \A(\*\.)?([a-zA-Z0-9-_]{1,63}\.)+([a-zA-Z]{2,3}\.)?([a-zA-Z]{2,16}|xn--[a-zA-Z0-9]+)\Z
minLength: 1
maxLength: 255
maxLength: 253
description: >
The new domain for the clone. Domain labels cannot be longer than
63 characters and must conform to [RFC1035](https://tools.ietf.org/html/rfc1035).
Expand Down Expand Up @@ -11071,6 +11071,116 @@ paths:
- lang: CLI
source: >
linode-cli lke kubeconfig-delete 12345
/lke/clusters/{clusterId}/regenerate:
parameters:
- name: clusterId
in: path
description: ID of the target Kubernetes cluster.
required: true
schema:
type: integer
x-linode-cli-command: lke
post:
operationId: postLKEClusterRegenerate
x-linode-cli-action: regenerate
security:
- personalAccessToken: []
- oauth:
- lke:read_write
tags:
- Linode Kubernetes Engine (LKE)
summary: Kubernetes Cluster Regenerate
description: |
Regenerate the Kubeconfig file and/or the service account token for a Cluster.

This is a helper command that allows performing both the [Kubeconfig Delete](#kubeconfig-delete) and the [Service Token Delete](#service-token-delete) actions with a single request.

When using this command, at least one of `kubeconfig` or `servicetoken` is required.

**Note**: When regenerating a service account token, the Cluster's control plane components and Linode CSI drivers are also restarted and configured with the new token. High Availability Clusters should not experience any disruption, while standard Clusters may experience brief control plane downtime while components are restarted.
requestBody:
description: The Kubernetes Cluster Regenerate request object.
content:
application/json:
schema:
properties:
kubeconfig:
type: boolean
default: false
example: true
description: |
Whether to delete and regenerate the Kubeconfig file for this Cluster.
servicetoken:
type: boolean
default: false
example: true
description: |
Whether to delete and regenerate the service access token for this Cluster.
responses:
'200':
description: Regenerate request successful.
content:
application/json:
schema:
type: object
default:
$ref: '#/components/responses/ErrorResponse'
x-code-samples:
- lang: Shell
source: >
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"kubeconfig": true;
"servicetoken": true
}' \
https://api.linode.com/v4/lke/clusters/12345/regenerate
- lang: CLI
source: >
linode-cli lke regenerate 12345 \
--kubeconfig true \
--servicetoken true
/lke/clusters/{clusterId}/servicetoken:
parameters:
- name: clusterId
in: path
description: ID of the target Kubernetes cluster.
required: true
schema:
type: integer
x-linode-cli-command: lke
delete:
operationId: postLKECServiceTokenDelete
x-linode-cli-action: service-token-delete
security:
- personalAccessToken: []
- oauth:
- lke:read_write
tags:
- Linode Kubernetes Engine (LKE)
summary: Service Token Delete
description: |
Delete and regenerate the service account token for a Cluster.

**Note**: When regenerating a service account token, the Cluster's control plane components and Linode CSI drivers are also restarted and configured with the new token. High Availability Clusters should not experience any disruption, while standard Clusters may experience brief control plane downtime while components are restarted.
responses:
'200':
description: Service token deleted and regenerated successfully.
content:
application/json:
schema:
type: object
default:
$ref: '#/components/responses/ErrorResponse'
x-code-samples:
- lang: Shell
source: >
curl -H "Authorization: Bearer $TOKEN" \
-X DELETE \
https://api.linode.com/v4/lke/clusters/12345/servicetoken
- lang: CLI
source: >
linode-cli lke service-token-delete 12345
/lke/versions:
x-linode-cli-command: lke
get:
Expand Down Expand Up @@ -16231,23 +16341,23 @@ paths:
- lang: Shell
source: >
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"label": "my-object-storage-key",
"bucket_access": [
{
"cluster": "ap-south-1",
"bucket_name": "bucket-example-1",
"permissions": "read_write"
},
{
"cluster": "us-east-1",
"bucket_name": "bucket-example-2",
"permissions": "read_only"
}
]
}' \
https://api.linode.com/v4/object-storage/keys
-H "Authorization: Bearer $TOKEN" \
-X POST -d '{
"label": "my-object-storage-key",
"bucket_access": [
{
"cluster": "ap-south-1",
"bucket_name": "bucket-example-1",
"permissions": "read_write"
},
{
"cluster": "us-east-1",
"bucket_name": "bucket-example-2",
"permissions": "read_only"
}
]
}' \
https://api.linode.com/v4/object-storage/keys
- lang: CLI
source: >
linode-cli object-storage keys-create \
Expand Down Expand Up @@ -20803,7 +20913,7 @@ components:
type: string
pattern: \A(\*\.)?([a-zA-Z0-9-_]{1,63}\.)+([a-zA-Z]{2,3}\.)?([a-zA-Z]{2,16}|xn--[a-zA-Z0-9]+)\Z
minLength: 1
maxLength: 255
maxLength: 253
description: >
The domain this Domain represents. Domain labels cannot be longer than
63 characters and must conform to [RFC1035](https://tools.ietf.org/html/rfc1035).
Expand Down Expand Up @@ -20840,7 +20950,7 @@ components:
description:
type: string
minLength: 1
maxLength: 255
maxLength: 253
description: |
A description for this Domain. This is for display purposes only.
example: null
Expand Down