Megosztás a következőn keresztül:


Endpoint - List

A munkaterület összes végpontjának listázása

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints?api-version=2025-04-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/endpoints?api-version=2025-04-01-preview&endpointType={endpointType}&includeOnlineEndpoints={includeOnlineEndpoints}&includeServerlessEndpoints={includeServerlessEndpoints}&includeConnections={includeConnections}&$skip={$skip}&$expand={$expand}

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ó.

$expand
query

string

A végponti erőforrás kibontása az üzembe helyezési információkkal, pl. $expand=deployments

$skip
query

string

Folytatási jogkivonat lapozáshoz.

endpointType
query

endpointType

Végponttípus-szűrő

includeConnections
query

boolean

includeOnlineEndpoints
query

boolean

includeServerlessEndpoints
query

boolean

Válaszok

Name Típus Description
200 OK

EndpointResourcePropertiesBasicResourceArmPaginatedResult

A kérés sikeres volt; a kérelem megfelelően alakult és megfelelően érkezett.

Other Status Codes

ErrorResponse

Hiba

Biztonság

azure_auth

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

List Endpoint

Mintakérelem

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/endpoints?api-version=2025-04-01-preview&endpointType=Azure.OpenAI&$skip=skip_string

Mintaválasz

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/endpoints/Azure.OpenAI",
      "name": "Azure.OpenAI",
      "type": "Microsoft.MachineLearningServices/workspaces/endpoints",
      "properties": {
        "endpointType": "Azure.OpenAI",
        "name": "Azure.OpenAI",
        "associatedResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.CognitiveService/account/account-1",
        "endpointUri": "https://www.contoso.com/",
        "provisioningState": "Succeeded",
        "failureReason": "some_string"
      },
      "systemData": {
        "createdAt": "2020-01-01T00:00:00Z",
        "createdBy": "some_string",
        "createdByType": "ManagedIdentity",
        "lastModifiedAt": "2020-01-01T00:00:00Z",
        "lastModifiedBy": "some_string",
        "lastModifiedByType": "User"
      }
    }
  ],
  "nextLink": "some_string"
}

Definíciók

Name Description
CognitiveServicesSku
ContentSafetyEndpointDeploymentResourceProperties
ContentSafetyEndpointResourceProperties
ContentSafetyStatus
createdByType

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

DefaultResourceProvisioningState
DeploymentModelVersionUpgradeOption

Az üzembehelyezési modell verziófrissítési lehetősége.

EndpointAuthMode
EndpointComputeType
EndpointDeploymentModel
EndpointDeploymentResourcePropertiesBasicResource
EndpointResourcePropertiesBasicResource
EndpointResourcePropertiesBasicResourceArmPaginatedResult
endpointType

Végponttípus-szűrő

ErrorAdditionalInfo

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

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

ManagedOnlineEndpointDeploymentResourceProperties
ManagedOnlineEndpointResourceProperties
OpenAIEndpointDeploymentResourceProperties
OpenAIEndpointResourceProperties
ServerlessEndpointCapacityReservation
ServerlessEndpointContentSafety
ServerlessEndpointInferenceEndpoint
ServerlessEndpointModelSettings
ServerlessEndpointResourceProperties
ServerlessEndpointState
ServerlessInferenceEndpointAuthMode
ServerlessOffer
SpeechEndpointDeploymentResourceProperties
SpeechEndpointResourceProperties
systemData

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

CognitiveServicesSku

Name Típus Description
capacity

integer (int32)

family

string

name

string

size

string

tier

string

ContentSafetyEndpointDeploymentResourceProperties

Name Típus Description
failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

model

EndpointDeploymentModel

A végpont üzembe helyezéséhez használt modell.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

raiPolicyName

string

Az RAI-szabályzat neve.

sku

CognitiveServicesSku

type string:

Azure.ContentSafety

minLength: 1
pattern: [a-zA-Z0-9_]

Az üzembe helyezés típusa.

versionUpgradeOption

DeploymentModelVersionUpgradeOption

Az üzembehelyezési modell verziófrissítési lehetősége.

ContentSafetyEndpointResourceProperties

Name Típus Description
associatedResourceId

string (arm-id)

Byo erőforrás-azonosító a beépített modellszolgáltatás-végpontok létrehozásához.

deployments

EndpointDeploymentResourcePropertiesBasicResource[]

Üzembe helyezési adatok.

endpointType string:

Azure.ContentSafety

A végpont típusa.

endpointUri

string (url)

A végpont URI-ja.

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

location

string

A végpont helye. Mivel a bemeneti dto és a végponti erőforrás elemzésekor ugyanazt a szerződést osztják meg, ez a Hely mező csak a végpont erőforrás-adatainak elemzésére szolgál, nem engedjük, hogy az ügyfél megadja a végpont erőforrásának helyét, mivel ugyanazon a helyen hozzuk létre, mint a munkaterületet

name

string

A végpont neve.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

shouldCreateAiServicesEndpoint

boolean

A proxyvégpont (nem byo) normál végpont vagy OneKeyV2 AI-szolgáltatások fiókvégpontja.

ContentSafetyStatus

Érték Description
Disabled
Enabled

createdByType

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

Érték Description
Application
Key
ManagedIdentity
User

DefaultResourceProvisioningState

Érték Description
Accepted
Canceled
Creating
Deleting
Disabled
Failed
NotStarted
Scaling
Succeeded
Updating

DeploymentModelVersionUpgradeOption

Az üzembehelyezési modell verziófrissítési lehetősége.

Érték Description
NoAutoUpgrade
OnceCurrentVersionExpired
OnceNewDefaultVersionAvailable

EndpointAuthMode

Érték Description
AADToken
AMLToken
Key

EndpointComputeType

Érték Description
AzureMLCompute
Kubernetes
Managed

EndpointDeploymentModel

Name Típus Description
format

string

Modellformátum

name

string

Modell neve.

source

string

Opcionális. Az üzembehelyezési modell forrás ARM-erőforrás-azonosítója.

version

string

Modellverzió.

EndpointDeploymentResourcePropertiesBasicResource

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Az erőforrás neve

properties EndpointDeploymentResourceProperties:
systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

EndpointResourcePropertiesBasicResource

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Az erőforrás neve

properties EndpointResourceProperties:
systemData

systemData

A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok.

type

string

Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

EndpointResourcePropertiesBasicResourceArmPaginatedResult

Name Típus Description
nextLink

string

value

EndpointResourcePropertiesBasicResource[]

endpointType

Végponttípus-szűrő

Érték Description
Azure.ContentSafety
Azure.Llama
Azure.OpenAI
Azure.Speech
managedOnlineEndpoint

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 hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

ManagedOnlineEndpointDeploymentResourceProperties

Name Típus Description
endpointComputeType

EndpointComputeType

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

model

string

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

type string:

managedOnlineEndpoint

minLength: 1
pattern: [a-zA-Z0-9_]

Az üzembe helyezés típusa.

ManagedOnlineEndpointResourceProperties

Name Típus Description
associatedResourceId

string (arm-id)

Byo erőforrás-azonosító a beépített modellszolgáltatás-végpontok létrehozásához.

authMode

EndpointAuthMode

compute

string

deployments

EndpointDeploymentResourcePropertiesBasicResource[]

Üzembe helyezési adatok.

description

string

endpointType string:

managedOnlineEndpoint

A végpont típusa.

endpointUri

string (url)

A végpont URI-ja.

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

location

string

A végpont helye. Mivel a bemeneti dto és a végponti erőforrás elemzésekor ugyanazt a szerződést osztják meg, ez a Hely mező csak a végpont erőforrás-adatainak elemzésére szolgál, nem engedjük, hogy az ügyfél megadja a végpont erőforrásának helyét, mivel ugyanazon a helyen hozzuk létre, mint a munkaterületet

mirrorTraffic

object

name

string

A végpont neve.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

scoringUri

string (uri)

shouldCreateAiServicesEndpoint

boolean

A proxyvégpont (nem byo) normál végpont vagy OneKeyV2 AI-szolgáltatások fiókvégpontja.

traffic

object

OpenAIEndpointDeploymentResourceProperties

Name Típus Description
failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

model

EndpointDeploymentModel

A végpont üzembe helyezéséhez használt modell.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

raiPolicyName

string

Az RAI-szabályzat neve.

sku

CognitiveServicesSku

type string:

Azure.OpenAI

minLength: 1
pattern: [a-zA-Z0-9_]

Az üzembe helyezés típusa.

versionUpgradeOption

DeploymentModelVersionUpgradeOption

Az üzembehelyezési modell verziófrissítési lehetősége.

OpenAIEndpointResourceProperties

Name Típus Description
associatedResourceId

string (arm-id)

Byo erőforrás-azonosító a beépített modellszolgáltatás-végpontok létrehozásához.

deployments

EndpointDeploymentResourcePropertiesBasicResource[]

Üzembe helyezési adatok.

endpointType string:

Azure.OpenAI

A végpont típusa.

endpointUri

string (url)

A végpont URI-ja.

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

location

string

A végpont helye. Mivel a bemeneti dto és a végponti erőforrás elemzésekor ugyanazt a szerződést osztják meg, ez a Hely mező csak a végpont erőforrás-adatainak elemzésére szolgál, nem engedjük, hogy az ügyfél megadja a végpont erőforrásának helyét, mivel ugyanazon a helyen hozzuk létre, mint a munkaterületet

name

string

A végpont neve.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

shouldCreateAiServicesEndpoint

boolean

A proxyvégpont (nem byo) normál végpont vagy OneKeyV2 AI-szolgáltatások fiókvégpontja.

ServerlessEndpointCapacityReservation

Name Típus Description
capacityReservationGroupId

string

minLength: 1
pattern: [a-zA-Z0-9_]
endpointReservedCapacity

integer (int32)

ServerlessEndpointContentSafety

Name Típus Description
contentSafetyStatus

ContentSafetyStatus

ServerlessEndpointInferenceEndpoint

Name Típus Description
headers

object

uri

string (uri)

ServerlessEndpointModelSettings

Name Típus Description
modelId

string

minLength: 1
pattern: [a-zA-Z0-9_]

ServerlessEndpointResourceProperties

Name Típus Description
associatedResourceId

string (arm-id)

Byo erőforrás-azonosító a beépített modellszolgáltatás-végpontok létrehozásához.

authMode

ServerlessInferenceEndpointAuthMode

capacityReservation

ServerlessEndpointCapacityReservation

contentSafety

ServerlessEndpointContentSafety

deployments

EndpointDeploymentResourcePropertiesBasicResource[]

Üzembe helyezési adatok.

endpointState

ServerlessEndpointState

endpointType string:

serverlessEndpoint

A végpont típusa.

endpointUri

string (url)

A végpont URI-ja.

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

inferenceEndpoint

ServerlessEndpointInferenceEndpoint

location

string

A végpont helye. Mivel a bemeneti dto és a végponti erőforrás elemzésekor ugyanazt a szerződést osztják meg, ez a Hely mező csak a végpont erőforrás-adatainak elemzésére szolgál, nem engedjük, hogy az ügyfél megadja a végpont erőforrásának helyét, mivel ugyanazon a helyen hozzuk létre, mint a munkaterületet

marketplaceSubscriptionId

string

metadata
modelSettings

ServerlessEndpointModelSettings

name

string

A végpont neve.

offer

ServerlessOffer

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

shouldCreateAiServicesEndpoint

boolean

A proxyvégpont (nem byo) normál végpont vagy OneKeyV2 AI-szolgáltatások fiókvégpontja.

ServerlessEndpointState

Érték Description
Creating
CreationFailed
Deleting
DeletionFailed
Online
Reinstating
Suspended
Suspending
Unknown

ServerlessInferenceEndpointAuthMode

Érték Description
AAD
Key

ServerlessOffer

Name Típus Description
offerName

string

minLength: 1
pattern: [a-zA-Z0-9_]
publisher

string

minLength: 1
pattern: [a-zA-Z0-9_]

SpeechEndpointDeploymentResourceProperties

Name Típus Description
failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

model

EndpointDeploymentModel

A végpont üzembe helyezéséhez használt modell.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

raiPolicyName

string

Az RAI-szabályzat neve.

sku

CognitiveServicesSku

type string:

Azure.Speech

minLength: 1
pattern: [a-zA-Z0-9_]

Az üzembe helyezés típusa.

versionUpgradeOption

DeploymentModelVersionUpgradeOption

Az üzembehelyezési modell verziófrissítési lehetősége.

SpeechEndpointResourceProperties

Name Típus Description
associatedResourceId

string (arm-id)

Byo erőforrás-azonosító a beépített modellszolgáltatás-végpontok létrehozásához.

deployments

EndpointDeploymentResourcePropertiesBasicResource[]

Üzembe helyezési adatok.

endpointType string:

Azure.Speech

A végpont típusa.

endpointUri

string (url)

A végpont URI-ja.

failureReason

string

A sikertelenség oka, ha a létrehozás meghiúsult.

location

string

A végpont helye. Mivel a bemeneti dto és a végponti erőforrás elemzésekor ugyanazt a szerződést osztják meg, ez a Hely mező csak a végpont erőforrás-adatainak elemzésére szolgál, nem engedjük, hogy az ügyfél megadja a végpont erőforrásának helyét, mivel ugyanazon a helyen hozzuk létre, mint a munkaterületet

name

string

A végpont neve.

provisioningState

DefaultResourceProvisioningState

Csak olvasható kiépítési állapottulajdonság.

shouldCreateAiServicesEndpoint

boolean

A proxyvégpont (nem byo) normál végpont vagy OneKeyV2 AI-szolgáltatások fiókvégpontja.

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.