private_endpoints
Creates, updates, deletes, gets or lists a private_endpoints
resource.
Overview
Name | private_endpoints |
Type | Resource |
Id | azure.network.private_endpoints |
Fields
The following fields are returned by SELECT
queries:
- get
- list
- list_by_subscription
Request successful. The operation returns the resulting private endpoint resource.
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
etag | string | A unique read-only string that changes whenever the resource is updated. |
extendedLocation | object | The extended location of the load balancer. |
properties | object | Properties of the private endpoint. |
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" |
Request successful. The operation returns a list of private endpoint resources.
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
etag | string | A unique read-only string that changes whenever the resource is updated. |
extendedLocation | object | The extended location of the load balancer. |
properties | object | Properties of the private endpoint. |
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" |
Request successful. The operation returns a list of private endpoint resources.
Name | Datatype | Description |
---|---|---|
id | string (arm-id) | Fully qualified resource ID for the resource. E.g. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name | string | The name of the resource |
etag | string | A unique read-only string that changes whenever the resource is updated. |
extendedLocation | object | The extended location of the load balancer. |
properties | object | Properties of the private endpoint. |
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" |
Methods
The following methods are available for this resource:
Name | Accessible by | Required Params | Optional Params | Description |
---|---|---|---|---|
get | select | resourceGroupName , privateEndpointName , subscriptionId | $expand | Gets the specified private endpoint by resource group. |
list | select | resourceGroupName , subscriptionId | Gets all private endpoints in a resource group. | |
list_by_subscription | select | subscriptionId | Gets all private endpoints in a subscription. | |
create_or_update | insert | resourceGroupName , privateEndpointName , subscriptionId | Creates or updates an private endpoint in the specified resource group. | |
delete | delete | resourceGroupName , privateEndpointName , subscriptionId | Deletes the specified private endpoint. |
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 |
---|---|---|
privateEndpointName | string | The name of the private endpoint. |
resourceGroupName | string | The name of the resource group. |
subscriptionId | string (uuid) | The ID of the target subscription. The value must be an UUID. |
$expand | string | Expands referenced resources. |
SELECT
examples
- get
- list
- list_by_subscription
Gets the specified private endpoint by resource group.
SELECT
id,
name,
etag,
extendedLocation,
properties,
systemData,
type
FROM azure.network.private_endpoints
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND privateEndpointName = '{{ privateEndpointName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
AND $expand = '{{ $expand }}'
;
Gets all private endpoints in a resource group.
SELECT
id,
name,
etag,
extendedLocation,
properties,
systemData,
type
FROM azure.network.private_endpoints
WHERE resourceGroupName = '{{ resourceGroupName }}' -- required
AND subscriptionId = '{{ subscriptionId }}' -- required
;
Gets all private endpoints in a subscription.
SELECT
id,
name,
etag,
extendedLocation,
properties,
systemData,
type
FROM azure.network.private_endpoints
WHERE subscriptionId = '{{ subscriptionId }}' -- required
;
INSERT
examples
- create_or_update
- Manifest
Creates or updates an private endpoint in the specified resource group.
INSERT INTO azure.network.private_endpoints (
data__extendedLocation,
data__properties,
resourceGroupName,
privateEndpointName,
subscriptionId
)
SELECT
'{{ extendedLocation }}',
'{{ properties }}',
'{{ resourceGroupName }}',
'{{ privateEndpointName }}',
'{{ subscriptionId }}'
RETURNING
id,
name,
etag,
extendedLocation,
properties,
systemData,
type
;
# Description fields are for documentation purposes
- name: private_endpoints
props:
- name: resourceGroupName
value: string
description: Required parameter for the private_endpoints resource.
- name: privateEndpointName
value: string
description: Required parameter for the private_endpoints resource.
- name: subscriptionId
value: string (uuid)
description: Required parameter for the private_endpoints resource.
- name: extendedLocation
value: object
description: |
The extended location of the load balancer.
- name: properties
value: object
description: |
Properties of the private endpoint.
DELETE
examples
- delete
Deletes the specified private endpoint.
DELETE FROM azure.network.private_endpoints
WHERE resourceGroupName = '{{ resourceGroupName }}' --required
AND privateEndpointName = '{{ privateEndpointName }}' --required
AND subscriptionId = '{{ subscriptionId }}' --required
;