Managed Object - HostFirewallSystem

Property of: HostConfigManager
Extends: ExtensibleManagedObject
See also: HostFirewallDefaultPolicy, HostFirewallInfo, HostFirewallRulesetRulesetSpec

Managed Object Description

The FirewallSystem managed object describes the firewall configuration of the host.

The firewall should be configured first by setting the default policy and then by making exceptions to the policy to get the desired openness.

Properties

Name	Type	Description
firewallInfo*	HostFirewallInfo	Firewall configuration.
Properties inherited from ExtensibleManagedObject
availableField, value

*May not be present

Methods

Methods defined in this Managed Object
DisableRuleset, EnableRuleset, RefreshFirewall, UpdateDefaultPolicy, UpdateRuleset
Methods inherited from ExtensibleManagedObject
setCustomValue

DisableRuleset

Blocks the firewall ports belonging to the specified ruleset. If the ruleset has a managed service with a policy of 'auto' and all other rulesets used by the service are blocked, stops the service.

Required Privileges: Host.Config.NetService

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostFirewallSystem used to make the method call.
id	xsd:string

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown if an internal error happend when reconfigure the ruleset.
NotFound	Thrown if the ruleset ID is unknown.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DisableRuleset" type="vim25:DisableRulesetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="DisableRulesetResponse">
            <complexType/>
         </element>

EnableRuleset

Opens the firewall ports belonging to the specified ruleset. If the ruleset has a managed service with a policy of 'auto' that is not running, starts the service.

Required Privileges: Host.Config.NetService

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostFirewallSystem used to make the method call.
id	xsd:string

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown if an internal error happend when reconfigure the ruleset.
NotFound	Thrown if the ruleset ID is unknown.
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="EnableRuleset" type="vim25:EnableRulesetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="EnableRulesetResponse">
            <complexType/>
         </element>

RefreshFirewall

Refresh the firewall information and settings to pick up any changes made directly on the host.

Required Privileges: Host.Config.NetService

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostFirewallSystem used to make the method call.

Return Value

Type	Description
None

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RefreshFirewall" type="vim25:RefreshFirewallRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="RefreshFirewallResponse">
            <complexType/>
         </element>

UpdateDefaultPolicy

Updates the default firewall policy; unset fields are left unchanged.

Required Privileges: Host.Config.NetService

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostFirewallSystem used to make the method call.
defaultPolicy	HostFirewallDefaultPolicy

Return Value

Type	Description
None

Faults

Type	Description
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateDefaultPolicy" type="vim25:UpdateDefaultPolicyRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateDefaultPolicyResponse">
            <complexType/>
         </element>

UpdateRuleset

Update the firewall ruleset specification.

Required Privileges: Host.Config.NetService
Since: vSphere API 5.0

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the HostFirewallSystem used to make the method call.
id	xsd:string
spec	HostFirewallRulesetRulesetSpec

Return Value

Type	Description
None

Faults

Type	Description
HostConfigFault	Thrown if the update of the ruleset failed.
NotFound	Thrown if the ruleset ID is unknown
RuntimeFault	Thrown if any type of runtime fault is thrown that is not covered by the other faults; for example, a communication error.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateRuleset" type="vim25:UpdateRulesetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vim25="urn:vim25" name="UpdateRulesetResponse">
            <complexType/>
         </element>