Viewing vNET Access

Virtual network access (vNET Access) allows sharing of vNETs between tenants. View the vNET Access objects in your own tenancy to determine what vNETs you have permission to use when configuring virtual machines. Tenant users and administrators can fetch the vNET Access information to determine the vNETs that they can use.

Topics:

Discover vNET Access

This API enables you to discover a list of vNet Access entities configured in a specific container.

Note:

The discover API calls display the names of the objects in the specified container, not the details about the objects. To list the names of the objects, you must set the Accept header to application/oracle-compute-v3+directory+json. For all other purposes, you must set the Accept header to application/oracle-compute-v3+json.

Method

GET

REST Resource

/vnetaccess/container/

URI

https://api_endpoint/vnetaccess/container/

URI Parameter

Parameter Description
container Hierarchical namespace for vNET access.

Example URI

https://api.oc.example.com/vnetaccess/mytenant/public

Example Response Body

Data:
{"result": [
        "/mytenant/public/IPoIB-instance-storage-c2", 
        "/mytenant/public/IPoIB-load-balancer-c2", 
        "/mytenant/public/IPoIB-management-c2", 
        "/mytenant/public/IPoIB-service-manager-c2", 
        "/mytenant/public/IPoIB-virt-admin-c2"
]}

List vNET Access

This API enables you list information for all the vNet Access entities in a container.

Method

GET

REST Resource

/vnetaccess/container/

URI

https://api_endpoint/vnetaccess/container?vnet=vnetValue

URI Parameters

Parameter Description
container Hierarchical name-space for vNET Access
vnet=vnetValue (Optional) Name of the associated virtual network

Example URI

https://api.oc.example.com/vnetaccess/mytenant/public/

Example Response Body


{
"result": 
        [{
                        "permissions": {"object": ["...."]}, 
                        "vnet": "/cloud/public/EoIB-OMS", 
                        "uri": "https://api.oc.example.com/vnetaccess/mytenant/public/EoIB-OMS", 
                        "name": "/mytenant/public/EoIB-OMS", 
                        "provider": false
        }]
}

Get vNET Access

This API enables you to retrieve information for a specific vNET access entity in a specific container.

Method

GET

REST Resource

/vnetaccess/name

URI

https://api_endpoint/vnetaccess/name

URI Parameter

Parameter Description
name A unique hierarchical name for the virtual network access. For example, /mytenant/public/myvnetworkaccess

Example URI

https://api.oc.example.com/vnetaccess/mytenant/public/EoIB-OMS

Example Response Body

{
"permissions": 
        {"object": ["b8c73cc2-1600-592...... "774ec529-acaf-5d53-bd1c-46726d7e091a", "95e5b59d-cde4-5530-a334-81b22095e19c"]}, 
        "vnet": "/cloud/public/EoIB-OMS", 
        "uri": "https://api.oc.example.com/vnetaccess/mytenant/public/EoIB-OMS", 
        "name": "/mytenant/public/EoIB-OMS",
        "provider": false
}