Method: folders.settings.deleteValue

Xoá một giá trị cài đặt. Nếu giá trị cài đặt không tồn tại, thì thao tác sẽ không hoạt động.

Trả về google.rpc.Status có google.rpc.Code.NOT_FOUND nếu chế độ cài đặt hoặc giá trị của chế độ cài đặt không tồn tại. Giá trị của chế độ cài đặt sẽ không tồn tại nếu một lệnh gọi trước đó đến DeleteSetting cho giá trị của chế độ cài đặt đã trả về mã thành công. Trả về google.rpc.Status có google.rpc.Code.FAILED_PRECONDITION nếu chế độ cài đặt được gắn cờ là chỉ đọc.

Yêu cầu HTTP

DELETE https://resourcesettings.googleapis.com/v1alpha1/{name=folders/*/settings/*/value}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
name

string

Tên của giá trị chế độ cài đặt cần xoá. Hãy xem SettingValue để biết các yêu cầu về việc đặt tên.

Để uỷ quyền, bạn cần có quyền IAM sau đây trên tài nguyên name được chỉ định:

  • resourcesettings.settingvalues.delete

Tham số truy vấn

Thông số
ignoreReadOnly

boolean

Một cờ cho phép xoá giá trị của chế độ cài đặt readOnly. CẢNH BÁO: bạn tự chịu rủi ro khi sử dụng. Xoá giá trị của chế độ cài đặt chỉ đọc là một thao tác không thể đảo ngược (tức là bạn không thể tạo lại).

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ trống.

Phạm vi cấp phép

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/cloud-platform

Để biết thêm thông tin, hãy xem bài viết Tổng quan về quy trình xác thực.