managed_virtual_networks
Creates, updates, deletes, gets or lists a managed_virtual_networks resource.
Overview
| Name | managed_virtual_networks |
| Type | Resource |
| Id | azure.data_factory.managed_virtual_networks |
Fields
The following fields are returned by SELECT queries:
- get
- list_by_factory
| Name | Datatype | Description |
|---|---|---|
id | string | Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. |
name | string | The name of the resource. |
alias | string | Managed Virtual Network alias. |
etag | string | "If etag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields."). |
systemData | object | Azure Resource Manager metadata containing createdBy and modifiedBy information. |
type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts". |
vNetId | string | Managed Virtual Network ID. |
| Name | Datatype | Description |
|---|---|---|
id | string | Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}. |
name | string | The name of the resource. |
alias | string | Managed Virtual Network alias. |
etag | string | "If etag is provided in the response body, it may also be provided as a header per the normal etag convention. Entity tags are used for comparing two or more entities from the same requested resource. HTTP/1.1 uses entity tags in the etag (section 14.19), If-Match (section 14.24), If-None-Match (section 14.26), and If-Range (section 14.27) header fields."). |
systemData | object | Azure Resource Manager metadata containing createdBy and modifiedBy information. |
type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts". |
vNetId | string | Managed Virtual Network ID. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | resource_group_name, factory_name, managed_virtual_network_name, subscription_id | Gets a managed Virtual Network. | |
list_by_factory | select | resource_group_name, factory_name, subscription_id | Lists managed Virtual Networks. | |
create_or_update | insert | resource_group_name, factory_name, managed_virtual_network_name, subscription_id, properties | Creates or updates a managed Virtual Network. | |
create_or_update | replace | resource_group_name, factory_name, managed_virtual_network_name, subscription_id, properties | Creates or updates a managed Virtual Network. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
factory_name | string | The factory name. Required. |
managed_virtual_network_name | string | Managed virtual network name. Required. |
resource_group_name | string | The name of the resource group. The name is case insensitive. Required. |
subscription_id | string |
SELECT examples
- get
- list_by_factory
Gets a managed Virtual Network.
SELECT
id,
name,
alias,
etag,
systemData,
type,
vNetId
FROM azure.data_factory.managed_virtual_networks
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND factory_name = '{{ factory_name }}' -- required
AND managed_virtual_network_name = '{{ managed_virtual_network_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;
Lists managed Virtual Networks.
SELECT
id,
name,
alias,
etag,
systemData,
type,
vNetId
FROM azure.data_factory.managed_virtual_networks
WHERE resource_group_name = '{{ resource_group_name }}' -- required
AND factory_name = '{{ factory_name }}' -- required
AND subscription_id = '{{ subscription_id }}' -- required
;
INSERT examples
- create_or_update
- Manifest
Creates or updates a managed Virtual Network.
INSERT INTO azure.data_factory.managed_virtual_networks (
properties,
resource_group_name,
factory_name,
managed_virtual_network_name,
subscription_id
)
SELECT
'{{ properties }}' /* required */,
'{{ resource_group_name }}',
'{{ factory_name }}',
'{{ managed_virtual_network_name }}',
'{{ subscription_id }}'
RETURNING
id,
name,
etag,
properties,
systemData,
type
;
# Description fields are for documentation purposes
- name: managed_virtual_networks
props:
- name: resource_group_name
value: "{{ resource_group_name }}"
description: Required parameter for the managed_virtual_networks resource.
- name: factory_name
value: "{{ factory_name }}"
description: Required parameter for the managed_virtual_networks resource.
- name: managed_virtual_network_name
value: "{{ managed_virtual_network_name }}"
description: Required parameter for the managed_virtual_networks resource.
- name: subscription_id
value: "{{ subscription_id }}"
description: Required parameter for the managed_virtual_networks resource.
- name: properties
description: |
Managed Virtual Network properties. Required.
value:
vNetId: "{{ vNetId }}"
alias: "{{ alias }}"
REPLACE examples
- create_or_update
Creates or updates a managed Virtual Network.
REPLACE azure.data_factory.managed_virtual_networks
SET
properties = '{{ properties }}'
WHERE
resource_group_name = '{{ resource_group_name }}' --required
AND factory_name = '{{ factory_name }}' --required
AND managed_virtual_network_name = '{{ managed_virtual_network_name }}' --required
AND subscription_id = '{{ subscription_id }}' --required
AND properties = '{{ properties }}' --required
RETURNING
id,
name,
etag,
properties,
systemData,
type;