CreateServer

Mode fokus

CreateServer - AWS Transfer Family

Sintaksis Permintaan Parameter Permintaan Sintaksis Respons Elemen Respons Kesalahan Contoh Lihat Juga

Membuat instance server virtual auto-scaling berdasarkan protokol transfer file yang dipilih di. AWS Saat Anda melakukan pembaruan ke server berkemampuan protokol transfer file atau saat Anda bekerja dengan pengguna, gunakan ServerId properti yang dihasilkan layanan yang ditetapkan ke server yang baru dibuat.

Sintaksis Permintaan


{
   "Certificate": "string",
   "Domain": "string",
   "EndpointDetails": { 
      "AddressAllocationIds": [ "string" ],
      "SecurityGroupIds": [ "string" ],
      "SubnetIds": [ "string" ],
      "VpcEndpointId": "string",
      "VpcId": "string"
   },
   "EndpointType": "string",
   "HostKey": "string",
   "IdentityProviderDetails": { 
      "DirectoryId": "string",
      "Function": "string",
      "InvocationRole": "string",
      "SftpAuthenticationMethods": "string",
      "Url": "string"
   },
   "IdentityProviderType": "string",
   "LoggingRole": "string",
   "PostAuthenticationLoginBanner": "string",
   "PreAuthenticationLoginBanner": "string",
   "ProtocolDetails": { 
      "As2Transports": [ "string" ],
      "PassiveIp": "string",
      "SetStatOption": "string",
      "TlsSessionResumptionMode": "string"
   },
   "Protocols": [ "string" ],
   "S3StorageOptions": { 
      "DirectoryListingOptimization": "string"
   },
   "SecurityPolicyName": "string",
   "StructuredLogDestinations": [ "string" ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "WorkflowDetails": { 
      "OnPartialUpload": [ 
         { 
            "ExecutionRole": "string",
            "WorkflowId": "string"
         }
      ],
      "OnUpload": [ 
         { 
            "ExecutionRole": "string",
            "WorkflowId": "string"
         }
      ]
   }
}

Parameter Permintaan

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.

Permintaan menerima data berikut dalam JSON format.

Certificate

Nama Sumber Daya Amazon (ARN) dari sertifikat AWS Certificate Manager (ACM). Diperlukan saat Protocols diatur ke FTPS.

Untuk meminta sertifikat publik baru, lihat Meminta sertifikat publik di Panduan AWS Certificate Manager Pengguna.

Untuk mengimpor sertifikat yang adaACM, lihat Mengimpor sertifikat ke ACM dalam Panduan AWS Certificate Manager Pengguna.

Untuk meminta sertifikat pribadi untuk digunakan FTPS melalui alamat IP pribadi, lihat Meminta sertifikat pribadi di Panduan AWS Certificate Manager Pengguna.

Sertifikat dengan algoritme kriptografi dan ukuran kunci berikut didukung:

2048-bit RSA (_2048) RSA
4096-bit RSA (_4096) RSA
Elliptic Prime Curve 256 bit (EC_prime256v1)
Elliptic Prime Curve 384 bit (EC_secp384r1)
Elliptic Prime Curve 521 bit (EC_secp521r1)

catatan

Sertifikat harus berupa SSL TLS sertifikat/X.509 versi 3 yang valid dengan FQDN atau alamat IP yang ditentukan dan informasi tentang penerbit.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 1600.

Wajib: Tidak

Domain

Domain dari sistem penyimpanan yang digunakan untuk transfer file. Ada dua domain yang tersedia: Amazon Simple Storage Service (Amazon S3) dan Amazon Elastic File System (Amazon). EFS Nilai defaultnya adalah S3.

catatan

Setelah server dibuat, domain tidak dapat diubah.

Tipe: String

Nilai yang Valid: S3 | EFS

Wajib: Tidak

EndpointDetails

Pengaturan titik akhir virtual private cloud (VPC) yang dikonfigurasi untuk server Anda. Ketika Anda meng-host titik akhir Anda di dalam AndaVPC, Anda dapat membuat titik akhir Anda hanya dapat diakses oleh sumber daya di dalam AndaVPC, atau Anda dapat melampirkan alamat IP Elastic dan membuat titik akhir Anda dapat diakses oleh klien melalui internet. Grup VPC keamanan default Anda secara otomatis ditetapkan ke titik akhir Anda.

Tipe: Objek EndpointDetails

Wajib: Tidak

EndpointType

Jenis endpoint yang Anda ingin server Anda gunakan. Anda dapat memilih untuk membuat endpoint server Anda dapat diakses secara publik (PUBLIC) atau menghostingnya di dalam server Anda. VPC Dengan endpoint yang di-host di aVPC, Anda dapat membatasi akses ke server dan sumber daya hanya di dalam Anda VPC atau memilih untuk membuatnya menghadap internet dengan melampirkan alamat IP Elastis langsung ke sana.

catatan

Setelah 19 Mei 2021, Anda tidak akan dapat membuat server menggunakan EndpointType=VPC_ENDPOINT di akun Anda Akun AWS jika akun Anda belum melakukannya sebelum 19 Mei 2021. Jika Anda telah membuat server dengan EndpointType=VPC_ENDPOINT di Anda Akun AWS pada atau sebelum 19 Mei 2021, Anda tidak akan terpengaruh. Setelah tanggal ini, gunakan EndpointType =VPC.

Untuk informasi selengkapnya, lihat Menghentikan penggunaan _ VPC ENDPOINT.

Direkomendasikan agar Anda menggunakan VPC sebagai EndpointType. Dengan tipe endpoint ini, Anda memiliki opsi untuk secara langsung mengaitkan hingga tiga IPv4 alamat Elastic (termasuk BYO IP) dengan endpoint server Anda dan menggunakan grup VPC keamanan untuk membatasi lalu lintas dengan alamat IP publik klien. Hal ini tidak mungkin terjadi jika EndpointType diatur ke VPC_ENDPOINT.

Tipe: String

Nilai yang Valid: PUBLIC | VPC | VPC_ENDPOINT

Wajib: Tidak

HostKey

KunciRSA,ECDSA, atau ED25519 pribadi yang akan digunakan untuk server SFTP yang diaktifkan. Anda dapat menambahkan beberapa kunci host, jika Anda ingin memutar tombol, atau memiliki satu set kunci aktif yang menggunakan algoritma yang berbeda.

Gunakan perintah berikut untuk menghasilkan kunci RSA 2048 bit tanpa frasa sandi:

ssh-keygen -t rsa -b 2048 -N "" -m PEM -f my-new-server-key.

Gunakan nilai minimum 2048 untuk -b opsi. Anda dapat membuat kunci yang lebih kuat dengan menggunakan 3072 atau 4096.

Gunakan perintah berikut untuk menghasilkan kunci ECDSA 256 bit tanpa frasa sandi:

ssh-keygen -t ecdsa -b 256 -N "" -m PEM -f my-new-server-key.

Nilai yang valid untuk -b opsi ECDSA adalah 256, 384, dan 521.

Gunakan perintah berikut untuk menghasilkan ED25519 kunci tanpa frasa sandi:

ssh-keygen -t ed25519 -N "" -f my-new-server-key.

Untuk semua perintah ini, Anda dapat mengganti my-new-server-keydengan string pilihan Anda.

penting

Jika Anda tidak berencana untuk memigrasikan pengguna yang sudah ada dari server SFTP berkemampuan yang sudah ada ke server baru, jangan perbarui kunci host. Mengubah kunci host server secara tidak sengaja dapat mengganggu.

Untuk informasi selengkapnya, lihat Memperbarui kunci host untuk server yang SFTP diaktifkan di Panduan AWS Transfer Family Pengguna.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 4096.

Wajib: Tidak

IdentityProviderDetails

Diperlukan saat IdentityProviderType diatur keAWS_DIRECTORY_SERVICE, AWS_LAMBDA atauAPI_GATEWAY. Menerima array yang berisi semua informasi yang diperlukan untuk menggunakan direktori di AWS_DIRECTORY_SERVICE atau memanggil otentikasi API yang disediakan pelanggan, termasuk Gateway. API URL Tidak diperlukan saat IdentityProviderType diatur ke SERVICE_MANAGED.

Tipe: Objek IdentityProviderDetails

Wajib: Tidak

IdentityProviderType

Modus otentikasi untuk server. Nilai defaultnya adalahSERVICE_MANAGED, yang memungkinkan Anda untuk menyimpan dan mengakses kredensi pengguna dalam layanan. AWS Transfer Family

Gunakan AWS_DIRECTORY_SERVICE untuk menyediakan akses ke grup Direktori Aktif di AWS Directory Service for Microsoft Active Directory atau Microsoft Active Directory di lingkungan lokal Anda atau AWS menggunakan AD Connector. Opsi ini juga mengharuskan Anda untuk memberikan ID Direktori dengan menggunakan IdentityProviderDetails parameter.

Gunakan nilai API_GATEWAY untuk mengintegrasikan dengan penyedia identitas pilihan Anda. API_GATEWAYPengaturan mengharuskan Anda untuk menyediakan endpoint Amazon API Gateway URL untuk memanggil otentikasi dengan menggunakan parameter. IdentityProviderDetails

Gunakan AWS_LAMBDA nilai untuk langsung menggunakan AWS Lambda fungsi sebagai penyedia identitas Anda. Jika Anda memilih nilai ini, Anda harus menentukan fungsi ARN untuk Lambda dalam Function parameter untuk tipe IdentityProviderDetails data.

Tipe: String

Nilai yang Valid: SERVICE_MANAGED | API_GATEWAY | AWS_DIRECTORY_SERVICE | AWS_LAMBDA

Wajib: Tidak

LoggingRole

Nama Sumber Daya Amazon (ARN) dari peran AWS Identity and Access Management (IAM) yang memungkinkan server mengaktifkan CloudWatch pencatatan Amazon untuk Amazon S3 atau Amazon. EFSevents Saat disetel, Anda dapat melihat aktivitas pengguna di CloudWatch log Anda.

Tipe: String

Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum 2048.

Pola: (|arn:.*role/\S+)

Wajib: Tidak

PostAuthenticationLoginBanner

Menentukan string untuk ditampilkan ketika pengguna terhubung ke server. String ini ditampilkan setelah pengguna mengautentikasi.

catatan

SFTPProtokol tidak mendukung spanduk tampilan pasca-otentikasi.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 4096.

Pola: [\x09-\x0D\x20-\x7E]*

Wajib: Tidak

PreAuthenticationLoginBanner

Menentukan string untuk ditampilkan ketika pengguna terhubung ke server. String ini ditampilkan sebelum pengguna mengautentikasi. Misalnya, spanduk berikut menampilkan detail tentang penggunaan sistem:

This system is for the use of authorized users only. Individuals using this computer system without authority, or in excess of their authority, are subject to having all of their activities on this system monitored and recorded by system personnel.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 4096.

Pola: [\x09-\x0D\x20-\x7E]*

Wajib: Tidak

ProtocolDetails

Pengaturan protokol yang dikonfigurasi untuk server Anda.

Untuk menunjukkan mode pasif (untuk FTP dan FTPS protokol), gunakan parameter. PassiveIp Masukkan alamat dotted-quad tunggal, seperti IPv4 alamat IP eksternal firewall, router, atau penyeimbang beban.
Untuk mengabaikan kesalahan yang dihasilkan saat klien mencoba menggunakan SETSTAT perintah pada file yang Anda unggah ke bucket Amazon S3, gunakan SetStatOption parameternya. Agar AWS Transfer Family server mengabaikan SETSTAT perintah dan mengunggah file tanpa perlu membuat perubahan apa pun pada SFTP klien Anda, tetapkan nilainya. ENABLE_NO_OP Jika Anda menyetel SetStatOption parameternyaENABLE_NO_OP, Transfer Family akan menghasilkan entri CloudWatch log ke Amazon Logs, sehingga Anda dapat menentukan kapan klien melakukan SETSTAT panggilan.
Untuk menentukan apakah AWS Transfer Family server Anda melanjutkan sesi terbaru yang dinegosiasikan melalui ID sesi unik, gunakan parameternya. TlsSessionResumptionMode
As2Transportsmenunjukkan metode transportasi untuk AS2 pesan. Saat ini, hanya HTTP didukung.

Tipe: Objek ProtocolDetails

Wajib: Tidak

Protocols

Menentukan protokol transfer file atau protokol di mana klien protokol transfer file Anda dapat terhubung ke titik akhir server Anda. Protokol yang tersedia adalah:

SFTP(Secure Shell (SSH) Protokol Transfer File): Transfer file SSH
FTPS(File Transfer Protocol Secure): Transfer file dengan TLS enkripsi
FTP (Protokol Transfer File): Transfer file tidak terenkripsi
AS2(Pernyataan Penerapan 2): digunakan untuk mengangkut data terstruktur business-to-business

catatan

Jika Anda memilihFTPS, Anda harus memilih sertifikat yang disimpan di AWS Certificate Manager (ACM) yang digunakan untuk mengidentifikasi server Anda ketika klien terhubung dengannyaFTPS.
Jika Protocol termasuk salah satu FTP atauFTPS, maka EndpointType harus VPC dan IdentityProviderType harus baikAWS_DIRECTORY_SERVICE,AWS_LAMBDA, atauAPI_GATEWAY.
Jika Protocol termasuk FTP, maka AddressAllocationIds tidak dapat dikaitkan.
Jika Protocol disetel hanya keSFTP, EndpointType dapat diatur ke PUBLIC dan IdentityProviderType dapat disetel salah satu jenis identitas yang didukung:SERVICE_MANAGED,AWS_DIRECTORY_SERVICE,AWS_LAMBDA, atauAPI_GATEWAY.
Jika Protocol termasukAS2, maka EndpointType harusVPC, dan domain harus Amazon S3.

Tipe: Array string

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 4 item.

Nilai yang Valid: SFTP | FTP | FTPS | AS2

Wajib: Tidak

S3StorageOptions

Menentukan apakah atau tidak kinerja untuk direktori Amazon S3 Anda dioptimalkan. Ini dinonaktifkan secara default.

Secara default, pemetaan direktori home memiliki TYPE file. DIRECTORY Jika Anda mengaktifkan opsi ini, Anda kemudian perlu secara eksplisit menyetel HomeDirectoryMapEntry Type ke FILE jika Anda ingin pemetaan memiliki target file.

Tipe: Objek S3StorageOptions

Wajib: Tidak

SecurityPolicyName

Menentukan nama kebijakan keamanan yang dilampirkan ke server.

Tipe: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 100.

Pola: TransferSecurityPolicy-.+

Wajib: Tidak

StructuredLogDestinations

Menentukan grup log yang log server Anda dikirim.

Untuk menentukan grup log, Anda harus menyediakan ARN untuk grup log yang ada. Dalam hal ini, format grup log adalah sebagai berikut:

arn:aws:logs:region-name:amazon-account-id:log-group:log-group-name:*

Sebagai contoh, arn:aws:logs:us-east-1:111122223333:log-group:mytestgroup:*.

Jika sebelumnya Anda telah menentukan grup log untuk server, Anda dapat menghapusnya, dan pada dasarnya mematikan logging terstruktur, dengan memberikan nilai kosong untuk parameter ini dalam update-server panggilan. Sebagai contoh:

update-server --server-id s-1234567890abcdef0 --structured-log-destinations

Tipe: Array string.

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 1 item.

Batasan Panjang: Panjang minimum 20. Panjang maksimum 1600.

Pola: arn:\S+

Wajib: Tidak

Tags

Pasangan nilai kunci yang dapat digunakan untuk grup dan mencari server.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 50 item.

Wajib: Tidak

WorkflowDetails

Menentukan ID alur kerja untuk alur kerja yang akan ditetapkan dan peran eksekusi yang digunakan untuk mengeksekusi alur kerja.

Selain alur kerja untuk mengeksekusi ketika file diunggah sepenuhnya, juga WorkflowDetails dapat berisi ID alur kerja (dan peran eksekusi) untuk alur kerja untuk mengeksekusi pada upload sebagian. Upload sebagian terjadi ketika sesi server terputus saat file masih diunggah.

Tipe: Objek WorkflowDetails

Wajib: Tidak

Sintaksis Respons


{
   "ServerId": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

ServerId

Pengenal yang ditugaskan layanan dari server yang dibuat.

Tipe: String

Kendala Panjang: Panjang tetap 19.

Pola: s-([0-9a-f]{17})

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AccessDeniedException

Anda tidak memiliki akses yang memadai untuk melakukan tindakan ini.

HTTPKode Status: 400

InternalServiceError

Pengecualian ini dilemparkan ketika kesalahan terjadi dalam AWS Transfer Family layanan.

HTTPKode Status: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

HTTPKode Status: 400

ResourceExistsException

Sumber daya yang diminta tidak ada, atau ada di wilayah selain yang ditentukan untuk perintah.

HTTPKode Status: 400

ResourceNotFoundException

Pengecualian ini dilemparkan ketika sumber daya tidak ditemukan oleh layanan AWS Transfer Family.

HTTPKode Status: 400

ServiceUnavailableException

Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.

HTTPKode Status: 500

ThrottlingException

Permintaan ditolak karena throttling permintaan.

HTTPKode Status: 400

Contoh

Contoh berikut membuat server baru menggunakan fileVPC_ENDPOINT.

Permintaan Sampel


{     
   "EndpointType": "VPC",
   "EndpointDetails":...,
   "HostKey": "Your RSA private key",
   "IdentityProviderDetails": "IdentityProvider",
   "IdentityProviderType": "SERVICE_MANAGED",
   "LoggingRole": "CloudWatchLoggingRole",
   "Tags": [ 
      { 
         "Key": "Name",
         "Value": "MyServer"
      }
   ]
}

Contoh

Ini adalah contoh respons untuk API panggilan ini.

Contoh Respons


{
   "ServerId": "s-01234567890abcdef"
}

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

CreateProfile

CreateUser

Di halaman ini

Pilih preferensi cookie Anda

Sesuaikan preferensi cookie

Penting

Kinerja

Fungsional

Iklan

Tidak dapat menyimpan preferensi cookie

CreateServer

Sintaksis Permintaan

Parameter Permintaan

catatan

catatan

catatan

penting

catatan

catatan

Sintaksis Respons

Elemen Respons

Kesalahan

Contoh

Contoh

Permintaan Sampel

Contoh

Contoh Respons

Lihat Juga

Di halaman ini

Apakah halaman ini membantu Anda?

Topik berikutnya:

Topik sebelumnya:

Perlu bantuan?