Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# UpdateLedgerPermissionsMode
<a name="API_UpdateLedgerPermissionsMode"></a>

Memperbarui mode izin buku besar.

**penting**  
Sebelum beralih ke mode `STANDARD` izin, Anda harus terlebih dahulu membuat semua kebijakan IAM dan tag tabel yang diperlukan untuk menghindari gangguan pada pengguna Anda. Untuk mempelajari selengkapnya, lihat [Memigrasi ke mode izin standar di Panduan Pengembang](https://docs.aws.amazon.com/qldb/latest/developerguide/ledger-management.basics.html#ledger-mgmt.basics.update-permissions.migrating) *QLDB* Amazon.

## Minta Sintaks
<a name="API_UpdateLedgerPermissionsMode_RequestSyntax"></a>

```
PATCH /ledgers/name/permissions-mode HTTP/1.1
Content-type: application/json

{
   "PermissionsMode": "string"
}
```

## Parameter Permintaan URI
<a name="API_UpdateLedgerPermissionsMode_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [name](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-uri-Name"></a>
Nama buku besar.  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 32.  
Pola: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$`   
Wajib: Ya

## Isi Permintaan
<a name="API_UpdateLedgerPermissionsMode_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_RequestSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-request-PermissionsMode"></a>
Mode izin untuk menetapkan ke buku besar. parameter ini dapat memiliki salah satu nilai berikut:  
+  `ALLOW_ALL`: Mode izin warisan yang memungkinkan kontrol akses dengan rincian tingkat API untuk buku besar.

  Mode ini memungkinkan pengguna yang memiliki izin API `SendCommand` untuk buku besar ini untuk menjalankan semua perintah PartiQL (maka, `ALLOW_ALL`) pada setiap tabel dalam buku besar yang ditentukan. Mode ini mengabaikan setiap kebijakan izin IAM tingkat tabel atau tingkat perintah yang Anda buat untuk buku besar.
+  `STANDARD`: (*Direkomendasikan*) Mode perizinan yang memungkinkan kontrol akses dengan rincian yang lebih halus untuk buku besar, tabel, dan perintah PartiQL.

  Secara default, mode ini menyangkal semua permintaan pengguna untuk menjalankan perintah PartiQL pada setiap tabel dalam buku besar ini. Untuk mengizinkan perintah PartiQL untuk berjalan, Anda harus membuat kebijakan izin IAM untuk sumber daya tabel tertentu dan tindakan PartiQL, selain izin API `SendCommand` untuk buku besar. Untuk informasi, lihat [Memulai dengan mode izin standar](https://docs.aws.amazon.com/qldb/latest/developerguide/getting-started-standard-mode.html) dalam *Panduan Developer Amazon QLDB*.
Kami sangat merekomendasikan untuk menggunakan mode izin `STANDARD` untuk memaksimalkan keamanan data buku besar Anda.
Tipe: String  
Nilai yang Valid: `ALLOW_ALL | STANDARD`   
Wajib: Ya

## Sintaksis Respons
<a name="API_UpdateLedgerPermissionsMode_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Arn": "string",
   "Name": "string",
   "PermissionsMode": "string"
}
```

## Elemen Respons
<a name="API_UpdateLedgerPermissionsMode_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [Arn](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Arn"></a>
Nama Sumber Daya Amazon (ARN) untuk buku besar.  
Tipe: String  
Batasan Panjang: Panjang minimum 20. Panjang maksimum 1600.

 ** [Name](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-Name"></a>
Nama buku besar.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 32.  
Pola: `(?!^.*--)(?!^[0-9]+$)(?!^-)(?!.*-$)^[A-Za-z0-9-]+$` 

 ** [PermissionsMode](#API_UpdateLedgerPermissionsMode_ResponseSyntax) **   <a name="qldb-UpdateLedgerPermissionsMode-response-PermissionsMode"></a>
Mode izin saat ini dari buku besar.  
Tipe: String  
Nilai yang Valid: `ALLOW_ALL | STANDARD` 

## Kesalahan
<a name="API_UpdateLedgerPermissionsMode_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** InvalidParameterException **   
Satu atau beberapa parameter dalam permintaan tidak valid.  
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Sumber daya yang ditentukan tidak ada.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_UpdateLedgerPermissionsMode_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah](https://docs.aws.amazon.com/goto/aws-cli/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/qldb-2019-01-02/UpdateLedgerPermissionsMode) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/qldb-2019-01-02/UpdateLedgerPermissionsMode)