views

PATCH /v2/views/{view_id}

Changed on

Update a single View

Request

Path parameters

view_idstring required

Unique View identifier

Headers

cloudzero-idempotency-keystring

If passed, any subsequent operation with the same value for this header will return the exact same result. This is true for all responses, i.e. successes and errors.

cloudzero-test-keystring

If passed, the operation executes in the namespace specified by this key. Resource mutations in the namespace last for 1 hour.

Request body

namestring

View name

filterViewFilter

Filter mapping of dimension name to allowed values

principal_dimensionstring

primary group by dimension for the view

Example request

{
  "filter": {
    "accounts": [
      "123456789012"
    ]
  },
  "notifications": {
    "weekly": false,
    "monthly": true
  }
}

Response

Successful Operation

Example response

{
  "view": {
    "filter": {
      "accounts": [
        "123456789012"
      ]
    },
    "notifications": {
      "weekly": false,
      "monthly": true
    }
  }
}

Changes

    • info

      added the new optional request property

    • info

      added subschema #3 to the response property allOf list for the response status

    • info

      removed from the response property allOf list for the response status