CreateReplicationConfiguration

Membuat konfigurasi replikasi yang mereplikasi sistem file EFS yang ada ke sistem file read-only yang baru. Untuk informasi selengkapnya, lihat replikasi Amazon EFS di Panduan Pengguna Amazon EFS. Konfigurasi replikasi menentukan hal berikut:

• Sistem file sumber — Sistem file EFS yang ingin Anda replikasi. Sistem file sumber tidak dapat menjadi sistem file tujuan dalam konfigurasi replikasi yang ada.

• Wilayah AWS— Wilayah AWS Di mana sistem file tujuan dibuat. Replikasi Amazon EFS tersedia Wilayah AWS di semua tempat EFS tersedia. Wilayah harus diaktifkan. Untuk informasi selengkapnya, lihat Mengelola Wilayah AWS dalam Panduan Referensi Referensi AWS Umum.

• Konfigurasi sistem file tujuan — Konfigurasi sistem file tujuan tempat sistem file sumber akan direplikasi. Hanya ada satu sistem file tujuan dalam konfigurasi replikasi.

  Parameter untuk konfigurasi replikasi meliputi:

  • File system ID — ID dari sistem file tujuan untuk replikasi. Jika tidak ada ID yang disediakan, maka EFS membuat sistem file baru dengan pengaturan default. Untuk sistem file yang ada, perlindungan penimpaan replikasi sistem file harus dinonaktifkan. Untuk informasi selengkapnya, lihat Mereplikasi ke sistem file yang ada.

  • Availability Zone - Jika Anda ingin sistem file tujuan menggunakan penyimpanan One Zone, Anda harus menentukan Availability Zone untuk membuat sistem file di. Untuk informasi selengkapnya, lihat jenis sistem file EFS di Panduan Pengguna Amazon EFS.

  • Enkripsi — Semua sistem file tujuan dibuat dengan enkripsi saat istirahat diaktifkan. Anda dapat menentukan AWS Key Management Service (AWS KMS) kunci yang digunakan untuk mengenkripsi sistem file tujuan. Jika Anda tidak menentukan kunci KMS, kunci KMS yang dikelola layanan untuk Amazon EFS akan digunakan.

    catatan

    Setelah sistem file dibuat, Anda tidak dapat mengubah kunci KMS.

Untuk sistem file tujuan baru, properti berikut ditetapkan secara default:

• Mode kinerja - Mode kinerja sistem file tujuan cocok dengan sistem file sumber, kecuali sistem file tujuan menggunakan penyimpanan EFS One Zone. Dalam hal ini, mode kinerja Tujuan Umum digunakan. Mode kinerja tidak dapat diubah.

• Mode throughput - Mode throughput sistem file tujuan cocok dengan sistem file sumber. Setelah sistem file dibuat, Anda dapat memodifikasi mode throughput.

• manajemen siklus hidup - manajemen siklus hidup tidak diaktifkan pada sistem file tujuan. Setelah sistem file tujuan dibuat, Anda dapat mengaktifkan manajemen siklus hidup.

• Pencadangan otomatis — Pencadangan harian otomatis diaktifkan pada sistem file tujuan. Setelah sistem file dibuat, Anda dapat mengubah pengaturan ini.

Untuk informasi selengkapnya, lihat replikasi Amazon EFS di Panduan Pengguna Amazon EFS.

Minta Sintaks

POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json

{
   "Destinations": [ 
      { 
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "KmsKeyId": "string",
         "Region": "string"
      }
   ]
}

Parameter Permintaan URI

Permintaan menggunakan parameter URI berikut.

SourceFileSystemId

Menentukan sistem file Amazon EFS yang ingin Anda replikasi. Sistem file ini belum dapat menjadi sumber atau sistem file tujuan dalam konfigurasi replikasi lain.

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

Destinations

Sebuah array objek konfigurasi tujuan. Hanya satu objek konfigurasi tujuan yang didukung.

Tipe: Array objek DestinationToCreate

Diperlukan: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "Destinations": [ 
      { 
         "FileSystemId": "string",
         "LastReplicatedTimestamp": number,
         "Region": "string",
         "Status": "string"
      }
   ],
   "OriginalSourceFileSystemArn": "string",
   "SourceFileSystemArn": "string",
   "SourceFileSystemId": "string",
   "SourceFileSystemRegion": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

CreationTime

Menjelaskan kapan konfigurasi replikasi dibuat.

Tipe: Timestamp

Destinations

Sebuah array objek tujuan. Hanya satu objek tujuan yang didukung.

Tipe: Array objek Destination

OriginalSourceFileSystemArn

Nama Sumber Daya Amazon (ARN) dari sistem file EFS sumber asli dalam konfigurasi replikasi.

Jenis: String

SourceFileSystemArn

Nama Sumber Daya Amazon (ARN) dari sistem file sumber saat ini dalam konfigurasi replikasi.

Jenis: String

SourceFileSystemId

ID dari sistem file Amazon EFS sumber yang sedang direplikasi.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

SourceFileSystemRegion

Wilayah AWSDi mana sistem file EFS sumber berada.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum adalah 64.

Pola: ^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$

Kesalahan

BadRequest

Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.

Kode Status HTTP: 400

ConflictException

Dikembalikan jika sistem file sumber dalam replikasi dienkripsi tetapi sistem file tujuan tidak dienkripsi.

Kode Status HTTP: 409

FileSystemLimitExceeded

Dikembalikan jika Akun AWS telah membuat jumlah maksimum sistem file yang diizinkan per akun.

Kode Status HTTP: 403

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

Kode Status HTTP: 404

IncorrectFileSystemLifeCycleState

Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.

Kode Status HTTP: 409

InsufficientThroughputCapacity

Dikembalikan jika tidak ada kapasitas yang cukup untuk menyediakan throughput tambahan. Nilai ini mungkin dikembalikan saat Anda mencoba membuat sistem file dalam mode throughput yang disediakan, saat Anda mencoba meningkatkan throughput yang disediakan dari sistem file yang ada, atau saat Anda mencoba mengubah sistem file yang ada dari Bursting Throughput ke mode Throughput Terprovsioned. Coba lagi nanti.

Kode Status HTTP: 503

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

ReplicationNotFound

Dikembalikan jika sistem file yang ditentukan tidak memiliki konfigurasi replikasi.

Kode Status HTTP: 404

ThroughputLimitExceeded

Dikembalikan jika mode throughput atau jumlah throughput yang disediakan tidak dapat diubah karena batas throughput 1024 MiB/s telah tercapai.

Kode Status HTTP: 400

UnsupportedAvailabilityZone

Dikembalikan jika fungsionalitas Amazon EFS yang diminta tidak tersedia di Availability Zone yang ditentukan.

Kode Status HTTP: 400

ValidationException

Dikembalikan jika AWS Backup layanan tidak tersedia Wilayah AWS di mana permintaan dibuat.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu AWS SDK khusus bahasa, lihat berikut ini:

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go.

• AWSSDK for Java V2

• AWSSDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK for Python

• AWS SDK for Ruby V3