Update filtered group of proxies

PUT /platform/infrastructure/proxies/filtered-groups/{proxies_filtered_group_id}

Update the settings for a filtered group of proxies.

Path parameters

Query parameters

  • version string

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

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

    Selects proxies by matching a proxy metadata item.

    Hide filters attributes Show filters attributes object
    • 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

    Returns the created or updated filtered group of proxies

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • id string

      Identifier of the filtered group of proxies

    • filters array[object] Required

      Filters to be matched

      Selects proxies by matching a proxy metadata item.

      Hide filters attributes Show filters attributes object
      • 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

    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

    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}' \
 --data '{"id":"string","filters":[{"key":"string","value":"string"}],"expected_proxies_count":42}'
Request examples 
{
  "id": "string",
  "filters": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "expected_proxies_count": 42
}
Response examples (200) 
# Headers
x-cloud-resource-version: string
x-cloud-resource-created: string
x-cloud-resource-last-modified: string

# Payload
{
  "id": "string",
  "filters": [
    {
      "key": "string",
      "value": "string"
    }
  ],
  "expected_proxies_count": 42
}
Response examples (400) 
# Headers
x-cloud-error-codes: proxies.proxies_filtered_group_id_conflict

# Payload
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}
Response examples (409) 
# Headers
x-cloud-error-codes: proxies.proxies_filtered_group_version_conflict

# Payload
{
  "errors": [
    {
      "code": "string",
      "message": "string",
      "fields": [
        "string"
      ]
    }
  ]
}