Megosztás a következőn keresztül:

Certificate - Add

  • Referencia
Szolgáltatás:
Batch Service
API-verzió:
2024-07-01.20.0

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

POST {batchUrl}/certificates?api-version=2024-07-01.20.0
Opcionális paraméterekkel: 
POST {batchUrl}/certificates?timeout={timeout}&api-version=2024-07-01.20.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 kiszolgáló által a kérés feldolgozásának maximális időtartama másodpercben. Az alapértelmezett érték 30 másodperc. Ha az érték nagyobb, mint 30, akkor a rendszer az alapértelmezett értéket használja.

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 közvetlenül a REST API-t 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 alap64 kódolású tartalma. A maximális méret 10 KB.
thumbprint True

string

A tanúsítvány X.509 ujjlenyomata. Ez legfeljebb 40 hexa számjegyből álló sorozat (szóközöket is 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.

Fejlécek

  • 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ódfolyamat

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

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

Authorization

Típus: apiKey
In: header

Példák

Certificate add

Mintakérelem

POST account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0



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

Mintaválasz

Állapotkód:
201

Definíciók

Name Description
BatchError

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

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

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

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

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

BatchError

Az 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, amelyek további részleteket tartalmaznak a hibáról.

BatchErrorDetail

Az 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álasz további információi.

CertificateAddParameter

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

Name Típus Description
certificateFormat

CertificateFormat

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

string

A tanúsítvány alap64 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 legfeljebb 40 hexa számjegyből álló sorozat (szóközöket is 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 egy 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 nyelvi kódja
value

string

Az üzenet szövege.