Update azure_rm_networkinterface related document (#57454)
* Update azure_rm_networkinterface related document * fixes errors with plural nouns, typos, uses single quotes for version_added
This commit is contained in:
parent
e834cd7d41
commit
6e89fbe58a
2 changed files with 210 additions and 112 deletions
|
@ -19,15 +19,16 @@ DOCUMENTATION = '''
|
|||
---
|
||||
module: azure_rm_networkinterface
|
||||
|
||||
version_added: "2.1"
|
||||
version_added: '2.1'
|
||||
|
||||
short_description: Manage Azure network interfaces.
|
||||
short_description: Manage Azure network interfaces
|
||||
|
||||
description:
|
||||
- Create, update or delete a network interface. When creating a network interface you must provide the name of an
|
||||
existing virtual network, the name of an existing subnet within the virtual network. A default security group
|
||||
and public IP address will be created automatically, or you can provide the name of an existing security group
|
||||
and public IP address. See the examples below for more details.
|
||||
- Create, update or delete a network interface.
|
||||
- When creating a network interface you must provide the name of an existing virtual network, the name of an existing subnet within the virtual network.
|
||||
- A default security group and public IP address will be created automatically.
|
||||
- Or you can provide the name of an existing security group and public IP address.
|
||||
- See the examples below for more details.
|
||||
|
||||
options:
|
||||
resource_group:
|
||||
|
@ -48,32 +49,30 @@ options:
|
|||
- present
|
||||
location:
|
||||
description:
|
||||
- Valid azure location. Defaults to location of the resource group.
|
||||
- Valid Azure location. Defaults to location of the resource group.
|
||||
virtual_network:
|
||||
description:
|
||||
- An existing virtual network with which the network interface will be associated. Required
|
||||
when creating a network interface.
|
||||
- An existing virtual network with which the network interface will be associated. Required when creating a network interface.
|
||||
- It can be the virtual network's name.
|
||||
- Make sure your virtual network is in the same resource group as NIC when you give only the name.
|
||||
- It can be the virtual network's resource id.
|
||||
- It can be a dict which contains C(name) and C(resource_group) of the virtual network.
|
||||
- It can be a dict which contains I(name) and I(resource_group) of the virtual network.
|
||||
aliases:
|
||||
- virtual_network_name
|
||||
required: true
|
||||
subnet_name:
|
||||
description:
|
||||
- Name of an existing subnet within the specified virtual network. Required when creating a network
|
||||
interface
|
||||
- Name of an existing subnet within the specified virtual network. Required when creating a network interface.
|
||||
- Use the C(virtual_network)'s resource group.
|
||||
aliases:
|
||||
- subnet
|
||||
required: true
|
||||
os_type:
|
||||
description:
|
||||
- Determines any rules to be added to a default security group. When creating a network interface, if no
|
||||
security group name is provided, a default security group will be created. If the os_type is 'Windows',
|
||||
a rule will be added allowing RDP access. If the os_type is 'Linux', a rule allowing SSH access will be
|
||||
added.
|
||||
- Determines any rules to be added to a default security group.
|
||||
- When creating a network interface, if no security group name is provided, a default security group will be created.
|
||||
- If the I(os_type=Windows), a rule allowing RDP access will be added.
|
||||
- If the I(os_type=Linux), a rule allowing SSH access will be added.
|
||||
choices:
|
||||
- Windows
|
||||
- Linux
|
||||
|
@ -84,9 +83,9 @@ options:
|
|||
- This option will be deprecated in 2.9, use I(ip_configurations) instead.
|
||||
private_ip_allocation_method:
|
||||
description:
|
||||
- "(Deprecate) Specify whether or not the assigned IP address is permanent. NOTE: when creating a network interface
|
||||
specifying a value of 'Static' requires that a private_ip_address value be provided. You can update
|
||||
the allocation method to 'Static' after a dynamic private ip address has been assigned."
|
||||
- (Deprecate) Whether or not the assigned IP address is permanent.
|
||||
- When creating a network interface, if you specify I(private_ip_address=Static), you must provide a value for I(private_ip_address).
|
||||
- You can update the allocation method to C(Static) after a dynamic private IP address has been assigned.
|
||||
- This option will be deprecated in 2.9, use I(ip_configurations) instead.
|
||||
default: Dynamic
|
||||
choices:
|
||||
|
@ -94,8 +93,8 @@ options:
|
|||
- Static
|
||||
public_ip:
|
||||
description:
|
||||
- (Deprecate) When creating a network interface, if no public IP address name is provided a default public IP
|
||||
address will be created. Set to false, if you do not want a public IP address automatically created.
|
||||
- (Deprecate) When creating a network interface, if no public IP address name is provided a default public IP address will be created.
|
||||
- Set to C(false) if you do not want a public IP address automatically created.
|
||||
- This option will be deprecated in 2.9, use I(ip_configurations) instead.
|
||||
type: bool
|
||||
default: 'yes'
|
||||
|
@ -108,8 +107,8 @@ options:
|
|||
- public_ip_name
|
||||
public_ip_allocation_method:
|
||||
description:
|
||||
- (Deprecate) If a public_ip_address_name is not provided, a default public IP address will be created. The allocation
|
||||
method determines whether or not the public IP address assigned to the network interface is permanent.
|
||||
- (Deprecate) If a I(public_ip_address_name) is not provided, a default public IP address will be created.
|
||||
- The allocation method determines whether or not the public IP address assigned to the network interface is permanent.
|
||||
- This option will be deprecated in 2.9, use I(ip_configurations) instead.
|
||||
choices:
|
||||
- Dynamic
|
||||
|
@ -117,103 +116,103 @@ options:
|
|||
default: Dynamic
|
||||
ip_configurations:
|
||||
description:
|
||||
- List of ip configuration if contains mutilple configuration, should contain configuration object include
|
||||
field private_ip_address, private_ip_allocation_method, public_ip_address_name, public_ip, public_ip_allocation_method, name
|
||||
- List of IP configurations. Each configuration object should include
|
||||
field I(private_ip_address), I(private_ip_allocation_method), I(public_ip_address_name), I(public_ip), I(public_ip_allocation_method), I(name).
|
||||
suboptions:
|
||||
name:
|
||||
description:
|
||||
- Name of the ip configuration.
|
||||
- Name of the IP configuration.
|
||||
required: true
|
||||
private_ip_address:
|
||||
description:
|
||||
- Private ip address for the ip configuration.
|
||||
- Private IP address for the IP configuration.
|
||||
private_ip_allocation_method:
|
||||
description:
|
||||
- private ip allocation method.
|
||||
- Private IP allocation method.
|
||||
choices:
|
||||
- Dynamic
|
||||
- Static
|
||||
default: Dynamic
|
||||
public_ip_address_name:
|
||||
description:
|
||||
- Name of the public ip address. None for disable ip address.
|
||||
- Name of the public IP address. None for disable IP address.
|
||||
aliases:
|
||||
- public_ip_address
|
||||
- public_ip_name
|
||||
public_ip_allocation_method:
|
||||
description:
|
||||
- public ip allocation method.
|
||||
- Public IP allocation method.
|
||||
choices:
|
||||
- Dynamic
|
||||
- Static
|
||||
default: Dynamic
|
||||
load_balancer_backend_address_pools:
|
||||
description:
|
||||
- List of an existing load-balancer backend address pool id to associate with the network interface.
|
||||
- It can be write as a resource id.
|
||||
- List of existing load-balancer backend address pools to associate with the network interface.
|
||||
- Can be written as a resource ID.
|
||||
- Also can be a dict of I(name) and I(load_balancer).
|
||||
version_added: 2.6
|
||||
version_added: '2.6'
|
||||
primary:
|
||||
description:
|
||||
- Whether the ip configuration is the primary one in the list.
|
||||
- Whether the IP configuration is the primary one in the list.
|
||||
type: bool
|
||||
default: 'no'
|
||||
application_security_groups:
|
||||
description:
|
||||
- List of application security groups in which the IP configuration is included.
|
||||
- Element of the list could be a resource id of application security group, or dict of C(resource_group) and C(name).
|
||||
version_added: 2.8
|
||||
version_added: 2.5
|
||||
- Element of the list could be a resource id of application security group, or dict of I(resource_group) and I(name).
|
||||
version_added: '2.8'
|
||||
version_added: '2.5'
|
||||
enable_accelerated_networking:
|
||||
description:
|
||||
- Specifies whether the network interface should be created with the accelerated networking feature or not
|
||||
- Whether the network interface should be created with the accelerated networking feature or not.
|
||||
type: bool
|
||||
version_added: 2.7
|
||||
version_added: '2.7'
|
||||
default: False
|
||||
create_with_security_group:
|
||||
description:
|
||||
- Specifies whether a security group should be be created with the NIC.
|
||||
- If this flag set to C(True) and no C(security_group) set, a default security group will be created.
|
||||
- Whether a security group should be be created with the NIC.
|
||||
- If this flag set to C(True) and no I(security_group) set, a default security group will be created.
|
||||
type: bool
|
||||
version_added: 2.6
|
||||
version_added: '2.6'
|
||||
default: True
|
||||
security_group:
|
||||
description:
|
||||
- An existing security group with which to associate the network interface. If not provided, a
|
||||
default security group will be created when C(create_with_security_group) is true.
|
||||
- An existing security group with which to associate the network interface.
|
||||
- If not provided, a default security group will be created when I(create_with_security_group=true).
|
||||
- It can be the name of security group.
|
||||
- Make sure the security group is in the same resource group when you only give its name.
|
||||
- It can be the resource id.
|
||||
- It can be a dict contains security_group's C(name) and C(resource_group).
|
||||
- It can be a dict contains security_group's I(name) and I(resource_group).
|
||||
aliases:
|
||||
- security_group_name
|
||||
open_ports:
|
||||
description:
|
||||
- When a default security group is created for a Linux host a rule will be added allowing inbound TCP
|
||||
connections to the default SSH port 22, and for a Windows host rules will be added allowing inbound
|
||||
access to RDP ports 3389 and 5986. Override the default ports by providing a list of open ports.
|
||||
connections to the default SSH port C(22), and for a Windows host rules will be added allowing inbound
|
||||
access to RDP ports C(3389) and C(5986). Override the default ports by providing a list of open ports.
|
||||
enable_ip_forwarding:
|
||||
description:
|
||||
- Whether to enable IP forwarding
|
||||
- Whether to enable IP forwarding.
|
||||
aliases:
|
||||
- ip_forwarding
|
||||
type: bool
|
||||
default: False
|
||||
version_added: 2.7
|
||||
version_added: '2.7'
|
||||
dns_servers:
|
||||
description:
|
||||
- Which DNS servers should the NIC lookup
|
||||
- List of IP's
|
||||
- Which DNS servers should the NIC lookup.
|
||||
- List of IP addresses.
|
||||
type: list
|
||||
version_added: 2.7
|
||||
version_added: '2.7'
|
||||
extends_documentation_fragment:
|
||||
- azure
|
||||
- azure_tags
|
||||
|
||||
author:
|
||||
- "Chris Houseknecht (@chouseknecht)"
|
||||
- "Matt Davis (@nitzmahone)"
|
||||
- "Yuwei Zhou (@yuwzho)"
|
||||
- Chris Houseknecht (@chouseknecht)
|
||||
- Matt Davis (@nitzmahone)
|
||||
- Yuwei Zhou (@yuwzho)
|
||||
'''
|
||||
|
||||
EXAMPLES = '''
|
||||
|
@ -266,7 +265,7 @@ EXAMPLES = '''
|
|||
public_ip_address_name: publicip001
|
||||
primary: True
|
||||
|
||||
- name: Create a network with mutilple ip configurations
|
||||
- name: Create a network with multiple ip configurations
|
||||
azure_rm_networkinterface:
|
||||
name: nic004
|
||||
resource_group: myResourceGroup
|
||||
|
@ -323,43 +322,137 @@ EXAMPLES = '''
|
|||
|
||||
RETURN = '''
|
||||
state:
|
||||
description: The current state of the network interface.
|
||||
description:
|
||||
- The current state of the network interface.
|
||||
returned: always
|
||||
type: complex
|
||||
contains:
|
||||
dns_server:
|
||||
description:
|
||||
- Which DNS servers should the NIC lookup.
|
||||
- List of IP addresses.
|
||||
type: list
|
||||
sample: ['8.9.10.11', '7.8.9.10']
|
||||
dns_setting:
|
||||
description:
|
||||
- The DNS settings in network interface.
|
||||
type: dict
|
||||
sample: {
|
||||
"dns_settings": {
|
||||
"applied_dns_servers": [],
|
||||
"dns_servers": [],
|
||||
"dns_servers": [
|
||||
"8.9.10.11",
|
||||
"7.8.9.10"
|
||||
],
|
||||
"internal_dns_name_label": null,
|
||||
"internal_fqdn": null
|
||||
},
|
||||
"enable_ip_forwarding": false,
|
||||
"etag": 'W/"be115a43-2148-4545-a324-f33ad444c926"',
|
||||
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroup/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nic003",
|
||||
"ip_configurations": [{
|
||||
"name": "default",
|
||||
"private_ip_address": "10.1.0.10",
|
||||
"private_ip_allocation_method": "Static",
|
||||
"public_ip_address": {
|
||||
}
|
||||
enable_ip_forwarding:
|
||||
description:
|
||||
Whether to enable IP forwarding.
|
||||
type: bool
|
||||
sample: true
|
||||
etag:
|
||||
description:
|
||||
- A unique read-only string that changes whenever the resource is updated.
|
||||
type: str
|
||||
sample: 'W/"be115a43-2148-4545-a324-f33ad444c926"'
|
||||
id:
|
||||
description:
|
||||
- Id of the network interface.
|
||||
type: str
|
||||
sample: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroup/myResourceGroup/providers/Microsoft.Network/networkInterfaces/nic003"
|
||||
enable_accelerated_networking:
|
||||
description:
|
||||
- Whether the network interface should be created with the accelerated networking feature or not.
|
||||
type: bool
|
||||
sample: true
|
||||
ip_configurations:
|
||||
description:
|
||||
- List of IP configurations.
|
||||
type: complex
|
||||
contains:
|
||||
name:
|
||||
description:
|
||||
- Name of the IP configuration.
|
||||
type: str
|
||||
sample: default
|
||||
load_balancer_backend_address_pools:
|
||||
description:
|
||||
- List of existing load-balancer backend address pools to associate with the network interface.
|
||||
type: list
|
||||
private_ip_address:
|
||||
description:
|
||||
- Private IP address for the IP configuration.
|
||||
type: str
|
||||
sample: "10.1.0.10"
|
||||
private_ip_allocation_method:
|
||||
description:
|
||||
- Private IP allocation method.
|
||||
type: str
|
||||
sample: "Static"
|
||||
public_ip_address:
|
||||
description:
|
||||
- Name of the public IP address. None for disable IP address.
|
||||
type: dict
|
||||
sample: {
|
||||
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroup/myResourceGroup/providers/Microsoft.Network/publicIPAddresse
|
||||
s/publicip001",
|
||||
"name": "publicip001"
|
||||
},
|
||||
"subnet": {},
|
||||
"load_balancer_backend_address_pools": []
|
||||
}],
|
||||
"location": "eastus2",
|
||||
"mac_address": null,
|
||||
"name": "nic003",
|
||||
"network_security_group": {
|
||||
"id": "/subscriptions//xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroup/myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/nsg001",
|
||||
"name": "nsg001"
|
||||
},
|
||||
"primary": null,
|
||||
"provisioning_state": "Succeeded",
|
||||
"tags": null,
|
||||
"type": "Microsoft.Network/networkInterfaces"
|
||||
}
|
||||
subnet:
|
||||
description:
|
||||
- The reference of the subnet resource.
|
||||
type: dict
|
||||
sample: {
|
||||
"id": "/subscriptions/xxxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/
|
||||
myresourcegroup/providers/Microsoft.Network/virtualNetworks/tnb57dc95318/subnets/tnb57dc95318",
|
||||
"name": "tnb57dc95318",
|
||||
"resource_group": "myresourcegroup",
|
||||
"virtual_network_name": "tnb57dc95318"
|
||||
}
|
||||
location:
|
||||
description:
|
||||
- The network interface resource location.
|
||||
type: str
|
||||
sample: eastus
|
||||
mac_address:
|
||||
description:
|
||||
- The MAC address of the network interface.
|
||||
type: str
|
||||
name:
|
||||
description:
|
||||
- Name of the network interface.
|
||||
type: str
|
||||
sample: nic003
|
||||
network_security_group:
|
||||
description:
|
||||
- The reference of the network security group resource.
|
||||
type: dict
|
||||
sample: {
|
||||
"id": "/subscriptions//xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroup/
|
||||
myResourceGroup/providers/Microsoft.Network/networkSecurityGroups/nsg001",
|
||||
"name": "nsg001"
|
||||
}
|
||||
primary:
|
||||
description:
|
||||
- Get whether this is a primary network interface on virtual machine.
|
||||
type: bool
|
||||
sample: true
|
||||
provisioning_state:
|
||||
description:
|
||||
- The provisioning state of the public IP resource.
|
||||
type: str
|
||||
sample: Succeeded
|
||||
tags:
|
||||
description:
|
||||
-Tags of the network interface.
|
||||
type: dict
|
||||
sample: { 'key': 'value' }
|
||||
type:
|
||||
description:
|
||||
- Type of the resource.
|
||||
type: str
|
||||
sample: "Microsoft.Network/networkInterfaces"
|
||||
'''
|
||||
|
||||
try:
|
||||
|
|
|
@ -20,7 +20,7 @@ module: azure_rm_networkinterface_facts
|
|||
|
||||
version_added: "2.1"
|
||||
|
||||
short_description: Get network interface facts.
|
||||
short_description: Get network interface facts
|
||||
|
||||
description:
|
||||
- Get facts for a specific network interface or all network interfaces within a resource group.
|
||||
|
@ -40,8 +40,8 @@ extends_documentation_fragment:
|
|||
- azure
|
||||
|
||||
author:
|
||||
- "Chris Houseknecht (@chouseknecht)"
|
||||
- "Matt Davis (@nitzmahone)"
|
||||
- Chris Houseknecht (@chouseknecht)
|
||||
- Matt Davis (@nitzmahone)
|
||||
|
||||
'''
|
||||
|
||||
|
@ -65,7 +65,8 @@ EXAMPLES = '''
|
|||
|
||||
RETURN = '''
|
||||
azure_networkinterfaces:
|
||||
description: List of network interface dicts.
|
||||
description:
|
||||
- List of network interface dicts.
|
||||
returned: always
|
||||
type: list
|
||||
example: [{
|
||||
|
@ -105,7 +106,8 @@ azure_networkinterfaces:
|
|||
"type": "Microsoft.Network/networkInterfaces"
|
||||
}]
|
||||
networkinterfaces:
|
||||
description: List of network interface dict, the dict contains parameters can be passed to C(azure_rm_networkinterface) module.
|
||||
description:
|
||||
- List of network interface dicts. Each dict contains parameters can be passed to M(azure_rm_networkinterface) module.
|
||||
type: list
|
||||
returned: always
|
||||
contains:
|
||||
|
@ -124,7 +126,7 @@ networkinterfaces:
|
|||
virtual_network:
|
||||
description:
|
||||
- An existing virtual network with which the network interface will be associated.
|
||||
- It is a dict which contains C(name) and C(resource_group) of the virtual network.
|
||||
- It is a dict which contains I(name) and I(resource_group) of the virtual network.
|
||||
subnet:
|
||||
description:
|
||||
- Name of an existing subnet within the specified virtual network.
|
||||
|
@ -133,36 +135,36 @@ networkinterfaces:
|
|||
- Tags of the network interface.
|
||||
ip_configurations:
|
||||
description:
|
||||
- List of ip configuration if contains mutilple configuration.
|
||||
- List of IP configurations, if contains multiple configurations.
|
||||
contains:
|
||||
name:
|
||||
description:
|
||||
- Name of the ip configuration.
|
||||
- Name of the IP configuration.
|
||||
private_ip_address:
|
||||
description:
|
||||
- Private ip address for the ip configuration.
|
||||
- Private IP address for the IP configuration.
|
||||
private_ip_allocation_method:
|
||||
description:
|
||||
- private ip allocation method.
|
||||
- Private IP allocation method.
|
||||
public_ip_address:
|
||||
description:
|
||||
- Name of the public ip address. None for disable ip address.
|
||||
- Name of the public IP address. None for disable IP address.
|
||||
public_ip_allocation_method:
|
||||
description:
|
||||
- public ip allocation method.
|
||||
- Public IP allocation method.
|
||||
load_balancer_backend_address_pools:
|
||||
description:
|
||||
- List of an existing load-balancer backend address pool id to associate with the network interface.
|
||||
- List of existing load-balancer backend address pools to associate with the network interface.
|
||||
primary:
|
||||
description:
|
||||
- Whether the ip configuration is the primary one in the list.
|
||||
- Whether the IP configuration is the primary one in the list.
|
||||
application_security_groups:
|
||||
description:
|
||||
- List of Application security groups.
|
||||
sample: /subscriptions/<subsid>/resourceGroups/<rg>/providers/Microsoft.Network/applicationSecurityGroups/myASG
|
||||
enable_accelerated_networking:
|
||||
description:
|
||||
- Specifies whether the network interface should be created with the accelerated networking feature or not
|
||||
- Specifies whether the network interface should be created with the accelerated networking feature or not.
|
||||
create_with_security_group:
|
||||
description:
|
||||
- Specifies whether a default security group should be be created with the NIC. Only applies when creating a new NIC.
|
||||
|
@ -175,8 +177,8 @@ networkinterfaces:
|
|||
- Whether to enable IP forwarding
|
||||
dns_servers:
|
||||
description:
|
||||
- Which DNS servers should the NIC lookup
|
||||
- List of IP's
|
||||
- Which DNS servers should the NIC lookup.
|
||||
- List of IP addresses.
|
||||
mac_address:
|
||||
description:
|
||||
- The MAC address of the network interface.
|
||||
|
@ -188,15 +190,18 @@ networkinterfaces:
|
|||
- The DNS settings in network interface.
|
||||
contains:
|
||||
dns_servers:
|
||||
description: List of DNS servers IP addresses.
|
||||
description:
|
||||
- List of DNS servers IP addresses.
|
||||
applied_dns_servers:
|
||||
description:
|
||||
- If the VM that uses this NIC is part of an Availability Set, then this list will have the union of all DNS servers
|
||||
from all NICs that are part of the Availability Set. This property is what is configured on each of those VMs.
|
||||
internal_dns_name_label:
|
||||
description: Relative DNS name for this NIC used for internal communications between VMs in the same virtual network.
|
||||
description:
|
||||
- Relative DNS name for this NIC used for internal communications between VMs in the same virtual network.
|
||||
internal_fqdn:
|
||||
description: Fully qualified DNS name supporting internal communications between VMs in the same virtual network.
|
||||
description:
|
||||
- Fully qualified DNS name supporting internal communications between VMs in the same virtual network.
|
||||
''' # NOQA
|
||||
try:
|
||||
from msrestazure.azure_exceptions import CloudError
|
||||
|
|
Loading…
Reference in a new issue