Share via

Certificate - Add

  • Reference
Service:
Batch Service
API Version:
2023-11-01.18.0

Přidá certifikát do zadaného účtu.
Upozornění: Tato operace je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
batchUrl
 path True

string

Základní adresa URL pro všechny požadavky služby Azure Batch.
api-version
 query True

string

Verze klientského rozhraní API.
timeout
 query

integer

int32

Maximální čas, který může server strávit zpracováním požadavku, v sekundách. Výchozí hodnota je 30 sekund.

Hlavička požadavku

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

Name Vyžadováno Typ Description
client-request-id

string

uuid

Identita požadavku vygenerovaná volajícím ve formě identifikátoru GUID bez ozdob, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Jestli má server v odpovědi vrátit client-request-id.
ocp-date

string

date-time-rfc1123

Čas, kdy byla žádost vystavena. Klientské knihovny obvykle tuto možnost nastaví na aktuální systémový čas. pokud přímo voláte rozhraní REST API, nastavte ho explicitně.

Text požadavku

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

Name Vyžadováno Typ Description
data True

string

Obsah certifikátu kódovaný jako base64. Maximální velikost je 10 kB.
thumbprint True

string

Kryptografický otisk X.509 certifikátu. Jedná se o posloupnost až 40 šestnáctkových číslic (může obsahovat mezery, ale ty se odeberou).
thumbprintAlgorithm True

string

Algoritmus použitý k odvození kryptografického otisku. To musí být sha1.
certificateFormat

CertificateFormat

Formát dat certifikátu.
password

string

Heslo pro přístup k privátnímu klíči certifikátu.
Toto je nutné vynechat, pokud je formát certifikátu cer.

Odpovědi

Name Typ Description
201 Created

Požadavek na službu Batch byl úspěšný.

Headers

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • DataServiceId: string
Other Status Codes

BatchError

Chyba ze služby Batch.

Zabezpečení

azure_auth

Microsoft Entra tok kódu ověřování OAuth 2.0

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

Scopes

Name Description
user_impersonation Zosobnění uživatelského účtu

Authorization

Type: apiKey
In: header

Příklady

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

Status code:
201

Definice

Name Description
BatchError

Ze služby Azure Batch byla přijata chybová odpověď.
BatchErrorDetail

Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.
CertificateAddParameter

Certifikát, který se dá nainstalovat na výpočetní uzly a dá se použít k ověřování operací na počítači.
CertificateFormat

Formát dat certifikátu.
ErrorMessage

Chybová zpráva přijatá v Azure Batch odpověď na chybu.

BatchError

Ze služby Azure Batch byla přijata chybová odpověď.

Name Typ Description
code

string

Identifikátor chyby. Kódy jsou invariantní a mají být využívány programově.
message

ErrorMessage

Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values

BatchErrorDetail[]

Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě.

BatchErrorDetail

Položka s dalšími informacemi, které jsou součástí Azure Batch odpovědi na chybu.

Name Typ Description
key

string

Identifikátor určující význam vlastnosti Value.
value

string

Další informace zahrnuté v chybové odpovědi.

CertificateAddParameter

Certifikát, který se dá nainstalovat na výpočetní uzly a dá se použít k ověřování operací na počítači.

Name Typ Description
certificateFormat

CertificateFormat

Formát dat certifikátu.
data

string

Obsah certifikátu kódovaný jako base64. Maximální velikost je 10 kB.
password

string

Heslo pro přístup k privátnímu klíči certifikátu.
Toto je nutné vynechat, pokud je formát certifikátu cer.
thumbprint

string

Kryptografický otisk X.509 certifikátu. Jedná se o posloupnost až 40 šestnáctkových číslic (může obsahovat mezery, ale ty se odeberou).
thumbprintAlgorithm

string

Algoritmus použitý k odvození kryptografického otisku. To musí být sha1.

CertificateFormat

Formát dat certifikátu.

Name Typ Description
cer

string

Certifikát je certifikát X.509 s kódováním base64.
pfx

string

Certifikát je certifikát ve formátu PFX (PKCS#12) nebo řetěz certifikátů.

ErrorMessage

Chybová zpráva přijatá v Azure Batch odpověď na chybu.

Name Typ Description
lang

string

Kód jazyka chybové zprávy
value

string

Text zprávy.