Certificate - Delete
Tar bort ett certifikat från det angivna kontot.
Du kan inte ta bort ett certifikat om en resurs (pool eller beräkningsnod) använder det. Innan du kan ta bort ett certifikat måste du därför se till att certifikatet inte är associerat med några befintliga pooler, att certifikatet inte är installerat på några noder (även om du tar bort ett certifikat från en pool tas det inte bort från befintliga beräkningsnoder i poolen förrän de startas om) och inga aktiviteter som körs beror på certifikatet. Om du försöker ta bort ett certifikat som används misslyckas borttagningen. Certifikatstatusen ändras till deleteFailed. Du kan använda Avbryt ta bort certifikat för att ange statusen aktiv igen om du bestämmer dig för att fortsätta använda certifikatet.
Varning! Den här åtgärden är inaktuell och tas bort efter februari 2024. Använd Azure KeyVault-tillägget i stället.
DELETE {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?api-version=2023-11-01.18.0
DELETE {batchUrl}/certificates(thumbprintAlgorithm={thumbprintAlgorithm},thumbprint={thumbprint})?timeout={timeout}&api-version=2023-11-01.18.0
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
batch
|
path | True |
string |
Bas-URL:en för alla Azure Batch tjänstbegäranden. |
thumbprint
|
path | True |
string |
Tumavtrycket för certifikatet som ska tas bort. |
thumbprint
|
path | True |
string |
Algoritmen som används för att härleda tumavtrycksparametern. Det här måste vara sha1. |
api-version
|
query | True |
string |
Klient-API-version. |
timeout
|
query |
integer int32 |
Den maximala tid som servern kan ägna åt att bearbeta begäran, i sekunder. Standardvärdet är 30 sekunder. |
Begärandehuvud
Media Types: "application/json; odata=minimalmetadata"
Name | Obligatorisk | Typ | Description |
---|---|---|---|
client-request-id |
string uuid |
Den anropargenererade begärandeidentiteten i form av ett GUID utan dekoration, till exempel klammerparenteser, t.ex. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Om servern ska returnera client-request-id i svaret. |
|
ocp-date |
string date-time-rfc1123 |
Den tid då begäran utfärdades. Klientbibliotek anger vanligtvis detta till systemets aktuella klocktid. ange det uttryckligen om du anropar REST-API:et direkt. |
Svar
Name | Typ | Description |
---|---|---|
202 Accepted |
Begäran till Batch-tjänsten lyckades. Sidhuvuden
|
|
Other Status Codes |
Felet från Batch-tjänsten. |
Säkerhet
azure_auth
Microsoft Entra OAuth 2.0-autentiseringskodflöde
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
Name | Description |
---|---|
user_impersonation | Personifiera ditt användarkonto |
Authorization
Typ:
apiKey
I:
header
Exempel
Certificate delete
Exempelbegäran
DELETE account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)?api-version=2023-11-01.18.0
Exempelsvar
Definitioner
Name | Description |
---|---|
Batch |
Ett felsvar som tagits emot från Azure Batch-tjänsten. |
Batch |
Ett objekt med ytterligare information som ingår i ett Azure Batch felsvar. |
Error |
Ett felmeddelande som tas emot i ett Azure Batch felsvar. |
BatchError
Ett felsvar som tagits emot från Azure Batch-tjänsten.
Name | Typ | Description |
---|---|---|
code |
string |
En identifierare för felet. Koder är invarianta och är avsedda att användas programmatiskt. |
message |
Ett meddelande som beskriver felet, avsett att vara lämpligt för visning i ett användargränssnitt. |
|
values |
En samling nyckel/värde-par som innehåller ytterligare information om felet. |
BatchErrorDetail
Ett objekt med ytterligare information som ingår i ett Azure Batch felsvar.
Name | Typ | Description |
---|---|---|
key |
string |
En identifierare som anger innebörden av egenskapen Value. |
value |
string |
Den ytterligare information som ingår i felsvaret. |
ErrorMessage
Ett felmeddelande som tas emot i ett Azure Batch felsvar.
Name | Typ | Description |
---|---|---|
lang |
string |
Språkkoden för felmeddelandet |
value |
string |
Texten i meddelandet. |