Endpoint - List

Servizio:

Machine Learning

Versione API:

2025-10-01-preview

Elencare tutti gli endpoint in questa area di lavoro

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

Con parametri facoltativi:

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

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.
$expand	query		string	Se la risorsa endpoint verrà espansa per includere le informazioni sulla distribuzione, ad esempio $expand=distribuzioni
$skip	query		string	Token di continuazione per la paginazione.
endpointType	query		endpointType	Filtro del tipo di endpoint
includeConnections	query		boolean
includeOnlineEndpoints	query		boolean
includeServerlessEndpoints	query		boolean

Risposte

Nome	Tipo	Descrizione
200 OK	EndpointResourcePropertiesBasicResourceArmPaginatedResult	La richiesta è andata a buon fine; La richiesta era ben formata e ricevuta correttamente.
Other Status Codes	ErrorResponse	Errore

Sicurezza

azure_auth

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

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List Endpoint

Esempio di richiesta

HTTP

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-10-01-preview&endpointType=Azure.OpenAI&$skip=skip_string

Risposta di esempio

Codice di stato:

200

{
  "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"
}

Definizioni

Nome	Descrizione
CognitiveServicesSku
ContentSafetyEndpointDeploymentResourceProperties
ContentSafetyEndpointResourceProperties
ContentSafetyStatus
createdByType	Tipo di identità che ha creato la risorsa.
DefaultResourceProvisioningState
DeploymentModelVersionUpgradeOption	Opzione di aggiornamento della versione del modello di distribuzione.
EndpointAuthMode
EndpointComputeType
EndpointDeploymentModel
EndpointDeploymentResourcePropertiesBasicResource
EndpointResourcePropertiesBasicResource
EndpointResourcePropertiesBasicResourceArmPaginatedResult
endpointType	Filtro del tipo di endpoint
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedOnlineEndpointDeploymentResourceProperties
ManagedOnlineEndpointResourceProperties
OpenAIEndpointDeploymentResourceProperties
OpenAIEndpointResourceProperties
ServerlessEndpointCapacityReservation
ServerlessEndpointContentSafety
ServerlessEndpointInferenceEndpoint
ServerlessEndpointModelSettings
ServerlessEndpointResourceProperties
ServerlessEndpointState
ServerlessInferenceEndpointAuthMode
ServerlessOffer
SpeechEndpointDeploymentResourceProperties
SpeechEndpointResourceProperties
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

CognitiveServicesSku

Object

Nome	Tipo	Descrizione
capacity	integer (int32)
family	string
name	string
size	string
tier	string

ContentSafetyEndpointDeploymentResourceProperties

Object

Nome	Tipo	Descrizione
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
model	EndpointDeploymentModel	Modello usato per la distribuzione dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
raiPolicyName	string	Nome della politica RAI.
sku	CognitiveServicesSku
type	string: Azure.ContentSafety minLength: 1 pattern: [a-zA-Z0-9_]	Tipo di distribuzione.
versionUpgradeOption	DeploymentModelVersionUpgradeOption	Opzione di aggiornamento della versione del modello di distribuzione.

ContentSafetyEndpointResourceProperties

Object

Nome	Tipo	Descrizione
associatedResourceId	string (arm-id)	ID risorsa byo per la creazione degli endpoint di servizio del modello predefiniti.
deployments	EndpointDeploymentResourcePropertiesBasicResource[]	Informazioni sulle distribuzioni.
endpointType	string: Azure.ContentSafety	Tipo dell'endpoint.
endpointUri	string (url)	URI dell'endpoint.
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
location	string	Posizione dell'endpoint. Poiché l'input dto e quando la risorsa dell'endpoint analizza condividono lo stesso contratto, questo campo Posizione serve solo per analizzare le informazioni sulla risorsa dell'endpoint, non consentiremo al cliente di specificare la posizione della risorsa dell'endpoint poiché la creeremo nella stessa posizione dell'area di lavoro
name	string	Nome dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
shouldCreateAiServicesEndpoint	boolean	Se l'endpoint proxy (non byo) è un endpoint normale o un endpoint dell'account dei servizi di intelligenza artificiale OneKeyV2.

ContentSafetyStatus

Enumerazione

Valore	Descrizione
Enabled
Disabled

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DefaultResourceProvisioningState

Enumerazione

Valore	Descrizione
NotStarted
Failed
Creating
Updating
Succeeded
Deleting
Accepted
Canceled
Scaling
Disabled

DeploymentModelVersionUpgradeOption

Enumerazione

Opzione di aggiornamento della versione del modello di distribuzione.

Valore	Descrizione
OnceNewDefaultVersionAvailable
OnceCurrentVersionExpired
NoAutoUpgrade

EndpointAuthMode

Enumerazione

Valore	Descrizione
AMLToken
Key
AADToken

EndpointComputeType

Enumerazione

Valore	Descrizione
Managed
Kubernetes
AzureMLCompute

EndpointDeploymentModel

Object

Nome	Tipo	Descrizione
format	string	Formato del modello
name	string	Nome del modello.
source	string	Optional. ID risorsa ARM del modello di distribuzione.
version	string	Versione del modello.

EndpointDeploymentResourcePropertiesBasicResource

Object

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	EndpointDeploymentResourceProperties: ContentSafetyEndpointDeploymentResourceProperties ManagedOnlineEndpointDeploymentResourceProperties OpenAIEndpointDeploymentResourceProperties SpeechEndpointDeploymentResourceProperties
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

EndpointResourcePropertiesBasicResource

Object

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	EndpointResourceProperties: ContentSafetyEndpointResourceProperties ManagedOnlineEndpointResourceProperties OpenAIEndpointResourceProperties ServerlessEndpointResourceProperties SpeechEndpointResourceProperties
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

EndpointResourcePropertiesBasicResourceArmPaginatedResult

Object

Nome	Tipo	Descrizione
nextLink	string
value	EndpointResourcePropertiesBasicResource[]

endpointType

Enumerazione

Filtro del tipo di endpoint

Valore	Descrizione
Azure.OpenAI
Azure.Speech
Azure.ContentSafety
Azure.Llama
managedOnlineEndpoint

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

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

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedOnlineEndpointDeploymentResourceProperties

Object

Nome	Tipo	Descrizione
endpointComputeType	EndpointComputeType
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
model	string
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
type	string: managedOnlineEndpoint minLength: 1 pattern: [a-zA-Z0-9_]	Tipo di distribuzione.

ManagedOnlineEndpointResourceProperties

Object

Nome	Tipo	Descrizione
associatedResourceId	string (arm-id)	ID risorsa byo per la creazione degli endpoint di servizio del modello predefiniti.
authMode	EndpointAuthMode
compute	string
deployments	EndpointDeploymentResourcePropertiesBasicResource[]	Informazioni sulle distribuzioni.
description	string
endpointType	string: managedOnlineEndpoint	Tipo dell'endpoint.
endpointUri	string (url)	URI dell'endpoint.
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
location	string	Posizione dell'endpoint. Poiché l'input dto e quando la risorsa dell'endpoint analizza condividono lo stesso contratto, questo campo Posizione serve solo per analizzare le informazioni sulla risorsa dell'endpoint, non consentiremo al cliente di specificare la posizione della risorsa dell'endpoint poiché la creeremo nella stessa posizione dell'area di lavoro
mirrorTraffic	object
name	string	Nome dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
scoringUri	string (uri)
shouldCreateAiServicesEndpoint	boolean	Se l'endpoint proxy (non byo) è un endpoint normale o un endpoint dell'account dei servizi di intelligenza artificiale OneKeyV2.
traffic	object

OpenAIEndpointDeploymentResourceProperties

Object

Nome	Tipo	Descrizione
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
model	EndpointDeploymentModel	Modello usato per la distribuzione dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
raiPolicyName	string	Nome della politica RAI.
sku	CognitiveServicesSku
type	string: Azure.OpenAI minLength: 1 pattern: [a-zA-Z0-9_]	Tipo di distribuzione.
versionUpgradeOption	DeploymentModelVersionUpgradeOption	Opzione di aggiornamento della versione del modello di distribuzione.

OpenAIEndpointResourceProperties

Object

Nome	Tipo	Descrizione
associatedResourceId	string (arm-id)	ID risorsa byo per la creazione degli endpoint di servizio del modello predefiniti.
deployments	EndpointDeploymentResourcePropertiesBasicResource[]	Informazioni sulle distribuzioni.
endpointType	string: Azure.OpenAI	Tipo dell'endpoint.
endpointUri	string (url)	URI dell'endpoint.
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
location	string	Posizione dell'endpoint. Poiché l'input dto e quando la risorsa dell'endpoint analizza condividono lo stesso contratto, questo campo Posizione serve solo per analizzare le informazioni sulla risorsa dell'endpoint, non consentiremo al cliente di specificare la posizione della risorsa dell'endpoint poiché la creeremo nella stessa posizione dell'area di lavoro
name	string	Nome dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
shouldCreateAiServicesEndpoint	boolean	Se l'endpoint proxy (non byo) è un endpoint normale o un endpoint dell'account dei servizi di intelligenza artificiale OneKeyV2.

ServerlessEndpointCapacityReservation

Object

Nome	Tipo	Descrizione
capacityReservationGroupId	string minLength: 1 pattern: [a-zA-Z0-9_]
endpointReservedCapacity	integer (int32)

ServerlessEndpointContentSafety

Object

Nome	Tipo	Descrizione
contentSafetyStatus	ContentSafetyStatus

ServerlessEndpointInferenceEndpoint

Object

Nome	Tipo	Descrizione
headers	object
uri	string (uri)

ServerlessEndpointModelSettings

Object

Nome	Tipo	Descrizione
modelId	string minLength: 1 pattern: [a-zA-Z0-9_]

ServerlessEndpointResourceProperties

Object

Nome	Tipo	Descrizione
associatedResourceId	string (arm-id)	ID risorsa byo per la creazione degli endpoint di servizio del modello predefiniti.
authMode	ServerlessInferenceEndpointAuthMode
capacityReservation	ServerlessEndpointCapacityReservation
contentSafety	ServerlessEndpointContentSafety
deployments	EndpointDeploymentResourcePropertiesBasicResource[]	Informazioni sulle distribuzioni.
endpointState	ServerlessEndpointState
endpointType	string: serverlessEndpoint	Tipo dell'endpoint.
endpointUri	string (url)	URI dell'endpoint.
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
inferenceEndpoint	ServerlessEndpointInferenceEndpoint
location	string	Posizione dell'endpoint. Poiché l'input dto e quando la risorsa dell'endpoint analizza condividono lo stesso contratto, questo campo Posizione serve solo per analizzare le informazioni sulla risorsa dell'endpoint, non consentiremo al cliente di specificare la posizione della risorsa dell'endpoint poiché la creeremo nella stessa posizione dell'area di lavoro
marketplaceSubscriptionId	string
metadata
modelSettings	ServerlessEndpointModelSettings
name	string	Nome dell'endpoint.
offer	ServerlessOffer
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
shouldCreateAiServicesEndpoint	boolean	Se l'endpoint proxy (non byo) è un endpoint normale o un endpoint dell'account dei servizi di intelligenza artificiale OneKeyV2.

ServerlessEndpointState

Enumerazione

Valore	Descrizione
Unknown
Creating
Deleting
Suspending
Reinstating
Online
Suspended
CreationFailed
DeletionFailed

ServerlessInferenceEndpointAuthMode

Enumerazione

Valore	Descrizione
Key
AAD

ServerlessOffer

Object

Nome	Tipo	Descrizione
offerName	string minLength: 1 pattern: [a-zA-Z0-9_]
publisher	string minLength: 1 pattern: [a-zA-Z0-9_]

SpeechEndpointDeploymentResourceProperties

Object

Nome	Tipo	Descrizione
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
model	EndpointDeploymentModel	Modello usato per la distribuzione dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
raiPolicyName	string	Nome della politica RAI.
sku	CognitiveServicesSku
type	string: Azure.Speech minLength: 1 pattern: [a-zA-Z0-9_]	Tipo di distribuzione.
versionUpgradeOption	DeploymentModelVersionUpgradeOption	Opzione di aggiornamento della versione del modello di distribuzione.

SpeechEndpointResourceProperties

Object

Nome	Tipo	Descrizione
associatedResourceId	string (arm-id)	ID risorsa byo per la creazione degli endpoint di servizio del modello predefiniti.
deployments	EndpointDeploymentResourcePropertiesBasicResource[]	Informazioni sulle distribuzioni.
endpointType	string: Azure.Speech	Tipo dell'endpoint.
endpointUri	string (url)	URI dell'endpoint.
failureReason	string	Motivo dell'errore se la creazione non è riuscita.
location	string	Posizione dell'endpoint. Poiché l'input dto e quando la risorsa dell'endpoint analizza condividono lo stesso contratto, questo campo Posizione serve solo per analizzare le informazioni sulla risorsa dell'endpoint, non consentiremo al cliente di specificare la posizione della risorsa dell'endpoint poiché la creeremo nella stessa posizione dell'area di lavoro
name	string	Nome dell'endpoint.
provisioningState	DefaultResourceProvisioningState	Proprietà dello stato del provisioning di sola lettura.
shouldCreateAiServicesEndpoint	boolean	Se l'endpoint proxy (non byo) è un endpoint normale o un endpoint dell'account dei servizi di intelligenza artificiale OneKeyV2.

systemData

Object

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.