VMNetworks
Applies To: System Center 2016 - Service Provider Foundation, System Center Technical Preview
VMNetworks
Manages virtual networks for Virtual Machine Manager (VMM).
HTTP Verbs
| GET | POST | PUT | DELETE |
|---|---|---|---|
| Yes | Yes | Yes | Yes |
GET
Reads all virtual network objects that are associated with the specified stamp.
If you supply the ID property, the computer tier template with that identifier is returned.
If you supply the Name property, the virtual network with that name is returned.
If you supply the LogicalNetworkName property, the virtual networks that are assigned to the specified logical network with this name are returned.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | No | The identifier of the stamp to restrict the query to |
| Name | Edm.String | No | The name of the virtual network |
| LogicalNetworkName | Edm.String | No | The name of the logical network that a virtual network is using |
| IsAssigned | Edm.Boolean | No | When this value is true, returns networks that are available to be used. When this value is false, returns networks that are unavailable to be used—networks that are not available in the console but are available from Windows PowerShell. |
POST
Creates a new logical network.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| Name | Edm.String | Yes | The name of the virtual network |
| LogicalNetworkId | Edm.Guid | Yes | The logical network to assign the new virtual network to |
| Description | Edm.String | No | The description of the virtual network |
| IsolationType | Edm.String | No | Specifies an isolation type for the virtual network. Valid values are NoIsolation, WindowsNetworkVirtualization, External, VLANNetwork. |
| VPNGateway | VPNVMNetworkGateway | No | The virtual machine network gateway object |
PUT
Updates an existing virtual network.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| ID | Edm.Guid | Yes | The identifier of the virtual network to update |
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| Owner | UserAndRole | Yes | The owner of this object |
| GrantedToList | UserAndRole[] | Yes | The users or roles that are allowed to use this virtual network Collection may be empty. |
| VPNGateway | VPNVMNetworkGateway | Yes | The virtual machine network gateway object |
DELETE
Deletes a virtual network.
Entity Properties
| Name | Type | Mandatory | Description |
|---|---|---|---|
| StampId | Edm.Guid | Yes | The identifier of the stamp to restrict the query to |
| ID | Edm.Guid | Yes | The identifier of the virtual network to delete |