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
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

subscriptionId
path True

string

minLength: 1

A cél-előfizetés azonosítója.

workspaceName
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

PrivateLinkResourceListResult

Az Azure-művelet sikeresen befejeződött.

Other Status Codes

ErrorResponse

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
createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ManagedServiceIdentity

Felügyeltszolgáltatás-identitás (rendszer által hozzárendelt és/vagy felhasználó által hozzárendelt 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).

PrivateLinkResource

Privát kapcsolati erőforrás

PrivateLinkResourceListResult

A privát kapcsolat erőforrásainak listája

Sku

A termékváltozatot képviselő erőforrásmodell-definíció

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.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

UserAssignedIdentity

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célpontja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

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

ManagedServiceIdentityType

A felügyelt szolgáltatás identitásának típusa (ahol a SystemAssigned és a UserAssigned típus is engedélyezett).

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identitások
Az erőforráshoz társított felhasználó által hozzárendelt identitások készlete. A userAssignedIdentities szótárkulcsai ARM erőforrásazonosítók lesznek a következő formában: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. ManagedIdentity/userAssignedIdentities/{identityName}. A szótár értékei lehetnek üres objektumok ({}) a kérelmekben.

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

ManagedServiceIdentity

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

Sku

Optional. Ezt a mezőt az RP-nek kell implementálnia, mert az AML több szintet is támogat

systemData

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

PrivateLinkResource[]

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

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.

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

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

createdByType

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.