Private Link Resources - List
Az ügyfél (portál, parancssori felület stb.) hívja meg, hogy elérhető "privát kapcsolati erőforrásokat" kapjon a munkaterülethez.
Minden "privát kapcsolati erőforrás" egy kapcsolati végpont (IP-cím) az erőforráshoz.
Egyetlen kapcsolat előtti végpont munkaterületenként: az adatsík IP-címe, amelyet a DNS-feloldás ad vissza.
Más RP-k, például az Azure Storage, több is rendelkezik – az egyik a blobokhoz, a másik az üzenetsorokhoz stb. Az "[NRP] Private Endpoint Design" dokumentum "GET API for GroupIds" témakörében van meghatározva.
Az ügyfél (portál, parancssori felület stb.) hívja meg, hogy elérhető "privát kapcsolati erőforrásokat" kapjon a munkaterülethez.
Minden "privát kapcsolati erőforrás" egy kapcsolati végpont (IP-cím) az erőforráshoz.
Egyetlen kapcsolat előtti végpont munkaterületenként: az adatsík IP-címe, amelyet a DNS-feloldás ad vissza.
Más RP-k, például az Azure Storage, több is rendelkezik – az egyik a blobokhoz, a másik az üzenetsorokhoz stb. Az "[NRP] Private Endpoint Design" dokumentum "GET API for GroupIds" témakörében van meghatározva.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/privateLinkResources?api-version=2026-03-01
URI-paraméterek
| Name | In | Kötelező | Típus | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
|
subscription
|
path | True |
string minLength: 1 |
A cél-előfizetés azonosítója. |
|
workspace
|
path | True |
string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$ |
Azure Machine Learning munkaterület neve |
|
api-version
|
query | True |
string minLength: 1 |
A művelethez használandó API-verzió. |
Válaszok
| Name | Típus | Description |
|---|---|---|
| 200 OK |
Az Azure-művelet sikeresen befejeződött. |
|
| Other Status Codes |
Váratlan hibaválasz. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
| Name | Description |
|---|---|
| user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
WorkspaceListPrivateLinkResources
Mintakérelem
GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateLinkResources?api-version=2026-03-01
Mintaválasz
{
"value": [
{
"name": "amlworkspace",
"type": "Microsoft.MachineLearningServices/workspaces/privateLinkResources",
"id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/rg-1234/providers/Microsoft.MachineLearningServices/workspaces/testworkspace/privateLinkResources/amlworkspace",
"properties": {
"groupId": "amlworkspace",
"requiredMembers": [
"default"
]
}
}
]
}
Definíciók
| Name | Description |
|---|---|
|
created |
Az erőforrást létrehozó identitás típusa. |
|
Error |
Az erőforrás-kezelési hiba további információi. |
|
Error |
A hiba részletei. |
|
Error |
Hibaválasz |
|
Managed |
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások) |
|
Managed |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
|
Private |
Privát kapcsolati erőforrás |
|
Private |
A privát kapcsolat erőforrásainak listája |
| Sku |
A termékváltozatot képviselő erőforrásmodell-definíció |
|
Sku |
Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges. |
|
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
|
User |
Felhasználó által hozzárendelt identitástulajdonságok |
createdByType
Az erőforrást létrehozó identitás típusa.
| Érték | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
| Name | Típus | Description |
|---|---|---|
| info |
object |
A további információk. |
| type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
| Name | Típus | Description |
|---|---|---|
| additionalInfo |
A hiba további információi. |
|
| code |
string |
A hibakód. |
| details |
A hiba részletei. |
|
| message |
string |
A hibaüzenet. |
| target |
string |
A hiba célpontja. |
ErrorResponse
Hibaválasz
| Name | Típus | Description |
|---|---|---|
| error |
A hibaobjektum. |
ManagedServiceIdentity
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások)
| Name | Típus | Description |
|---|---|---|
| principalId |
string (uuid) |
A rendszer által hozzárendelt identitás szolgáltatásnév-azonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
| tenantId |
string (uuid) |
A rendszer által hozzárendelt identitás bérlőazonosítója. Ez a tulajdonság csak a rendszer által hozzárendelt identitáshoz lesz megadva. |
| type |
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett). |
|
| userAssignedIdentities |
<string,
User |
User-Assigned identitások |
ManagedServiceIdentityType
A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).
| Érték | Description |
|---|---|
| None | |
| SystemAssigned | |
| UserAssigned | |
| SystemAssigned,UserAssigned |
PrivateLinkResource
Privát kapcsolati erőforrás
| Name | Típus | Description |
|---|---|---|
| id |
string |
Az erőforrás teljes erőforrás-azonosítója. Example - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| identity |
Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt identitások) |
|
| location |
string |
Ugyanaz, mint a munkaterület helye. |
| name |
string |
Az erőforrás neve |
| properties.groupId |
string |
A privát kapcsolat erőforráscsoport-azonosítója. |
| properties.requiredMembers |
string[] |
A privát kapcsolat erőforrásának tagneveket kellett megadnia. |
| properties.requiredZoneNames |
string[] |
A privát kapcsolati erőforrás privát kapcsolat DNS-zónaneve. |
| sku |
Optional. Ezt a mezőt az RP-nek kell implementálnia, mert az AML több szintet is támogat |
|
| systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
| tags |
object |
|
| type |
string |
Az erőforrás típusa. Például: "Microsoft. Compute/virtualMachines" vagy "Microsoft. Tárhely/tárolásFiókok" |
PrivateLinkResourceListResult
A privát kapcsolat erőforrásainak listája
| Name | Típus | Description |
|---|---|---|
| nextLink |
string |
|
| value |
A privát kapcsolat erőforrásainak listája |
Sku
A termékváltozatot képviselő erőforrásmodell-definíció
| Name | Típus | Description |
|---|---|---|
| capacity |
integer (int32) |
Ha az SKU támogatja a vertikális felskálázást/azt, akkor a kapacitás egészét is tartalmaznia kell. Ha az erőforrás esetében nem lehetséges a vertikális felskálázás/beskálázás, akkor ez kihagyható. |
| family |
string |
Ha a szolgáltatás különböző hardvergenerációval rendelkezik ugyanahhoz az SKU-hoz, akkor ezt itt rögzítheti. |
| name |
string |
Az termékváltozat neve. Ex - P3. Ez általában egy betű+szám kód |
| size |
string |
A termékváltozat mérete. Ha a névmező a réteg és más értékek kombinációja, akkor ez a különálló kód. |
| tier |
Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges. |
SkuTier
Ezt a mezőt az erőforrás-szolgáltatónak kell implementálnia, ha a szolgáltatás egynél több szinttel rendelkezik, de put esetén nem szükséges.
| Érték | Description |
|---|---|
| Free | |
| Basic | |
| Standard | |
| Premium |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
| Name | Típus | Description |
|---|---|---|
| createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
| createdBy |
string |
Az erőforrást létrehozó identitás. |
| createdByType |
Az erőforrást létrehozó identitás típusa. |
|
| lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
| lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
| lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
UserAssignedIdentity
Felhasználó által hozzárendelt identitástulajdonságok
| Name | Típus | Description |
|---|---|---|
| clientId |
string (uuid) |
A hozzárendelt identitás ügyfélazonosítója. |
| principalId |
string (uuid) |
A hozzárendelt identitás egyszerű azonosítója. |