Compartir a través de


Private Link Resources - List By Server

Obtiene los recursos de vínculo privado para SQL Server.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/privateLinkResources?api-version=2025-01-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.

serverName
path True

string

El nombre del servidor.

subscriptionId
path True

string

Identificador de suscripción que identifica una suscripción de Azure.

api-version
query True

string

Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

PrivateLinkResourceListResult

Se han recuperado correctamente los recursos de private link.

Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 InvalidServerName: nombre de servidor no válido especificado.

  • 400 InvalidIdentifier: el identificador contiene NULL o un carácter unicode no válido.

  • 400 TokenTooLong: el token proporcionado es demasiado largo.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 404 OperationIdNotFound: la operación con id. no existe.

  • 409 CannotCancelOperation: la operación de administración está en un estado que no se puede cancelar.

  • 409 OperationCancelled: el usuario canceló la operación.

  • 409 OperationInterrupted: no se pudo completar la operación en el recurso porque se interrumpió otra operación en el mismo recurso.

  • 429 SubscriptionTooManyCreateUpdateRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

  • 429 SubscriptionTooManyRequests: solicitudes más allá de las solicitudes máximas que los recursos disponibles pueden procesar.

  • 500 OperationTimedOut: la operación agota el tiempo de espera y se revierte automáticamente. Vuelva a intentar la operación.

  • 503 TooManyRequests: solicitudes más allá de las solicitudes máximas que pueden procesar los recursos disponibles.

Ejemplos

Solicitud de ejemplo

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateLinkResources?api-version=2025-01-01

Respuesta de muestra

{
  "value": [
    {
      "id": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/test-svr/privateLinkResources/plr",
      "name": "plr",
      "type": "Microsoft.Sql/servers/privateLinkResources",
      "properties": {
        "groupId": "sqlServer",
        "requiredMembers": [
          "sqlServer"
        ]
      }
    }
  ]
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

PrivateLinkResource

Un recurso de vínculo privado

PrivateLinkResourceListResult

Lista de recursos de private link

PrivateLinkResourceProperties

Propiedades de un recurso de vínculo privado.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

PrivateLinkResource

Un recurso de vínculo privado

Nombre Tipo Description
id

string

Identificador de recurso.

name

string

Nombre del recurso.

properties

PrivateLinkResourceProperties

Identificador del grupo de recursos private link.

type

string

Tipo de recurso.

PrivateLinkResourceListResult

Lista de recursos de private link

Nombre Tipo Description
nextLink

string

Vínculo para recuperar la siguiente página de resultados.

value

PrivateLinkResource[]

Matriz de resultados.

PrivateLinkResourceProperties

Propiedades de un recurso de vínculo privado.

Nombre Tipo Description
groupId

string

Identificador del grupo de recursos private link.

requiredMembers

string[]

Los nombres de miembro necesarios para el recurso private link.

requiredZoneNames

string[]

El recurso de vínculo privado requería nombres de zona.