Compute Node - Update User

참조

서비스:: Batch Service

API 버전:: 2023-11-01.18.0

지정된 컴퓨팅 노드에서 사용자 계정의 암호 및 만료 시간을 업데이트.
이 작업은 계정의 업데이트 가능한 모든 속성을 대체합니다. 예를 들어 expiryTime 요소를 지정하지 않으면 현재 값이 수정되지 않은 상태로 남아 있지 않고 기본값으로 바뀝니다. 컴퓨팅 노드가 유휴 상태이거나 실행 중인 경우에만 컴퓨팅 노드에서 사용자 계정을 업데이트할 수 있습니다.

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 매개 변수

Name	In(다음 안에)	필수	형식	Description
batchUrl	path	True	string	모든 Azure Batch 서비스 요청에 대한 기본 URL입니다.
nodeId	path	True	string	사용자 계정을 업데이트하려는 컴퓨터의 ID입니다.
poolId	path	True	string	컴퓨팅 노드를 포함하는 풀의 ID입니다.
userName	path	True	string	업데이트할 사용자 계정의 이름입니다.
api-version	query	True	string	클라이언트 API 버전.
timeout	query		integer int32	서버에서 요청을 처리하는 데 소요할 수 있는 최대 시간(초)입니다. 기본값은 30초입니다.

요청 헤더

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

Name	형식	Description
client-request-id	string uuid	9C4D50EE-2D56-4CD3-8152-34347DC9F2B0과 같이 장식이 없는 GUID 형식의 호출자 생성 요청 ID입니다.
return-client-request-id	boolean	서버가 응답에서 client-request-id를 반환해야 하는지 여부입니다.
ocp-date	string date-time-rfc1123	요청이 실행된 시간입니다. 클라이언트 라이브러리는 일반적으로 이를 현재 시스템 클록 시간으로 설정합니다. REST API를 직접 호출하는 경우 명시적으로 설정합니다.

요청 본문

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

Name	형식	Description
expiryTime	string	계정이 만료되어야 하는 시간입니다. 생략하면 기본값은 현재 시간으로부터 1일입니다. Linux 컴퓨팅 노드의 경우 expiryTime의 전체 자릿수는 최대 하루입니다.
password	string	계정의 암호입니다. 암호는 Windows Compute 노드('cloudServiceConfiguration'로 만들거나 Windows 이미지 참조를 사용하여 'virtualMachineConfiguration'으로 만든 노드)에 필요합니다. Linux 컴퓨팅 노드의 경우 sshPublicKey 속성과 함께 암호를 선택적으로 지정할 수 있습니다. 생략하면 기존 암호가 제거됩니다.
sshPublicKey	string	컴퓨팅 노드에 원격 로그인하는 데 사용할 수 있는 SSH 공개 키입니다. 공개 키는 OpenSSH 인코딩과 호환되어야 하며 base 64로 인코딩되어야 합니다. 이 속성은 Linux 컴퓨팅 노드에 대해서만 지정할 수 있습니다. Windows Compute Node에 대해 지정한 경우 Batch 서비스는 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 생략하면 기존 SSH 공개 키가 제거됩니다.

응답

Name	형식	Description
200 OK		Batch 서비스에 대한 요청이 성공했습니다. 헤더 client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Batch 서비스의 오류입니다.

Name

형식

Description

200 OK

Batch 서비스에 대한 요청이 성공했습니다.

헤더

client-request-id: string
request-id: string
ETag: string
Last-Modified: string
DataServiceId: string

Other Status Codes

BatchError

Batch 서비스의 오류입니다.

보안

azure_auth

OAuth 2.0 인증 코드 흐름 Microsoft Entra

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

Authorization

형식: apiKey
In(다음 안에): header

예제

Node update user

샘플 요청

HTTP

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"
}

샘플 응답

상태 코드:: 200

정의

Name	Description
BatchError	Azure Batch 서비스에서 받은 오류 응답입니다.
BatchErrorDetail	Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.
ErrorMessage	Azure Batch 오류 응답에서 받은 오류 메시지입니다.
NodeUpdateUserParameter	컴퓨팅 노드의 사용자 계정에 대한 변경 내용 집합입니다.

BatchError

Azure Batch 서비스에서 받은 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정이며 프로그래밍 방식으로 사용하기 위한 것입니다.
message	ErrorMessage	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
values	BatchErrorDetail[]	오류에 대한 추가 세부 정보를 포함하는 키-값 쌍의 컬렉션입니다.

BatchErrorDetail

Azure Batch 오류 응답에 포함된 추가 정보의 항목입니다.

Name	형식	Description
key	string	Value 속성의 의미를 지정하는 식별자입니다.
value	string	오류 응답에 포함된 추가 정보입니다.

ErrorMessage

Azure Batch 오류 응답에서 받은 오류 메시지입니다.

Name	형식	Description
lang	string	오류 메시지의 언어 코드
value	string	메시지의 텍스트입니다.

NodeUpdateUserParameter

컴퓨팅 노드의 사용자 계정에 대한 변경 내용 집합입니다.

Name	형식	Description
expiryTime	string	계정이 만료되어야 하는 시간입니다. 생략하면 기본값은 현재 시간으로부터 1일입니다. Linux 컴퓨팅 노드의 경우 expiryTime의 전체 자릿수는 최대 하루입니다.
password	string	계정의 암호입니다. 암호는 Windows Compute 노드('cloudServiceConfiguration'로 만들거나 Windows 이미지 참조를 사용하여 'virtualMachineConfiguration'으로 만든 노드)에 필요합니다. Linux 컴퓨팅 노드의 경우 sshPublicKey 속성과 함께 암호를 선택적으로 지정할 수 있습니다. 생략하면 기존 암호가 제거됩니다.
sshPublicKey	string	컴퓨팅 노드에 원격 로그인하는 데 사용할 수 있는 SSH 공개 키입니다. 공개 키는 OpenSSH 인코딩과 호환되어야 하며 base 64로 인코딩되어야 합니다. 이 속성은 Linux 컴퓨팅 노드에 대해서만 지정할 수 있습니다. Windows Compute Node에 대해 지정한 경우 Batch 서비스는 요청을 거부합니다. REST API를 직접 호출하는 경우 HTTP 상태 코드는 400(잘못된 요청)입니다. 생략하면 기존 SSH 공개 키가 제거됩니다.

다음을 통해 공유

Compute Node - Update User

URI 매개 변수

요청 헤더

요청 본문

응답

보안

azure_auth

범위

Authorization

예제

Node update user

샘플 요청

샘플 응답

정의

BatchError

BatchErrorDetail

ErrorMessage

NodeUpdateUserParameter

추가 리소스