Update filtered group of proxies

PUT /platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}
Basic auth Api key

Update the settings for a filtered group of proxies.

Path parameters

  • proxies_filtered_group_id string Required

    "The identifier for the filtered group of proxies

Query parameters

  • version string

    Checks for conflicts against the metadata version, then returns the value in the x-cloud-resource-version header.

application/json

Body Required

Data for the filtered group of proxies to update

  • id string

    Identifier of the filtered group of proxies

  • filters array[object] Required

    Filters to be matched

    Hide filters attributes Show filters attributes object

    Selects proxies by matching a proxy metadata item.

    • key string Required

      Key of the proxy metadata item to be matched

    • value string Required

      Value of the proxy metadata item to be matched

  • expected_proxies_count integer(int32) Required

    Expected minimum number of proxies matching all filters in this group

Responses

  • 200 application/json

    Returns the created or updated filtered group of proxies

    Hide headers attributes Show headers attributes
    • x-cloud-resource-version string

      The resource version, which is used to avoid update conflicts with concurrent operations

    • x-cloud-resource-created string

      The date-time when the resource was created (ISO format relative to UTC)

    • x-cloud-resource-last-modified string

      The date-time when the resource was last modified (ISO format relative to UTC)

    Hide response attributes Show response attributes object
    • id string

      Identifier of the filtered group of proxies

    • filters array[object] Required

      Filters to be matched

      Hide filters attributes Show filters attributes object

      Selects proxies by matching a proxy metadata item.

      • key string Required

        Key of the proxy metadata item to be matched

      • value string Required

        Value of the proxy metadata item to be matched

    • expected_proxies_count integer(int32) Required

      Expected minimum number of proxies matching all filters in this group
  • 400 application/json

    The provided identifier doesn't match the identifier in the object. (code: proxies.proxies_filtered_group_id_conflict)

    Hide headers attribute Show headers attribute
    • x-cloud-error-codes string

      The error codes associated with the response

      Value is proxies.proxies_filtered_group_id_conflict.

    Hide response attribute Show response attribute object
    • errors array[object] Required

      A list of errors that occurred in the failing request

      Hide errors attributes Show errors attributes object
      • code string Required

        A structured code representing the error type that occurred

      • message string Required

        A human readable message describing the error that occurred

      • fields array[string]

        If the error can be tied to a specific field or fields in the user request, this lists those fields
  • 409 application/json

    There is a version conflict. (code: proxies.proxies_filtered_group_version_conflict)

    Hide headers attribute Show headers attribute
    • x-cloud-error-codes string

      The error codes associated with the response

      Value is proxies.proxies_filtered_group_version_conflict.

    Hide response attribute Show response attribute object
    • errors array[object] Required

      A list of errors that occurred in the failing request

      Hide errors attributes Show errors attributes object
      • code string Required

        A structured code representing the error type that occurred

      • message string Required

        A human readable message describing the error that occurred

      • fields array[string]

        If the error can be tied to a specific field or fields in the user request, this lists those fields
PUT /platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id} 
curl \
 --request PUT 'https://{{hostname}}/api/v1/platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{
  "id": "string",
  "filters": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "expected_proxies_count": 42
}'