QuotaFailure

Mô tả lý do kiểm tra hạn mức không thành công.

Ví dụ: nếu một dự án gọi vượt quá hạn mức hằng ngày, thì một dịch vụ có thể phản hồi bằng thông tin chi tiết QuotaFailure chứa mã dự án và nội dung mô tả về hạn mức đã vượt quá. Nếu dự án gọi chưa bật dịch vụ trong bảng điều khiển dành cho nhà phát triển, thì một dịch vụ có thể phản hồi bằng mã dự án và đặt service_disabled thành true.

Bạn cũng có thể xem các loại RetryInfo và Help để biết thêm thông tin về cách xử lý lỗi liên quan đến hạn mức.

Biểu diễn dưới dạng JSON 
{
  "violations": [
    {
      object (Violation)
    }
  ]
}
Trường
violations[]

object (Violation)

Mô tả tất cả các lỗi vi phạm hạn mức.

Vi phạm

Một loại thông báo dùng để mô tả một trường hợp vi phạm hạn mức. Ví dụ: vượt quá hạn mức hằng ngày hoặc hạn mức tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "subject": string,
  "description": string,
  "apiService": string,
  "quotaMetric": string,
  "quotaId": string,
  "quotaDimensions": {
    string: string,
    ...
  },
  "quotaValue": string,
  "futureQuotaValue": string
}
Trường
subject

string

Đối tượng mà bạn không kiểm tra được hạn mức. Ví dụ: "clientip:" hoặc "project:".
description

string

Nội dung mô tả về lý do kiểm tra hạn mức không thành công. Khách hàng có thể sử dụng nội dung mô tả này để tìm hiểu thêm về cấu hình hạn mức trong tài liệu công khai của dịch vụ hoặc tìm hạn mức liên quan để điều chỉnh thông qua bảng điều khiển dành cho nhà phát triển.

Ví dụ: "Dịch vụ bị vô hiệu hoá" hoặc "Vượt quá giới hạn hằng ngày cho các thao tác đọc".
apiService

string

Dịch vụ API mà QuotaFailure.Violation bắt nguồn. Trong một số trường hợp, vấn đề về hạn mức bắt nguồn từ một Dịch vụ API khác với dịch vụ đã được gọi. Nói cách khác, một phần phụ thuộc của Dịch vụ API được gọi có thể là nguyên nhân gây ra QuotaFailure và trường này sẽ có tên dịch vụ API phụ thuộc.

Ví dụ: nếu API được gọi là Kubernetes Engine API (container.googleapis.com) và một lỗi vi phạm hạn mức xảy ra trong chính Kubernetes Engine API, thì trường này sẽ là "container.googleapis.com". Mặt khác, nếu lỗi vi phạm hạn mức xảy ra khi Kubernetes Engine API tạo máy ảo trong Compute Engine API (compute.googleapis.com), thì trường này sẽ là "compute.googleapis.com".
quotaMetric

string

Chỉ số của hạn mức bị vi phạm. Chỉ số hạn mức là một bộ đếm có tên dùng để đo lường mức sử dụng, chẳng hạn như yêu cầu API hoặc CPU. Khi một hoạt động xảy ra trong một dịch vụ, chẳng hạn như việc phân bổ Máy ảo, một hoặc nhiều chỉ số hạn mức có thể bị ảnh hưởng.

Ví dụ: "compute.googleapis.com/cpus_per_vm_family", "storage.googleapis.com/internet_egress_bandwidth".
quotaId

string

Mã của hạn mức bị vi phạm. Còn được gọi là "tên giới hạn", đây là giá trị nhận dạng duy nhất của một hạn mức trong bối cảnh của một dịch vụ API.

Ví dụ: "CPUS-PER-VM-FAMILY-per-project-region".
quotaDimensions

map (key: string, value: string)

Các phương diện của hạn mức bị vi phạm. Mỗi hạn mức không phải là hạn mức toàn cầu đều được áp dụng cho một nhóm phương diện. Mặc dù chỉ số hạn mức xác định những gì cần tính, nhưng phương diện sẽ chỉ định những khía cạnh mà bộ đếm cần tăng.

Ví dụ: hạn mức "Số CPU trên mỗi khu vực cho mỗi họ VM" áp dụng một giới hạn cho chỉ số "compute.googleapis.com/cpus_per_vm_family" trên các phương diện "region" và "vm_family". Nếu lỗi vi phạm xảy ra ở khu vực "us-central1" và đối với nhóm máy ảo "n1", thì quotaDimensions sẽ là:

{ "region": "us-central1", "vm_family": "n1", }

Khi hạn mức được thực thi trên toàn cầu, quotaDimensions sẽ luôn trống.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
quotaValue

string (int64 format)

Giá trị hạn mức được thực thi tại thời điểm QuotaFailure.

Ví dụ: nếu giá trị hạn mức bắt buộc tại thời điểm QuotaFailure trên số lượng CPU là "10", thì giá trị của trường này sẽ phản ánh số lượng này.
futureQuotaValue

string (int64 format)

Giá trị hạn mức mới được triển khai tại thời điểm xảy ra lỗi vi phạm. Khi quá trình triển khai hoàn tất, giá trị này sẽ được thực thi thay cho quotaValue. Nếu không có quy trình triển khai nào đang diễn ra tại thời điểm vi phạm, thì trường này sẽ không được đặt.

Ví dụ: nếu tại thời điểm vi phạm, một quy trình triển khai đang diễn ra và thay đổi hạn mức số lượng CPU từ 10 thành 20, thì 20 sẽ là giá trị của trường này.