Compute Node - Update User

Aktualizace heslo a čas vypršení platnosti uživatelského účtu na zadaném výpočetním uzlu.
Tato operace nahrazuje všechny aktualizovatelné vlastnosti účtu. Pokud například není zadaný prvek expiryTime, aktuální hodnota se nahradí výchozí hodnotou, není ponechána neupravená. Uživatelský účet můžete aktualizovat na výpočetním uzlu jenom v případě, že je v nečinnosti nebo spuštěném stavu.

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2022-01-01.15.0
PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?timeout={timeout}&api-version=2022-01-01.15.0

Parametry identifikátoru URI

Name In Required Type Description
batchUrl
path True
  • string

Základní adresa URL pro všechny požadavky na služby Azure Batch.

nodeId
path True
  • string

ID počítače, na kterém chcete aktualizovat uživatelský účet.

poolId
path True
  • string

ID fondu, který obsahuje výpočetní uzel.

userName
path True
  • string

Jméno uživatelského účtu, který se má aktualizovat.

api-version
query True
  • string

Verze rozhraní API klienta

timeout
query
  • integer
int32

Maximální doba, kterou může server strávit zpracováním požadavku, v sekundách. Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name Required Type Description
client-request-id
  • string
uuid

Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id
  • boolean

Jestli má server v odpovědi vrátit ID požadavku klienta.

ocp-date
  • string
date-time-rfc1123

Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas hodin; pokud voláte rozhraní REST API přímo, nastavte ho explicitně.

Text požadavku

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

Name Type Description
expiryTime
  • string

Čas, kdy má účet vypršet.
Pokud je vynecháno, výchozí hodnota je 1 den od aktuálního času. U výpočetních uzlů s Linuxem má doba vypršení platnosti přesnost až den.

password
  • string

Heslo účtu.
Heslo se vyžaduje pro výpočetní uzly Windows (vytvořené pomocí cloudServiceConfiguration nebo vytvořené pomocí virtualMachineConfiguration pomocí odkazu na image Windows). Pro výpočetní uzly Linuxu je možné heslo volitelně zadat spolu s vlastností sshPublicKey. Pokud je vynecháno, odebere se jakékoli existující heslo.

sshPublicKey
  • string

Veřejný klíč SSH, který lze použít pro vzdálené přihlášení k výpočetnímu uzlu.
Veřejný klíč by měl být kompatibilní s kódováním OpenSSH a měl by být zakódovaný na bázi 64. Tuto vlastnost lze zadat pouze pro výpočetní uzly Linuxu. Pokud je tato hodnota určená pro výpočetní uzel Windows, služba Batch žádost odmítne; pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (chybný požadavek). Pokud je vynecháno, odebere se veškerý existující veřejný klíč SSH.

Odpovědi

Name Type Description
200 OK

Požadavek na službu Batch byl úspěšný.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

Chyba ze služby Batch.

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Zosobnění uživatelského účtu

Authorization

Type: apiKey
In: header

Příklady

Node update user

Sample Request

PUT account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2022-01-01.15.0



{
  "password": "12345",
  "expiryTime": "2016-11-27T00:45:48.7320857Z"
}

Sample Response

Definice

BatchError

Chybová odpověď přijatá ze služby Azure Batch.

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu Azure Batch

ErrorMessage

V odpovědi na chybu Azure Batch se zobrazila chybová zpráva.

NodeUpdateUserParameter

Sada změn, které se mají provést u uživatelského účtu na výpočetním uzlu.

BatchError

Chybová odpověď přijatá ze služby Azure Batch.

Name Type Description
code
  • string

Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.

message

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.

values

Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka dalších informací zahrnutých v odpovědi na chybu Azure Batch

Name Type Description
key
  • string

Identifikátor určující význam vlastnosti Value.

value
  • string

Další informace zahrnuté v odpovědi na chybu

ErrorMessage

V odpovědi na chybu Azure Batch se zobrazila chybová zpráva.

Name Type Description
lang
  • string

Kód jazyka chybové zprávy

value
  • string

Text zprávy.

NodeUpdateUserParameter

Sada změn, které se mají provést u uživatelského účtu na výpočetním uzlu.

Name Type Description
expiryTime
  • string

Čas, kdy má účet vypršet.
Pokud je vynecháno, výchozí hodnota je 1 den od aktuálního času. U výpočetních uzlů s Linuxem má doba vypršení platnosti přesnost až den.

password
  • string

Heslo účtu.
Heslo se vyžaduje pro výpočetní uzly Windows (vytvořené pomocí cloudServiceConfiguration nebo vytvořené pomocí virtualMachineConfiguration pomocí odkazu na image Windows). Pro výpočetní uzly Linuxu je možné heslo volitelně zadat spolu s vlastností sshPublicKey. Pokud je vynecháno, odebere se jakékoli existující heslo.

sshPublicKey
  • string

Veřejný klíč SSH, který lze použít pro vzdálené přihlášení k výpočetnímu uzlu.
Veřejný klíč by měl být kompatibilní s kódováním OpenSSH a měl by být zakódovaný na bázi 64. Tuto vlastnost lze zadat pouze pro výpočetní uzly Linuxu. Pokud je tato hodnota určená pro výpočetní uzel Windows, služba Batch žádost odmítne; pokud voláte rozhraní REST API přímo, stavový kód HTTP je 400 (chybný požadavek). Pokud je vynecháno, odebere se veškerý existující veřejný klíč SSH.