SendFile - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengirim file jarak jauh ke satu atau beberapa Instans ECS.

Deskripsi operasi

Instans ECS target harus dalam status Berjalan (Running).
Agen Asisten Cloud harus diinstal pada Instans ECS target sebelumnya.
Versi Agen Asisten Cloud harus lebih baru dari versi berikut untuk mendukung pengiriman file. Jika kode kesalahan ClientNeedUpgrade dikembalikan, perbarui agen ke versi terbaru.
- Linux: 1.0.2.569
- Windows: 1.0.0.149
Setelah pengodean Base64, ukuran konten file tidak boleh melebihi 32 KB.
Pengiriman file dapat gagal karena pengecualian pada status Instans ECS target, masalah jaringan, atau pengecualian Agen Asisten Cloud. Panggil DescribeSendFileResults atau lihat Kesalahan umum dan solusi untuk kegagalan eksekusi untuk memecahkan masalah.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:SendFile

update

*Instance.

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah Instans ECS target. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ResourceGroupId	string	No	ID kelompok sumber daya untuk pengiriman file. Jika Anda menentukan parameter ini: Instans ECS yang ditentukan oleh InstanceId harus termasuk dalam kelompok sumber daya ini. Anda dapat memfilter hasil pengiriman file dengan menentukan parameter ini saat memanggil DescribeSendFileResults.	rg-bp67acfmxazb4p****
Name	string	Yes	Nama file. Set karakter lengkap didukung. Nama tidak boleh melebihi 255 karakter.	file.txt
Description	string	No	Deskripsi. Set karakter lengkap didukung. Deskripsi tidak boleh melebihi 512 karakter.	Ini adalah file uji
Timeout	integer	No	Periode waktu tunggu untuk pengiriman file. Unit: detik. Waktu tunggu dapat terjadi ketika file tidak dapat dikirim karena masalah proses, modul yang hilang, atau Agen Asisten Cloud yang hilang. Jika periode waktu tunggu yang ditentukan kurang dari 10 detik, sistem secara otomatis mengatur periode waktu tunggu menjadi 10 detik untuk memastikan pengiriman berhasil. Nilai default: 60.	60
TargetDir	string	Yes	Folder tujuan pada Instans ECS target untuk file yang akan dikirim. Jika folder tidak ada, pembuatan otomatis dilakukan. Nilai tidak boleh melebihi 255 karakter.	/home
ContentType	string	No	Tipe konten file. Nilai valid: PlainText: teks biasa. Base64: pengodean Base64. Nilai default: PlainText.	PlainText
Content	string	Yes	Konten file. Setelah pengodean Base64, ukuran konten tidak boleh melebihi 32 KB. Jika `ContentType` diatur ke `PlainText`, parameter ini menentukan konten dalam teks biasa. Jika `ContentType` diatur ke `Base64`, parameter ini menentukan konten yang dikodekan Base64.	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}') -------- oss://bucketName/objectName
FileOwner	string	No	Pemilik file. Parameter ini hanya berlaku pada instans Linux. Nilai default: root. Nilai tidak boleh melebihi 64 karakter. Catatan Jika Anda menentukan pengguna lain, pastikan pengguna tersebut ada pada instans.	test
FileGroup	string	No	Kelompok pengguna file. Parameter ini hanya berlaku pada instans Linux. Nilai default: root. Nilai tidak boleh melebihi 64 karakter. Catatan Jika Anda menentukan kelompok pengguna lain, pastikan kelompok pengguna tersebut ada pada instans.	test
FileMode	string	No	Izin pada file. Parameter ini hanya berlaku pada instans Linux. Anda dapat mengonfigurasi parameter ini dengan cara yang sama seperti menjalankan perintah chmod. Nilai default: 0644, yang menunjukkan bahwa pemilik memiliki izin baca dan tulis, serta kelompok dan pengguna lain memiliki izin hanya baca.	0644
Overwrite	boolean	No	Apakah akan menimpa file dengan nama yang sama di direktori tujuan. Nilai valid: true: Menimpa file. false: Tidak menimpa file. Nilai default: false.	true
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	123e4567-e89b-12d3-a456-426655440000
InstanceId	array	Yes	ID Instans ECS tujuan pengiriman file. Anda dapat menentukan hingga 50 ID Instans. Nilai valid N: 1 hingga 50.	i-bp185dy2o3o6n****
	string	No	ID Instans ECS tujuan pengiriman file. Anda dapat menentukan hingga 50 ID Instans. Nilai valid N: 1 hingga 50.	i-bp185dy2o3o6n****
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag untuk pengiriman file. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong. Jika Anda menggunakan satu tag untuk memfilter Sumber daya, jumlah Sumber daya dengan tag tersebut tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter Sumber daya, jumlah Sumber daya yang memiliki semua tag yang ditentukan terpasang tidak boleh melebihi 1.000. Jika jumlah Sumber daya melebihi 1.000, panggil operasi ListTagResources untuk mengkueri Sumber daya. Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	TestKey
Value	string	No	Nilai tag untuk pengiriman file. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh mengandung `http://` atau `https://`.	TestValue

Elemen respons

Element	Type	Description	Example
	object
InvokeId	string	ID eksekusi.	f-7d2a745b412b46****
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "InvokeId": "f-7d2a745b412b46****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	RegionId.ApiNotSupported	The api is not supported in this region.	Pemanggilan API tidak didukung di wilayah tertentu. Periksa apakah nilai parameter RegionId benar.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	ID instans kosong.
400	NumberExceed.Tags	The Tags parameter number is exceed.	Jumlah tag melebihi batas maksimum. Anda dapat menentukan hingga 20 tag untuk operasi ini.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tentukan kunci tag.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Terdapat kunci duplikat dalam tag. Pastikan semua kunci unik.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Parameter kunci tag yang ditentukan tidak valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Parameter nilai tag yang ditentukan tidak valid.
400	FileTargetDir.Invalid	The target directory of file is invalid.
400	FileMode.Invalid	The mode of file is invalid.
400	FileContent.DecodeError	The Content can not be base64 decoded.
400	FileContentType.Invalid	The ContentType of file is invalid.
400	InvalidParameter.FileOwner	The specified parameter FileOwner is not valid.	Parameter FileOwner yang ditentukan tidak valid.
400	InvalidParameter.FileGroup	The specified parameter FileGroup is not valid.	Parameter FileGroup yang ditentukan tidak valid.
400	InvalidClientToken.Malformed	The specified parameter clientToken is not valid.	Parameter idempoten yang ditentukan tidak valid.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	Terjadi kesalahan saat mengirim permintaan. Coba lagi nanti.
403	InvalidParameterCharacter	The specified parameter %s contains illegal characters.
403	FileSize.ExceedLimit	The length of file content exceeds limit.	Panjang konten file melebihi batas atas.
403	FileName.ExceedLimit	The length of file name exceeds limit.	Panjang nama file melebihi batas atas.
403	FileDesc.ExceedLimit	The length of file description exceeds limit.	Panjang deskripsi file melebihi batas atas.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	Jumlah instans target melebihi batas atas.
403	Operation.Forbidden	The operation is not permitted.	Operasi tidak diizinkan.
403	InvalidTimeout.ExceedLimit	The specified parameter Timeout exceeds the upper limit.
403	IdempotentParameterMismatch	The specified parameter has changed while using an already used clientToken.	Parameter permintaan tidak cocok dengan permintaan yang memiliki ClientToken yang sama.
403	IdempotentProcessing	The previous idempotent request(s) is still processing.	Permintaan idempoten sebelumnya masih diproses. Coba lagi nanti.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.
404	InvalidInstance.NotFound	The specified instances not found.	Instans yang ditentukan tidak ada.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kelompok sumber daya tidak ditemukan dalam catatan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.