Compute Node - Update User

Service:

Batch Service

API Version:

2023-11-01.18.0

Updates kata sandi dan waktu kedaluwarsa Akun pengguna pada Simpul Komputasi yang ditentukan.
Operasi ini menggantikan semua properti Akun yang dapat diperbarui. Misalnya, jika elemen expiryTime tidak ditentukan, nilai saat ini diganti dengan nilai default, tidak dibiarkan tidak dimodifikasi. Anda dapat memperbarui Akun pengguna pada Simpul Komputasi hanya saat berada dalam status menganggur atau berjalan.

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

With optional parameters:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
batchUrl	path	True	string	URL dasar untuk semua permintaan layanan Azure Batch.
nodeId	path	True	string	ID komputer tempat Anda ingin memperbarui Akun pengguna.
poolId	path	True	string	ID Kumpulan yang berisi Simpul Komputasi.
userName	path	True	string	Nama Akun pengguna yang akan diperbarui.
api-version	query	True	string	Versi API Klien.
timeout	query		integer int32	Waktu maksimum yang dapat dihabiskan server untuk memproses permintaan, dalam hitung detik. Defaultnya adalah 30 detik.

Header Permintaan

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

Nama	Diperlukan	Jenis	Deskripsi
client-request-id		string uuid	Identitas permintaan yang dihasilkan pemanggil, dalam bentuk GUID tanpa dekorasi seperti kurung kurawal, misalnya 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Apakah server harus mengembalikan client-request-id dalam respons.
ocp-date		string date-time-rfc1123	Waktu permintaan dikeluarkan. Pustaka klien biasanya mengatur ini ke waktu jam sistem saat ini; atur secara eksplisit jika Anda memanggil REST API secara langsung.

Isi Permintaan

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

Nama	Jenis	Deskripsi
expiryTime	string	Waktu kedaluwarsa Akun. Jika dihilangkan, defaultnya adalah 1 hari dari waktu saat ini. Untuk Simpul Komputasi Linux, expiryTime memiliki presisi hingga sehari.
password	string	Kata sandi Akun. Kata sandi diperlukan untuk Simpul Komputasi Windows (yang dibuat dengan 'cloudServiceConfiguration', atau dibuat dengan 'virtualMachineConfiguration' menggunakan referensi Gambar Windows). Untuk Simpul Komputasi Linux, kata sandi dapat secara opsional ditentukan bersama dengan properti sshPublicKey. Jika dihilangkan, kata sandi yang ada akan dihapus.
sshPublicKey	string	Kunci umum SSH yang dapat digunakan untuk login jarak jauh ke Simpul Komputasi. Kunci publik harus kompatibel dengan pengodean OpenSSH dan harus dikodekan base 64. Properti ini hanya dapat ditentukan untuk Simpul Komputasi Linux. Jika ini ditentukan untuk Simpul Komputasi Windows, maka layanan Batch menolak permintaan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk). Jika dihilangkan, kunci umum SSH yang ada akan dihapus.

Respons

Nama	Jenis	Deskripsi
200 OK		Permintaan ke layanan Batch berhasil. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	Kesalahan dari layanan Batch.

Keamanan

azure_auth

Microsoft Entra alur kode autentikasi OAuth 2.0

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

Scopes

Nama	Deskripsi
user_impersonation	Meniru akun pengguna Anda

Authorization

Type: apiKey
In: header

Contoh

Node update user

Sample Request

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

Sample Response

Status code:

200

Definisi

Nama	Deskripsi
BatchError	Respons kesalahan yang diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
ErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.
NodeUpdateUserParameter	Kumpulan perubahan yang akan dilakukan pada Akun pengguna pada Simpul Komputasi.

BatchError

Respons kesalahan yang diterima dari layanan Azure Batch.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode tidak berubah dan dimaksudkan untuk dikonsumsi secara terprogram.
message	ErrorMessage	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
values	BatchErrorDetail[]	Kumpulan pasangan kunci-nilai yang berisi detail tambahan tentang kesalahan.

BatchErrorDetail

Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
key	string	Pengidentifikasi yang menentukan arti properti Nilai.
value	string	Informasi tambahan disertakan dengan respons kesalahan.

ErrorMessage

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

Nama	Jenis	Deskripsi
lang	string	Kode bahasa pesan kesalahan
value	string	Teks pesan.

NodeUpdateUserParameter

Kumpulan perubahan yang akan dilakukan pada Akun pengguna pada Simpul Komputasi.

Nama	Jenis	Deskripsi
expiryTime	string	Waktu kedaluwarsa Akun. Jika dihilangkan, defaultnya adalah 1 hari dari waktu saat ini. Untuk Simpul Komputasi Linux, expiryTime memiliki presisi hingga sehari.
password	string	Kata sandi Akun. Kata sandi diperlukan untuk Simpul Komputasi Windows (yang dibuat dengan 'cloudServiceConfiguration', atau dibuat dengan 'virtualMachineConfiguration' menggunakan referensi Gambar Windows). Untuk Simpul Komputasi Linux, kata sandi dapat secara opsional ditentukan bersama dengan properti sshPublicKey. Jika dihilangkan, kata sandi yang ada akan dihapus.
sshPublicKey	string	Kunci umum SSH yang dapat digunakan untuk login jarak jauh ke Simpul Komputasi. Kunci publik harus kompatibel dengan pengodean OpenSSH dan harus dikodekan base 64. Properti ini hanya dapat ditentukan untuk Simpul Komputasi Linux. Jika ini ditentukan untuk Simpul Komputasi Windows, maka layanan Batch menolak permintaan; jika Anda memanggil REST API secara langsung, kode status HTTP adalah 400 (Permintaan Buruk). Jika dihilangkan, kunci umum SSH yang ada akan dihapus.