CreateFileSystem

Membuat sistem file baru yang kosong. Operasi ini memerlukan token pembuatan dalam permintaan yang digunakan Amazon EFS untuk memastikan pembuatan idempoten (memanggil operasi dengan token pembuatan yang sama tidak berpengaruh). Jika sistem file saat ini tidak ada yang dimiliki oleh pemanggil Akun AWS dengan token pembuatan yang ditentukan, operasi ini melakukan hal berikut:

• Membuat sistem file baru yang kosong. Sistem file akan memiliki ID yang ditetapkan Amazon EFS, dan status siklus hidup awal. creating

• Kembali dengan deskripsi sistem file yang dibuat.

Jika tidak, operasi ini mengembalikan FileSystemAlreadyExists kesalahan dengan ID dari sistem file yang ada.

catatan

Untuk kasus penggunaan dasar, Anda dapat menggunakan UUID yang dibuat secara acak untuk token pembuatan.

Operasi idempoten memungkinkan Anda untuk mencoba lagi CreateFileSystem panggilan tanpa risiko membuat sistem file tambahan. Ini bisa terjadi ketika panggilan awal gagal dengan cara yang membuatnya tidak pasti apakah sistem file benar-benar dibuat atau tidak. Contohnya mungkin batas waktu tingkat transport terjadi atau koneksi Anda disetel ulang. Selama Anda menggunakan token pembuatan yang sama, jika panggilan awal berhasil membuat sistem file, klien dapat mengetahui keberadaannya dari FileSystemAlreadyExists kesalahan.

Untuk informasi selengkapnya, lihat Membuat sistem file di Panduan Pengguna Amazon EFS.

catatan

CreateFileSystemPanggilan kembali saat status siklus hidup sistem file masih. creating Anda dapat memeriksa status pembuatan sistem file dengan memanggil DescribeFileSystems operasi, yang antara lain mengembalikan status sistem file.

Operasi ini menerima PerformanceMode parameter opsional yang Anda pilih untuk sistem file Anda. Kami merekomendasikan generalPurpose PerformanceMode untuk semua sistem file. maxIOMode ini adalah tipe kinerja generasi sebelumnya yang dirancang untuk beban kerja yang sangat paralel yang dapat mentolerir latensi yang lebih tinggi daripada mode. generalPurpose MaxIOmode tidak didukung untuk sistem file One Zone atau sistem file yang menggunakan throughput Elastis.

Tidak PerformanceMode dapat diubah setelah sistem file dibuat. Untuk informasi selengkapnya, lihat mode kinerja Amazon EFS.

Anda dapat mengatur mode throughput untuk sistem file menggunakan ThroughputMode parameter.

Setelah sistem file dibuat sepenuhnya, Amazon EFS menetapkan status siklus hidupnyaavailable, di mana Anda dapat membuat satu atau beberapa target mount untuk sistem file di VPC Anda. Untuk informasi selengkapnya, lihat CreateMountTarget. Anda memasang sistem file Amazon EFS pada instans EC2 di VPC Anda dengan menggunakan target pemasangan. Untuk informasi selengkapnya, lihat Amazon EFS: Cara Kerjanya.

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:CreateFileSystem.

Sistem file dapat ditandai pada pembuatan. Jika tag ditentukan dalam tindakan pembuatan, IAM melakukan otorisasi tambahan pada elasticfilesystem:TagResource tindakan untuk memverifikasi apakah pengguna memiliki izin untuk membuat tag. Oleh karena itu, Anda harus memberikan izin eksplisit untuk menggunakan tindakan. elasticfilesystem:TagResource Untuk informasi selengkapnya, lihat Memberikan izin untuk menandai sumber daya selama pembuatan.

Minta Sintaks

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

{
   "AvailabilityZoneName": "string",
   "Backup": boolean,
   "CreationToken": "string",
   "Encrypted": boolean,
   "KmsKeyId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

AvailabilityZoneName

Untuk sistem file One Zone, tentukan AWS Availability Zone untuk membuat sistem file. Gunakan format us-east-1a untuk menetapkan Availability Zone. Untuk informasi selengkapnya tentang sistem file One Zone, lihat tipe sistem file EFS di Panduan Pengguna Amazon EFS.

catatan

Sistem file One Zone tidak tersedia di semua Availability Zone di Wilayah AWS mana Amazon EFS tersedia.

Jenis: String

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

Pola: .+

Wajib: Tidak

Backup

Menentukan apakah backup otomatis diaktifkan pada sistem file yang Anda buat. Tetapkan nilainya true untuk mengaktifkan pencadangan otomatis. Jika Anda membuat sistem file One Zone, backup otomatis diaktifkan secara default. Untuk informasi selengkapnya, lihat Pencadangan otomatis di Panduan Pengguna Amazon EFS.

Default-nya adalah false. Namun, jika Anda menentukanAvailabilityZoneName, defaultnya adalahtrue.

catatan

AWS Backup tidak tersedia di semua Wilayah AWS tempat Amazon EFS tersedia.

Tipe: Boolean

Wajib: Tidak

CreationToken

Sebuah string hingga 64 karakter ASCII. Amazon EFS menggunakan ini untuk memastikan kreasi idempoten.

Jenis: String

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

Pola: .+

Wajib: Ya

Encrypted

Nilai Boolean yang, jika BETUL, menciptakan sistem file terenkripsi. Saat membuat sistem file terenkripsi, Anda memiliki opsi untuk menentukan kunci yang ada ( AWS Key Management Service kunci KMS). Jika Anda tidak menentukan kunci KMS, maka kunci KMS default untuk Amazon EFS,/aws/elasticfilesystem, digunakan untuk melindungi sistem file terenkripsi.

Tipe: Boolean

Wajib: Tidak

KmsKeyId

ID kunci KMS yang ingin Anda gunakan untuk melindungi sistem file terenkripsi. Parameter ini diperlukan hanya jika Anda ingin menggunakan kunci KMS non-default. Jika parameter ini tidak ditentukan, kunci KMS default untuk Amazon EFS digunakan. Anda dapat menentukan ID kunci KMS menggunakan format berikut:

• ID kunci - Pengidentifikasi unik dari kunci, misalnya 1234abcd-12ab-34cd-56ef-1234567890ab.

• ARN - Amazon Resource Name (ARN) untuk kunci, misalnya arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.

• Alias kunci - Nama tampilan yang dibuat sebelumnya untuk kunci, misalnya alias/projectKey1.

• ARN alias kunci - ARN untuk alias kunci, misalnya arn:aws:kms:us-west-2:444455556666:alias/projectKey1.

Jika Anda menggunakanKmsKeyId, Anda harus mengatur parameter CreateFileSystem:Encrypted ke true.

penting

EFS hanya menerima kunci KMS simetris. Anda tidak dapat menggunakan kunci KMS asimetris dengan sistem file Amazon EFS.

Jenis: String

Batasan Panjang: Panjang maksimum 2048.

Pola: ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

Wajib: Tidak

PerformanceMode

Mode performa sistem file. Kami merekomendasikan mode generalPurpose kinerja untuk semua sistem file. Sistem file yang menggunakan mode performa maxIO dapat menskalakan ke tingkat throughput dan operasi agregat per detik yang lebih tinggi dengan kompromi latensi yang sedikit lebih tinggi untuk sebagian besar operasi file. Mode performa tidak dapat diubah setelah sistem file dibuat. maxIOMode ini tidak didukung pada sistem file One Zone.

penting

Karena latensi per operasi yang lebih tinggi dengan Max I/O, sebaiknya gunakan mode kinerja Tujuan Umum untuk semua sistem file.

Default-nya adalah generalPurpose.

Jenis: String

Nilai yang Valid: generalPurpose | maxIO

Wajib: Tidak

ProvisionedThroughputInMibps

Throughput, diukur dalam mebibytes per detik (MiBps), yang ingin Anda sediakan untuk sistem file yang Anda buat. Harus diisi jika ThroughputMode diatur ke provisioned. Nilai yang valid adalah 1-3414 MiBps, dengan batas atas tergantung pada Wilayah. Untuk meningkatkan batas ini, hubungi AWS Support. Untuk informasi selengkapnya, lihat Kuota Amazon EFS yang dapat Anda tingkatkan di Panduan Pengguna Amazon EFS.

Tipe: Ganda

Rentang Valid: Nilai minimum 1.0.

Wajib: Tidak

Tags

Gunakan untuk membuat satu tanda atau lebih yang terkait dengan sistem file. Setiap tanda adalah pasangan nilai-kunci yang ditentukan pengguna. Nama sistem file Anda pada pembuatan dengan menyertakan "Key":"Name","Value":"{value}" pasangan nilai-kunci. Setiap kunci harus unik. Untuk informasi selengkapnya, lihat Menandai AWS sumber daya di Panduan Referensi AWS Umum.

Tipe: Array objek Tag

Wajib: Tidak

ThroughputMode

Menentukan modus throughput untuk sistem file. Modenya bisabursting,provisioned, atauelastic. Jika Anda mengatur ThroughputMode ke provisioned, Anda juga haru mengatur nilai ProvisionedThroughputInMibps. Setelah Anda membuat sistem file, Anda dapat mengurangi throughput Provisioned sistem file Anda atau mengubah antara mode throughput, dengan batasan waktu tertentu. Untuk informasi selengkapnya, lihat Menentukan throughput dengan mode yang disediakan di Panduan Pengguna Amazon EFS.

Default-nya adalah bursting.

Jenis: String

Nilai yang Valid: bursting | provisioned | elastic

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 201
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respon HTTP 201.

Layanan mengembalikan data berikut dalam format JSON.

AvailabilityZoneId

Pengidentifikasi unik dan konsisten dari Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Misalnya, use1-az1 adalah ID Availability Zone untuk Wilayah AWS us-east-1, dan memiliki lokasi yang sama di setiap. Akun AWS

Jenis: String

AvailabilityZoneName

Menjelaskan AWS Availability Zone di mana sistem file berada, dan hanya berlaku untuk sistem file One Zone. Untuk informasi selengkapnya, lihat Menggunakan kelas penyimpanan EFS di Panduan Pengguna Amazon EFS.

Jenis: String

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

Pola: .+

CreationTime

Waktu sistem file dibuat, dalam hitungan detik (sejak 1970-01-01T 00:00:00 Z).

Tipe: Timestamp

CreationToken

String buram ditentukan dalam permintaan.

Jenis: String

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

Pola: .+

Encrypted

Nilai Boolean yang, jika benar, menunjukkan bahwa sistem file dienkripsi.

Jenis: Boolean

FileSystemArn

Nama Sumber Daya Amazon (ARN) untuk sistem file EFS, dalam format. arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id Contoh dengan data sampel: arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567

Jenis: String

FileSystemId

ID sistem file, yang ditetapkan oleh Amazon EFS.

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})$

FileSystemProtection

Menjelaskan perlindungan pada sistem file.

Tipe: Objek FileSystemProtectionDescription

KmsKeyId

ID yang AWS KMS key digunakan untuk melindungi sistem file terenkripsi.

Jenis: String

Batasan Panjang: Panjang maksimum 2048.

Pola: ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

LifeCycleState

Fase siklus hidup dari sistem file.

Jenis: String

Nilai yang Valid: creating | available | updating | deleting | deleted | error

Name

Anda dapat menambahkan tag ke sistem file, termasuk Name tag. Untuk informasi selengkapnya, lihat CreateFileSystem. Jika sistem file memiliki Name tag, Amazon EFS mengembalikan nilai di bidang ini.

Jenis: String

Batasan Panjang: Panjang maksimum 256.

Pola: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

Jumlah target mount saat ini yang dimiliki sistem file. Untuk informasi selengkapnya, lihat CreateMountTarget.

Tipe: Bilangan Bulat

Rentang yang Valid: Nilai minimum 0.

OwnerId

Akun AWS Yang menciptakan sistem file.

Jenis: String

Kendala Panjang: Panjang maksimum 14.

Pola: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

Mode performa sistem file.

Jenis: String

Nilai yang Valid: generalPurpose | maxIO

ProvisionedThroughputInMibps

Jumlah throughput yang disediakan, diukur dalam MiBps, untuk sistem file. Berlaku untuk sistem file menggunakan ThroughputMode set toprovisioned.

Tipe: Ganda

Rentang Valid: Nilai minimum 1.0.

SizeInBytes

Ukuran terukur terbaru yang diketahui (dalam byte) data yang disimpan dalam sistem file, di Value bidangnya, dan waktu di mana ukuran itu ditentukan di bidangnyaTimestamp. TimestampNilainya adalah bilangan bulat detik sejak 1970-01-01T 00:00:00 Z. SizeInBytesNilai tidak mewakili ukuran snapshot yang konsisten dari sistem file, tetapi pada akhirnya konsisten ketika tidak ada penulisan ke sistem file. Artinya, SizeInBytes mewakili ukuran sebenarnya hanya jika sistem file tidak dimodifikasi untuk jangka waktu lebih dari beberapa jam. Jika tidak, nilainya bukan ukuran yang tepat dari sistem file pada setiap titik waktu.

Tipe: Objek FileSystemSize

Tags

Tag yang terkait dengan sistem file, disajikan sebagai array Tag objek.

Tipe: Array objek Tag

ThroughputMode

Menampilkan mode throughput sistem file. Untuk informasi selengkapnya, lihat Mode throughput di Panduan Pengguna Amazon EFS.

Jenis: String

Nilai yang Valid: bursting | provisioned | elastic

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

FileSystemAlreadyExists

Dikembalikan jika sistem file yang Anda coba buat sudah ada, dengan token pembuatan yang Anda berikan.

Kode Status HTTP: 409

FileSystemLimitExceeded

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

Kode Status HTTP: 403

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

Kembali jika terjadi kesalahan di sisi server.

Kode Status HTTP: 500

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

Contoh

Buat sistem file EFS terenkripsi

Contoh berikut mengirimkan permintaan POST untuk membuat sistem file di us-west-2 Wilayah dengan backup otomatis diaktifkan. Permintaan ditentukan myFileSystem1 sebagai token penciptaan untuk idempotensi.

Permintaan Sampel

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem1",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "Encrypted": true,
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

Contoh Respons

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

Buat sistem file EFS terenkripsi dengan ketersediaan One Zone

Contoh berikut mengirimkan permintaan POST untuk membuat sistem file di us-west-2 Wilayah dengan backup otomatis diaktifkan. Sistem file akan memiliki penyimpanan One Zone di us-west-2b Availability Zone.

Permintaan Sampel

POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42

{
  "CreationToken" : "myFileSystem2",
  "PerformanceMode" : "generalPurpose",
  "Backup": true,
  "AvailabilityZoneName": "us-west-2b",
  "Encrypted": true,
  "ThroughputMode": "elastic",
  "Tags":[
      {
         "Key": "Name",
         "Value": "Test Group1"
      }
   ]
}

Contoh Respons

HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319

{
   "ownerId":"251839141158",
   "CreationToken":"myFileSystem1",
   "Encrypted": true,
   "AvailabilityZoneId": "usew2-az2", 
   "AvailabilityZoneName": "us-west-2b",
   "PerformanceMode" : "generalPurpose",
   "fileSystemId":"fs-01234567",
   "CreationTime":"1403301078",
   "LifeCycleState":"creating",
   "numberOfMountTargets":0,
   "SizeInBytes":{
       "Timestamp": 1403301078,
       "Value": 29313618372,
       "ValueInArchive": 201156,
       "ValueInIA": 675432,
       "ValueInStandard": 29312741784
   },
   "Tags":[
      {
        "Key": "Name",
        "Value": "Test Group1"
      }
   ],
   "ThroughputMode": "elastic"
}

Lihat Juga

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

• AWS Antarmuka Baris Perintah

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK untuk V3 JavaScript

• AWS SDK for PHP V3

• AWS SDK untuk Python

• AWS SDK for Ruby V3