List policy schemas

You can list supported policy schemas, schemas within a namespace, or fetch a particular schema directly by name, with the filter parameter of the customers.policySchemas.list method. If you omit the filter parameter, all supported schemas are returned.

For more details, see the code samples.

Filter syntax

  GLOBAL_STRING_LITERAL|
  name=PARTIAL_NAME_MATCH|
  description=PARTIAL_DESCRIPTION_MATCH|
  access_restrictions=PARTIAL_ACCESS_RESTRICTIONS_MATCH|
  policy_api_lifecycle=EXACT_LIFECYCLE_STAGE_MATCH|
  field_descriptions.field=EXACT_FIELD_NAME_MATCH|
  field_descriptions.input_constraint=EXACT_INPUT_CONSTRAINT_MATCH|
  field_descriptions.description=PARTIAL_FIELD_DESCRIPTION_MATCH|
  additional_target_keys:EXACT_KEY_MATCH_IN_COLLECTION
  • GLOBAL_STRING_LITERAL: matches if a policy schema's name and/or description contains the string (partial match)
  • PARTIAL_NAME_MATCH: matches if a policy schema's name contains the string (partial match)
  • PARTIAL_DESCRIPTION_MATCH: matches if a policy schema's description contains the string (partial match)
  • PARTIAL_ACCESS_RESTRICTION_MATCH: matches if a policy schema's access restrictions contain the string (partial match)
  • EXACT_LIFECYCLE_STAGE_MATCH: matches if a policy schema's lifecycle stage is an exact match for the provided string
  • EXACT_FIELD_NAME_MATCH: matches if a policy schema's field name is an exact match for the provided string
  • EXACT_INPUT_CONSTRAINT_MATCH: matches if a policy schema's input constraint is an exact match for the provided string
  • PARTIAL_FIELD_DESCRIPTION_MATCH: matches if a policy schema's field description contains the string (partial match)
  • EXACT_KEY_MATCH_IN_COLLECTION: matches if a policy schema's additional index keys contain an exact match for the provided string

Sample filter values

URL-encoded filter Literal filter value and description
filter=chrome%2Eprinters chrome.printers

Filters by namespace "chrome.printers"
filter=description%3Dcookies description=cookies

Filters for descriptions that contain "cookies"
filter=policy_api_lifecycle%API_DEPRECATED policy_api_lifecycle=API_DEPRECATED

Filters for policy api lifecycle stages that match "API_DEPRECATED"
filter=name%3Dprinters%20AND%20description%3Ddevices name=printers AND description=devices

Filters for names that contain "printers" and descriptions that contain "devices"
filter=(name%3Dblock%20OR%20name%3Dlist)%20AND%20NOT%20description%3Durl filter=(name=block OR name=list) AND NOT description=url

Filters for names that contain "block" or "list", but excludes descriptions that contain "url"