CreateLocationObjectStorage

Membuat lokasi transfer untuk sistem penyimpanan objek. AWS DataSync dapat menggunakan lokasi ini sebagai sumber atau tujuan untuk mentransfer data.

Sebelum Anda mulai, pastikan Anda memahami prasyarat DataSync untuk bekerja dengan sistem penyimpanan objek.

Sintaksis Permintaan

{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "BucketName": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parameter Permintaan

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

Permintaan menerima data berikut dalam JSON format.

AccessKey

Menentukan kunci akses (misalnya, nama pengguna) jika kredensil 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: Ya

BucketName

Menentukan nama bucket penyimpanan objek yang terlibat dalam transfer.

Tipe: String

Batasan Panjang: Panjang minimum 3. Panjang maksimum 63.

Pola: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Wajib: Ya

SecretKey

Menentukan kunci rahasia (misalnya, kata sandi) jika kredensil 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 .pem file 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 .pem file (yang dapat mencapai 32768 byte sebelum pengkodean base64). Contoh cat perintah berikut membuat object_storage_certificates.pem file yang mencakup tiga sertifikat:

cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem

Untuk menggunakan parameter ini, konfigurasikan ServerProtocol keHTTPS.

Tipe: Objek data biner dienkode Base64

Kendala Panjang: Panjang maksimum 32768.

Wajib: Tidak

ServerHostname

Menentukan nama domain atau alamat IP dari server penyimpanan objek. DataSyncAgen menggunakan nama host ini untuk me-mount server penyimpanan objek dalam jaringan.

Tipe: String

Batasan Panjang: Panjang maksimum 255.

Pola: ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Wajib: Ya

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 | HTTP

Wajib: 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}]*$

Wajib: Tidak

Tags

Menentukan pasangan kunci-nilai yang mewakili tag yang ingin Anda tambahkan ke sumber daya. Tag dapat membantu Anda mengelola, memfilter, dan mencari sumber daya Anda. Sebaiknya buat tag nama untuk lokasi Anda.

Tipe: Array objek TagListEntry

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

Diperlukan: Tidak

Sintaksis Respons

{
   "LocationArn": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

LocationArn

Menentukan ARN lokasi sistem penyimpanan objek yang Anda buat.

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

Kesalahan

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

InternalException

Pengecualian ini dilontarkan ketika terjadi kesalahan dalam layanan AWS DataSync .

HTTPKode Status: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

HTTPKode Status: 400

Lihat Juga

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

• AWS Antarmuka Baris Perintah

• AWS SDKuntuk. NET

• AWS SDKuntuk C ++

• AWS SDKuntuk Go v2

• AWS SDKuntuk Java V2

• AWS SDKuntuk JavaScript V3

• AWS SDKuntuk PHP V3

• AWS SDKuntuk Python

• AWS SDKuntuk Ruby V3