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

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

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](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

## Sintaksis Permintaan
<a name="API_UpdateLocationObjectStorage_RequestSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

## Parameter Permintaan
<a name="API_UpdateLocationObjectStorage_RequestParameters"></a>

Untuk informasi tentang parameter yang umum untuk semua tindakan, lihat [Parameter Umum](CommonParameters.md).

Permintaan menerima data berikut dalam format JSON.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
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](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(Opsional) Menentukan Nama Sumber Daya Amazon (ARNs) dari DataSync agen yang dapat terhubung dengan sistem penyimpanan objek Anda. Jika Anda menyiapkan transfer lintas cloud tanpa agen, Anda tidak perlu menentukan nilai untuk parameter ini.  
Anda tidak dapat menambah atau menghapus agen dari lokasi penyimpanan setelah Anda pertama kali membuatnya.
Tipe: Array string  
Anggota Array: Jumlah minimum 1 item. Jumlah maksimum 8 item.  
Batasan Panjang: Panjang maksimum 128.  
Pola: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$`   
Wajib: Tidak

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang DataSync dikelola, seperti token otentikasi atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan yang dikelola pelanggan. AWS KMS key  
Tipe: Objek [CmkSecretConfig](API_CmkSecretConfig.md)  
Wajib: Tidak

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Menentukan informasi konfigurasi untuk rahasia yang dikelola pelanggan, seperti token otentikasi atau kumpulan kredensional yang DataSync digunakan untuk mengakses lokasi transfer tertentu, dan peran yang dikelola pelanggan AWS Identity and Access Management (IAM) yang menyediakan akses ke rahasia.  
Tipe: Objek [CustomSecretConfig](API_CustomSecretConfig.md)  
Wajib: Tidak

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
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-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$`   
Wajib: Ya

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
Menentukan kunci rahasia (misalnya, kata sandi) jika kredensional diperlukan untuk mengautentikasi dengan server penyimpanan objek.  
Jika Anda memberikan rahasia menggunakan`SecretKey`, tetapi tidak memberikan rincian konfigurasi rahasia menggunakan `CmkSecretConfig` atau`CustomSecretConfig`, kemudian DataSync menyimpan token menggunakan rahasia Secrets Manager AWS akun Anda.
Tipe: String  
Batasan Panjang: Panjang minimum 0. Panjang maksimum 200.  
Pola: `^.*$`   
Wajib: Tidak

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
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 menengah (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` ke`HTTPS`.  
Memperbarui parameter ini tidak mengganggu tugas yang sedang Anda jalani.  
Tipe: Objek data biner dienkode Base64  
Kendala Panjang: Panjang maksimum 32768.  
Wajib: Tidak

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
Menentukan nama domain atau alamat IP (IPv4 atau IPv6) dari server penyimpanan objek yang terhubung dengan DataSync agen Anda.  
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: Tidak

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
Menentukan port tempat server penyimpanan objek Anda menerima lalu lintas jaringan masuk (misalnya, port 443).  
Tipe: Bilangan Bulat  
Rentang yang Valid: Nilai minimum 1. Nilai maksimum 65536.  
Wajib: Tidak

 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Menentukan protokol yang digunakan server penyimpanan objek Anda untuk berkomunikasi.  
Tipe: String  
Nilai yang Valid: `HTTPS | HTTP`   
Wajib: Tidak

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
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
<a name="API_UpdateLocationObjectStorage_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200 dengan isi HTTP kosong.

## Kesalahan
<a name="API_UpdateLocationObjectStorage_Errors"></a>

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Kesalahan Umum](CommonErrors.md).

 ** 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
<a name="API_UpdateLocationObjectStorage_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage)