Sdílet prostřednictvím


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 rozšíření Azure KeyVault.

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

CertificateListResult

Odpověď obsahující seznam 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

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
BatchError

Odpověď na chybu přijatá ze služby Azure Batch

BatchErrorDetail

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.

CertificateListResult

Výsledek výpisu certifikátů v účtu.

CertificateState

Stav certifikátu.

DeleteCertificateError

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

ErrorMessage

V odpovědi na chybu služby Azure Batch se zobrazila chybová zpráva.

NameValuePair

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

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

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 certifikát je 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 aktivním stavu.

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.

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

Certificate[]

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

NameValuePair[]

Seznam dalších podrobností o chybě 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 však na certifikát odkazuje velký počet prostředků, seznam obsahuje pouze asi první stovka.

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.