Private Endpoint Connections - List

Servizio:
Machine Learning
Versione API:
2025-09-01

Elencare tutte le connessioni all'endpoint privato associate all'area di lavoro.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateEndpointConnections?api-version=2025-09-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId
 path True

string

minLength: 1

ID della sottoscrizione di destinazione.
workspaceName
 path True

string

pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$

Nome dell'area di lavoro di Azure Machine Learning.
api-version
 query True

string

minLength: 1

Versione dell'API da usare per questa operazione.

Risposte

Nome Tipo Descrizione
200 OK

PrivateEndpointConnectionListResult

OK -- Connessioni all'endpoint privato recuperate correttamente.
Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

StorageAccountListPrivateEndpointConnections

Esempio di richiesta

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateEndpointConnections?api-version=2025-09-01

Risposta di esempio

Codice di stato:
200 
{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateEndpointConnections/{privateEndpointConnectionName}",
      "name": "{privateEndpointConnectionName}",
      "type": "Microsoft.MachineLearningServices/workspaces/privateEndpointConnections",
      "properties": {
        "provisioningState": "Succeeded",
        "privateEndpoint": {
          "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.Network/privateEndpoints/petest01"
        },
        "privateLinkServiceConnectionState": {
          "status": "Approved",
          "description": "Auto-Approved",
          "actionsRequired": "None"
        }
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateEndpointConnections/{privateEndpointConnectionName}",
      "name": "{privateEndpointConnectionName}",
      "type": "Microsoft.MachineLearningServices/workspaces/privateEndpointConnections",
      "properties": {
        "provisioningState": "Succeeded",
        "privateEndpoint": {
          "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.Network/privateEndpoints/petest01"
        },
        "privateLinkServiceConnectionState": {
          "status": "Approved",
          "description": "Auto-Approved",
          "actionsRequired": "None"
        }
      }
    }
  ]
}

Definizioni

Nome Descrizione
createdByType

Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail

Dettagli dell'errore.
ErrorResponse

Risposta di errore
ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
PrivateEndpoint

Risorsa endpoint privato.
PrivateEndpointConnection

Risorsa connessione endpoint privato.
PrivateEndpointConnectionListResult

Elenco delle connessioni all'endpoint privato associate all'area di lavoro specificata
PrivateEndpointConnectionProvisioningState

Stato di provisioning corrente.
PrivateEndpointServiceConnectionStatus

Stato della connessione dell'endpoint privato.
PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
Sku

Definizione del modello di risorse che rappresenta lo SKU
SkuTier

Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.
systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.
UserAssignedIdentity

Proprietà di identità assegnate dall'utente

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore Descrizione
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.
type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.
code

string

Codice di errore.
details

ErrorDetail[]

Dettagli dell'errore.
message

string

Messaggio di errore.
target

string

Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ManagedServiceIdentity

Oggetto

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome Tipo Descrizione
principalId

string (uuid)

ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId

string (uuid)

ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities

<string,  UserAssignedIdentity>

identità User-Assigned
Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Enumerazione

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Valore Descrizione
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PrivateEndpoint

Oggetto

Risorsa endpoint privato.

Nome Tipo Descrizione
id

string

Identificatore ARM per l'endpoint privato

PrivateEndpointConnection

Oggetto

Risorsa connessione endpoint privato.

Nome Tipo Descrizione
id

string

ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

ManagedServiceIdentity

Identità della risorsa.
location

string

Specifica la posizione della risorsa.
name

string

Nome della risorsa
properties.privateEndpoint

PrivateEndpoint

Risorsa dell'endpoint privato.
properties.privateLinkServiceConnectionState

PrivateLinkServiceConnectionState

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.
properties.provisioningState

PrivateEndpointConnectionProvisioningState

Stato di provisioning della risorsa di connessione dell'endpoint privato.
sku

Sku

SKU dell'area di lavoro.
systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags

object

Contiene tag di risorsa definiti come coppie chiave/valore.
type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

PrivateEndpointConnectionListResult

Oggetto

Elenco delle connessioni all'endpoint privato associate all'area di lavoro specificata

Nome Tipo Descrizione
value

PrivateEndpointConnection[]

Matrice di connessioni endpoint private

PrivateEndpointConnectionProvisioningState

Enumerazione

Stato di provisioning corrente.

Valore Descrizione
Succeeded
Creating
Deleting
Failed

PrivateEndpointServiceConnectionStatus

Enumerazione

Stato della connessione dell'endpoint privato.

Valore Descrizione
Pending
Approved
Rejected
Disconnected
Timeout

PrivateLinkServiceConnectionState

Oggetto

Raccolta di informazioni sullo stato della connessione tra consumer di servizi e provider.

Nome Tipo Descrizione
actionsRequired

string

Messaggio che indica se le modifiche apportate al provider di servizi richiedono aggiornamenti sul consumer.
description

string

Motivo dell'approvazione/rifiuto della connessione.
status

PrivateEndpointServiceConnectionStatus

Indica se la connessione è stata approvata/rifiutata/rimossa dal proprietario del servizio.

Sku

Oggetto

Definizione del modello di risorse che rappresenta lo SKU

Nome Tipo Descrizione
capacity

integer (int32)

Se lo SKU supporta l'aumento o l'aumento del numero di istanze, è necessario includere l'intero della capacità. Se non è possibile aumentare o ridurre il numero di istanze per la risorsa, potrebbe essere omesso.
family

string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.
name

string

Nome dello SKU. Ad esempio - P3. Si tratta in genere di un codice lettera+numero
size

string

Dimensioni dello SKU. Quando il campo nome è la combinazione di livello e un altro valore, si tratta del codice autonomo.
tier

SkuTier

Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.

SkuTier

Enumerazione

Questo campo deve essere implementato dal provider di risorse se il servizio ha più di un livello, ma non è necessario in un PUT.

Valore Descrizione
Free
Basic
Standard
Premium

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string (date-time)

Timestamp della creazione della risorsa (UTC).
createdBy

string

Identità che ha creato la risorsa.
createdByType

createdByType

Tipo di identità che ha creato la risorsa.
lastModifiedAt

string (date-time)

Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy

string

Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima volta la risorsa.

UserAssignedIdentity

Oggetto

Proprietà di identità assegnate dall'utente

Nome Tipo Descrizione
clientId

string (uuid)

ID client dell'identità assegnata.
principalId

string (uuid)

ID entità dell'identità assegnata.