v Net Peering - Get

Reference

Service:: Databricks

API Version:: 2024-05-01

Gets the workspace vNet Peering.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Databricks/workspaces/{workspaceName}/virtualNetworkPeerings/{peeringName}?api-version=2024-05-01

URI Parameters

Name	In	Required	Type	Description
peeringName	path	True	string	The name of the workspace vNet peering.
resourceGroupName	path	True	string	The name of the resource group. The name is case insensitive.
subscriptionId	path	True	string uuid	The ID of the target subscription. The value must be an UUID.
workspaceName	path	True	string	The name of the workspace.
api-version	query	True	string	The API version to use for this operation.

Responses

Name	Type	Description
200 OK	VirtualNetworkPeering	OK. The request has succeeded.
204 No Content		OK - NoContent
Other Status Codes	ErrorResponse	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

Get a workspace with vNet Peering Configured

Sample request

HTTP

GET https://management.azure.com/subscriptions/0140911e-1040-48da-8bc9-b99fb3dd88a6//resourceGroups/subramantest/providers/Microsoft.Databricks/workspaces/adbworkspace/virtualNetworkPeerings/vNetPeeringTest?api-version=2024-05-01

Sample response

Status code:: 200

{
  "id": "/subscriptions/0140911e-1040-48da-8bc9-b99fb3dd88a6/resourceGroups/subramantest/providers/Microsoft.Databricks/workspaces/adbworkspace/virtualNetworkPeerings/vNetPeeringTest",
  "name": "vNetPeeringTest",
  "properties": {
    "allowVirtualNetworkAccess": true,
    "allowForwardedTraffic": false,
    "allowGatewayTransit": false,
    "useRemoteGateways": false,
    "remoteVirtualNetwork": {
      "id": "/subscriptions/0140911e-1040-48da-8bc9-b99fb3dd88a6/resourceGroups/subramantest/providers/Microsoft.Network/virtualNetworks/subramanvnet"
    },
    "remoteAddressSpace": {
      "addressPrefixes": [
        "10.203.0.0/16"
      ]
    },
    "databricksVirtualNetwork": {
      "id": "/subscriptions/0140911e-1040-48da-8bc9-b99fb3dd88a6/resourceGroups/databricks-rg-adbworkspace-2jsxhmzoyooxm/providers/Microsoft.Network/virtualNetworks/workers-vnet"
    },
    "databricksAddressSpace": {
      "addressPrefixes": [
        "10.139.0.0/16"
      ]
    },
    "peeringState": "Initiated",
    "provisioningState": "Succeeded"
  }
}

Status code:: 204

Definitions

Name	Description
AddressSpace	AddressSpace contains an array of IP address ranges that can be used by subnets of the virtual network.
DatabricksVirtualNetwork	The remote virtual network should be in the same region. See here to learn more (https://docs.microsoft.com/en-us/azure/databricks/administration-guide/cloud-configurations/azure/vnet-peering).
ErrorDetail	Error details.
ErrorInfo	The code and message for an error.
ErrorResponse	Error response.
PeeringProvisioningState	The current provisioning state.
peeringState	The status of the virtual network peering.
RemoteVirtualNetwork	The remote virtual network should be in the same region. See here to learn more (https://docs.microsoft.com/en-us/azure/databricks/administration-guide/cloud-configurations/azure/vnet-peering).
VirtualNetworkPeering	Peerings in a VirtualNetwork resource

AddressSpace

AddressSpace contains an array of IP address ranges that can be used by subnets of the virtual network.

Name	Type	Description
addressPrefixes	string[]	A list of address blocks reserved for this virtual network in CIDR notation.

DatabricksVirtualNetwork

The remote virtual network should be in the same region. See here to learn more (https://docs.microsoft.com/en-us/azure/databricks/administration-guide/cloud-configurations/azure/vnet-peering).

Name	Type	Description
id	string	The Id of the databricks virtual network.

ErrorDetail

Error details.

Name	Type	Description
code	string	The error's code.
message	string	A human readable error message.
target	string	Indicates which property in the request is responsible for the error.

ErrorInfo

The code and message for an error.

Name	Type	Description
code	string	A machine readable error code.
details	ErrorDetail[]	error details.
innererror	string	Inner error details if they exist.
message	string	A human readable error message.

ErrorResponse

Error response.

Name	Type	Description
error	ErrorInfo	The code and message for an error. The error details.

PeeringProvisioningState

The current provisioning state.

Name	Type	Description
Deleting	string
Failed	string
Succeeded	string
Updating	string

peeringState

The status of the virtual network peering.

Name	Type	Description
Connected	string
Disconnected	string
Initiated	string

RemoteVirtualNetwork