Certificate - Delete

從指定的帳戶刪除憑證。
如果資源 (集區或計算節點) 正在使用憑證,則您無法刪除憑證。 在刪除憑證之前,您必須確定憑證未與任何現有的集區相關聯,憑證不會安裝在任何節點上 (即使您從集區移除憑證,也不會從該集區中的現有計算節點中移除,直到它們重新啟動) ,而且沒有執行中的工作相依於憑證。 如果您嘗試刪除正在使用中的憑證,刪除會失敗。 憑證狀態會變更為 deleteFailed。 如果您決定要繼續使用憑證,您可以使用 [取消刪除憑證] 將狀態設定回使用中。

警告:此作業已被取代,將在 2024 年 2 月之後移除。 請改用 Azure KeyVault 擴充功能

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

名稱 位於 必要 類型 Description
batchUrl
path True

string

所有 Azure Batch 服務要求的基底 URL。

thumbprint
path True

string

要刪除之憑證的指紋。

thumbprintAlgorithm
path True

string

用來衍生指紋參數的演算法。 這必須是sha1。

api-version
query True

string

用戶端 API 版本。

timeout
query

integer

int32

伺服器可以花費在數秒內處理要求的時間上限。 預設值為 30 秒。

要求標頭

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

名稱 必要 類型 Description
client-request-id

string

uuid

呼叫端產生的要求身分識別,格式為不含大括弧的 GUID,例如 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0。

return-client-request-id

boolean

伺服器是否應該在回應中傳回 client-request-id。

ocp-date

string

date-time-rfc1123

發出要求的時間。 用戶端連結庫通常會將此設定為目前的系統時鐘時間;如果您直接呼叫 REST API,請明確設定它。

回應

名稱 類型 Description
202 Accepted

Batch 服務的要求成功。

標題

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
Other Status Codes

BatchError

Batch 服務的錯誤。

安全性

azure_auth

Microsoft Entra OAuth 2.0 驗證碼流程

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬用戶帳戶

Authorization

類型: apiKey
位於: header

範例

Certificate delete

範例要求

DELETE account.region.batch.azure.com/certificates(thumbprintAlgorithm=sha1,thumbprint=0123456789abcdef0123456789abcdef01234567)?api-version=2023-11-01.18.0


範例回覆

定義

名稱 Description
BatchError

從 Azure Batch 服務收到的錯誤回應。

BatchErrorDetail

Azure Batch 錯誤回應中包含的其他信息專案。

ErrorMessage

在 Azure Batch 錯誤回應中收到的錯誤訊息。

BatchError

從 Azure Batch 服務收到的錯誤回應。

名稱 類型 Description
code

string

錯誤的識別碼。 程式碼不變,且要以程式設計方式使用。

message

ErrorMessage

描述錯誤的訊息,適用於在使用者介面中顯示。

values

BatchErrorDetail[]

索引鍵/值組的集合,其中包含錯誤的其他詳細數據。

BatchErrorDetail

Azure Batch 錯誤回應中包含的其他信息專案。

名稱 類型 Description
key

string

指定 Value 屬性意義的識別碼。

value

string

錯誤回應中包含的其他資訊。

ErrorMessage

在 Azure Batch 錯誤回應中收到的錯誤訊息。

名稱 類型 Description
lang

string

錯誤訊息的語言代碼

value

string

訊息的文字。