Disk Accesses - List
Lists all the disk access resources under a subscription.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/diskAccesses?api-version=2023-10-02
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client Api Version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
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
List all disk access resources in a subscription.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.Compute/diskAccesses?api-version=2023-10-02
Sample Response
{
"value": [
{
"properties": {
"provisioningState": "Succeeded",
"timeCreated": "2020-05-01T04:41:35.079872+00:00"
},
"type": "Microsoft.Compute/diskAccesses",
"location": "westus",
"tags": {
"department": "Development",
"project": "PrivateEndpoints"
},
"id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess",
"name": "myDiskAccess"
},
{
"properties": {
"provisioningState": "Succeeded",
"timeCreated": "2020-05-01T04:41:35.079872+00:00",
"privateEndpointConnections": [
{
"name": "myDiskAccess.d4914cfa-6bc2-4049-a57c-3d1f622d8eef",
"type": "Microsoft.Compute/diskAccesses/PrivateEndpointConnections",
"id": "/subscriptions/{subscription-id}/resourceGroups/mySecondResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess2/privateEndpoinConnections/myDiskAccess2.d4914cfa-6bc2-4049-a57c-3d1f622d8eef",
"properties": {
"provisioningState": "Succeeded",
"privateEndpoint": {
"id": "/subscriptions/{subscription-id}/resourceGroups/mySecondResourceGroup/providers/Microsoft.Network/privateEndpoints/myPrivateEndpoint2"
},
"privateLinkServiceConnectionState": {
"actionsRequired": "None",
"description": "Auto-Approved",
"status": "Approved"
}
}
}
]
},
"type": "Microsoft.Compute/diskAccesses",
"location": "westus",
"tags": {
"department": "Development",
"project": "PrivateEndpoints"
},
"id": "/subscriptions/{subscription-id}/resourceGroups/mySecondResourceGroup/providers/Microsoft.Compute/diskAccesses/myDiskAccess2",
"name": "myDiskAccess2"
}
],
"nextLink": "https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/diskAccesses?$skiptoken={token}"
}
Definitions
Name | Description |
---|---|
Api |
Api error. |
Api |
Api error base. |
Cloud |
An error response from the Compute service. |
Disk |
disk access resource. |
Disk |
The List disk access operation response. |
Extended |
The complex type of the extended location. |
Extended |
The type of the extended location. |
Inner |
Inner error details. |
Private |
The Private Endpoint resource. |
Private |
The Private Endpoint Connection resource. |
Private |
The current provisioning state. |
Private |
The private endpoint connection status. |
Private |
A collection of information about the state of the connection between service consumer and provider. |
ApiError
Api error.
Name | Type | Description |
---|---|---|
code |
string |
The error code. |
details |
The Api error details |
|
innererror |
The Api inner error |
|
message |
string |
The error message. |
target |
string |
The target of the particular error. |
ApiErrorBase
Api error base.
Name | Type | Description |
---|---|---|
code |
string |
The error code. |
message |
string |
The error message. |
target |
string |
The target of the particular error. |
CloudError
An error response from the Compute service.
Name | Type | Description |
---|---|---|
error |
Api error. |
DiskAccess
disk access resource.
Name | Type | Description |
---|---|---|
extendedLocation |
The extended location where the disk access will be created. Extended location cannot be changed. |
|
id |
string |
Resource Id |
location |
string |
Resource location |
name |
string |
Resource name |
properties.privateEndpointConnections |
A readonly collection of private endpoint connections created on the disk. Currently only one endpoint connection is supported. |
|
properties.provisioningState |
string |
The disk access resource provisioning state. |
properties.timeCreated |
string |
The time when the disk access was created. |
tags |
object |
Resource tags |
type |
string |
Resource type |
DiskAccessList
The List disk access operation response.
Name | Type | Description |
---|---|---|
nextLink |
string |
The uri to fetch the next page of disk access resources. Call ListNext() with this to fetch the next page of disk access resources. |
value |
A list of disk access resources. |
ExtendedLocation
The complex type of the extended location.
Name | Type | Description |
---|---|---|
name |
string |
The name of the extended location. |
type |
The type of the extended location. |
ExtendedLocationTypes
The type of the extended location.
Name | Type | Description |
---|---|---|
EdgeZone |
string |
InnerError
Inner error details.
Name | Type | Description |
---|---|---|
errordetail |
string |
The internal error message or exception dump. |
exceptiontype |
string |
The exception type. |
PrivateEndpoint
The Private Endpoint resource.
Name | Type | Description |
---|---|---|
id |
string |
The ARM identifier for Private Endpoint |
PrivateEndpointConnection
The Private Endpoint Connection resource.
Name | Type | Description |
---|---|---|
id |
string |
private endpoint connection Id |
name |
string |
private endpoint connection name |
properties.privateEndpoint |
The resource of private end point. |
|
properties.privateLinkServiceConnectionState |
A collection of information about the state of the connection between DiskAccess and Virtual Network. |
|
properties.provisioningState |
The provisioning state of the private endpoint connection resource. |
|
type |
string |
private endpoint connection type |
PrivateEndpointConnectionProvisioningState
The current provisioning state.
Name | Type | Description |
---|---|---|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
PrivateEndpointServiceConnectionStatus
The private endpoint connection status.
Name | Type | Description |
---|---|---|
Approved |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateLinkServiceConnectionState
A collection of information about the state of the connection between service consumer and provider.
Name | Type | Description |
---|---|---|
actionsRequired |
string |
A message indicating if changes on the service provider require any updates on the consumer. |
description |
string |
The reason for approval/rejection of the connection. |
status |
Indicates whether the connection has been Approved/Rejected/Removed by the owner of the service. |