security_profiles

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

Overview

Name	security_profiles
Type	Resource
Id	google.networksecurity.security_profiles

Fields

The following fields are returned by SELECT queries:

projects_locations_security_profiles_get

Name	Datatype	Description
name	string	Immutable. Identifier. Name of the SecurityProfile resource. It matches pattern projects|organizations/*/locations/{location}/securityProfiles/{security_profile}.
createTime	string (google-datetime)	Output only. Resource creation timestamp.
customInterceptProfile	object	The custom TPPI configuration for the SecurityProfile. (id: CustomInterceptProfile)
customMirroringProfile	object	The custom Packet Mirroring v2 configuration for the SecurityProfile. (id: CustomMirroringProfile)
description	string	Optional. An optional description of the profile. Max length 512 characters.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
labels	object	Optional. Labels as key value pairs.
threatPreventionProfile	object	The threat prevention configuration for the SecurityProfile. (id: ThreatPreventionProfile)
type	string	Immutable. The single ProfileType that the SecurityProfile resource configures. (PROFILE_TYPE_UNSPECIFIED, THREAT_PREVENTION, CUSTOM_MIRRORING, CUSTOM_INTERCEPT, URL_FILTERING)
updateTime	string (google-datetime)	Output only. Last resource update timestamp.
urlFilteringProfile	object	The URL filtering configuration for the SecurityProfile. (id: UrlFilteringProfile)

organizations_locations_security_profiles_get

Name	Datatype	Description
name	string	Immutable. Identifier. Name of the SecurityProfile resource. It matches pattern projects|organizations/*/locations/{location}/securityProfiles/{security_profile}.
createTime	string (google-datetime)	Output only. Resource creation timestamp.
customInterceptProfile	object	The custom TPPI configuration for the SecurityProfile. (id: CustomInterceptProfile)
customMirroringProfile	object	The custom Packet Mirroring v2 configuration for the SecurityProfile. (id: CustomMirroringProfile)
description	string	Optional. An optional description of the profile. Max length 512 characters.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
labels	object	Optional. Labels as key value pairs.
threatPreventionProfile	object	The threat prevention configuration for the SecurityProfile. (id: ThreatPreventionProfile)
type	string	Immutable. The single ProfileType that the SecurityProfile resource configures. (PROFILE_TYPE_UNSPECIFIED, THREAT_PREVENTION, CUSTOM_MIRRORING, CUSTOM_INTERCEPT, URL_FILTERING)
updateTime	string (google-datetime)	Output only. Last resource update timestamp.
urlFilteringProfile	object	The URL filtering configuration for the SecurityProfile. (id: UrlFilteringProfile)

projects_locations_security_profiles_list

Name	Datatype	Description
name	string	Immutable. Identifier. Name of the SecurityProfile resource. It matches pattern projects|organizations/*/locations/{location}/securityProfiles/{security_profile}.
createTime	string (google-datetime)	Output only. Resource creation timestamp.
customInterceptProfile	object	The custom TPPI configuration for the SecurityProfile. (id: CustomInterceptProfile)
customMirroringProfile	object	The custom Packet Mirroring v2 configuration for the SecurityProfile. (id: CustomMirroringProfile)
description	string	Optional. An optional description of the profile. Max length 512 characters.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
labels	object	Optional. Labels as key value pairs.
threatPreventionProfile	object	The threat prevention configuration for the SecurityProfile. (id: ThreatPreventionProfile)
type	string	Immutable. The single ProfileType that the SecurityProfile resource configures. (PROFILE_TYPE_UNSPECIFIED, THREAT_PREVENTION, CUSTOM_MIRRORING, CUSTOM_INTERCEPT, URL_FILTERING)
updateTime	string (google-datetime)	Output only. Last resource update timestamp.
urlFilteringProfile	object	The URL filtering configuration for the SecurityProfile. (id: UrlFilteringProfile)

organizations_locations_security_profiles_list

Name	Datatype	Description
name	string	Immutable. Identifier. Name of the SecurityProfile resource. It matches pattern projects|organizations/*/locations/{location}/securityProfiles/{security_profile}.
createTime	string (google-datetime)	Output only. Resource creation timestamp.
customInterceptProfile	object	The custom TPPI configuration for the SecurityProfile. (id: CustomInterceptProfile)
customMirroringProfile	object	The custom Packet Mirroring v2 configuration for the SecurityProfile. (id: CustomMirroringProfile)
description	string	Optional. An optional description of the profile. Max length 512 characters.
etag	string	Output only. This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding.
labels	object	Optional. Labels as key value pairs.
threatPreventionProfile	object	The threat prevention configuration for the SecurityProfile. (id: ThreatPreventionProfile)
type	string	Immutable. The single ProfileType that the SecurityProfile resource configures. (PROFILE_TYPE_UNSPECIFIED, THREAT_PREVENTION, CUSTOM_MIRRORING, CUSTOM_INTERCEPT, URL_FILTERING)
updateTime	string (google-datetime)	Output only. Last resource update timestamp.
urlFilteringProfile	object	The URL filtering configuration for the SecurityProfile. (id: UrlFilteringProfile)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_security_profiles_get	select	projectsId, locationsId, securityProfilesId		Gets details of a single SecurityProfile.
organizations_locations_security_profiles_get	select	organizationsId, locationsId, securityProfilesId		Gets details of a single SecurityProfile.
projects_locations_security_profiles_list	select	projectsId, locationsId	pageSize, pageToken	Lists SecurityProfiles in a given project and location.
organizations_locations_security_profiles_list	select	organizationsId, locationsId	pageSize, pageToken	Lists SecurityProfiles in a given organization and location.
projects_locations_security_profiles_create	insert	projectsId, locationsId	securityProfileId	Creates a new SecurityProfile in a given project and location.
organizations_locations_security_profiles_create	insert	organizationsId, locationsId	securityProfileId	Creates a new SecurityProfile in a given organization and location.
projects_locations_security_profiles_patch	update	projectsId, locationsId, securityProfilesId	updateMask	Updates the parameters of a single SecurityProfile.
organizations_locations_security_profiles_patch	update	organizationsId, locationsId, securityProfilesId	updateMask	Updates the parameters of a single SecurityProfile.
projects_locations_security_profiles_delete	delete	projectsId, locationsId, securityProfilesId	etag	Deletes a single SecurityProfile.
organizations_locations_security_profiles_delete	delete	organizationsId, locationsId, securityProfilesId	etag	Deletes a single SecurityProfile.

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
locationsId	string
organizationsId	string
projectsId	string
securityProfilesId	string
etag	string
pageSize	integer (int32)
pageToken	string
securityProfileId	string
updateMask	string (google-fieldmask)

SELECT examples

projects_locations_security_profiles_get

Gets details of a single SecurityProfile.

SELECT
name,
createTime,
customInterceptProfile,
customMirroringProfile,
description,
etag,
labels,
threatPreventionProfile,
type,
updateTime,
urlFilteringProfile
FROM google.networksecurity.security_profiles
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND securityProfilesId = '{{ securityProfilesId }}' -- required
;

organizations_locations_security_profiles_get

Gets details of a single SecurityProfile.

SELECT
name,
createTime,
customInterceptProfile,
customMirroringProfile,
description,
etag,
labels,
threatPreventionProfile,
type,
updateTime,
urlFilteringProfile
FROM google.networksecurity.security_profiles
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND securityProfilesId = '{{ securityProfilesId }}' -- required
;

projects_locations_security_profiles_list

Lists SecurityProfiles in a given project and location.

SELECT
name,
createTime,
customInterceptProfile,
customMirroringProfile,
description,
etag,
labels,
threatPreventionProfile,
type,
updateTime,
urlFilteringProfile
FROM google.networksecurity.security_profiles
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

organizations_locations_security_profiles_list

Lists SecurityProfiles in a given organization and location.

SELECT
name,
createTime,
customInterceptProfile,
customMirroringProfile,
description,
etag,
labels,
threatPreventionProfile,
type,
updateTime,
urlFilteringProfile
FROM google.networksecurity.security_profiles
WHERE organizationsId = '{{ organizationsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

projects_locations_security_profiles_create

Creates a new SecurityProfile in a given project and location.

INSERT INTO google.networksecurity.security_profiles (
data__urlFilteringProfile,
data__threatPreventionProfile,
data__name,
data__type,
data__description,
data__customMirroringProfile,
data__customInterceptProfile,
data__labels,
projectsId,
locationsId,
securityProfileId
)
SELECT 
'{{ urlFilteringProfile }}',
'{{ threatPreventionProfile }}',
'{{ name }}',
'{{ type }}',
'{{ description }}',
'{{ customMirroringProfile }}',
'{{ customInterceptProfile }}',
'{{ labels }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ securityProfileId }}'
RETURNING
name,
done,
error,
metadata,
response
;

organizations_locations_security_profiles_create

Creates a new SecurityProfile in a given organization and location.

INSERT INTO google.networksecurity.security_profiles (
data__urlFilteringProfile,
data__threatPreventionProfile,
data__name,
data__type,
data__description,
data__customMirroringProfile,
data__customInterceptProfile,
data__labels,
organizationsId,
locationsId,
securityProfileId
)
SELECT 
'{{ urlFilteringProfile }}',
'{{ threatPreventionProfile }}',
'{{ name }}',
'{{ type }}',
'{{ description }}',
'{{ customMirroringProfile }}',
'{{ customInterceptProfile }}',
'{{ labels }}',
'{{ organizationsId }}',
'{{ locationsId }}',
'{{ securityProfileId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: security_profiles
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the security_profiles resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the security_profiles resource.
  - name: organizationsId
    value: "{{ organizationsId }}"
    description: Required parameter for the security_profiles resource.
  - name: urlFilteringProfile
    description: |
      The URL filtering configuration for the SecurityProfile.
    value:
      urlFilters:
        - urls: "{{ urls }}"
          priority: {{ priority }}
          filteringAction: "{{ filteringAction }}"
  - name: threatPreventionProfile
    description: |
      The threat prevention configuration for the SecurityProfile.
    value:
      antivirusOverrides:
        - protocol: "{{ protocol }}"
          action: "{{ action }}"
      severityOverrides:
        - severity: "{{ severity }}"
          action: "{{ action }}"
      threatOverrides:
        - type: "{{ type }}"
          action: "{{ action }}"
          threatId: "{{ threatId }}"
  - name: name
    value: "{{ name }}"
    description: |
      Immutable. Identifier. Name of the SecurityProfile resource. It matches pattern `projects|organizations/*/locations/{location}/securityProfiles/{security_profile}`.
  - name: type
    value: "{{ type }}"
    description: |
      Immutable. The single ProfileType that the SecurityProfile resource configures.
    valid_values: ['PROFILE_TYPE_UNSPECIFIED', 'THREAT_PREVENTION', 'CUSTOM_MIRRORING', 'CUSTOM_INTERCEPT', 'URL_FILTERING']
  - name: description
    value: "{{ description }}"
    description: |
      Optional. An optional description of the profile. Max length 512 characters.
  - name: customMirroringProfile
    description: |
      The custom Packet Mirroring v2 configuration for the SecurityProfile.
    value:
      mirroringEndpointGroup: "{{ mirroringEndpointGroup }}"
  - name: customInterceptProfile
    description: |
      The custom TPPI configuration for the SecurityProfile.
    value:
      interceptEndpointGroup: "{{ interceptEndpointGroup }}"
  - name: labels
    value: "{{ labels }}"
    description: |
      Optional. Labels as key value pairs.
  - name: securityProfileId
    value: "{{ securityProfileId }}"

UPDATE examples

projects_locations_security_profiles_patch

Updates the parameters of a single SecurityProfile.

UPDATE google.networksecurity.security_profiles
SET 
data__urlFilteringProfile = '{{ urlFilteringProfile }}',
data__threatPreventionProfile = '{{ threatPreventionProfile }}',
data__name = '{{ name }}',
data__type = '{{ type }}',
data__description = '{{ description }}',
data__customMirroringProfile = '{{ customMirroringProfile }}',
data__customInterceptProfile = '{{ customInterceptProfile }}',
data__labels = '{{ labels }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityProfilesId = '{{ securityProfilesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;

organizations_locations_security_profiles_patch

Updates the parameters of a single SecurityProfile.

UPDATE google.networksecurity.security_profiles
SET 
data__urlFilteringProfile = '{{ urlFilteringProfile }}',
data__threatPreventionProfile = '{{ threatPreventionProfile }}',
data__name = '{{ name }}',
data__type = '{{ type }}',
data__description = '{{ description }}',
data__customMirroringProfile = '{{ customMirroringProfile }}',
data__customInterceptProfile = '{{ customInterceptProfile }}',
data__labels = '{{ labels }}'
WHERE 
organizationsId = '{{ organizationsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityProfilesId = '{{ securityProfilesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

projects_locations_security_profiles_delete

Deletes a single SecurityProfile.

DELETE FROM google.networksecurity.security_profiles
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityProfilesId = '{{ securityProfilesId }}' --required
AND etag = '{{ etag }}'
;

organizations_locations_security_profiles_delete

Deletes a single SecurityProfile.

DELETE FROM google.networksecurity.security_profiles
WHERE organizationsId = '{{ organizationsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND securityProfilesId = '{{ securityProfilesId }}' --required
AND etag = '{{ etag }}'
;