Certificate - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

Menambahkan Sertifikat ke Akun yang ditentukan.
Peringatan: Operasi ini tidak digunakan lagi dan akan dihapus setelah Februari 2024. Silakan gunakan Ekstensi Azure KeyVault sebagai gantinya.

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

With optional parameters:

POST {batchUrl}/certificates?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.
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	Diperlukan	Jenis	Deskripsi
data	True	string	Konten Sertifikat yang dikodekan base64. Ukuran maksimum adalah 10KB.
thumbprint	True	string	Thumbprint X.509 sertifikat. Ini adalah urutan hingga 40 digit heksa (mungkin termasuk spasi tetapi ini dihapus).
thumbprintAlgorithm	True	string	Algoritma yang digunakan untuk memperoleh thumbprint. Ini harus sha1.
certificateFormat		CertificateFormat	Format data Sertifikat.
password		string	Kata sandi untuk mengakses kunci privat Sertifikat. Ini harus dihilangkan jika format Sertifikat adalah cer.

Respons

Nama	Jenis	Deskripsi
201 Created		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

Certificate add

Sample Request

HTTP

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



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

Sample Response

Status code:

201

Definisi

Nama	Deskripsi
BatchError	Respons kesalahan yang diterima dari layanan Azure Batch.
BatchErrorDetail	Item informasi tambahan yang disertakan dalam respons kesalahan Azure Batch.
CertificateAddParameter	Sertifikat yang dapat diinstal pada Simpul Komputasi dan dapat digunakan untuk mengautentikasi operasi pada komputer.
CertificateFormat	Format data Sertifikat.
ErrorMessage	Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

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.

CertificateAddParameter

Sertifikat yang dapat diinstal pada Simpul Komputasi dan dapat digunakan untuk mengautentikasi operasi pada komputer.

Nama	Jenis	Deskripsi
certificateFormat	CertificateFormat	Format data Sertifikat.
data	string	Konten Sertifikat yang dikodekan base64. Ukuran maksimum adalah 10KB.
password	string	Kata sandi untuk mengakses kunci privat Sertifikat. Ini harus dihilangkan jika format Sertifikat adalah cer.
thumbprint	string	Thumbprint X.509 sertifikat. Ini adalah urutan hingga 40 digit heksa (mungkin termasuk spasi tetapi ini dihapus).
thumbprintAlgorithm	string	Algoritma yang digunakan untuk memperoleh thumbprint. Ini harus sha1.

CertificateFormat

Format data Sertifikat.

Nama	Jenis	Deskripsi
cer	string	Sertifikat adalah Sertifikat X.509 yang dikodekan base64.
pfx	string	Sertifikat adalah rantai Sertifikat atau Sertifikat berformat PFX (PKCS#12).

ErrorMessage

Pesan kesalahan diterima dalam respons kesalahan Azure Batch.

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