Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Memodifikasi parameter konfigurasi berikut dari lokasi transfer penyimpanan objek yang Anda gunakan. AWS DataSync
Untuk informasi selengkapnya, lihat Mengonfigurasi DataSync transfer dengan sistem penyimpanan objek.
Sintaksis Permintaan
{
"AccessKey": "string",
"AgentArns": [ "string" ],
"LocationArn": "string",
"SecretKey": "string",
"ServerCertificate": blob,
"ServerPort": number,
"ServerProtocol": "string",
"Subdirectory": "string"
}Parameter Permintaan
Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat Parameter Umum.
Permintaan menerima data berikut dalam format JSON.
- AccessKey
-
Menentukan kunci akses (misalnya, nama pengguna) jika kredensional diperlukan untuk mengautentikasi dengan server penyimpanan objek.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.
Pola:
^.*$Wajib: Tidak
- AgentArns
-
Menentukan Amazon Resource Names (ARNs) dari DataSync agen yang dapat terhubung dengan sistem penyimpanan objek Anda.
Tipe: Array string
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 4 item.
Batasan Panjang: Panjang maksimum 128.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$Wajib: Tidak
- LocationArn
-
Menentukan ARN dari lokasi sistem penyimpanan objek yang Anda perbarui.
Tipe: String
Batasan Panjang: Panjang maksimum 128.
Pola:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$Wajib: Ya
- SecretKey
-
Menentukan kunci rahasia (misalnya, kata sandi) jika kredensional diperlukan untuk mengautentikasi dengan server penyimpanan objek.
Tipe: String
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.
Pola:
^.*$Wajib: Tidak
- ServerCertificate
-
Menentukan rantai sertifikat DataSync untuk mengautentikasi dengan sistem penyimpanan objek Anda jika sistem menggunakan otoritas sertifikat pribadi atau yang ditandatangani sendiri (CA). Anda harus menentukan satu
.pemfile dengan rantai sertifikat lengkap (misalnya,file:///home/user/.ssh/object_storage_certificates.pem).Rantai sertifikat mungkin termasuk:
-
Sertifikat sistem penyimpanan objek
-
Semua sertifikat perantara (jika ada)
-
Sertifikat root dari CA penandatanganan
Anda dapat menggabungkan sertifikat Anda ke dalam
.pemfile (yang dapat mencapai 32768 byte sebelum pengkodean base64). Contohcatperintah berikut membuatobject_storage_certificates.pemfile yang mencakup tiga sertifikat:cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pemUntuk menggunakan parameter ini, konfigurasikan
ServerProtocolkeHTTPS.Memperbarui parameter ini tidak mengganggu tugas yang sedang Anda jalani.
Tipe: Objek data biner dienkode Base64
Kendala Panjang: Panjang maksimum 32768.
Wajib: Tidak
-
- ServerPort
-
Menentukan port tempat server penyimpanan objek Anda menerima lalu lintas jaringan masuk (misalnya, port 443).
Jenis: Integer
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.
Wajib: Tidak
- ServerProtocol
-
Menentukan protokol yang digunakan server penyimpanan objek Anda untuk berkomunikasi.
Tipe: String
Nilai yang Valid:
HTTPS | HTTPWajib: Tidak
- Subdirectory
-
Menentukan awalan objek untuk server penyimpanan objek Anda. Jika ini adalah lokasi sumber, DataSync hanya menyalin objek dengan awalan ini. Jika ini adalah lokasi tujuan, DataSync tulis semua objek dengan awalan ini.
Tipe: String
Batasan Panjang: Panjang maksimum 4096.
Pola:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$Diperlukan: Tidak
Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- InternalException
-
Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .
Kode Status HTTP: 500
- InvalidRequestException
-
Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.
Kode Status HTTP: 400
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
