Certificate - Get

Reference

Služba:: Batch Service

Verze rozhraní API:: 2023-11-01.18.0

Získá informace o zadaném certifikátu.
Upozornění: Tato operace je zastaralá a po únoru 2024 se odebere. Místo toho použijte rozšíření Azure KeyVault .

GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?api-version=2023-11-01.18.0

S volitelnými parametry:

GET {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?$select={$select}&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.
thumbprint	path	True	string	Kryptografický otisk certifikátu, který chcete získat.
thumbprintAlgorithm	path	True	string	Algoritmus použitý k odvození parametru kryptografického otisku To musí být sha1.
api-version	query	True	string	Verze klientského rozhraní API.
$select	query		string	Klauzule $select OData.
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	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ě.

Odpovědi

Name	Typ	Description
200 OK	Certificate	Odpověď obsahující certifikát. Hlavičky client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Chyba ze služby Batch.

Name

Typ

Description

200 OK

Certificate

Odpověď obsahující certifikát.

Hlavičky

client-request-id: string
request-id: string
ETag: string
Last-Modified: 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

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Authorization

Typ: apiKey
V: header

Příklady

Certificate get

Ukázkový požadavek

HTTP

GET account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)?api-version=2023-11-01.18.0

Ukázková odpověď

Stavový kód:: 200

{
  "thumbprint": "0123456789abcdef0123456789abcdef01234567",
  "thumbprintAlgorithm": "sha1",
  "url": "https://account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)",
  "state": "deletefailed",
  "stateTransitionTime": "2014-07-31T21:12:58.236Z",
  "previousState": "deleting",
  "previousStateTransitionTime": "2014-07-31T21:11:58.236Z",
  "publicData": "#####...",
  "deleteCertificateError": {
    "code": "PoolsReferencingCertificate",
    "message": "The specified certificate is being used by the below mentioned pool(s)",
    "values": [
      {
        "name": "Pools",
        "value": "mypool1"
      }
    ]
  }
}

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.
Certificate	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.
CertificateState	Stav certifikátu.
DeleteCertificateError	Při odstraňování certifikátu došlo ve službě Batch k chybě.
ErrorMessage	Chybová zpráva přijatá v Azure Batch odpověď na chybu.
NameValuePair	Představuje dvojici název-hodnota.

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.

Certificate

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
deleteCertificateError	DeleteCertificateError	Chyba, ke které došlo při posledním pokusu o odstranění tohoto certifikátu. Tato vlastnost je nastavena pouze v případě, že je certifikát ve stavu DeleteFailed.
previousState	CertificateState	Předchozí stav certifikátu. Tato vlastnost není nastavena, pokud je certifikát v počátečním aktivním stavu.
previousStateTransitionTime	string	Čas, kdy certifikát vstoupil do předchozího stavu. Tato vlastnost není nastavena, pokud je certifikát v počátečním stavu Aktivní.
publicData	string	Veřejná část certifikátu jako soubor s kódováním base-64 .cer.
state	CertificateState	Aktuální stav certifikátu.
stateTransitionTime	string	Čas, kdy certifikát vstoupil do aktuálního stavu.
thumbprint	string	Kryptografický otisk X.509 certifikátu. Jedná se o posloupnost až 40 šestnáctkových číslic.
thumbprintAlgorithm	string	Algoritmus použitý k odvození kryptografického otisku.
url	string	Adresa URL certifikátu.

CertificateState

Stav certifikátu.

Name	Typ	Description
active	string	Certifikát je k dispozici pro použití ve fondech.
deletefailed	string	Uživatel požádal o odstranění certifikátu, ale existují fondy, které stále obsahují odkazy na certifikát, nebo je stále nainstalovaný na jednom nebo více uzlech. (K druhému může dojít, pokud byl certifikát odebrán z fondu, ale výpočetní uzel se ještě nerestartoval. Výpočetní uzly aktualizují své certifikáty pouze při restartování.) Můžete použít operaci zrušení odstranění certifikátu ke zrušení odstranění nebo operaci odstranění certifikátu a zkusit odstranění znovu.
deleting	string	Uživatel požádal o odstranění certifikátu, ale operace odstranění ještě nebyla dokončena. Při vytváření nebo aktualizaci fondů nesmíte na certifikát odkazovat.

DeleteCertificateError

Při odstraňování certifikátu došlo ve službě Batch k chybě.

Name	Typ	Description
code	string	Identifikátor chyby odstranění certifikátu. Kódy jsou invariantní a mají být využívány programově.
message	string	Zpráva popisující chybu odstranění certifikátu, která má být vhodná pro zobrazení v uživatelském rozhraní.
values	NameValuePair[]	Seznam dalších podrobností o chybách souvisejících s chybou odstranění certifikátu Tento seznam obsahuje podrobnosti, jako jsou aktivní fondy a výpočetní uzly odkazující na tento certifikát. Pokud ale na certifikát odkazuje velký počet prostředků, seznam obsahuje pouze asi první stovku.

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.

NameValuePair

Představuje dvojici název-hodnota.

Name	Typ	Description
name	string	Název ve dvojici název-hodnota.
value	string	Hodnota ve dvojici název-hodnota.

Sdílet prostřednictvím

Certificate - Get

Parametry identifikátoru URI

Hlavička požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Authorization

Příklady

Certificate get

Ukázkový požadavek

Ukázková odpověď

Definice

BatchError

BatchErrorDetail

Certificate

CertificateState

DeleteCertificateError

ErrorMessage

NameValuePair

Další materiály