credentials
Creates, updates, deletes, gets or lists a credentials resource.
Overview
| Name | credentials |
| Type | Resource |
| Id | linode.managed.credentials |
Fields
The following fields are returned by SELECT queries:
- get_managed_credential
- get_managed_credentials
The requested Managed Credential.
| Name | Datatype | Description |
|---|---|---|
id | integer | Read-only This Credential's unique ID. |
label | string | The unique label for this Credential. This is for display purposes only. (example: prod-password-1, pattern: [a-zA-Z0-9-_ .]{2,75}) |
last_decrypted | string (date-time) | Read-only The date this Credential was last decrypted by a member of Linode special forces. (example: 2018-01-01T00:01:01) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_managed_credential | select | Returns a single Managed Credential. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... | ||
get_managed_credentials | select | page, page_size | Returns a paginated list of Managed Credentials on your Account. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... | |
post_managed_credential | insert | data__label, data__password | Creates a Managed Credential. A Managed Credential is stored securely to allow Linode special forces to access your Managed Services and resolve issues. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... | |
put_managed_credential | replace | Updates the label of a Managed Credential. This operation does not update the username and password for a Managed Credential. To do this, run the Update a managed credential's username and password) operation instead. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... | ||
post_managed_credential_revoke | exec | Deletes a Managed Credential. Linode special forces will no longer have access to this Credential when attempting to resolve issues. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... | ||
post_managed_credential_username_password | exec | password | Updates the username and password for a Managed Credential. This operation can only be accessed by the unrestricted users of an account. Learn more... Learn more... |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
page | integer | The page of a collection to return. |
page_size | integer | The number of items to return per page. |
SELECT examples
- get_managed_credential
- get_managed_credentials
Returns a single Managed Credential.
This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
SELECT
id,
label,
last_decrypted
FROM linode.managed.credentials;
Returns a paginated list of Managed Credentials on your Account.
This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
SELECT
data,
page,
pages,
results
FROM linode.managed.credentials
WHERE page = '{{ page }}'
AND page_size = '{{ page_size }}';
INSERT examples
- post_managed_credential
- Manifest
Creates a Managed Credential. A Managed Credential is stored securely to allow Linode special forces to access your Managed Services and resolve issues.
This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
INSERT INTO linode.managed.credentials (
data__label,
data__password,
data__username
)
SELECT
'{{ label }}' --required,
'{{ password }}' --required,
'{{ username }}'
RETURNING
id,
label,
last_decrypted
;
# Description fields are for documentation purposes
- name: credentials
props:
- name: label
value: string
description: >
The unique label for this Credential. This is for display purposes only.
- name: password
value: string
description: >
The password to use when accessing the Managed Service.
- name: username
value: string
description: >
The username to use when accessing the Managed Service.
REPLACE examples
- put_managed_credential
Updates the label of a Managed Credential. This operation does not update the username and password for a Managed Credential. To do this, run the Update a managed credential's username and password) operation instead. This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
REPLACE linode.managed.credentials
SET
data__label = '{{ label }}'
WHERE
RETURNING
id,
label,
last_decrypted;
Lifecycle Methods
- post_managed_credential_revoke
- post_managed_credential_username_password
Deletes a Managed Credential. Linode special forces will no longer have access to this Credential when attempting to resolve issues.
This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
EXEC linode.managed.credentials.post_managed_credential_revoke
;
Updates the username and password for a Managed Credential.
This operation can only be accessed by the unrestricted users of an account.
Learn more...
Learn more...
EXEC linode.managed.credentials.post_managed_credential_username_password
@@json=
'{
"password": "{{ password }}",
"username": "{{ username }}"
}';