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


Certificate - Add

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
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

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.