Certificate - Add

Service:

Batch Service

API Version:

2023-11-01.18.0

Tanúsítvány hozzáadása a megadott fiókhoz.
Figyelmeztetés: Ez a művelet elavult, és 2024 februárja után törlődik. Használja inkább az Azure KeyVault bővítményt .

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
batchUrl	path	True	string	Az összes Azure Batch szolgáltatáskérés alap URL-címe.
api-version	query	True	string	Ügyfél API-verziója.
timeout	query		integer int32	A kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 mp.

Kérelem fejléce

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

Name	Kötelező	Típus	Description
client-request-id		string uuid	A hívó által generált kérési identitás guid formában, díszítés nélkül, például kapcsos zárójelek, például 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id		boolean	Azt jelzi, hogy a kiszolgálónak vissza kell-e adnia az ügyfél-kérelem azonosítóját a válaszban.
ocp-date		string date-time-rfc1123	A kérelem kiállításának időpontja. Az ügyfélkódtárak ezt általában az aktuális rendszeróra-időpontra állítják be; állítsa be explicit módon, ha a REST API-t közvetlenül hívja meg.

Kérelem törzse

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

Name	Kötelező	Típus	Description
data	True	string	A tanúsítvány base64 kódolású tartalma. A maximális méret 10 KB.
thumbprint	True	string	A tanúsítvány X.509 ujjlenyomata. Ez egy legfeljebb 40 hexa számjegyből álló sorozat (szóközöket tartalmazhat, de ezek törlődnek).
thumbprintAlgorithm	True	string	Az ujjlenyomat származtatásához használt algoritmus. Ennek sha1-nek kell lennie.
certificateFormat		CertificateFormat	A tanúsítványadatok formátuma.
password		string	A tanúsítvány titkos kulcsának eléréséhez szükséges jelszó. Ezt ki kell hagyni, ha a tanúsítvány formátuma cer.

Válaszok

Name	Típus	Description
201 Created		A Batch szolgáltatásnak küldött kérés sikeres volt. Headers client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	A Batch szolgáltatás hibája.

Biztonság

azure_auth

Microsoft Entra OAuth 2.0 hitelesítési kódfolyamata

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	A felhasználói fiók megszemélyesítése

Authorization

Type: apiKey
In: header

Példák

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

Definíciók

Name	Description
BatchError	A Azure Batch szolgáltatástól kapott hibaválasz.
BatchErrorDetail	A Azure Batch hibaválaszban szereplő további információk egy eleme.
CertificateAddParameter	A számítási csomópontokra telepíthető tanúsítvány, amely a gépen végzett műveletek hitelesítésére használható.
CertificateFormat	A tanúsítványadatok formátuma.
ErrorMessage	Hibaüzenet érkezett egy Azure Batch hibaválaszban.

BatchError

A Azure Batch szolgáltatástól kapott hibaválasz.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
message	ErrorMessage	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
values	BatchErrorDetail[]	Kulcs-érték párok gyűjteménye, amely további részleteket tartalmaz a hibáról.

BatchErrorDetail

A Azure Batch hibaválaszban szereplő további információk egy eleme.

Name	Típus	Description
key	string	Az Érték tulajdonság jelentését meghatározó azonosító.
value	string	A hibaválaszban szereplő további információk.

CertificateAddParameter

A számítási csomópontokra telepíthető tanúsítvány, amely a gépen végzett műveletek hitelesítésére használható.

Name	Típus	Description
certificateFormat	CertificateFormat	A tanúsítványadatok formátuma.
data	string	A tanúsítvány base64 kódolású tartalma. A maximális méret 10 KB.
password	string	A tanúsítvány titkos kulcsának eléréséhez szükséges jelszó. Ezt ki kell hagyni, ha a tanúsítvány formátuma cer.
thumbprint	string	A tanúsítvány X.509 ujjlenyomata. Ez egy legfeljebb 40 hexa számjegyből álló sorozat (szóközöket tartalmazhat, de ezek törlődnek).
thumbprintAlgorithm	string	Az ujjlenyomat származtatásához használt algoritmus. Ennek sha1-nek kell lennie.

CertificateFormat

A tanúsítványadatok formátuma.

Name	Típus	Description
cer	string	A tanúsítvány egy base64 kódolású X.509-tanúsítvány.
pfx	string	A tanúsítvány PFX (PKCS#12) formátumú tanúsítvány vagy tanúsítványlánc.

ErrorMessage

Hibaüzenet érkezett egy Azure Batch hibaválaszban.

Name	Típus	Description
lang	string	A hibaüzenet nyelvkódja
value	string	Az üzenet szövege.