說明失敗的先決條件。
舉例來說,如果 RPC 失敗是因為需要確認服務條款,則 PreconditionFailure 訊息可能會列出服務條款違規事項。
| JSON 表示法 |
|---|
{
"violations": [
{
object ( |
| 欄位 | |
|---|---|
violations[] |
說明所有前提條件違規事項。 |
違規事項
用於說明單一前提條件失敗的訊息類型。
| JSON 表示法 |
|---|
{ "type": string, "subject": string, "description": string } |
| 欄位 | |
|---|---|
type |
PreconditionFailure 的類型。建議使用服務專屬的列舉型別,定義支援的前提條件違規事項主體。例如「TOS」(違反服務條款)。 |
subject |
失敗的主體 (相對於類型)。舉例來說,相對於「TOS」類型,「google.com/cloud」會指出所參照的服務條款。 |
description |
先決條件失敗的原因。開發人員可根據這項說明瞭解如何修正失敗問題。 例如「未接受服務條款」。 |