NSGateway

Represents a Network Service Gateway.

Overview

associatedGatewaySecurityID string read only  
associatedGatewaySecurityProfileID string read only  
associatedNSGInfoID string
associatedNSGUpgradeProfileID string
autoDiscGatewayID string read only  
BIOSReleaseDate string orderable  
BIOSVersion string
bootstrapID string
bootstrapStatus enum (ACTIVE | CERTIFICATE_SIGNED | INACTIVE | NOTIFICATION_APP_REQ_ACK | NOTIFICATION_APP_REQ_SENT)
configurationReloadState enum (APPLIED | FAILED_TO_APPLY | PENDING | SENT | UNKNOWN)
configurationStatus enum (FAILURE | SUCCESS | UNKNOWN)
controlTrafficCOSValue integer filterable   orderable  
controlTrafficDSCPValue integer filterable   orderable  
CPUType string
datapathID string read only  
derivedSSHServiceState enum (INHERITED_DISABLED | INHERITED_ENABLED | INSTANCE_DISABLED | INSTANCE_ENABLED | UNKNOWN)
description string filterable   orderable  
enterpriseID string
entityScope enum (ENTERPRISE | GLOBAL) autogenerated  
externalID string filterable   orderable   locally unique  
family enum (ANY | NSG_AMI | NSG_C | NSG_E | NSG_E200 | NSG_E300 | NSG_V | NSG_X | NSG_X200)
inheritedSSHServiceState enum (DISABLED | ENABLED) deprecated  
lastConfigurationReloadTimestamp integer read only  
lastUpdatedBy string autogenerated  
libraries string
locationID string
MACAddress string
name string required   filterable   orderable  
NATTraversalEnabled boolean deprecated  
networkAcceleration enum (NONE | PERFORMANCE) filterable  
NSGVersion string
operationMode string
operationStatus string
patches string read only  
pending boolean filterable  
permittedAction enum (ALL | DEPLOY | EXTEND | INSTANTIATE | READ | USE)
personality enum (DC7X50 | HARDWARE_VTEP | NSG | NSGBR | NSGDUC | OTHER | VRSG | VSA | VSG) creation only   filterable   orderable  
productName string
redundancyGroupID string
serialNumber string
SKU string
SSHService enum (DISABLED | ENABLED | INHERITED)
systemID string filterable   orderable  
TCPMaximumSegmentSize integer
TCPMSSEnabled boolean filterable   orderable  
templateID string required  
TPMStatus enum (DISABLED | ENABLED_NOT_OPERATIONAL | ENABLED_OPERATIONAL | UNKNOWN)
TPMVersion string read only  
UUID string

API Resource

/nsgateways/id
delete get put

Parents

/enterprises/id/nsgateways
get post
/ducgroups/id/nsgateways
get put
/nsggroups/id/nsgateways
get put
/performancemonitors/id/nsgateways
get put
/policyobjectgroups/id/nsgateways
get put
/nsgateways
get
/nsgredundancygroups/id/nsgateways
get put

Children

/nsgateways/id/gatewaysecurities
get
/nsgateways/id/permissions
get post
/nsgateways/id/metadatas
get post
/nsgateways/id/wirelessports
get post
/nsgateways/id/alarms
get
/nsgateways/id/globalmetadatas
get post put
/nsgateways/id/infraconfig
get put
/nsgateways/id/enterprisepermissions
get
/nsgateways/id/jobs
get post
/nsgateways/id/locations
get
/nsgateways/id/commands
get post
/nsgateways/id/monitorscopes
get
/nsgateways/id/bootstraps
get
/nsgateways/id/bootstrapactivations
post
/nsgateways/id/uplinkconnections
get
/nsgateways/id/nsginfos
get
/nsgateways/id/nsports
get post put
/nsgateways/id/subnets
get
/nsgateways/id/eventlogs
get

Members

/nsgateways/id/patnatpools
get put

Attributes documentation

associatedGatewaySecurityID string read only  
Discussion

Read only ID of the associated gateway security object.


Charateristics

Format: free
SDK attribute: associatedGatewaySecurityID

associatedGatewaySecurityProfileID string read only  
Discussion

Read only ID of the associated gateway security profile object


Charateristics

Format: free
SDK attribute: associatedGatewaySecurityProfileID

associatedNSGInfoID string
Discussion

Read only ID of the associated NSG info object


Charateristics

Format: free
SDK attribute: associatedNSGInfoID

associatedNSGUpgradeProfileID string
Discussion

The UUID of the NSG Upgrade Profile associated to this NSG instance.


Charateristics

Format: free
SDK attribute: associatedNSGUpgradeProfileID

autoDiscGatewayID string read only  
Discussion

The Auto Discovered Gateway associated with this Gateway Instance


Charateristics

Format: free
SDK attribute: autoDiscGatewayID

BIOSReleaseDate string orderable  
Discussion

Release Date of the NSG BiOS


Charateristics

Format: free
SDK attribute: BIOSReleaseDate

BIOSVersion string
Discussion

NSG BIOS Version


Charateristics

Format: free
Max length: 255
SDK attribute: BIOSVersion

bootstrapID string
Discussion

The bootstrap details associated with this NSGateway. NOTE: this is a read only property, it can only be set during creation of an NSG


Charateristics

Format: free
SDK attribute: bootstrapID

bootstrapStatus enum
Discussion

The bootstrap status of this NSGateway. NOTE: this is a read only property


Charateristics

Allowed values: ACTIVE, CERTIFICATE_SIGNED, INACTIVE, NOTIFICATION_APP_REQ_ACK, NOTIFICATION_APP_REQ_SENT
SDK attribute: bootstrapStatus

configurationReloadState enum
Discussion

Status resulting from a manually triggered configuration reload operation on an NSG. This value only reflects the state for a manual action requested by the operator, not the automatic periodic configuration reload triggered by the NSG itself.


Charateristics

Allowed values: APPLIED, FAILED_TO_APPLY, PENDING, SENT, UNKNOWN
Default value: UNKNOWN
SDK attribute: configurationReloadState

configurationStatus enum
Discussion

NSG Configuration status represents the NSG update state following a query by the NSG to get the latest version of the infraconfig.json file. This status will be updated following a Bootstrap request or a Configuration Reload. Success means that the NSG was able to apply the changes included in the latest infraconfig.json file. A Failure response will be returned if the NSG was unable to apply the changes; this is normally accompanied with a rollback of the NSG to the previous configuration.


Charateristics

Allowed values: FAILURE, SUCCESS, UNKNOWN
Default value: UNKNOWN
SDK attribute: configurationStatus

controlTrafficCOSValue integer filterable   orderable  
Discussion

CoS Value for Self Generated Traffic (Control Traffic). Min is 0 and Max is 7


Charateristics

Default value: 7
Max value: 7
SDK attribute: controlTrafficCOSValue

controlTrafficDSCPValue integer filterable   orderable  
Discussion

DSCP Value for Self Generated Traffic (Control Traffic). Min is 0 and Max is 63


Charateristics

Default value: 56
Max value: 63
SDK attribute: controlTrafficDSCPValue

CPUType string
Discussion

The NSG Processor Type as reported during bootstrapping.


Charateristics

Format: free
SDK attribute: CPUType

datapathID string read only  
Discussion

Identifier of the Gateway, based on the systemId


Charateristics

Format: free
SDK attribute: datapathID

derivedSSHServiceState enum
Discussion

Indicates the SSH Service state on a NSG. This value is derived based on the SSHService configuration on the NSG and the associated Gateway Template.


Charateristics

Allowed values: INHERITED_DISABLED, INHERITED_ENABLED, INSTANCE_DISABLED, INSTANCE_ENABLED, UNKNOWN
SDK attribute: derivedSSHServiceState

description string filterable   orderable  
Discussion

A description of the Gateway


Charateristics

Format: free
Max length: 255
SDK attribute: description

enterpriseID string
Discussion

The enterprise associated with this Gateway. This is a read only attribute


Charateristics

Format: free
SDK attribute: enterpriseID

entityScope enum autogenerated  
Discussion

Specify if scope of entity is Data center or Enterprise level


Charateristics

Allowed values: ENTERPRISE, GLOBAL
SDK attribute: entityScope

externalID string filterable   orderable   locally unique  
Discussion

External object ID. Used for integration with third party systems


Charateristics

Format: free
SDK attribute: externalID

family enum
Discussion

The NSG Family type.


Charateristics

Allowed values: ANY, NSG_AMI, NSG_C, NSG_E, NSG_E200, NSG_E300, NSG_V, NSG_X, NSG_X200
SDK attribute: family

inheritedSSHServiceState enum deprecated  
Discussion

Indicates the SSH Service state which is configured on the associated template instance.


Charateristics

Allowed values: DISABLED, ENABLED
Default value: ENABLED
SDK attribute: inheritedSSHServiceState

lastConfigurationReloadTimestamp integer read only  
Discussion

Time stamp of the last known configuration update of the NSG. This timestamp gets updated when a bootstrap is successful or when a configuration reload request triggered by VSD is successful.


Charateristics

Default value: -1
SDK attribute: lastConfigurationReloadTimestamp

lastUpdatedBy string autogenerated  
Discussion

ID of the user who last updated the object.


Charateristics

Format: free
SDK attribute: lastUpdatedBy

libraries string
Discussion

Transient representation of the same property on NSGInfo.


Charateristics

Format: free
SDK attribute: libraries

locationID string
Discussion

The NSGateway's Location. NOTE: this is a read only property, it can only be set through the location object


Charateristics

Format: free
SDK attribute: locationID

MACAddress string
Discussion

MAC Address of the NSG


Charateristics

Format: free
SDK attribute: MACAddress

name string required   filterable   orderable  
Discussion

Name of the Gateway


Charateristics

Format: free
Min length: 1
Max length: 255
SDK attribute: name

NATTraversalEnabled boolean deprecated  
Discussion

This attribute is deprecated in version 4.0.


Charateristics

Format: free
SDK attribute: NATTraversalEnabled

networkAcceleration enum filterable  
Discussion

Attribute that enables or disables Network Acceleration (DPDK) on the NSGateway instance. Changing the value of this field will cause the device to restart at the next configuration reload.


Charateristics

Allowed values: NONE, PERFORMANCE
Default value: NONE
SDK attribute: networkAcceleration

NSGVersion string
Discussion

The NSG Version (software) as reported during bootstrapping or following an upgrade.


Charateristics

Format: free
SDK attribute: NSGVersion

operationMode string
Discussion

Operation mode of NSGateway


Charateristics

Format: free
SDK attribute: operationMode

operationStatus string
Discussion

Operation Status of NSGateway


Charateristics

Format: free
SDK attribute: operationStatus

patches string read only  
Discussion

Patches that have been installed on the NSG.


Charateristics

Format: free
SDK attribute: patches

pending boolean filterable  
Discussion

Indicates that this gateway is pending state or state. When in pending state it cannot be modified from REST.


Charateristics

Format: free
SDK attribute: pending

permittedAction enum
Discussion

The permitted action to USE/EXTEND this Gateway.


Charateristics

Allowed values: ALL, DEPLOY, EXTEND, INSTANTIATE, READ, USE
SDK attribute: permittedAction

personality enum creation only   filterable   orderable  
Discussion

Personality of the Gateway - NSG, cannot be changed after creation.


Charateristics

Allowed values: DC7X50, HARDWARE_VTEP, NSG, NSGBR, NSGDUC, OTHER, VRSG, VSA, VSG
SDK attribute: personality

productName string
Discussion

NSG Product Name as reported during bootstrapping.


Charateristics

Format: free
Max length: 255
SDK attribute: productName

redundancyGroupID string
Discussion

The Redundancy Gateway Group associated with this Gateway Instance. This is a read only attribute


Charateristics

Format: free
SDK attribute: redundancyGroupID

serialNumber string
Discussion

The NSG's serial number


Charateristics

Format: free
SDK attribute: serialNumber

SKU string
Discussion

The part number of the NSG


Charateristics

Format: free
SDK attribute: SKU

SSHService enum
Discussion

Indicates if SSH Service is enabled/disabled on a NSG. The value configured for this attribute is used only when instanceSSHOverride is allowed on the associated Gateway Template.


Charateristics

Allowed values: DISABLED, ENABLED, INHERITED
Default value: INHERITED
SDK attribute: SSHService

systemID string filterable   orderable  
Discussion

Identifier of the Gateway, cannot be modified after creation


Charateristics

Format: free
Min length: 1
Max length: 255
SDK attribute: systemID

TCPMaximumSegmentSize integer
Discussion

Maximum Segment Size for TCP(min = 576, max = 7812).


Charateristics

Default value: 1330
Min value: 576
Max value: 7812
SDK attribute: TCPMaximumSegmentSize

TCPMSSEnabled boolean filterable   orderable  
Discussion

Boolean flag to indicate whether MSS on TCP is enabled or not


Charateristics

Default value: false
SDK attribute: TCPMSSEnabled

templateID string required  
Discussion

The ID of the template that this Gateway was created from. This should be set when instantiating a Gateway


Charateristics

Format: free
SDK attribute: templateID

TPMStatus enum
Discussion

TPM Status of the NSG based on the information received by the device during bootstrapping or upgrade.


Charateristics

Allowed values: DISABLED, ENABLED_NOT_OPERATIONAL, ENABLED_OPERATIONAL, UNKNOWN
Default value: UNKNOWN
SDK attribute: TPMStatus

TPMVersion string read only  
Discussion

TPM (Trusted Platform Module) version as reported by the NSG.


Charateristics

Format: free
Max length: 255
SDK attribute: TPMVersion

UUID string
Discussion

The Redhat UUID of the NSG


Charateristics

Format: free
SDK attribute: UUID