url_lists

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

Overview

Name	url_lists
Type	Resource
Id	google.networksecurity.url_lists

Fields

The following fields are returned by SELECT queries:

projects_locations_url_lists_get

Successful response

Name	Datatype	Description
name	string	Required. Name of the resource provided by the user. Name is of the form projects/{project}/locations/{location}/urlLists/{url_list} url_list should match the pattern:(^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$).
createTime	string (google-datetime)	Output only. Time when the security policy was created.
description	string	Optional. Free-text description of the resource.
updateTime	string (google-datetime)	Output only. Time when the security policy was updated.
values	array	Required. FQDNs and URLs.

projects_locations_url_lists_list

Successful response

Name	Datatype	Description
name	string	Required. Name of the resource provided by the user. Name is of the form projects/{project}/locations/{location}/urlLists/{url_list} url_list should match the pattern:(^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$).
createTime	string (google-datetime)	Output only. Time when the security policy was created.
description	string	Optional. Free-text description of the resource.
updateTime	string (google-datetime)	Output only. Time when the security policy was updated.
values	array	Required. FQDNs and URLs.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
projects_locations_url_lists_get	select	projectsId, locationsId, urlListsId		Gets details of a single UrlList.
projects_locations_url_lists_list	select	projectsId, locationsId	pageSize, pageToken	Lists UrlLists in a given project and location.
projects_locations_url_lists_create	insert	projectsId, locationsId	urlListId	Creates a new UrlList in a given project and location.
projects_locations_url_lists_patch	update	projectsId, locationsId, urlListsId	updateMask	Updates the parameters of a single UrlList.
projects_locations_url_lists_delete	delete	projectsId, locationsId, urlListsId		Deletes a single UrlList.

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
projectsId	string
urlListsId	string
pageSize	integer (int32)
pageToken	string
updateMask	string (google-fieldmask)
urlListId	string

SELECT examples

projects_locations_url_lists_get

Gets details of a single UrlList.

SELECT
name,
createTime,
description,
updateTime,
values
FROM google.networksecurity.url_lists
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND urlListsId = '{{ urlListsId }}' -- required;

projects_locations_url_lists_list

Lists UrlLists in a given project and location.

SELECT
name,
createTime,
description,
updateTime,
values
FROM google.networksecurity.url_lists
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}';

INSERT examples

projects_locations_url_lists_create

Creates a new UrlList in a given project and location.

INSERT INTO google.networksecurity.url_lists (
data__name,
data__description,
data__values,
projectsId,
locationsId,
urlListId
)
SELECT 
'{{ name }}',
'{{ description }}',
'{{ values }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ urlListId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: url_lists
  props:
    - name: projectsId
      value: string
      description: Required parameter for the url_lists resource.
    - name: locationsId
      value: string
      description: Required parameter for the url_lists resource.
    - name: name
      value: string
      description: >
        Required. Name of the resource provided by the user. Name is of the form projects/{project}/locations/{location}/urlLists/{url_list} url_list should match the pattern:(^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$).
        
    - name: description
      value: string
      description: >
        Optional. Free-text description of the resource.
        
    - name: values
      value: array
      description: >
        Required. FQDNs and URLs.
        
    - name: urlListId
      value: string

UPDATE examples

projects_locations_url_lists_patch

Updates the parameters of a single UrlList.

UPDATE google.networksecurity.url_lists
SET 
data__name = '{{ name }}',
data__description = '{{ description }}',
data__values = '{{ values }}'
WHERE 
projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND urlListsId = '{{ urlListsId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
name,
done,
error,
metadata,
response;

DELETE examples

projects_locations_url_lists_delete

Deletes a single UrlList.

DELETE FROM google.networksecurity.url_lists
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND urlListsId = '{{ urlListsId }}' --required;