Compute - Update Custom Services

Usługa:: Machine Learning

Wersja interfejsu API:: 2025-07-01-preview

Aktualizuje listę usług niestandardowych. Lista świadczonych usług niestandardowych zostanie nadpisana

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/computes/{computeName}/customServices?api-version=2025-07-01-preview

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
computeName	path	True	string pattern: ^[a-zA-Z](?![a-zA-Z0-9-]*-\d+$)[a-zA-Z0-9\-]{2,23}$	Nazwa zasobów obliczeniowych usługi Azure Machine Learning.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nazwa obszaru roboczego usługi Azure Machine Learning.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Typ	Opis
customServices	CustomService[]	Nowa lista usług niestandardowych.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		Powodzenie
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego żądanie nie powiodło się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Update Custom Services

Przykładowe żądanie

HTTP

POST https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/workspaces/workspaces123/computes/compute123/customServices?api-version=2025-07-01-preview

[
  {
    "name": "rstudio-workbench",
    "image": {
      "type": "docker",
      "reference": "ghcr.io/azure/rstudio-workbench:latest"
    },
    "environmentVariables": {
      "RSP_LICENSE": {
        "type": "local",
        "value": "XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX"
      }
    },
    "docker": {
      "privileged": true
    },
    "endpoints": [
      {
        "protocol": "http",
        "name": "connect",
        "target": 8787,
        "published": 4444,
        "hostIp": null
      }
    ],
    "volumes": [
      {
        "type": "bind",
        "source": "/mnt/azureuser/",
        "target": "/home/testuser/",
        "readOnly": true
      }
    ]
  }
]

Przykładowa odpowiedź

Kod stanu:: 200

Definicje

Nazwa	Opis
BindOptions
CustomService	Określa konfigurację usługi niestandardowej
Docker
Endpoint
EnvironmentVariable
EnvironmentVariableType	Typ zmiennej środowiskowej
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
Image
ImageType	Typ obrazu
JupyterKernelConfig	Konfiguracja jądra Jupyter.
protocol	Protokół komunikacyjny punktu końcowego
TmpfsOptions
VolumeDefinition
VolumeDefinitionType	Typ definicji woluminu
VolumeOptions

BindOptions

Objekt

Nazwa	Typ	Opis
createHostPath	boolean	Wskaż, czy chcesz utworzyć ścieżkę hosta.
propagation	string	Typ opcji powiązania
selinux	string	Wspomnij o opcjach selinux.

CustomService

Objekt

Określa konfigurację usługi niestandardowej

Nazwa	Typ	Opis
docker	Docker	Opisuje ustawienia platformy Docker dla obrazu
endpoints	Endpoint[]	Konfigurowanie punktów końcowych dla kontenera
environmentVariables	<string, EnvironmentVariable>	Zmienna środowiskowa dla kontenera
image	Image	Opis specyfikacji obrazów
kernel	JupyterKernelConfig	Opisuje ustawienia jądra jupyter dla obrazu, jeśli jest to środowisko niestandardowe
name	string	Nazwa usługi niestandardowej
volumes	VolumeDefinition[]	Konfigurowanie woluminów dla kontenera

Docker

Objekt

Nazwa	Typ	Opis
privileged	boolean	Określ, czy kontener działa w trybie uprzywilejowanym, czy nieuprzywilejowanym.

Endpoint

Objekt

Nazwa	Typ	Domyślna wartość	Opis
hostIp	string		Adres IP hosta, za pośrednictwem którego aplikacja jest uwidaczniona z kontenera
name	string		Nazwa punktu końcowego
protocol	protocol	tcp	Protokół komunikacyjny punktu końcowego Protokół, za pośrednictwem którego komunikacja nastąpi za pośrednictwem tego punktu końcowego
published	integer (int32)		Port, za pomocą którego aplikacja jest uwidaczniona z kontenera.
target	integer (int32)		Port aplikacji wewnątrz kontenera.

EnvironmentVariable

Objekt

Nazwa	Typ	Domyślna wartość	Opis
type	EnvironmentVariableType	local	Typ zmiennej środowiskowej Typ zmiennej środowiskowej. Możliwe wartości to: local — dla zmiennej lokalnej
value	string		Wartość zmiennej środowiskowej

EnvironmentVariableType

Wyliczanie

Typ zmiennej środowiskowej

Wartość	Opis
local

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

Image

Objekt

Nazwa	Typ	Domyślna wartość	Opis
reference	string		Adres URL odwołania do obrazu, jeśli typem jest platforma Docker. Nazwa środowiska, jeśli typ to azureml
type	ImageType	docker	Typ obrazu Typ obrazu. Możliwe wartości to: docker — w przypadku obrazów platformy Docker. azureml — w przypadku obrazów środowiska AzureML (niestandardowe i wyselekcjonowane)
version	string		Używana wersja obrazu. Jeśli jest najnowsza, pomiń to pole

ImageType

Wyliczanie

Typ obrazu

Wartość	Opis
docker
azureml

JupyterKernelConfig

Objekt

Konfiguracja jądra Jupyter.

Nazwa	Typ	Opis
argv	string[]	Argument środowiska uruchomieniowego
displayName	string	Nazwa wyświetlana jądra
language	string	Język jądra [Przykładowa wartość: python]

protocol

Wyliczanie

Protokół komunikacyjny punktu końcowego

Wartość	Opis
tcp
udp
http

TmpfsOptions

Objekt

Nazwa	Typ	Opis
size	integer (int32)	Wzmianka o rozmiarze Tmpfs

VolumeDefinition

Objekt

Nazwa	Typ	Domyślna wartość	Opis
bind	BindOptions		Opcje powiązania instalacji
consistency	string		Spójność woluminu
readOnly	boolean		Określ, czy wolumin ma być zamontowany jako readOnly. Wartość domyślna dla tej wartości to false.
source	string		Źródło instalacji. W przypadku instalacji powiązania jest to ścieżka hosta.
target	string		Element docelowy instalacji. W przypadku instalacji powiązania jest to ścieżka w kontenerze.
tmpfs	TmpfsOptions		opcja tmpfs instalacji
type	VolumeDefinitionType	bind	Typ definicji woluminu Typ definicji woluminu. Możliwe wartości: bind,volume,tmpfs,npipe
volume	VolumeOptions		Opcje woluminu instalacji

VolumeDefinitionType

Wyliczanie

Typ definicji woluminu

Wartość	Opis
bind
volume
tmpfs
npipe

VolumeOptions

Objekt

Nazwa	Typ	Opis
nocopy	boolean	Wskazuje, czy wolumin jest nocopy

Udostępnij za pośrednictwem

Compute - Update Custom Services

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Update Custom Services

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

BindOptions

CustomService

Docker

Endpoint

EnvironmentVariable

EnvironmentVariableType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Image

ImageType

JupyterKernelConfig

protocol

TmpfsOptions

VolumeDefinition

VolumeDefinitionType

VolumeOptions