CreateAccessPoint - Sistem File Elastis Amazon
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateAccessPoint

Menciptakan titik akses EFS. Titik akses adalah tampilan khusus aplikasi ke dalam sistem file EFS yang menerapkan pengguna dan grup sistem operasi, serta jalur sistem file, untuk setiap permintaan sistem file yang dibuat melalui titik akses. Pengguna dan grup sistem operasi menimpa informasi identitas apa pun yang disediakan oleh klien NFS. 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. Sistem file dapat memiliki maksimum 10.000 titik akses kecuali Anda meminta peningkatan. Untuk mempelajari selengkapnya, lihat Memasang sistem file menggunakan titik akses EFS.

catatan

Jika beberapa permintaan untuk membuat titik akses pada sistem file yang sama dikirim secara berurutan, dan sistem file mendekati batas 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 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/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"
      }
   ]
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

ClientToken

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

Tipe: String

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

Pola: .+

Wajib: Ya

FileSystemId

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

Tipe: 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 file EFS yang diekspos oleh titik akses sebagai direktori root sistem file Anda ke klien NFS menggunakan titik akses. Klien yang menggunakan jalur akses hanya dapat mengakses direktori root dan di bawahnya. Jika RootDirectory > yang Path ditentukan tidak ada, Amazon EFS 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, ownGid, dan izin untuk direktori tersebut. 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.

Layanan mengembalikan data berikut dalam format JSON.

AccessPointArn

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

Tipe: 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 Amazon EFS.

Tipe: 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.

Tipe: String

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

Pola: .+

FileSystemId

ID dari sistem file EFS di mana titik akses berlaku.

Tipe: 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.

Tipe: String

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

Name

Nama titik akses. Ini adalah nilai Name tag.

Tipe: String

OwnerId

Mengidentifikasi Akun AWS yang memiliki sumber daya titik akses.

Tipe: String

Kendala Panjang: Panjang maksimum 14.

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

PosixUser

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

Tipe: Objek PosixUser

RootDirectory

Direktori pada sistem file EFS yang diekspos oleh titik akses sebagai direktori root ke klien NFS 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.

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 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

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 403

BadRequest

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

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 400

FileSystemNotFound

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

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 404

IncorrectFileSystemLifeCycleState

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

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 409

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 500

ThrottlingException

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

ErrorCode

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.

Message

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Kode Status HTTP: 429

Lihat Juga

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