Shared Private Link Resources - List By Service
Gets a list of all shared private link resources managed by the given service.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}/sharedPrivateLinkResources?api-version=2023-11-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
The name of the resource group within the current subscription. You can obtain this value from the Azure Resource Manager API or the portal. |
search
|
path | True |
string |
The name of the search service associated with the specified resource group. |
subscription
|
path | True |
string |
The unique identifier for a Microsoft Azure subscription. You can obtain this value from the Azure Resource Manager API, command line tools, or the portal. |
api-version
|
query | True |
string |
The API version to use for each request. |
Request Header
Name | Required | Type | Description |
---|---|---|---|
x-ms-client-request-id |
string uuid |
A client-generated GUID value that identifies this request. If specified, this will be included in response information as a way to track the request. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
The operation succeeded. The response contains the list of all shared private link resources managed by the given service. |
|
Other Status Codes |
An unexpected error occurred during the operation. |
Security
azure_auth
Microsoft Entra ID OAuth2 authorization flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
ListSharedPrivateLinkResourcesByService
Sample request
Sample response
{
"value": [
{
"name": "testResource",
"type": "Microsoft.Search/searchServices/sharedPrivateLinkResources",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Search/searchServices/mysearchservice/sharedPrivateLinkResources/testResource",
"properties": {
"requestMessage": "please approve",
"groupId": "blob",
"privateLinkResourceId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/storageAccountName",
"status": "Pending",
"resourceRegion": null
}
}
]
}
Definitions
Name | Description |
---|---|
Cloud |
Contains information about an API error. |
Cloud |
Describes a particular API error with an error code and a message. |
Shared |
Describes a Shared Private Link Resource managed by the search service. |
Shared |
Response containing a list of Shared Private Link Resources. |
Shared |
Describes the properties of an existing Shared Private Link Resource managed by the search service. |
Shared |
The provisioning state of the shared private link resource. Valid values are Updating, Deleting, Failed, Succeeded or Incomplete. |
Shared |
Status of the shared private link resource. Valid values are Pending, Approved, Rejected or Disconnected. |
CloudError
Contains information about an API error.
Name | Type | Description |
---|---|---|
error |
Describes a particular API error with an error code and a message. |
CloudErrorBody
Describes a particular API error with an error code and a message.
Name | Type | Description |
---|---|---|
code |
string |
An error code that describes the error condition more precisely than an HTTP status code. Can be used to programmatically handle specific error cases. |
details |
Contains nested errors that are related to this error. |
|
message |
string |
A message that describes the error in detail and provides debugging information. |
target |
string |
The target of the particular error (for example, the name of the property in error). |
SharedPrivateLinkResource
Describes a Shared Private Link Resource managed by the search service.
Name | Type | 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 |
properties |
Describes the properties of a Shared Private Link Resource managed by the search service. |
|
type |
string |
The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" |
SharedPrivateLinkResourceListResult
Response containing a list of Shared Private Link Resources.
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of shared private link resources, if there are any. |
value |
The list of Shared Private Link Resources. |
SharedPrivateLinkResourceProperties
Describes the properties of an existing Shared Private Link Resource managed by the search service.
Name | Type | Description |
---|---|---|
groupId |
string |
The group id from the provider of resource the shared private link resource is for. |
privateLinkResourceId |
string |
The resource id of the resource the shared private link resource is for. |
provisioningState |
The provisioning state of the shared private link resource. Valid values are Updating, Deleting, Failed, Succeeded or Incomplete. |
|
requestMessage |
string |
The request message for requesting approval of the shared private link resource. |
resourceRegion |
string |
Optional. Can be used to specify the Azure Resource Manager location of the resource to which a shared private link is to be created. This is only required for those resources whose DNS configuration are regional (such as Azure Kubernetes Service). |
status |
Status of the shared private link resource. Valid values are Pending, Approved, Rejected or Disconnected. |
SharedPrivateLinkResourceProvisioningState
The provisioning state of the shared private link resource. Valid values are Updating, Deleting, Failed, Succeeded or Incomplete.
Name | Type | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Incomplete |
string |
|
Succeeded |
string |
|
Updating |
string |
SharedPrivateLinkResourceStatus
Status of the shared private link resource. Valid values are Pending, Approved, Rejected or Disconnected.
Name | Type | Description |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |