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

CreateAccessPoint

Menciptakan titik EFS akses. Titik akses adalah tampilan khusus aplikasi ke dalam sistem EFS file yang menerapkan pengguna dan grup sistem operasi, dan jalur sistem file, ke permintaan sistem file apa pun yang dibuat melalui titik akses. Pengguna dan grup sistem operasi mengesampingkan informasi identitas apa pun yang diberikan oleh NFS klien. Jalur sistem file dipaparkan sebagai direktori root titik akses. Aplikasi yang menggunakan titik akses hanya dapat mengakses data di direktori aplikasi sendiri dan subdirektori apa pun. Untuk mempelajari lebih lanjut, lihat Memasang sistem file menggunakan titik EFS akses.

catatan

Jika beberapa permintaan untuk membuat titik akses pada sistem file yang sama dikirim secara berurutan, dan sistem file mendekati batas 1.000 titik akses, Anda mungkin mengalami respons pelambatan untuk permintaan ini. Ini untuk memastikan bahwa sistem file tidak melebihi batas titik akses yang dinyatakan.

Operasi ini memerlukan izin utuk tindakan elasticfilesystem:CreateAccessPoint.

Titik akses 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/access-points HTTP/1.1
Content-type: application/json

{
   "ClientToken": "string",
   "FileSystemId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

ClientToken

Serangkaian hingga 64 ASCII karakter yang EFS digunakan Amazon untuk memastikan pembuatan idempoten.

Jenis: String

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

Pola: .+

Wajib: Ya

FileSystemId

ID dari sistem EFS file yang menyediakan akses ke titik akses.

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

Wajib: Ya

PosixUser

Pengguna dan grup sistem operasi diterapkan ke semua permintaan sistem file yang dibuat menggunakan titik akses.

Tipe: Objek PosixUser

Wajib: Tidak

RootDirectory

Menentukan direktori pada sistem EFS file yang diekspos oleh titik akses sebagai direktori root sistem file Anda ke NFS klien menggunakan titik akses. Klien yang menggunakan jalur akses hanya dapat mengakses direktori root dan di bawahnya. Jika RootDirectory > yang Path ditentukan tidak ada, EFS Amazon membuatnya dan menerapkan CreationInfo pengaturan saat klien terhubung ke titik akses. Saat menentukan aRootDirectory, Anda harus memberikanPath, dan. CreationInfo

Amazon EFS membuat direktori root hanya jika Anda telah menyediakan CreationInfo: OwnUid, MilikGID, dan izin untuk direktori. Jika Anda tidak memberikan informasi ini, Amazon EFS tidak membuat direktori root. Jika direktori root tidak ada, upaya untuk memasang menggunakan titik akses akan gagal.

Tipe: Objek RootDirectory

Wajib: Tidak

Tags

Membuat tag yang terkait dengan titik akses. Setiap tag adalah pasangan kunci-nilai, setiap kunci harus unik. Untuk informasi selengkapnya, lihat Menandai AWS sumber daya di Panduan Referensi AWS Umum.

Tipe: Array objek Tag

Wajib: Tidak

Sintaksis Respons


HTTP/1.1 200
Content-type: application/json

{
   "AccessPointArn": "string",
   "AccessPointId": "string",
   "ClientToken": "string",
   "FileSystemId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "OwnerId": "string",
   "PosixUser": { 
      "Gid": number,
      "SecondaryGids": [ number ],
      "Uid": number
   },
   "RootDirectory": { 
      "CreationInfo": { 
         "OwnerGid": number,
         "OwnerUid": number,
         "Permissions": "string"
      },
      "Path": "string"
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

AccessPointArn

Nama Sumber Daya Amazon (ARN) unik yang terkait dengan titik akses.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

Pola: ^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

ID titik akses, yang ditetapkan oleh AmazonEFS.

Jenis: String

Batasan Panjang: Panjang maksimum 128.

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

ClientToken

String buram ditentukan dalam permintaan untuk memastikan pembuatan yang idempotensi.

Jenis: String

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

Pola: .+

FileSystemId

ID sistem EFS file tempat titik akses berlaku.

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

LifeCycleState

Mengidentifikasi fase siklus hidup dari titik akses.

Jenis: String

Name

Nama titik akses. Ini adalah nilai Name tag.

Jenis: String

OwnerId

Mengidentifikasi Akun AWS yang memiliki sumber daya titik akses.

Jenis: String

Kendala Panjang: Panjang maksimum 14.

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

PosixUser

POSIXIdentitas lengkap, termasuk ID pengguna, ID grup, dan grup sekunder IDs pada titik akses yang digunakan untuk semua operasi file oleh NFS klien menggunakan titik akses.

Tipe: Objek PosixUser

RootDirectory

Direktori pada sistem EFS file yang diekspos oleh titik akses sebagai direktori root ke NFS klien menggunakan titik akses.

Tipe: Objek RootDirectory

Tags

Tag yang terkait dengan titik akses, disajikan sebagai array objek Tag.

Tipe: Array objek Tag

Kesalahan

AccessPointAlreadyExists

Dikembalikan jika titik akses yang Anda coba buat sudah ada, dengan token pembuatan yang Anda berikan dalam permintaan.

HTTPKode Status: 409

AccessPointLimitExceeded

Dikembalikan jika Akun AWS telah menciptakan jumlah maksimum titik akses yang diizinkan per sistem file. Untuk informasi lebih lanjut, lihat. https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region

HTTPKode Status: 403

BadRequest

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

HTTPKode Status: 400

FileSystemNotFound

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

HTTPKode Status: 404

IncorrectFileSystemLifeCycleState

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

HTTPKode Status: 409

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

HTTPKode Status: 500

ThrottlingException

Dikembalikan ketika CreateAccessPoint API tindakan dipanggil terlalu cepat dan jumlah Titik Akses pada sistem file mendekati batas 120.

HTTPKode Status: 429

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

Tindakan

CreateFileSystem