Compute Node - Add User
Lägger till ett användarkonto i den angivna beräkningsnoden.
Du kan bara lägga till ett användarkonto i en beräkningsnod när den är i inaktivt eller körs-tillstånd.
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/users?api-version=2024-07-01.20.0
POST {batchUrl}/pools/{poolId}/nodes/{nodeId}/users?timeout={timeout}&api-version=2024-07-01.20.0
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Bas-URL:en för alla Azure Batch-tjänstbegäranden. |
node
|
path | True |
string |
ID:t för den dator där du vill skapa ett användarkonto. |
pool
|
path | True |
string |
ID:t för poolen som innehåller beräkningsnoden. |
api-version
|
query | True |
string |
Klient-API-version. |
timeout
|
query |
integer (int32) |
Den maximala tid som servern kan ägna åt att bearbeta begäran i sekunder. Standardvärdet är 30 sekunder. Om värdet är större än 30 används standardvärdet i stället. |
Begärandehuvud
Media Types: "application/json; odata=minimalmetadata"
Name | Obligatorisk | Typ | Description |
---|---|---|---|
client-request-id |
string (uuid) |
Den anropargenererade begärandeidentiteten i form av ett GUID utan dekoration, till exempel klammerparenteser, t.ex. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Om servern ska returnera klient-request-id i svaret. |
|
ocp-date |
string (date-time-rfc1123) |
Den tid då begäran utfärdades. Klientbibliotek anger vanligtvis detta till den aktuella systemklockatiden. ange det explicit om du anropar REST-API:et direkt. |
Begärandetext
Media Types: "application/json; odata=minimalmetadata"
Name | Obligatorisk | Typ | Description |
---|---|---|---|
name | True |
string |
Användarnamnet för kontot. |
expiryTime |
string (date-time) |
Den tid då kontot ska upphöra att gälla. |
|
isAdmin |
boolean |
Om kontot ska vara administratör på beräkningsnoden. |
|
password |
string |
Lösenordet för kontot. |
|
sshPublicKey |
string |
Den offentliga SSH-nyckeln som kan användas för fjärrinloggning till beräkningsnoden. |
Svar
Name | Typ | Description |
---|---|---|
201 Created |
Begäran till Batch-tjänsten lyckades. Sidhuvuden
|
|
Other Status Codes |
Felet från Batch-tjänsten. |
Säkerhet
azure_auth
Autentiseringskodflöde för Microsoft Entra OAuth 2.0
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | Personifiera ditt användarkonto |
Authorization
Typ:
apiKey
I:
header
Exempel
Node add user
Exempelbegäran
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"
}
Exempelsvar
Definitioner
Name | Description |
---|---|
Batch |
Ett felsvar som tagits emot från Azure Batch-tjänsten. |
Batch |
Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar. |
Compute |
Ett användarkonto för RDP- eller SSH-åtkomst på en beräkningsnod. |
Error |
Ett felmeddelande som togs emot i ett Azure Batch-felsvar. |
BatchError
Ett felsvar som tagits emot från Azure Batch-tjänsten.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
message |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
|
values |
En samling nyckel/värde-par som innehåller ytterligare information om felet. |
BatchErrorDetail
Ett objekt med ytterligare information som ingår i ett Azure Batch-felsvar.
Name | Typ | Description |
---|---|---|
key |
string |
En identifierare som anger innebörden av egenskapen Value. |
value |
string |
Den ytterligare information som ingår i felsvaret. |
ComputeNodeUser
Ett användarkonto för RDP- eller SSH-åtkomst på en beräkningsnod.
Name | Typ | Description |
---|---|---|
expiryTime |
string (date-time) |
Den tid då kontot ska upphöra att gälla. |
isAdmin |
boolean |
Om kontot ska vara administratör på beräkningsnoden. |
name |
string |
Användarnamnet för kontot. |
password |
string |
Lösenordet för kontot. |
sshPublicKey |
string |
Den offentliga SSH-nyckeln som kan användas för fjärrinloggning till beräkningsnoden. |
ErrorMessage
Ett felmeddelande som togs emot i ett Azure Batch-felsvar.
Name | Typ | Description |
---|---|---|
lang |
string |
Språkkoden för felmeddelandet |
value |
string |
Texten i meddelandet. |