Certificate - List
Felsorolja a megadott fiókhoz hozzáadott összes tanúsítványt.
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.
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
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
batch
|
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. |
$filter
|
query |
string |
OData $filter záradék. A szűrő felépítésével kapcsolatos további információkért lásd: https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-certificates. |
|
$select
|
query |
string |
OData $select záradék. |
|
maxresults
|
query |
integer int32 |
A válaszban visszaadandó elemek maximális száma. Legfeljebb 1000 tanúsítvány adható vissza. |
|
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. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A tanúsítványok listáját tartalmazó válasz. Fejlécek
|
|
Other Status Codes |
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 list
Mintakérelem
GET account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0
Mintaválasz
{
"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"
}
]
}
}
]
}
Definíciók
Name | Description |
---|---|
Batch |
Az Azure Batch szolgáltatástól kapott hibaválasz. |
Batch |
Az Azure Batch-hibaválaszban szereplő további információk egy eleme. |
Certificate |
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. |
Certificate |
A tanúsítványok fiókban való listázásának eredménye. |
Certificate |
A tanúsítvány állapota. |
Delete |
Hiba történt a Batch szolgáltatásban a tanúsítvány törlésekor. |
Error |
Hibaüzenet érkezett egy Azure Batch-hibaválaszban. |
Name |
Név-érték párokat jelöl. |
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 |
A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
|
values |
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. |
Certificate
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 |
---|---|---|
deleteCertificateError |
A tanúsítvány utolsó törlési kísérlete során bekövetkezett hiba. |
|
previousState |
A tanúsítvány előző állapota. |
|
previousStateTransitionTime |
string |
A tanúsítvány korábbi állapotának megadásának időpontja. |
publicData |
string |
A tanúsítvány nyilvános része base-64 kódolású .cer fájlként. |
state |
A tanúsítvány aktuális állapota. |
|
stateTransitionTime |
string |
A tanúsítvány aktuális állapotának megadásának időpontja. |
thumbprint |
string |
A tanúsítvány X.509 ujjlenyomata. Ez legfeljebb 40 hexa számjegyből álló sorozat. |
thumbprintAlgorithm |
string |
Az ujjlenyomat származtatásához használt algoritmus. |
url |
string |
A tanúsítvány URL-címe. |
CertificateListResult
A tanúsítványok fiókban való listázásának eredménye.
Name | Típus | Description |
---|---|---|
odata.nextLink |
string |
A következő találatkészlet lekéréséhez tartozó URL-cím. |
value |
A tanúsítványok listája. |
CertificateState
A tanúsítvány állapota.
Name | Típus | Description |
---|---|---|
active |
string |
A tanúsítvány a készletekben használható. |
deletefailed |
string |
A felhasználó kérte a tanúsítvány törlését, de vannak olyan készletek, amelyek továbbra is hivatkoznak a tanúsítványra, vagy egy vagy több csomóponton még telepítve van. (Ez utóbbi akkor fordulhat elő, ha a tanúsítványt eltávolították a készletből, de a számítási csomópont még nem újraindult. A számítási csomópontok csak újraindításkor frissítik a tanúsítványaikat.) A törlés visszavonásához használhatja a Tanúsítvány törlése műveletet, vagy a törlés újrapróbálkozásához a Tanúsítvány törlése műveletet. |
deleting |
string |
A felhasználó kérte a tanúsítvány törlését, de a törlési művelet még nem fejeződött be. Előfordulhat, hogy a készletek létrehozásakor vagy frissítésekor nem hivatkozik a tanúsítványra. |
DeleteCertificateError
Hiba történt a Batch szolgáltatásban a tanúsítvány törlésekor.
Name | Típus | Description |
---|---|---|
code |
string |
A tanúsítvány törlési hibájának azonosítója. A kódok invariánsak, és programozott módon használhatók. |
message |
string |
A tanúsítványtörlési hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre. |
values |
A tanúsítványtörléssel kapcsolatos további hibaadatok listája. |
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. |
NameValuePair
Név-érték párokat jelöl.
Name | Típus | Description |
---|---|---|
name |
string |
A név-érték pár neve. |
value |
string |
A név-érték párban lévő érték. |