Sintaks Permintaan URIParameter Permintaan Isi Permintaan Sintaksis Respons Elemen Respons Kesalahan Contoh Lihat Juga

CreateFileSystem

Membuat sistem file baru yang kosong. Operasi ini memerlukan token pembuatan dalam permintaan yang EFS digunakan Amazon 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 EFS ditetapkan Amazon, 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 token pembuatan yang dibuat UUID secara acak.

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 EFS Pengguna Amazon.

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 EFS kinerja Amazon.

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

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

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:CreateFileSystem.

Sistem file dapat ditandai pada pembuatan. Jika tag ditentukan dalam tindakan pembuatan, IAM lakukan 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.

Sintaks Permintaan


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"
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

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 jenis sistem EFS file di Panduan EFS Pengguna Amazon.

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 EFSPanduan Pengguna Amazon.

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

String hingga 64 ASCII karakter. 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 AWS Key Management Service kunci (kunci) KMS yang ada. Jika Anda tidak menentukan KMS kunci, maka KMS kunci default untuk AmazonEFS,/aws/elasticfilesystem, digunakan untuk melindungi sistem file terenkripsi.

Tipe: Boolean

Wajib: Tidak

KmsKeyId

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

ID kunci - Pengidentifikasi unik dari kunci, misalnya 1234abcd-12ab-34cd-56ef-1234567890ab.
ARN- Nama Sumber Daya Amazon (ARN) untuk kunci, misalnyaarn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab.
Alias kunci - Nama tampilan yang dibuat sebelumnya untuk kunci, misalnya alias/projectKey1.
Alias kunci ARN - Sebuah ARN untuk alias kunci, misalnya. arn:aws:kms:us-west-2:444455556666:alias/projectKey1

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

penting

EFShanya menerima kunci simetrisKMS. Anda tidak dapat menggunakan KMS kunci asimetris dengan sistem EFS file Amazon.

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 EFSKuota Amazon yang dapat Anda tingkatkan di Panduan EFS Pengguna Amazon.

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 respons HTTP 201.

Data berikut dikembalikan dalam JSON format oleh layanan.

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 EFS penyimpanan di Panduan EFS Pengguna Amazon.

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

Amazon Resource Name (ARN) untuk sistem EFS file, dalam formatarn: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 AmazonEFS.

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.

LifeCycleState

Fase siklus hidup dari sistem file.

Jenis: String

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 EFS Pengguna Amazon.

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.

HTTPKode Status: 400

FileSystemAlreadyExists

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

HTTPKode Status: 409

FileSystemLimitExceeded

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

HTTPKode Status: 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.

HTTPKode Status: 503

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

HTTPKode Status: 500

ThroughputLimitExceeded

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

HTTPKode Status: 400

UnsupportedAvailabilityZone

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

HTTPKode Status: 400

Contoh

Buat sistem file terenkripsi EFS

Contoh berikut mengirimkan POST permintaan 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 EFS file terenkripsi dengan ketersediaan One Zone

Contoh berikut mengirimkan POST permintaan 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 ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini:

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

CreateAccessPoint

CreateMountTarget