InlineInfraServerExclusionsRequest1

JSON Example

{
    "site_id": "0c7d7379-3ac5-41e0-9a97-5daf80ccde17",
    "server_id_filters": [
        "IP-172.16.14.1"
    ],
    "exclude_all": false,
    "offset": 0,
    "page_size": 1000,
    "sort_ascending": false
}

string

site_id

Required

Required field that limits the exclusion operation to a single site. Server exclusions are isolated per site - removing a server from one site's discovered list will not impact its status on other sites. Site IDs can be retrieved from your environment settings or from the response of a POST /intelligence/monitoring/infra/service-categories/{service-category-id}/discovered-servers call.

array of string

server_id_filters

Optional

List of server IDs to target for exclusion. This is the NSX Inventory ID (UUID) for NSX-managed VMs. For non-NSX-managed infrastructure servers, use the IP address prefixed with IP- (e.g., IP-192.168.1.10). Obtain valid server_id values from POST /intelligence/monitoring/infra/service-categories/{service-category-id}/discovered-servers.

Required when exclude_all is false or not provided.

array of string

server_name_filters

Optional

Optional patterns matched against the server display name (VM display name, or the IP portion for IP-* rows). Multiple patterns are OR-combined under match_mode.

TextMatchMode

match_mode

Optional

Constraints: default: CONTAINS

How each pattern in server_name_filters and server_id_filters is compared (CONTAINS, EXACT, or NOT_CONTAINS). Does not apply to time_selection. Defaults to CONTAINS when any filter list is non-empty.

Enumeration: CONTAINS, EXACT, NOT_CONTAINS

ServerClassification

server_classification_filter

Optional

Optional filter by server classification. INTERNAL targets only servers classified as internal to the network; EXTERNAL targets only external servers. Omitting this field targets both internal and external servers.

Enumeration: INTERNAL, EXTERNAL

boolean

exclude_all

Optional

Controls bulk exclusion behavior when used without filters:

When no filters are provided: if true, all currently discovered servers for this category and site are excluded; if false (default), no servers are targeted.
When any filter is provided (server_id_filters, server_name_filters, or server_classification_filter), this flag is ignored - only servers matching the filters are targeted, regardless of this value.

Used By

InfraServerExclusionsRequest