Compute Node - Add User

Usługa:

Batch Service

Wersja interfejsu API:

2024-07-01.20.0

Dodaje konto użytkownika do określonego węzła obliczeniowego.
Konto użytkownika można dodać do węzła obliczeniowego tylko wtedy, gdy jest w stanie bezczynności lub uruchomienia.

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/users?api-version=2024-07-01.20.0

Z parametrami opcjonalnymi:

POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/users?timeout={timeout}&api-version=2024-07-01.20.0

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
batchUrl	path	True	string	Podstawowy adres URL dla wszystkich żądań usługi Azure Batch.
nodeId	path	True	string	Identyfikator maszyny, na której chcesz utworzyć konto użytkownika.
poolId	path	True	string	Identyfikator puli zawierającej węzeł obliczeniowy.
api-version	query	True	string	Wersja interfejsu API klienta.
timeout	query		integer (int32)	Maksymalny czas przetwarzania żądania przez serwer w sekundach. Wartość domyślna to 30 sekund. Jeśli wartość jest większa niż 30, zostanie użyta wartość domyślna.

Nagłówek żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
client-request-id		string (uuid)	Tożsamość żądania wygenerowanego przez obiekt wywołujący w postaci identyfikatora GUID bez dekoracji, takiej jak nawiasy klamrowe, np. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Czy serwer powinien zwrócić identyfikator żądania klienta w odpowiedzi.
ocp-date		string (date-time-rfc1123)	Czas wystawienia żądania. Biblioteki klienckie zazwyczaj ustawiają tę wartość na bieżący czas zegara systemowego; ustaw go jawnie, jeśli bezpośrednio wywołujesz interfejs API REST.

Treść żądania

Media Types: "application/json; odata=minimalmetadata"

Nazwa	Wymagane	Typ	Opis
name	True	string	Nazwa użytkownika konta.
expiryTime		string (date-time)	Czas wygaśnięcia konta. W przypadku pominięcia wartość domyślna to 1 dzień od bieżącej godziny. W przypadku węzłów obliczeniowych systemu Linux funkcja expiryTime ma maksymalną precyzję do dnia.
isAdmin		boolean	Czy konto powinno być administratorem w węźle obliczeniowym. Wartość domyślna to false.
password		string	Hasło konta. Hasło jest wymagane dla węzłów obliczeniowych systemu Windows. W przypadku węzłów obliczeniowych systemu Linux można opcjonalnie określić hasło wraz z właściwością sshPublicKey.
sshPublicKey		string	Klucz publiczny SSH, który może służyć do zdalnego logowania do węzła obliczeniowego. Klucz publiczny powinien być zgodny z kodowaniem OpenSSH i powinien być zakodowany w formacie base 64. Tę właściwość można określić tylko dla węzłów obliczeniowych systemu Linux. Jeśli określono to dla węzła obliczeniowego systemu Windows, usługa Batch odrzuca żądanie; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

Odpowiedzi

Nazwa	Typ	Opis
201 Created		Żądanie do usługi Batch zakończyło się pomyślnie. Nagłówki client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Błąd usługi Batch.

Zabezpieczenia

azure_auth

Microsoft Entra OAuth 2.0 — przepływ kodu uwierzytelniania

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

Zakresy

Nazwa	Opis
user_impersonation	Personifikuj konto użytkownika

Authorization

Typ: apiKey
W: header

Przykłady

Node add user

Przykładowe żądanie

HTTP

POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users?api-version=2024-07-01.20.0



{
  "name": "userName",
  "isAdmin": false,
  "expiryTime": "2017-08-01T00:00:00Z",
  "password": "Password"
}

Przykładowa odpowiedź

Kod stanu:

201

Definicje

Nazwa	Opis
BatchError	Odebrano odpowiedź o błędzie z usługi Azure Batch.
BatchErrorDetail	Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.
ComputeNodeUser	Konto użytkownika na potrzeby dostępu RDP lub SSH w węźle obliczeniowym.
ErrorMessage	Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

BatchError

Objekt

Odebrano odpowiedź o błędzie z usługi Azure Batch.

Nazwa	Typ	Opis
code	string	Identyfikator błędu. Kody są niezmienne i mają być używane programowo.
message	ErrorMessage	Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.
values	BatchErrorDetail[]	Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu.

BatchErrorDetail

Objekt

Element dodatkowych informacji zawartych w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
key	string	Identyfikator określający znaczenie właściwości Value.
value	string	Dodatkowe informacje zawarte w odpowiedzi na błąd.

ComputeNodeUser

Objekt

Konto użytkownika na potrzeby dostępu RDP lub SSH w węźle obliczeniowym.

Nazwa	Typ	Opis
expiryTime	string (date-time)	Czas wygaśnięcia konta. W przypadku pominięcia wartość domyślna to 1 dzień od bieżącej godziny. W przypadku węzłów obliczeniowych systemu Linux funkcja expiryTime ma maksymalną precyzję do dnia.
isAdmin	boolean	Czy konto powinno być administratorem w węźle obliczeniowym. Wartość domyślna to false.
name	string	Nazwa użytkownika konta.
password	string	Hasło konta. Hasło jest wymagane dla węzłów obliczeniowych systemu Windows. W przypadku węzłów obliczeniowych systemu Linux można opcjonalnie określić hasło wraz z właściwością sshPublicKey.
sshPublicKey	string	Klucz publiczny SSH, który może służyć do zdalnego logowania do węzła obliczeniowego. Klucz publiczny powinien być zgodny z kodowaniem OpenSSH i powinien być zakodowany w formacie base 64. Tę właściwość można określić tylko dla węzłów obliczeniowych systemu Linux. Jeśli określono to dla węzła obliczeniowego systemu Windows, usługa Batch odrzuca żądanie; Jeśli bezpośrednio wywołujesz interfejs API REST, kod stanu HTTP to 400 (Nieprawidłowe żądanie).

ErrorMessage

Objekt

Komunikat o błędzie odebrany w odpowiedzi na błąd usługi Azure Batch.

Nazwa	Typ	Opis
lang	string	Kod języka komunikatu o błędzie
value	string	Tekst wiadomości.