Delen via


Compute Node - Update User

Updates het wachtwoord en de verlooptijd van een gebruikersaccount op het opgegeven rekenknooppunt.
Deze bewerking vervangt alle bijwerkbare eigenschappen van het account. Als het element expiryTime bijvoorbeeld niet is opgegeven, wordt de huidige waarde vervangen door de standaardwaarde, niet ongewijzigd gelaten. U kunt een gebruikersaccount op een rekenknooppunt alleen bijwerken wanneer het inactief of actief is.

PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?api-version=2023-11-01.18.0
PUT {batchUrl}/pools/{poolId}/nodes/{nodeId}/users/{userName}?timeout={timeout}&api-version=2023-11-01.18.0

URI-parameters

Name In Vereist Type Description
batchUrl
path True

string

De basis-URL voor alle Azure Batch serviceaanvragen.

nodeId
path True

string

De id van de computer waarop u een gebruikersaccount wilt bijwerken.

poolId
path True

string

De id van de pool die het rekenknooppunt bevat.

userName
path True

string

De naam van het gebruikersaccount dat moet worden bijgewerkt.

api-version
query True

string

Client-API-versie.

timeout
query

integer

int32

De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden.

Aanvraagkoptekst

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

Name Vereist Type Description
client-request-id

string

uuid

De aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Of de server de client-request-id in het antwoord moet retourneren.

ocp-date

string

date-time-rfc1123

Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige systeemkloktijd; stel dit expliciet in als u de REST API rechtstreeks aanroept.

Aanvraagbody

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

Name Type Description
expiryTime

string

Het tijdstip waarop het account verloopt.
Als u dit weglaat, is de standaardwaarde 1 dag vanaf de huidige tijd. Voor Linux-rekenknooppunten heeft de expiryTime een precisie van maximaal een dag.

password

string

Het wachtwoord van het account.
Het wachtwoord is vereist voor Windows-rekenknooppunten (die zijn gemaakt met 'cloudServiceConfiguration', of die zijn gemaakt met 'virtualMachineConfiguration' met behulp van een Verwijzing naar een Windows-installatiekopie). Voor Linux-rekenknooppunten kan het wachtwoord optioneel worden opgegeven samen met de eigenschap sshPublicKey. Als u dit weglaat, wordt een bestaand wachtwoord verwijderd.

sshPublicKey

string

De openbare SSH-sleutel die kan worden gebruikt voor externe aanmelding bij het rekenknooppunt.
De openbare sleutel moet compatibel zijn met OpenSSH-codering en moet base 64-codering hebben. Deze eigenschap kan alleen worden opgegeven voor Linux-rekenknooppunten. Als dit is opgegeven voor een Windows Compute-knooppunt, weigert de Batch-service de aanvraag; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Als u dit weglaat, wordt een bestaande openbare SSH-sleutel verwijderd.

Antwoorden

Name Type Description
200 OK

De aanvraag voor de Batch-service is geslaagd.

Kopteksten

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

BatchError

De fout van de Batch-service.

Beveiliging

azure_auth

Microsoft Entra OAuth 2.0-verificatiecodestroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Authorization

Type: apiKey
In: header

Voorbeelden

Node update user

Voorbeeldaanvraag

PUT account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161121t182739z/users/userName?api-version=2023-11-01.18.0



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

Voorbeeldrespons

Definities

Name Description
BatchError

Een foutbericht dat is ontvangen van de Azure Batch-service.

BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

ErrorMessage

Een foutbericht ontvangen in een Azure Batch antwoord.

NodeUpdateUserParameter

De set wijzigingen die moeten worden aangebracht in een gebruikersaccount op een rekenknooppunt.

BatchError

Een foutbericht dat is ontvangen van de Azure Batch-service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

message

ErrorMessage

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

values

BatchErrorDetail[]

Een verzameling sleutel-waardeparen met aanvullende details over de fout.

BatchErrorDetail

Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.

Name Type Description
key

string

Een id die de betekenis van de eigenschap Value aangeeft.

value

string

De aanvullende informatie die is opgenomen in de foutreactie.

ErrorMessage

Een foutbericht ontvangen in een Azure Batch antwoord.

Name Type Description
lang

string

De taalcode van het foutbericht

value

string

De tekst van het bericht.

NodeUpdateUserParameter

De set wijzigingen die moeten worden aangebracht in een gebruikersaccount op een rekenknooppunt.

Name Type Description
expiryTime

string

Het tijdstip waarop het account verloopt.
Als u dit weglaat, is de standaardwaarde 1 dag vanaf de huidige tijd. Voor Linux-rekenknooppunten heeft de expiryTime een precisie van maximaal een dag.

password

string

Het wachtwoord van het account.
Het wachtwoord is vereist voor Windows-rekenknooppunten (die zijn gemaakt met 'cloudServiceConfiguration', of die zijn gemaakt met 'virtualMachineConfiguration' met behulp van een Verwijzing naar een Windows-installatiekopie). Voor Linux-rekenknooppunten kan het wachtwoord optioneel worden opgegeven samen met de eigenschap sshPublicKey. Als u dit weglaat, wordt een bestaand wachtwoord verwijderd.

sshPublicKey

string

De openbare SSH-sleutel die kan worden gebruikt voor externe aanmelding bij het rekenknooppunt.
De openbare sleutel moet compatibel zijn met OpenSSH-codering en moet base 64-codering hebben. Deze eigenschap kan alleen worden opgegeven voor Linux-rekenknooppunten. Als dit is opgegeven voor een Windows Compute-knooppunt, weigert de Batch-service de aanvraag; Als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Als u dit weglaat, wordt een bestaande openbare SSH-sleutel verwijderd.