Certificate - Add

Hizmet:

Batch Service

API Sürümü:

2023-11-01.18.0

Belirtilen Hesaba bir Sertifika ekler.
Uyarı: Bu işlem kullanım dışı bırakıldı ve Şubat 2024'den sonra kaldırılacak. Lütfen bunun yerine Azure KeyVault Uzantısını kullanın.

POST {batchUrl}/certificates?api-version=2023-11-01.18.0

İsteğe bağlı parametrelerle:

POST {batchUrl}/certificates?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.
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 tarafından oluşturulan istek kimliği, küme ayraçları gibi dekorasyonu olmayan 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 saatine 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	Gerekli	Tür	Description
data	True	string	Sertifikanın base64 ile kodlanmış içeriği. En büyük boyut 10 KB'tır.
thumbprint	True	string	Sertifikanın X.509 parmak izi. Bu, en fazla 40 onaltılık basamak dizisidir (boşluk içerebilir ama bunlar kaldırılır).
thumbprintAlgorithm	True	string	Parmak izini türetmek için kullanılan algoritma. Bu sha1 olmalı.
certificateFormat		CertificateFormat	Sertifika verilerinin biçimi.
password		string	Sertifikanın özel anahtarına erişmek için parola. Sertifika biçimi cer ise bu atlanmalıdır.

Yanıtlar

Name	Tür	Description
201 Created		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

Certificate add

Örnek isteği

HTTP

POST account.region.batch.azure.com/certificates?api-version=2023-11-01.18.0



{
  "thumbprintAlgorithm": "sha1",
  "thumbprint": "0123456789abcdef0123456789abcdef01234567",
  "data": "#####...",
  "certificateFormat": "pfx",
  "password": "<ExamplePassword>"
}

Örnek yanıt

Durum kodu:

201

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.
CertificateAddParameter	İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.
CertificateFormat	Sertifika verilerinin biçimi.
ErrorMessage	Azure Batch hata yanıtında bir hata iletisi alındı.

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.

CertificateAddParameter

İşlem Düğümlerine yüklenebilen ve makinedeki işlemlerin kimliğini doğrulamak için kullanılabilen bir Sertifika.

Name	Tür	Description
certificateFormat	CertificateFormat	Sertifika verilerinin biçimi.
data	string	Sertifikanın base64 ile kodlanmış içeriği. En büyük boyut 10 KB'tır.
password	string	Sertifikanın özel anahtarına erişmek için parola. Sertifika biçimi cer ise bu atlanmalıdır.
thumbprint	string	Sertifikanın X.509 parmak izi. Bu, en fazla 40 onaltılık basamak dizisidir (boşluk içerebilir ama bunlar kaldırılır).
thumbprintAlgorithm	string	Parmak izini türetmek için kullanılan algoritma. Bu sha1 olmalı.

CertificateFormat

Sertifika verilerinin biçimi.

Name	Tür	Description
cer	string	Sertifika, base64 kodlu bir X.509 Sertifikasıdır.
pfx	string	Sertifika, PFX (PKCS#12) biçimli bir Sertifika veya Sertifika zinciridir.

ErrorMessage

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

Name	Tür	Description
lang	string	Hata iletisinin dil kodu
value	string	İletinin metni.