Certificate - Delete

Referenz

Dienst:: Batch Service

API-Version:: 2023-11-01.18.0

Löscht ein Zertifikat aus dem angegebenen Konto.
Sie können ein Zertifikat nicht löschen, wenn es von einer Ressource (Pool oder Computeknoten) verwendet wird. Bevor Sie ein Zertifikat löschen können, müssen Sie daher sicherstellen, dass das Zertifikat keinem vorhandenen Pool zugeordnet ist, das Zertifikat nicht auf Knoten installiert ist (selbst wenn Sie ein Zertifikat aus einem Pool entfernen, wird es nicht aus vorhandenen Computeknoten in diesem Pool entfernt, bis sie neu gestartet werden), und keine ausgeführten Aufgaben hängen vom Zertifikat ab. Wenn Sie versuchen, ein verwendetes Zertifikat zu löschen, tritt beim Löschen ein Fehler auf. Das Zertifikat status Änderungen in deleteFailed. Sie können Zertifikat abbrechen verwenden, um die status wieder auf aktiv festzulegen, wenn Sie das Zertifikat weiterhin verwenden möchten.

Warnung: Dieser Vorgang ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .

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

Mit optionalen Parametern:

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
batchUrl	path	True	string	Die Basis-URL für alle Azure Batch-Dienstanforderungen.
thumbprint	path	True	string	Der Fingerabdruck des zu löschenden Zertifikats.
thumbprintAlgorithm	path	True	string	Der Algorithmus, der zum Ableiten des Fingerabdruckparameters verwendet wird. Dies muss sha1 sein.
api-version	query	True	string	Client-API-Version.
timeout	query		integer int32	Die maximale Zeit, die der Server für die Verarbeitung der Anforderung in Sekunden aufwenden kann. Der Standardwert ist 30 Sekunden.

Anforderungsheader

Media Types: "application/json; odata=minimalmetadata"

Name	Typ	Beschreibung
client-request-id	string uuid	Die vom Aufrufer generierte Anforderungsidentität in Form einer GUID ohne Dekoration wie geschweifte Klammern, z. B. 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Gibt an, ob der Server die client-request-ID in der Antwort zurückgeben soll.
ocp-date	string date-time-rfc1123	Der Zeitpunkt, zu dem die Anforderung ausgestellt wurde. Clientbibliotheken legen dies in der Regel auf die aktuelle Systemuhrzeit fest. legen Sie sie explizit fest, wenn Sie die REST-API direkt aufrufen.

Antworten

Name	Typ	Beschreibung
202 Accepted		Die Anforderung an den Batch-Dienst war erfolgreich. Header client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Der Fehler vom Batch-Dienst.

Name

Typ

Beschreibung

202 Accepted

Die Anforderung an den Batch-Dienst war erfolgreich.

Header

client-request-id: string
request-id: string
ETag: string
Last-Modified: string

Other Status Codes

BatchError

Der Fehler vom Batch-Dienst.

Sicherheit

azure_auth

Microsoft Entra OAuth 2.0-Authentifizierungscodeflow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel Ihres Benutzerkontos

Authorization

Typ: apiKey
In: header

Beispiele