Certificate - List
Zobrazí seznam všech certifikátů, které byly přidány do zadaného účtu.
Upozornění: Tato operace je zastaralá a bude odebrána po únoru 2024. Místo toho použijte
GET {batchUrl}/certificates?api-version=2024-07-01.20.0
GET {batchUrl}/certificates?$filter={$filter}&$select={$select}&maxresults={maxresults}&timeout={timeout}&api-version=2024-07-01.20.0
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Základní adresa URL pro všechny požadavky služby Azure Batch. |
api-version
|
query | True |
string |
Verze rozhraní API klienta. |
$filter
|
query |
string |
Klauzule $filter OData. Další informace o vytváření tohoto filtru naleznete v tématu https://docs.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-certificates. |
|
$select
|
query |
string |
Klauzule $select OData. |
|
maxresults
|
query |
integer int32 |
Maximální počet položek, které se mají vrátit v odpovědi. Může se vrátit maximálně 1000 certifikátů. |
|
timeout
|
query |
integer int32 |
Maximální doba, po kterou může server strávit zpracováním požadavku v sekundách. Výchozí hodnota je 30 sekund. Pokud je hodnota větší než 30, použije se výchozí hodnota. |
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 dekorace, jako jsou složené závorky, například 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Určuje, jestli má server v odpovědi vrátit ID požadavku klienta. |
|
ocp-date |
string date-time-rfc1123 |
Čas vydání žádosti. Klientské knihovny obvykle nastavily aktuální systémový čas; explicitně ji nastavte, pokud voláte přímo rozhraní REST API. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Odpověď obsahující seznam certifikátů. Hlavičky
|
|
Other Status Codes |
Chyba ze služby Batch. |
Zabezpečení
azure_auth
Tok ověřovacího kódu Microsoft Entra 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 list
Ukázkový požadavek
GET account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0
Ukázková odpověď
{
"value": [
{
"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 |
---|---|
Batch |
Odpověď na chybu přijatá ze služby Azure Batch |
Batch |
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch |
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. |
Certificate |
Výsledek výpisu certifikátů v účtu. |
Certificate |
Stav certifikátu. |
Delete |
Při odstraňování certifikátu došlo u služby Batch k chybě. |
Error |
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva. |
Name |
Představuje dvojici název-hodnota. |
BatchError
Odpověď na chybu přijatá ze služby Azure Batch
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby. Kódy jsou invariantní a mají být využity programově. |
message |
Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní. |
|
values |
Kolekce párů klíč-hodnota obsahující další podrobnosti o chybě. |
BatchErrorDetail
Položka dalších informací zahrnutých v odpovědi na chybu služby Azure Batch
Name | Typ | Description |
---|---|---|
key |
string |
Identifikátor určující význam vlastnosti Value. |
value |
string |
Další informace zahrnuté v 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.
Name | Typ | Description |
---|---|---|
deleteCertificateError |
Chyba, ke které došlo při posledním pokusu o odstranění tohoto certifikátu. |
|
previousState |
Předchozí stav certifikátu. |
|
previousStateTransitionTime |
string |
Čas, kdy certifikát vstoupil do předchozího stavu. |
publicData |
string |
Veřejná část certifikátu jako soubor s kódováním base-64 .cer. |
state |
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. |
CertificateListResult
Výsledek výpisu certifikátů v účtu.
Name | Typ | Description |
---|---|---|
odata.nextLink |
string |
Adresa URL pro získání další sady výsledků. |
value |
Seznam certifikátů. |
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 stále existují fondy s odkazy na certifikát nebo je stále nainstalovaný na jednom nebo několika uzlech. (K tomu 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í.) Operaci zrušení odstranění certifikátu můžete použít k zrušení odstranění nebo operaci odstranění certifikátu k opakování odstranění. |
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ů nemusí odkazovat na certifikát. |
DeleteCertificateError
Při odstraňování certifikátu došlo u služby Batch k chybě.
Name | Typ | Description |
---|---|---|
code |
string |
Identifikátor chyby odstranění certifikátu. Kódy jsou invariantní a mají být využity 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 |
Seznam dalších podrobností o chybě souvisejících s chybou odstranění certifikátu |
ErrorMessage
V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.
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 v páru name-value. |
value |
string |
Hodnota v páru name-value. |