本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
UpdateLedgerPermissionsMode
更新分類帳的權限模式。
重要
切換到STANDARD許可模式之前，您必須先建立所有必要的 IAM 政策和表格標記，以避免對使用者造成干擾。若要進一步了解，請參閱 Amazon QLDB 開發人員指南中的遷移至標準許可模式。
請求語法
PATCH /ledgers/name/permissions-mode HTTP/1.1
Content-type: application/json
{
"PermissionsMode": "string"
}URI 請求參數
請求會使用下列 URI 參數。
- name
-
分類帳的名稱。
長度限制：長度下限為 1。長度上限為 32。
模式：
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$必要：是
請求主體
請求接受採用 JSON 格式的下列資料。
- PermissionsMode
-
指定給分類帳的權限模式。此參數可以有下列其中一個值：
-
ALLOW_ALL：一種舊版許可模式，可使用 API 層級精細程度啟用對分類帳的存取控制。此模式允許具有指定分類帳
SendCommandAPI 許可的使用者 (因此為ALLOW_ALL)，在此分類帳中的任何資料表上執行所有 PartiQL 命令。此模式會忽略您為分類帳建立之任何資料表層級或命令層級 IAM 許可政策。 -
STANDARD：(建議) 一種許可模式，可使用更細的層級啟用對分類帳、資料表和 PartiQL 命令的存取控制。根據預設，此模式會拒絕所有使用者在此分類帳中任何資料表上執行任何 PartiQL 命令的請求。若要允許執行 PartiQL 命令，除了分類帳的
SendCommandAPI 許可之外，您還必須為特定資料表資源和 PartiQL 動作建立 IAM 許可政策。如需相關資訊，請參閱《Amazon QLDB 開發人員指南》中的開始使用標準許可模式。
注意
強烈建議您使用
STANDARD許可模式來最大化分類帳資料的安全性。類型：字串
有效值:
ALLOW_ALL | STANDARD必要：是
-
回應語法
HTTP/1.1 200
Content-type: application/json
{
"Arn": "string",
"Name": "string",
"PermissionsMode": "string"
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
服務會傳回下列 JSON 格式的資料。
- Arn
-
分類帳的 Amazon 資源名稱（ARN）。
類型：字串
長度限制︰長度下限為 20。長度上限為 1600。
- Name
-
分類帳的名稱。
類型：字串
長度限制：長度下限為 1。長度上限為 32。
模式：
(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$ - PermissionsMode
-
分類帳的目前權限模式。
類型：字串
有效值:
ALLOW_ALL | STANDARD
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- InvalidParameterException
-
請求中的一個或多個參數無效。
HTTP 狀態碼：400
- ResourceNotFoundException
-
指定的資源不存在。
HTTP 狀態碼：404
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：
