Compute Node - Add User
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=2023-11-01.18.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/users?timeout={timeout}&api-version=2023-11-01.18.0
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
batch
|
path | True |
string |
Podstawowy adres URL wszystkich żądań obsługi Azure Batch. |
node
|
path | True |
string |
Identyfikator komputera, na którym chcesz utworzyć konto użytkownika. |
pool
|
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, który serwer może poświęcić na przetwarzanie żądania w sekundach. Wartość domyślna to 30 sekund. |
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ć wartość client-request-id 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 |
Czas wygaśnięcia konta. |
|
isAdmin |
boolean |
Czy konto powinno być administratorem w węźle obliczeniowym. |
|
password |
string |
Hasło konta. |
|
sshPublicKey |
string |
Klucz publiczny SSH, który może służyć do zdalnego logowania do węzła obliczeniowego. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
201 Created |
Żądanie usługi Batch zakończyło się pomyślnie. Headers
|
|
Other Status Codes |
Błąd usługi Batch. |
Zabezpieczenia
azure_auth
Microsoft Entra przepływ kodu uwierzytelniania OAuth 2.0
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Nazwa | Opis |
---|---|
user_impersonation | Personifikuj konto użytkownika |
Authorization
Type:
apiKey
In:
header
Przykłady
Node add user
Sample Request
POST account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users?api-version=2023-11-01.18.0
{
"name": "userName",
"isAdmin": false,
"expiryTime": "2017-08-01T00:00:00Z",
"password": "Password"
}
Sample Response
Definicje
Nazwa | Opis |
---|---|
Batch |
Odpowiedź o błędzie odebrana z usługi Azure Batch. |
Batch |
Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu. |
Compute |
Konto użytkownika na potrzeby dostępu RDP lub SSH w węźle obliczeniowym. |
Error |
Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu. |
BatchError
Odpowiedź o błędzie odebrana z usługi Azure Batch.
Nazwa | Typ | Opis |
---|---|---|
code |
string |
Identyfikator błędu. Kody są niezmienne i mają być używane programowo. |
message |
Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika. |
|
values |
Kolekcja par klucz-wartość zawierająca dodatkowe szczegóły dotyczące błędu. |
BatchErrorDetail
Element dodatkowych informacji zawartych w odpowiedzi Azure Batch błędu.
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
Konto użytkownika na potrzeby dostępu RDP lub SSH w węźle obliczeniowym.
Nazwa | Typ | Opis |
---|---|---|
expiryTime |
string |
Czas wygaśnięcia konta. |
isAdmin |
boolean |
Czy konto powinno być administratorem w węźle obliczeniowym. |
name |
string |
Nazwa użytkownika konta. |
password |
string |
Hasło konta. |
sshPublicKey |
string |
Klucz publiczny SSH, który może służyć do zdalnego logowania do węzła obliczeniowego. |
ErrorMessage
Komunikat o błędzie odebrany w odpowiedzi Azure Batch błędu.
Nazwa | Typ | Opis |
---|---|---|
lang |
string |
Kod języka komunikatu o błędzie |
value |
string |
Tekst wiadomości. |