You are here: Supporting Documents > Reference Topics > Concepts > Network Reference

Network Reference

A network is an isolated virtual layer-2 broadcast domain that is typically reserved for the tenant by whom it was created unless the network is configured to be shared. Tenants can create multiple networks until they reach the thresholds specified by per-tenant quotas. Ports and subnets are always associated with a network.

The following table describes the attributes for network objects.

 
Attribute Type Required CRUD[a] Default Value Validation Constraints Notes
id uuid-str N/A R Generated N/A UUID for the network.
name String No CRU None N/A Human-readable name for the network; may not be unique.
admin_state_up Bool No CRU True {true|false} The administrative state of network. If false (down), the network does not forward packets.
status String N/A R N/A N/A

Indicates whether network is currently operational. Possible values include:

  • ACTIVE

  • DOWN

  • BUILD

  • ERROR

Plug-ins may define additional values.

subnets list(uuid-str) No R Empty List N/A Subnets associated with this network.
shared Bool No CRU False { True | False } Specifies whether the network resource can be accessed by any tenant.
tenant_id uuid-str No[b] CR N/A No constraint Owner of network. Only admin users can specify a tenant_id other than its own.

[a]

  • C. Use the attribute in create operations.

  • R. This attribute is returned in response to show and list operations.

  • U. You can update the value of this attribute.

  • D. You can delete the value of this attribute.

[b] If OpenStack networking is not running with the Keystone identity service, the tenant_id attribute is required.

of