Bagikan melalui


Compute Node - Update User

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
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.

Header

  • 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

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Authorization

Jenis: apiKey
Dalam: header

Contoh

Node update user

Permintaan sampel

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

Respon sampel

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.