tags

Creates, updates, deletes, gets or lists a tags resource.

Overview

Name	tags
Type	Resource
Id	cloudflare.cloudforce_one.tags

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	insert	account_id, value		Creates a new tag to be used accross threat events.
patch_tag_update	update	account_id, tag_uuid		Updates a Source-of-Truth tag by UUID.
delete_tag_delete	delete	account_id, tag_uuid		Deletes a Source-of-Truth tag by UUID.

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.
tag_uuid	string	Tag UUID.

INSERT examples

create

Creates a new tag to be used accross threat events.

INSERT INTO cloudflare.cloudforce_one.tags (
activeDuration,
actorCategory,
aliasGroupNames,
aliasGroupNamesInternal,
analyticPriority,
attributionConfidence,
attributionOrganization,
categoryUuid,
externalReferenceLinks,
internalDescription,
motive,
opsecLevel,
originCountryISO,
priority,
sophisticationLevel,
value,
account_id
)
SELECT 
'{{ activeDuration }}',
'{{ actorCategory }}',
'{{ aliasGroupNames }}',
'{{ aliasGroupNamesInternal }}',
{{ analyticPriority }},
'{{ attributionConfidence }}',
'{{ attributionOrganization }}',
'{{ categoryUuid }}',
'{{ externalReferenceLinks }}',
'{{ internalDescription }}',
'{{ motive }}',
'{{ opsecLevel }}',
'{{ originCountryISO }}',
{{ priority }},
'{{ sophisticationLevel }}',
'{{ value }}' /* required */,
'{{ account_id }}'
RETURNING
activeDuration,
actorCategory,
aliasGroupNames,
aliasGroupNamesInternal,
analyticPriority,
attributionConfidence,
attributionOrganization,
categoryName,
categoryUuid,
externalReferenceLinks,
internalDescription,
motive,
opsecLevel,
originCountryISO,
priority,
sophisticationLevel,
uuid,
value
;

Manifest

# Description fields are for documentation purposes
- name: tags
props:
  - name: account_id
    value: "{{ account_id }}"
    description: Required parameter for the tags resource.
  - name: activeDuration
    value: "{{ activeDuration }}"
  - name: actorCategory
    value: "{{ actorCategory }}"
  - name: aliasGroupNames
    value:
      - "{{ aliasGroupNames }}"
  - name: aliasGroupNamesInternal
    value:
      - "{{ aliasGroupNamesInternal }}"
  - name: analyticPriority
    value: {{ analyticPriority }}
  - name: attributionConfidence
    value: "{{ attributionConfidence }}"
  - name: attributionOrganization
    value: "{{ attributionOrganization }}"
  - name: categoryUuid
    value: "{{ categoryUuid }}"
  - name: externalReferenceLinks
    value:
      - "{{ externalReferenceLinks }}"
  - name: internalDescription
    value: "{{ internalDescription }}"
  - name: motive
    value: "{{ motive }}"
  - name: opsecLevel
    value: "{{ opsecLevel }}"
  - name: originCountryISO
    value: "{{ originCountryISO }}"
  - name: priority
    value: {{ priority }}
  - name: sophisticationLevel
    value: "{{ sophisticationLevel }}"
  - name: value
    value: "{{ value }}"

UPDATE examples

patch_tag_update

Updates a Source-of-Truth tag by UUID.

UPDATE cloudflare.cloudforce_one.tags
SET 
activeDuration = '{{ activeDuration }}',
actorCategory = '{{ actorCategory }}',
aliasGroupNames = '{{ aliasGroupNames }}',
aliasGroupNamesInternal = '{{ aliasGroupNamesInternal }}',
analyticPriority = {{ analyticPriority }},
attributionConfidence = '{{ attributionConfidence }}',
attributionOrganization = '{{ attributionOrganization }}',
categoryUuid = '{{ categoryUuid }}',
externalReferenceLinks = '{{ externalReferenceLinks }}',
internalDescription = '{{ internalDescription }}',
motive = '{{ motive }}',
opsecLevel = '{{ opsecLevel }}',
originCountryISO = '{{ originCountryISO }}',
priority = {{ priority }},
sophisticationLevel = '{{ sophisticationLevel }}',
value = '{{ value }}'
WHERE 
account_id = '{{ account_id }}' --required
AND tag_uuid = '{{ tag_uuid }}' --required
RETURNING
activeDuration,
actorCategory,
aliasGroupNames,
aliasGroupNamesInternal,
analyticPriority,
attributionConfidence,
attributionOrganization,
categoryName,
categoryUuid,
externalReferenceLinks,
internalDescription,
motive,
opsecLevel,
originCountryISO,
priority,
sophisticationLevel,
uuid,
value;

DELETE examples

delete_tag_delete

Deletes a Source-of-Truth tag by UUID.

DELETE FROM cloudflare.cloudforce_one.tags
WHERE account_id = '{{ account_id }}' --required
AND tag_uuid = '{{ tag_uuid }}' --required
;