Filter

Get

Retrieve the filter of a Published item.

GET/api/PubItems/{id}/Filter

Path parameters

id*integer (int32)

Published item ID

Response

200401404

Success

Body

application/json; api-version=1.0

rulesnullable array of PubItemRule (object)

defaultDefaultAssignmentType (enum)

Default assignment type options

0 = Deny,1 = Allow

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/{id}/Filter', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200401404

{
  "rules": [
    {
      "enabled": false,
      "name": "text",
      "description": "text",
      "criteria": {
        "securityPrincipals": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "members": [
            {
              "account": "text",
              "type": [
                "1 = User",
                "2 = Group",
                "3 = ForeignSecurityPrincipal",
                "4 = Computer"
              ],
              "sid": "text"
            }
          ]
        },
        "gateways": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "members": [
            {
              "gatewayIP": "text"
            }
          ]
        },
        "oSs": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "allowedOSes": {
            "chrome": false,
            "android": false,
            "webClient": false,
            "iOS": false,
            "linux": false,
            "mac": false,
            "wyse": false,
            "windows": false
          }
        },
        "iPs": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "allowedIPs": {
            "iPv4s": [
              {
                "from": "text",
                "to": "text"
              }
            ],
            "iPv6s": [
              {
                "from": "text",
                "to": "text"
              }
            ]
          }
        },
        "hardwareIDs": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "members": [
            {
              "hardwareID": "text"
            }
          ]
        },
        "access": [
          "0 = DenyCriteriaWhen",
          "1 = AllowCriteriaWhen"
        ],
        "devices": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "members": [
            {
              "client": "text"
            }
          ]
        },
        "themes": {
          "enabled": false,
          "matchingMode": [
            "0 = IsNotOneOfTheFollowing",
            "1 = IsOneOfTheFollowing"
          ],
          "ids": []
        }
      }
    }
  ],
  "default": [
    "0 = Deny",
    "1 = Allow"
  ]
}

Update

Update settings of a Published item filter. For each setting, the request has a corresponding parameter. To modify a setting, specify a matching parameter and its value.

PUT/api/PubItems/{id}/Filter

Path parameters

id*integer (int32)

Published item ID

Body

application/json; api-version=1.0

Published item filter

defaultDefaultAssignmentType (enum)

Default assignment type options

0 = Deny,1 = Allow

Response

204401404

No Content

Request

JavaScriptCurlPython

const response = await fetch('/api/PubItems/{id}/Filter', {
    method: 'PUT',
    headers: {
      "Content-Type": "application/json; api-version=1.0"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

401404

{
  "type": "text",
  "title": "text",
  "detail": "text",
  "instance": "text"
}