UpdateAgreement - AWS Transfer Family

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

UpdateAgreement

Memperbarui beberapa parameter untuk perjanjian yang ada. Berikan AgreementId dan ServerId untuk perjanjian yang ingin Anda perbarui, bersama dengan nilai baru untuk parameter yang akan diperbarui.

Sintaksis Permintaan

{ "AccessRole": "string", "AgreementId": "string", "BaseDirectory": "string", "Description": "string", "LocalProfileId": "string", "PartnerProfileId": "string", "ServerId": "string", "Status": "string" }

Parameter Permintaan

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

Permintaan menerima data berikut dalam format JSON.

AccessRole

Konektor digunakan untuk mengirim file menggunakan protokol AS2 atau SFTP. Untuk peran akses, berikan Nama Sumber Daya Amazon (ARN) AWS Identity and Access Management peran yang akan digunakan.

Untuk konektor AS2

Dengan AS2, Anda dapat mengirim file dengan memanggil StartFileTransfer dan menentukan jalur file dalam parameter permintaan,. SendFilePaths Kami menggunakan direktori induk file (misalnya, untuk, direktori induk/bucket/dir/) untuk --send-file-paths /bucket/dir/file.txt sementara menyimpan file pesan AS2 yang diproses, menyimpan MDN ketika kami menerimanya dari mitra, dan menulis file JSON akhir yang berisi metadata transmisi yang relevan. Jadi, AccessRole kebutuhan untuk menyediakan akses baca dan tulis ke direktori induk dari lokasi file yang digunakan dalam StartFileTransfer permintaan. Selain itu, Anda perlu menyediakan akses baca dan tulis ke direktori induk dari file yang ingin Anda kirimStartFileTransfer.

Jika Anda menggunakan otentikasi Dasar untuk konektor AS2 Anda, peran akses memerlukan secretsmanager:GetSecretValue izin untuk rahasia tersebut. Jika rahasia dienkripsi menggunakan kunci yang dikelola pelanggan alih-alih kunci yang dikelola di AWS Secrets Manager, maka peran tersebut juga memerlukan kms:Decrypt izin untuk kunci tersebut.

Untuk konektor SFTP

Pastikan bahwa peran akses menyediakan akses baca dan tulis ke direktori induk dari lokasi file yang digunakan dalam StartFileTransfer permintaan. Selain itu, pastikan bahwa peran tersebut memberikan secretsmanager:GetSecretValue izin untuk AWS Secrets Manager.

Jenis: String

Batasan Panjang: Panjang minimum 20. Panjang maksimum 2048.

Pola: arn:.*role/\S+

Wajib: Tidak

AgreementId

Pengidentifikasi unik untuk perjanjian. Pengenal ini dikembalikan saat Anda membuat perjanjian.

Jenis: String

Kendala Panjang: Panjang tetap 19.

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

Wajib: Ya

BaseDirectory

Untuk mengubah direktori pendaratan (folder) untuk file yang ditransfer, berikan folder bucket yang ingin Anda gunakan; misalnya,/DOC-EXAMPLE-BUCKET/home/mydirectory .

Jenis: String

Batasan Panjang: Panjang minimum 0. Panjang maksimum 1024.

Pola: (|/.*)

Wajib: Tidak

Description

Untuk mengganti deskripsi yang ada, berikan deskripsi singkat untuk perjanjian tersebut.

Jenis: String

Panjang Batasan: Panjang minimum 1. Panjang maksimum 200.

Pola: [\p{Graph}]+

Wajib: Tidak

LocalProfileId

Pengidentifikasi unik untuk profil lokal AS2.

Untuk mengubah pengenal profil lokal, berikan nilai baru di sini.

Jenis: String

Kendala Panjang: Panjang tetap 19.

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

Wajib: Tidak

PartnerProfileId

Pengenal unik untuk profil mitra. Untuk mengubah pengenal profil mitra, berikan nilai baru di sini.

Jenis: String

Kendala Panjang: Panjang tetap 19.

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

Wajib: Tidak

ServerId

Pengidentifikasi unik yang ditetapkan sistem untuk instans server. Ini adalah server khusus yang digunakan perjanjian.

Jenis: String

Kendala Panjang: Panjang tetap 19.

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

Wajib: Ya

Status

Anda dapat memperbarui status perjanjian, baik mengaktifkan perjanjian yang tidak aktif atau sebaliknya.

Jenis: String

Nilai yang Valid: ACTIVE | INACTIVE

Wajib: Tidak

Sintaksis Respons

{ "AgreementId": "string" }

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

AgreementId

Pengidentifikasi unik untuk perjanjian. Pengenal ini dikembalikan saat Anda membuat perjanjian.

Jenis: String

Kendala Panjang: Panjang tetap 19.

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

Kesalahan

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

InternalServiceError

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

Kode Status HTTP: 500

InvalidRequestException

Pengecualian ini dilontarkan ketika klien mengirimkan permintaan yang salah format.

Kode Status HTTP: 400

ResourceExistsException

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

Kode Status HTTP: 400

ResourceNotFoundException

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

Kode Status HTTP: 400

ServiceUnavailableException

Permintaan gagal karena layanan AWS Transfer Family tidak tersedia.

Kode Status HTTP: 500

ThrottlingException

Permintaan ditolak karena throttling permintaan.

Kode Status HTTP: 400

Lihat Juga

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