scanning_groups

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

Overview

Name	scanning_groups
Type	Resource
Id	datadog.security.scanning_groups

Fields

The following fields are returned by SELECT queries:

list_scanning_groups

Name	Datatype	Description
id	string	ID of the configuration.
attributes	object	Attributes of the Sensitive Data configuration.
relationships	object	Relationships of the configuration.
type	string	Sensitive Data Scanner configuration type. (default: sensitive_data_scanner_configuration, example: sensitive_data_scanner_configuration)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list_scanning_groups	select	region		List all the Scanning groups in your organization.
create_scanning_group	insert	region		Create a scanning group. The request MAY include a configuration relationship. A rules relationship can be omitted entirely, but if it is included it MUST be null or an empty array (rules cannot be created at the same time). The new group will be ordered last within the configuration.
update_scanning_group	update	group_id, region, data__data, data__meta		Update a group, including the order of the rules. Rules within the group are reordered by including a rules relationship. If the rules relationship is present, its data section MUST contain linkages for all of the rules currently in the group, and MUST NOT contain any others.
delete_scanning_group	delete	group_id, region		Delete a given group.
reorder_scanning_groups	exec	region, data, meta		Reorder the list of groups.

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
group_id	string	The ID of a group of rules.
region	string	(default: datadoghq.com)

SELECT examples

list_scanning_groups

List all the Scanning groups in your organization.

SELECT
id,
attributes,
relationships,
type
FROM datadog.security.scanning_groups
WHERE region = '{{ region }}' -- required
;

INSERT examples

create_scanning_group

Create a scanning group.
The request MAY include a configuration relationship.
A rules relationship can be omitted entirely, but if it is included it MUST be
null or an empty array (rules cannot be created at the same time).
The new group will be ordered last within the configuration.

INSERT INTO datadog.security.scanning_groups (
data__data,
data__meta,
region
)
SELECT 
'{{ data }}',
'{{ meta }}',
'{{ region }}'
RETURNING
data,
meta
;

Manifest

# Description fields are for documentation purposes
- name: scanning_groups
  props:
    - name: region
      value: string
      description: Required parameter for the scanning_groups resource.
    - name: data
      value: object
      description: |
        Data related to the creation of a group.
    - name: meta
      value: object
      description: |
        Meta payload containing information about the API.

UPDATE examples

update_scanning_group

Update a group, including the order of the rules.
Rules within the group are reordered by including a rules relationship. If the rules
relationship is present, its data section MUST contain linkages for all of the rules
currently in the group, and MUST NOT contain any others.

UPDATE datadog.security.scanning_groups
SET 
data__data = '{{ data }}',
data__meta = '{{ meta }}'
WHERE 
group_id = '{{ group_id }}' --required
AND region = '{{ region }}' --required
AND data__data = '{{ data }}' --required
AND data__meta = '{{ meta }}' --required
RETURNING
meta;

DELETE examples

delete_scanning_group

Delete a given group.

DELETE FROM datadog.security.scanning_groups
WHERE group_id = '{{ group_id }}' --required
AND region = '{{ region }}' --required
;

Lifecycle Methods

reorder_scanning_groups

Reorder the list of groups.

EXEC datadog.security.scanning_groups.reorder_scanning_groups 
@region='{{ region }}' --required 
@@json=
'{
"data": "{{ data }}", 
"meta": "{{ meta }}"
}'
;