

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

# Kepemilikan hukum dan AWS Backup
<a name="legalhold"></a>

## Ikhtisar penahanan hukum
<a name="legalhold-overview"></a>

Penahanan hukum adalah alat administratif yang membantu mencegah cadangan dihapus saat berada di bawah penahanan. Saat penahanan dilakukan, pencadangan di bawah penahanan tidak dapat dihapus dan kebijakan siklus hidup yang akan mengubah status pencadangan (seperti transisi ke `Deleted` negara bagian) ditunda hingga penahanan hukum dihapus.

Penahanan hukum dapat diterapkan pada satu atau lebih cadangan (juga dikenal sebagai titik pemulihan) yang dibuat oleh AWS Backup jika siklus hidup mereka memungkinkan. Penahanan hukum tidak berlaku untuk [pencadangan berkelanjutan](https://docs.aws.amazon.com/aws-backup/latest/devguide/point-in-time-recovery.html).

Ketika penahanan hukum dibuat, ia dapat mempertimbangkan kriteria penyaringan tertentu, seperti jenis sumber daya dan sumber daya IDs. Selain itu, Anda dapat menentukan rentang tanggal pembuatan cadangan yang ingin Anda sertakan dalam penangguhan hukum. 

Penahanan hukum hanya berlaku untuk cadangan asli tempat mereka ditempatkan. Ketika cadangan disalin di seluruh Wilayah atau akun (jika sumber daya mendukungnya), cadangan tersebut tidak mempertahankan atau membawa pegangan hukumnya. Penangguhan hukum, seperti sumber daya lainnya, memiliki ARN (Nama Sumber Daya Amazon) unik yang terkait dengannya. Hanya poin pemulihan yang dibuat oleh yang AWS Backup dapat menjadi bagian dari penahanan hukum.

Perhatikan bahwa meskipun [AWS Backup Vault Lock](https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html) memberikan perlindungan tambahan dan kekekalan ke brankas, penangguhan hukum memberikan perlindungan tambahan terhadap penghapusan cadangan individu (titik pemulihan). Penahanan hukum tidak kedaluwarsa dan menyimpan data dalam cadangan tanpa batas waktu. Penahanan tetap aktif sampai dirilis oleh pengguna dengan izin yang memadai.

## Beberapa pegangan hukum
<a name="legalhold-multiple"></a>

Cadangan dapat memiliki lebih dari satu pegangan hukum. Penahanan dan pencadangan hukum memiliki banyak: banyak hubungan, yang berarti bahwa cadangan dapat memiliki lebih dari sekadar penahanan hukum dan penahanan hukum dapat mencakup lebih dari satu cadangan.

Cadangan tidak dapat dihapus selama memiliki setidaknya satu pegangan hukum. Setelah semua penahanan hukum pada cadangan dihapus, itu tunduk pada properti siklus hidup retensi. Pertahankan setidaknya satu penahanan hukum untuk mencegah penghapusan cadangan. Penahanan hukum dapat diterapkan pada titik pemulihan yang dipertahankan setelah tanggal retensi siklus hidup cadangannya (karena penahanan hukum yang ada).

Setiap akun dapat memiliki maksimal 50 penahanan hukum yang aktif pada satu waktu.

## Buat pegangan hukum
<a name="legalhold-creation"></a>

Penahanan hukum dapat ditambahkan ke cadangan yang ada (titik pemulihan). 

 Cadangan (poin pemulihan) dengan status `EXPIRED` atau tidak `DELETING` akan dimasukkan dalam penahanan hukum. Poin pemulihan (cadangan) dengan status `CREATING` mungkin tidak termasuk dalam penangguhan hukum, tergantung pada waktu penyelesaian.

Penahanan hukum dapat ditambahkan oleh pengguna yang memiliki izin IAM yang diperlukan.

### Buat penahanan hukum menggunakan konsol
<a name="legalhold-console"></a>

**Untuk membuat pegangan hukum**

1. Buka AWS Backup konsol di [https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup).

1. Di dasbor di sebelah kiri konsol, temukan Akun Saya. Pilih **pegangan Legal**.

1. Pilih **Tambahkan penahanan hukum**.

1. Tiga panel ditampilkan: **Detail penahanan hukum**, **Ruang lingkup penahanan hukum**, dan **tag penahanan hukum**.

   1. Di bawah **rincian penahanan hukum**, masukkan judul penahanan hukum dan deskripsi untuk penahanan di kotak teks yang disediakan.

   1. Di panel **Lingkup penahanan hukum**, pilih bagaimana Anda ingin memilih sumber daya yang akan disertakan dalam penahanan. Saat Anda membuat penahanan, Anda memilih metode yang digunakan untuk memilih sumber daya yang berada dalam penahanan hukum. Anda dapat memilih untuk memasukkan salah satu dari berikut ini:
      + Jenis sumber daya tertentu dan IDs
      + Pilih brankas cadangan
      + Semua jenis sumber daya atau semua brankas cadangan dalam akun Anda

   1. Tentukan rentang tanggal penangguhan hukum Anda. Masukkan tanggal dalam format TTTT:BB:HH (tanggal dianggap termasuk dalam rentang).

   1. Secara opsional, Anda dapat menambahkan tag untuk penahanan di bawah **tag penahanan hukum**. Tag dapat membantu mengkategorikan penahanan untuk referensi dan organisasi masa depan. Anda dapat menambahkan hingga 50 tag total.

1. Ketika Anda puas dengan konfigurasi penahanan hukum baru Anda, klik tombol **Tambahkan penahanan baru**.

### Buat penahanan hukum menggunakan AWS CLI
<a name="create-legalhold-api"></a>

Anda dapat membuat penahanan hukum menggunakan [create-legal-hold](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/create-legal-hold.html)perintah.

```
aws backup create-legal-hold --title "{{my title}}" \
    --description "{{my description}}" \
    --recovery-point-selection "VaultNames={{string}},DateRange={FromDate={{timestamp}},ToDate={{timestamp}}}"
```

## Lihat pegangan hukum
<a name="legalhold-view"></a>

Anda dapat melihat detail penahanan hukum di AWS Backup konsol atau secara terprogram.

### Lihat penahanan hukum menggunakan konsol
<a name="legalhold-view-console"></a>

Untuk melihat semua penahanan hukum dalam akun menggunakan konsol Backup,

1. Buka AWS Backup konsol di [https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup).

1. Menggunakan bagian kiri dasbor, di bawah **Akun saya**, klik Penahanan **hukum**.

1. Tabel **penahanan hukum** menampilkan judul, status, deskripsi, ID, dan tanggal pembuatan penahanan yang ada. Klik pada karat (panah bawah) di sebelah header tabel untuk memfilter tabel dengan kolom yang dipilih.

### Lihat pegangan hukum secara terprogram
<a name="legalhold-view-api"></a>

Untuk melihat semua penahanan hukum secara terprogram, Anda dapat menggunakan panggilan API berikut: [ListLegalHolds](API_ListLegalHolds.md)dan. [GetLegalHold](API_GetLegalHold.md)

Template JSON berikut dapat digunakan untuk`GetLegalHold`.

```
GET /legal-holds/{legalHoldId} HTTP/1.1

Request

empty body

Response

{
    Title: string,
    Status: LegalHoldStatus, 
    Description: string, // 280 chars max
    CancelDescription: string, // this is provided during cancel // 280 chars max
    LegalHoldId: string,
    LegalHoldArn: string,
    CreatedTime: number,
    CanceledTime: number,
    
   ResourceSelection: {
        VaultArns: [ string ]
        Resources: [ string ]
   }, 
   ResourceFilters: {
        DateRange: {
          FromDate: number,
          ToDate: number
        }
   }
}
```

Template JSON berikut dapat digunakan untuk`ListLegalHolds`.

```
GET /legal-holds/
  &maxResults=MaxResults
  &nextToken=NextToken


Request

empty body
url params: 
  MaxResults: number  // optional,
  NextToken: string  // optional

status: Valid values: CREATING | ACTIVE | CANCELED | CANCELING
maxResults: 1-1000



Response

{
  NextToken: token,
  LegalHolds: [
    Title: string,
    Status: string, 
    Description: string, // 280 chars max
    CancelDescription: string, // this is provided during cancel // 280 chars max
    LegalHoldId: string,
    LegalHoldArn: string,
    CreatedTime: number,
    CanceledTime: number,
  ]

}
```

Berikut ini adalah nilai status yang mungkin.


| Status | Deskripsi | 
| --- | --- | 
| CREATING | Poin pemulihan yang diminta sedang dalam proses ditahan, dan menghapus permintaan dari titik pemulihan tersebut mungkin berhasil karena penahanan belum selesai dibuat. | 
| AKTIF | Penahanan hukum telah dibuat, Semua poin pemulihan yang tercantum dalam penangguhan hukum ini diadakan. | 
| MEMBATALKAN | Penahanan hukum sedang dalam proses dihapus, dan menghapus permintaan poin pemulihan di bawah penahanan mungkin berhasil. | 
| MEMBATALKAN | Penahanan hukum sepenuhnya dilepaskan dan tidak lagi berpengaruh. Poin pemulihan dapat dihapus. | 

## Lihat poin pemulihan dalam penahanan hukum
<a name="legalhold-view-rps"></a>

Anda dapat melihat poin pemulihan dalam penahanan hukum di AWS Backup konsol atau secara terprogram.

### Lihat poin pemulihan dalam penangguhan hukum menggunakan konsol
<a name="legalhold-view-rps-console"></a>

1. Buka AWS Backup konsol di [https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup).

1. Menggunakan bagian kiri dasbor, di bawah **Akun saya**, klik Penahanan **hukum**.

1. Pilih penahanan hukum, lalu Anda dapat melihat **detail penahanan hukum**, **Sumber daya yang dipilih untuk penahanan ini**, **poin Pemulihan yang ditahan**, dan **Tag** untuk penahanan ini.

### Lihat poin pemulihan dalam pegangan hukum secara terprogram
<a name="legalhold-view-rps-api"></a>

Untuk melihat titik pemulihan dalam penangguhan hukum secara terprogram, Anda dapat menggunakan panggilan [ListRecoveryPointsByLegalHold](API_ListRecoveryPointsByLegalHold.md)API.

Berikut ini adalah contoh permintaan dan tanggapan untuk`ListRecoveryPointsByLegalHold`.

```
GET /legal-holds/{legalHoldId}/recovery-points HTTP/1.1

Request

empty body

Response

{
  "RecoveryPoints": [
    {
      "RecoveryPointArn": "string",
      "ResourceArn": "string",
      "ResourceType": "string",
      "BackupVaultName": "string"
    }
  ],
  "NextToken": "string"
}
```

## Lepaskan pegangan hukum
<a name="legalhold-release"></a>

Penahanan hukum tetap berlaku sampai dihapus oleh pengguna dengan izin yang memadai. Menghapus penahanan hukum juga dikenal sebagai membatalkan, menghapus, atau melepaskan penahanan hukum. Menghapus penahanan hukum menghilangkannya dari semua cadangan yang dilampirkan. Setiap cadangan yang kedaluwarsa selama penangguhan hukum akan dihapus dalam waktu 24 jam setelah penangguhan hukum dihapus.

### Lepaskan penahanan hukum menggunakan konsol
<a name="release-legalhold-console"></a>

**Untuk melepaskan penahanan menggunakan konsol**

1. Buka AWS Backup konsol di [https://console.aws.amazon.com/backup](https://console.aws.amazon.com/backup).

1. Masukkan deskripsi yang ingin Anda kaitkan dengan rilis.

1. Tinjau detailnya, lalu klik **Lepaskan penahanan**.

1. Saat kotak dialog Lepaskan penahanan muncul, konfirmasikan alasan Anda melepaskan penahanan legal dengan mengetik `confirm` ke dalam kotak teksnya. 

   1. Centang kotak yang menyatakan bahwa Anda membatalkan penahanan. 

Pada halaman **penahanan hukum** Anda dapat melihat semua pegangan Anda. Jika rilis berhasil, status penahanan itu akan ditampilkan sebagai`Released`.

### Lepaskan penahanan hukum secara terprogram
<a name="release-legalhold-api"></a>

Untuk menghapus penahanan secara terprogram, gunakan panggilan API. [CancelLegalHold](API_CancelLegalHold.md)

Gunakan template JSON berikut.

```
DELETE /legal-holds/{legalHoldId}


Request

{
   CancelDescription: String
   DeleteAfterDays: number // optional
}


DeleteAfterDays: optional. 
  Defaults to 180 days. how long to keep legal hold record after canceled.
  This applies to the actual legal hold record only.
  Recovery points are unlocked as soon as cancelation processes and are not subject to this date.

Response 

Empty body

200 if successful
other standard codes
```