PreconditionFailure

說明失敗的先決條件。

舉例來說,如果 RPC 失敗是因為需要確認服務條款,則 PreconditionFailure 訊息可能會列出服務條款違規事項。

JSON 表示法
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
欄位
violations[]

object (Violation)

說明所有前提條件違規事項。

違規事項

用於說明單一前提條件失敗的訊息類型。

JSON 表示法
{
  "type": string,
  "subject": string,
  "description": string
}
欄位
type

string

PreconditionFailure 的類型。建議使用服務專屬的列舉型別,定義支援的前提條件違規事項主體。例如「TOS」(違反服務條款)。

subject

string

失敗的主體 (相對於類型)。舉例來說,相對於「TOS」類型,「google.com/cloud」會指出所參照的服務條款。

description

string

先決條件失敗的原因。開發人員可根據這項說明瞭解如何修正失敗問題。

例如「未接受服務條款」。