doh
Creates, updates, deletes, gets or lists a doh resource.
Overview
| Name | doh |
| Type | Resource |
| Id | cloudflare.zero_trust.doh |
Fields
The following fields are returned by SELECT queries:
- list
Get your Zero Trust organization DoH settings response
| Name | Datatype | Description |
|---|---|---|
id | string | UUID. (example: f174e90a-fafe-4643-bbbc-4a0ed4fc8415) |
name | string | The name of the service token. (example: CI/CD token) |
client_id | string | The Client ID for the service token. Access will check for this value in the CF-Access-Client-ID request header. (example: 88bf3b6d86161464f6509f7219099e57.access.example.com) |
created_at | string (date-time) | (example: 2014-01-01T05:20:00.12345Z) |
doh_jwt_duration | string | The duration the DoH JWT is valid for. Must be in the format 300ms or 2h45m. Valid time units are: ns, us (or µs), ms, s, m, h. Note that the maximum duration for this setting is the same as the key rotation period on the account. |
duration | string | The duration for how long the service token will be valid. Must be in the format 300ms or 2h45m. Valid time units are: ns, us (or µs), ms, s, m, h. The default is 1 year in hours (8760h). (default: 8760h, example: 60m) |
expires_at | string (date-time) | (example: 2014-01-01T05:20:00.12345Z) |
last_seen_at | string (date-time) | (example: 2014-01-01T05:20:00.12345Z) |
updated_at | string (date-time) | (example: 2014-01-01T05:20:00.12345Z) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
list | select | account_id | Returns the DoH settings for your Zero Trust organization. | |
update | replace | account_id | Updates the DoH settings for your Zero Trust organization. |
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 |
|---|---|---|
account_id | string | The Cloudflare account ID. |
SELECT examples
- list
Returns the DoH settings for your Zero Trust organization.
SELECT
id,
name,
client_id,
created_at,
doh_jwt_duration,
duration,
expires_at,
last_seen_at,
updated_at
FROM cloudflare.zero_trust.doh
WHERE account_id = '{{ account_id }}' -- required
;
REPLACE examples
- update
Updates the DoH settings for your Zero Trust organization.
REPLACE cloudflare.zero_trust.doh
SET
doh_jwt_duration = '{{ doh_jwt_duration }}',
service_token_id = '{{ service_token_id }}'
WHERE
account_id = '{{ account_id }}' --required
RETURNING
errors,
messages,
result,
success;