Headers

• X-Elastic-Page-Size integer

  Maximum number of traffic filters returned in the response. Defaults to 1000.

  Minimum value is 1, maximum value is 1000.

• X-Elastic-Next-Page string

  The next_page token from a previous response, to fetch the page that follows it.

Query parameters

• include_by_default boolean

  Retrieves a list of resources that have include_by_default set or not set

  Default value is false.

• region string

  If provided limits the traffic filters to that region only.

Responses

• 200 application/json

  The collection of traffic filters were successfully returned.

  Hide response attributes Show response attributes object

  • next_page string | null

    A token to fetch the next page, to be sent back in the X-Elastic-Next-Page header. Absent when there are no further pages. When present it does not guarantee the next page is non-empty, so keep paging until it is absent.

  • items array[object] Required

    List of traffic filters

    Hide items attributes Show items attributes object

    The container for a set of traffic filter rules.

    • id string Required

      The traffic filter ID

      Minimum length is 32, maximum length is 32.

    • name string Required

      Name of the traffic filter

      Minimum length is 1, maximum length is 128.

    • description string

      Description of the traffic filter

      Minimum length is 0, maximum length is 512.

    • type string Required

      Type of the traffic filter. Determines which rule fields are valid:

      • ip — IP/CIDR allowlist (source)
      • vpce — AWS PrivateLink VPC endpoint (source)
      • private_endpoint — Azure Private Link (azure_endpoint_name, azure_endpoint_guid)
      • psc_endpoint — GCP Private Service Connect endpoint (source)

      Minimum length is 1, maximum length is 32. Values are ip, vpce, private_endpoint, or psc_endpoint.

    • include_by_default boolean Required

      Should the traffic filter be automatically included in the new projects

    • region string Required

      The traffic filter can be attached only to projects in the specific region

      Minimum length is 1, maximum length is 32.

    • rules array[object] Required

      List of rules

      Hide rules attributes Show rules attributes object

      A single traffic filter rule. Which fields are required depends on the parent filter's type — the fields are mutually exclusive between Azure and IP/private-connectivity rules.

      • description string

        Optional human-readable description of the rule.

      • source string

        Allowed source for ip, vpce, or psc_endpoint filters: an IP address, CIDR mask, AWS VPC endpoint ID (vpce- followed by 17 lowercase hex characters), or GCP PSC connection ID. Must not be set for private_endpoint filters.

      • azure_endpoint_name string

        Azure Private Endpoint resource name. Required for private_endpoint filters; not applicable to ip, vpce, or psc_endpoint filters. Must be 2–80 characters, start with an alphanumeric character, and end with an alphanumeric character or underscore. May contain alphanumerics, underscores, periods, and hyphens.

        Minimum length is 2, maximum length is 80. Format should match the following pattern: ^[a-zA-Z0-9][-\w.]{0,78}[\w]$.

      • azure_endpoint_guid string

        Azure Private Endpoint resource GUID (properties.resourceGuid from the Azure resource). Required for private_endpoint filters. Must be a lowercase UUID. This is not the ARM resource ID.

        Format should match the following pattern: ^[a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}$.

• 400 application/json

  Bad request

  Hide response attribute Show response attribute object

  • errors array[object] Required

    An error response returned by the API.

    Hide errors attributes Show errors attributes object

    An error response returned by the API.

    • message string Required

      A human-readable message of the error.

    • code string Required

      An identifier for this type of error.

• 401 application/json

  Unauthorized

  Hide response attribute Show response attribute object

  • errors array[object] Required

    An error response returned by the API.

    Hide errors attributes Show errors attributes object

    An error response returned by the API.

    • message string Required

      A human-readable message of the error.

    • code string Required

      An identifier for this type of error.

• 500 application/json

  Internal server error

  Hide response attribute Show response attribute object

  • errors array[object] Required

    An error response returned by the API.

    Hide errors attributes Show errors attributes object

    An error response returned by the API.

    • message string Required

      A human-readable message of the error.

    • code string Required

      An identifier for this type of error.