Aracılığıyla paylaş


Compute Node - Update User

Belirtilen İşlem Düğümünde kullanıcı Hesabının parolasını ve sona erme süresini Güncelleştirmeler.
Bu işlem, Hesabın tüm güncelleştirilebilir özelliklerinin yerini alır. Örneğin, expiryTime öğesi belirtilmezse, geçerli değer değiştirilmemiş olarak bırakılmaz, varsayılan değerle değiştirilir. İşlem Düğümündeki bir kullanıcı hesabını yalnızca boşta veya çalışır durumda olduğunda güncelleştirebilirsiniz.

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 Parametreleri

Name İçinde Gerekli Tür Description
batchUrl
path True

string

Tüm Azure Batch hizmet isteklerinin temel URL'si.

nodeId
path True

string

Kullanıcı Hesabını güncelleştirmek istediğiniz makinenin kimliği.

poolId
path True

string

İşlem Düğümünü içeren Havuzun Kimliği.

userName
path True

string

Güncelleştirilecek kullanıcı hesabının adı.

api-version
query True

string

İstemci API Sürümü.

timeout
query

integer

int32

Sunucunun isteği işlemek için harcayabileceği en uzun süre (saniye olarak). Varsayılan değer 30 saniyedir.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

Çağıranın oluşturduğu istek kimliği, küme ayraçları gibi süsleme içermeyen bir GUID biçimindedir; örneğin 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.

return-client-request-id

boolean

Sunucunun yanıtta client-request-id döndürip döndürmeyeceği.

ocp-date

string

date-time-rfc1123

İsteğin verildiği saat. İstemci kitaplıkları bunu genellikle geçerli sistem saat saati olarak ayarlar; REST API'yi doğrudan çağırıyorsanız açıkça ayarlayın.

İstek Gövdesi

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

Name Tür Description
expiryTime

string

Hesabın süresinin dolması gereken saat.
Atlanırsa, varsayılan değer geçerli saatten itibaren 1 gündür. Linux İşlem Düğümleri için expiryTime değerinin bir güne kadar duyarlığı vardır.

password

string

Hesabın parolası.
Parola, Windows İşlem Düğümleri için gereklidir ('cloudServiceConfiguration' ile oluşturulanlar veya bir Windows Görüntüsü başvurusu kullanılarak 'virtualMachineConfiguration' ile oluşturulanlar). Linux İşlem Düğümleri için parola isteğe bağlı olarak sshPublicKey özelliğiyle birlikte belirtilebilir. Atlanırsa, var olan tüm parolalar kaldırılır.

sshPublicKey

string

İşlem Düğümünde uzaktan oturum açmak için kullanılabilecek SSH ortak anahtarı.
Ortak anahtar OpenSSH kodlamasıyla uyumlu olmalı ve 64 tabanı kodlanmış olmalıdır. Bu özellik yalnızca Linux İşlem Düğümleri için belirtilebilir. Bu bir Windows İşlem Düğümü için belirtilirse Batch hizmeti isteği reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400 (Hatalı İstek) olur. Atlanırsa, mevcut tüm SSH ortak anahtarları kaldırılır.

Yanıtlar

Name Tür Description
200 OK

Batch hizmetine yapılan istek başarılı oldu.

Üst Bilgiler

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

BatchError

Batch hizmetinden gelen hata.

Güvenlik

azure_auth

OAuth 2.0 kimlik doğrulama kodu akışını Microsoft Entra

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name Description
user_impersonation Kullanıcı hesabınızın kimliğine bürünme

Authorization

Tür: apiKey
İçinde: header

Örnekler

Node update user

Örnek isteği

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

Örnek yanıt

Tanımlar

Name Description
BatchError

Azure Batch hizmetinden alınan bir hata yanıtı.

BatchErrorDetail

Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.

ErrorMessage

Azure Batch hata yanıtında alınan bir hata iletisi.

NodeUpdateUserParameter

İşlem Düğümündeki bir kullanıcı hesabında yapılacak değişiklik kümesi.

BatchError

Azure Batch hizmetinden alınan bir hata yanıtı.

Name Tür Description
code

string

Hatanın tanımlayıcısı. Kodlar sabittir ve program aracılığıyla kullanılması amaçlanmıştır.

message

ErrorMessage

Hatayı açıklayan ve kullanıcı arabiriminde görüntülenmeye uygun olması amaçlanan bir ileti.

values

BatchErrorDetail[]

Hatayla ilgili ek ayrıntıları içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına eklenen ek bilgilerden oluşan bir öğe.

Name Tür Description
key

string

Value özelliğinin anlamını belirten tanımlayıcı.

value

string

Hata yanıtına eklenen ek bilgiler.

ErrorMessage

Azure Batch hata yanıtında alınan bir hata iletisi.

Name Tür Description
lang

string

Hata iletisinin dil kodu

value

string

İletinin metni.

NodeUpdateUserParameter

İşlem Düğümündeki bir kullanıcı hesabında yapılacak değişiklik kümesi.

Name Tür Description
expiryTime

string

Hesabın süresinin dolması gereken saat.
Atlanırsa, varsayılan değer geçerli saatten itibaren 1 gündür. Linux İşlem Düğümleri için expiryTime değerinin bir güne kadar duyarlığı vardır.

password

string

Hesabın parolası.
Parola, Windows İşlem Düğümleri için gereklidir ('cloudServiceConfiguration' ile oluşturulanlar veya bir Windows Görüntüsü başvurusu kullanılarak 'virtualMachineConfiguration' ile oluşturulanlar). Linux İşlem Düğümleri için parola isteğe bağlı olarak sshPublicKey özelliğiyle birlikte belirtilebilir. Atlanırsa, var olan tüm parolalar kaldırılır.

sshPublicKey

string

İşlem Düğümünde uzaktan oturum açmak için kullanılabilecek SSH ortak anahtarı.
Ortak anahtar OpenSSH kodlamasıyla uyumlu olmalı ve 64 tabanı kodlanmış olmalıdır. Bu özellik yalnızca Linux İşlem Düğümleri için belirtilebilir. Bu bir Windows İşlem Düğümü için belirtilirse Batch hizmeti isteği reddeder; REST API'yi doğrudan çağırıyorsanız HTTP durum kodu 400 (Hatalı İstek) olur. Atlanırsa, mevcut tüm SSH ortak anahtarları kaldırılır.