ResiLien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
terraform/website/source/docs/providers/cloudstack/r/network.html.markdown

81 lines
2.5 KiB
Markdown
Raw Normal View History

First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
---
layout: "cloudstack"
page_title: "CloudStack: cloudstack_network"
sidebar_current: "docs-cloudstack-resource-network"
description: |-
Creates a network.
---
# cloudstack\_network
Creates a network.
## Example Usage
Basic usage:
```
resource "cloudstack_network" "default" {
name = "test-network"
cidr = "10.0.0.0/16"
network_offering = "Default Network"
zone = "zone-1"
}
```
## Argument Reference
The following arguments are supported:
* `name` - (Required) The name of the network.
* `display_text` - (Optional) The display text of the network.
* `cidr` - (Required) The CIDR block for the network. Changing this forces a new
resource to be created.
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
* `startip` - (Optional) Start of the IP block that will be available on the
Fix wording on the docs for resource_cloudstack_network
2016-01-15 21:26:26 +01:00
network. Defaults to the second available IP in the range.
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
* `endip` - (Optional) End of the IP block that will be available on the
Fix wording on the docs for resource_cloudstack_network
2016-01-15 21:26:26 +01:00
network. Defaults to the last available IP in the range.
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
* `gateway` - (Optional) Gateway that will be provided to the instances in this
Fix wording on the docs for resource_cloudstack_network
2016-01-15 21:26:26 +01:00
network. Defaults to the first usable IP in the range.
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
Fixes #1: sets the rights values based on isUUID
2015-04-29 11:21:37 +02:00
* `network_offering` - (Required) The name or ID of the network offering to use
for this network.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
* `vlan` - (Optional) The VLAN number (1-4095) the network will use. This might be
Specify that the vlan attribute in cloudstack is only usable for ROOT admins and stop reading it back
2016-01-21 16:52:27 +01:00
required by the Network Offering if specifyVlan=true is set. Only the ROOT
admin can set this value.
Add vlan, startip, endip and gateway for network creation
2016-01-15 05:58:33 +01:00
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
* `vpc_id` - (Optional) The ID of the VPC to create this network for. Changing
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
this forces a new resource to be created.
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
* `vpc` - (Optional, Deprecated) The name or ID of the VPC to create this network
for. Changing this forces a new resource to be created.
Make ACL's swappable, unless you want to stop using an ACL In CloudStack you can dynamically start using an ACL and once you use an ACL you can dynamically swap ACL’s. But once your using an ACL, you can no longer stop using an ACL without rebuilding the network. This change makes the `ForceNew` value dynamic so that it only returns `true` if you are reverting from using an ACL to not using an ACL anymore, making this functionally inline with the behaviour CloudStack offers.
2016-06-24 13:27:05 +02:00
* `acl_id` - (Optional) The ACL ID that should be attached to the network or
`none` if you do not want to attach an ACL. You can dynamically attach and
swap ACL's, but if you want to detach an attached ACL and revert to using
`none`, this will force a new resource to be created. Defaults to `none`.
Refactor the use of names vs IDs for parameters referencing other TF resources We have a curtesy function in place allowing you to specify both a `name` of `ID`. But in order for the graph to be build correctly when you recreate or taint stuff that other resources depend on, we need to reference the `ID` and *not* the `name`. So in order to enforce this and by that help people to not make this mistake unknowingly, I deprecated all the parameters this allies to and changed the logic, docs and tests accordingly.
2016-04-11 17:14:19 +02:00
Make ACL's swappable, unless you want to stop using an ACL In CloudStack you can dynamically start using an ACL and once you use an ACL you can dynamically swap ACL’s. But once your using an ACL, you can no longer stop using an ACL without rebuilding the network. This change makes the `ForceNew` value dynamic so that it only returns `true` if you are reverting from using an ACL to not using an ACL anymore, making this functionally inline with the behaviour CloudStack offers.
2016-06-24 13:27:05 +02:00
* `aclid` - (Optional, Deprecated) The ID of a ACL that should be attached
Make replacing the ACL of a network update the network in place This prevents having to recreate the whole network and fixes #6630
2016-05-18 12:22:32 +02:00
to the network.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
Fix issue #3033 and update tweak several cloudstack resources - Added a retry loop for attaching disks as this something was tried to fast when the VM was still booting - Fix issue #3033 - Update docs for latest updates and done some minor refactoring (styling)
2015-08-21 16:59:35 +02:00
* `project` - (Optional) The name or ID of the project to deploy this
instance to. Changing this forces a new resource to be created.
Changed volume to network in description for zone
2016-03-16 13:15:57 +01:00
* `zone` - (Required) The name or ID of the zone where this network will be
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
available. Changing this forces a new resource to be created.
Add taging shared module for cloudstack and implement it in resource_network
2016-01-19 18:41:18 +01:00
* `tags` - (Optional) A mapping of tags to assign to the resource.
First release of a provider for CloudStack Of course not all resources are covered by this first release, but there should be enough resources available to handle most common operations. Tests and docs are included.
2014-12-10 22:20:52 +01:00
## Attributes Reference
The following attributes are exported:
* `id` - The ID of the network.
* `display_text` - The display text of the network.