NSX-T Data Center REST API
Associated URIs:
| API Description | API Path |
|---|---|
IP Reputation feed configuration.API to retrieve the current IP Reputation feed configuration. |
GET /policy/api/v1/infra/firewall-ip-reputation-feed
GET /policy/api/v1/global-infra/firewall-ip-reputation-feed |
IP reputation feed actions.This API can be used to activate or deactivate auto-download of IP reputation feed, it can also be used to trigger download of IP reputation feed when required. Once auto-download is activated, IP reputation feed will be downloaded at regular intervals of 720 mins(12 hrs). Auto-download of IP reputation feed can be activated using the action 'enable_auto_download', to deactivate use action 'disable_auto_download' and to trigger a download use action 'download'. For Global Manager, the only action that is supported is action=download. The enforcement_point_path of the site where the feed is to be downloaded should be provided along with the action |
POST /policy/api/v1/infra/firewall-ip-reputation-feed
POST /policy/api/v1/global-infra/firewall-ip-reputation-feed |
Retrieves the IP reputation exclusion list from the default malicious IP groupThe API retrieves the list of IP addresses excluded from IP reputation enforcement. The exclusion list is maintained in the default malicious IP group. The behavior varies depending on whether the API is executed on Global Manager (GM) or Local Manager (LM). Execution on Global Manager (GM): - API endpoint: GET https:// - When the 'enforcement_point_path' parameter is provided, the API returns the exclusion IP list from the default malicious IP group of the specified site (Local Manager) represented by the enforcement point path. - When the 'enforcement_point_path' parameter is not provided, the API returns the exclusion IP list from the Global Manager's default malicious IP group. Execution on Local Manager (LM): - API endpoint: GET https:// - The API returns the exclusion IP list from the Local Manager's default malicious IP group. - The 'enforcement_point_path' parameter is ignored if provided, as the Local Manager maintains only its own enforcement point and exclusion list. Note: - This API only considers IP addresses in the default malicious IP group. IP addresses in user-created malicious IP groups are not included in the response. |
GET /policy/api/v1/infra/ip-reputation-exclusion-list
|
List IP reputation site mappings configured across federated sitesThe API retrieves the list of IP reputation site mappings that define which sites are enabled for IP reputation management and their auto-download configuration from NTICS (NSX Threat Intelligence Cloud Services). IP Reputation Site Mapping is a Global Manager construct that: - Maps specific Local Manager sites to enable IP reputation functionality - Configures whether each site should automatically download IP reputation feeds from NTICS - Created and managed centrally from the Global Manager Execution on Global Manager (GM): - API endpoint: GET https:// - Returns the list of all IP reputation site mappings configured in the federated deployment - Supports pagination and filtering via request parameters Execution on Local Manager (LM): - API endpoint: GET https:// - When the Local Manager is onboarded to a Global Manager, this endpoint allows viewing the global IP reputation site mappings that are managed centrally by the GM - This is a read-only view - LM cannot create or modify these mappings - Useful for local administrators to verify IP reputation configuration and understand which sites are enabled for IP reputation management - Only available when the LM is part of a federated NSX deployment |
GET /policy/api/v1/global-infra/ip-reputation-site-mappings
|
Retrieves a specific IP reputation site mapping configurationThe API retrieves the configuration details of a specific IP reputation site mapping identified by its mapping ID. IP Reputation Site Mapping defines: - Which site (Local Manager) is enabled for IP reputation management - Whether the site should automatically download IP reputation feeds from NTICS (NSX Threat Intelligence Cloud Services) - The association between a site path and IP reputation configuration Execution on Global Manager (GM): - API endpoint: GET https:// - Retrieves the detailed configuration of a specific IP reputation site mapping - The mapping-id typically corresponds to the site name or a descriptive identifier for the site Execution on Local Manager (LM): - API endpoint: GET https:// - When the Local Manager is onboarded to a Global Manager, this endpoint allows viewing the specific IP reputation site mapping configuration that applies to sites in the federated deployment - This is a read-only view - Local Managers cannot modify site mappings - Useful for local administrators to verify their site's IP reputation configuration including: Whether auto-download is enabled for their site Last modification timestamps and ownership information - Only available when the LM is part of a federated NSX deployment |
GET /policy/api/v1/global-infra/ip-reputation-site-mappings/{mapping-id}
|