Certificate - Add
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
POST {batchUrl}/certificates?timeout={timeout}&api-version=2023-11-01.18.0
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
batch
|
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 |
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ó. |
Válaszok
Name | Típus | Description |
---|---|---|
201 Created |
A Batch szolgáltatásnak küldött kérés sikeres volt. Headers
|
|
Other Status Codes |
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
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
Definíciók
Name | Description |
---|---|
Batch |
A Azure Batch szolgáltatástól kapott hibaválasz. |
Batch |
A Azure Batch hibaválaszban szereplő további információk egy eleme. |
Certificate |
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ó. |
Certificate |
A tanúsítványadatok formátuma. |
Error |
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 |
A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
|
values |
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 |
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ó. |
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. |