Aracılığıyla paylaş

Certificate - Add

  • Başvuru
Hizmet:
Batch Service
API Sürümü:
2024-07-01.20.0

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

POST {batchUrl}/certificates?api-version=2024-07-01.20.0
İsteğe bağlı parametrelerle: 
POST {batchUrl}/certificates?timeout={timeout}&api-version=2024-07-01.20.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 cinsinden). Varsayılan değer 30 saniyedir. Değer 30'dan büyükse, bunun yerine varsayılan değer kullanılır.

İstek Başlığı

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

Name Gerekli Tür Description
client-request-id

string

uuid

Arayan tarafından oluşturulan istek kimliği, küme ayraçları gibi süslemesi olmayan bir GUID biçiminde, ö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. Maksimum 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 ancak 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şme parolası.
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

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

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

POST account.region.batch.azure.com/certificates?api-version=2024-07-01.20.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 dahil edilen 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[]

Hata hakkında ek ayrıntılar içeren anahtar-değer çiftleri koleksiyonu.

BatchErrorDetail

Azure Batch hata yanıtına dahil edilen 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. Maksimum boyut 10 KB'tır.
password

string

Sertifikanın özel anahtarına erişme parolası.
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 ancak 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.