integrations

Creates, updates, deletes, gets or lists an integrations resource.

Overview

Name	integrations
Type	Resource
Id	cloudflare.zero_trust.integrations

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
create_entry	insert	account_id, enabled, entry_id		Integration entries can't be created, this will update an existing integration entry. This is needed for our generated terraform API.
edit	update	integration_id, account_id		Updates a configured device posture integration.
update_entry	replace	account_id, entry_id, enabled		Updates a DLP entry.
update	replace	account_id, integration_id, tenant_url, active		Overwrite the reference_id, tenant_url, and active values with the ones provided.
delete_entry	delete	account_id, entry_id		This is a no-op as integration entires can't be deleted but is needed for our generated terraform API.

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.
entry_id	string (uuid)
integration_id	string (uuid)

INSERT examples

create_entry

Integration entries can't be created, this will update an existing integration entry. This is needed for our generated terraform API.

INSERT INTO cloudflare.zero_trust.integrations (
enabled,
entry_id,
profile_id,
account_id
)
SELECT 
{{ enabled }} /* required */,
'{{ entry_id }}' /* required */,
'{{ profile_id }}',
'{{ account_id }}'
RETURNING
errors,
messages,
result,
success
;

Manifest

# Description fields are for documentation purposes
- name: integrations
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the integrations resource.
  - name: enabled
    value: {{ enabled }}
  - name: entry_id
    value: "{{ entry_id }}"
  - name: profile_id
    value: "{{ profile_id }}"
    description: |
      This field is not used as the owning profile. For predefined entries it is already set to a predefined profile.

UPDATE examples

edit

Updates a configured device posture integration.

UPDATE cloudflare.zero_trust.integrations
SET 
config = '{{ config }}',
interval = '{{ interval }}',
name = '{{ name }}',
type = '{{ type }}'
WHERE 
integration_id = '{{ integration_id }}' --required
AND account_id = '{{ account_id }}' --required
RETURNING
errors,
messages,
result,
success;

REPLACE examples

update_entry

Updates a DLP entry.

REPLACE cloudflare.zero_trust.integrations
SET 
enabled = {{ enabled }}
WHERE 
account_id = '{{ account_id }}' --required
AND entry_id = '{{ entry_id }}' --required
AND enabled = {{ enabled }} --required
RETURNING
errors,
messages,
result,
success;

update

Overwrite the reference_id, tenant_url, and active values with the ones provided.

REPLACE cloudflare.zero_trust.integrations
SET 
active = {{ active }},
reference_id = '{{ reference_id }}',
tenant_url = '{{ tenant_url }}'
WHERE 
account_id = '{{ account_id }}' --required
AND integration_id = '{{ integration_id }}' --required
AND tenant_url = '{{ tenant_url }}' --required
AND active = {{ active }} --required
RETURNING
errors,
messages,
result,
success;

DELETE examples

delete_entry

This is a no-op as integration entires can't be deleted but is needed for our generated terraform API.

DELETE FROM cloudflare.zero_trust.integrations
WHERE account_id = '{{ account_id }}' --required
AND entry_id = '{{ entry_id }}' --required
;