SendFile - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Dosya gönderilecek örneklerin Çalışıyor (Running) durumunda olması gerekir.
Örneklerde Cloud Assistant Agent yüklü olmalıdır.
Yalnızca aşağıdaki sürümlerden daha yeni olan Cloud Assistant Agent sürümleri dosya göndermeyi destekler. ClientNeedUpgrade hata kodu döndürülürse Cloud Assistant Agent'ı en son sürüme güncelleyin.
- Linux örnekleri için Cloud Assistant Agent sürümü 1.0.2.569'dan sonraki bir sürüm olmalıdır.
- Windows örnekleri için Cloud Assistant Agent sürümü 1.0.0.149'dan sonraki bir sürüm olmalıdır.
Göndermek istediğiniz dosyanın Base64 ile kodlandıktan sonraki boyutu 32 KB'yi aşmamalıdır.
Dosya; örnek kaynaklı sorunlar, ağ hataları veya Cloud Assistant Agent ile ilgili istisnalar nedeniyle gönderilemeyebilir. Sorun giderme adımları için DescribeSendFileResults API'sini çağırın veya Çalıştırma sonuçlarını kontrol edin ve yaygın sorunları giderin konusuna bakın.

Hata ayıklama

OpenAPI Explorer, imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlem örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	SendFile	Gerçekleştirmek istediğiniz işlem. Değeri SendFile olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	Dosyanın gönderileceği örneğin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions API'sini çağırabilirsiniz.
ResourceGroupId	String	Hayır	rg-bp67acfmxazb4p****	Kaynak grubunun kimliği. Bu parametreyi belirtirken aşağıdaki hususlara dikkat edin: InstanceId parametresiyle belirtilen ECS örneği bu kaynak grubuna ait olmalıdır. Bu parametreyi belirtirseniz belirtilen kaynak grubundaki dosya gönderme sonuçlarını sorgulamak için DescribeSendFileResults API'sini çağırabilirsiniz.
Name	String	Evet	file.txt	Dosyanın adı. Ad tüm karakter kümelerini destekler ve uzunluğu en fazla 255 karakter olabilir.
Description	String	Hayır	This is a test file.	Dosyanın açıklaması. Açıklama tüm karakter kümelerini destekler ve uzunluğu en fazla 512 karakter olabilir.
Timeout	Long	Hayır	60	Dosya gönderme görevi için zaman aşımı süresi. Birim: saniye. İşlem yavaşladığında veya belirli bir modül ya da Cloud Assistant Agent bulunmadığında dosya gönderilemediği için zaman aşımı hatası oluşur. Belirtilen zaman aşımı süresi 10 saniyeden kısa ise sistem dosyanın örneklere gönderilebilmesini sağlamak için zaman aşımı süresini 10 saniye olarak ayarlar. Varsayılan değer: 60.
TargetDir	String	Evet	/home	Dosyanın gönderileceği örnekteki hedef dizin. Belirtilen dizin yoksa sistem örnekte dizini oluşturur. Değer tüm karakter kümelerini destekler ve uzunluğu 255 karakteri aşamaz.
ContentType	String	Hayır	PlainText	Dosyanın içerik türü. Geçerli değerler: PlainText: Dosya içeriği kodlanmamıştır. Base64: Dosya içeriği Base64 ile kodlanmıştır. Varsayılan değer: PlainText.
Content	String	Evet	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}') -------- oss://bucketName/objectName	Uzak dosyanın içeriği. İçeriğin Base64 ile kodlandıktan sonraki boyutu 32 KB'yi aşmamalıdır. `ContentType` değeri `PlainText` olarak ayarlanırsa Content değeri düz metin formatındadır. `ContentType` değeri `Base64` olarak ayarlanırsa Content değeri Base64 ile kodlanmıştır.
FileOwner	String	Hayır	test	Dosyanın sahibi. Bu parametre yalnızca Linux örnekleri için geçerlidir. Varsayılan değer: root. Değerin uzunluğu en fazla 64 karakter olabilir. Not Kök olmayan bir kullanıcı kullanmak istiyorsanız kullanıcının örneklerde bulunduğundan emin olun.
FileGroup	String	Hayır	test	Dosyanın kullanıcı grubu. Bu parametre yalnızca Linux örnekleri için geçerlidir. Varsayılan değer: root. Kullanıcı grubu adının uzunluğu en fazla 64 karakter olabilir. Not Kök olmayan bir kullanıcı grubu kullanmak istiyorsanız kullanıcı grubunun örneklerde bulunduğundan emin olun.
FileMode	String	Hayır	0644	Dosya üzerindeki izinler. Bu parametre yalnızca Linux örnekleri için geçerlidir. Bu parametreyi chmod komutunu yapılandırdığınız şekilde yapılandırabilirsiniz. Varsayılan değer: 0644. Bu değer dosya sahibinin dosyada okuma ve yazma iznine sahip olduğunu; dosya kullanıcı grubu ve diğer kullanıcıların ise dosyada yalnızca okuma iznine sahip olduğunu gösterir.
Overwrite	Boolean	Hayır	true	Hedef dizinde gönderilen dosya ile aynı ada sahip bir dosya varsa dosyanın üzerine yazılıp yazılmayacağını belirtir. true: Dosyanın üzerine yazar. false: Dosyanın üzerine yazmaz. Varsayılan değer: false.
InstanceId.N	String	Evet	i-bp185dy2o3o6n****	Dosyanın gönderileceği N. örneğin kimliği. Her istekte en fazla 50 örnek kimliği belirtilebilir. N için geçerli değerler: 1 ila 50.
Tag.N.Key	String	Hayır	TestKey	Dosya gönderme görevine eklenecek N. etiketin anahtarı. N için geçerli değerler: 1 ila 20. Etiket anahtarı boş bir dize olamaz. Kaynakları sorgulamak için tek bir etiket belirtilirse yanıtta bu etiket eklenmiş en fazla 1.000 kaynak görüntülenebilir. Kaynakları sorgulamak için birden çok etiket belirtilirse yanıtta tüm bu etiketler eklenmiş en fazla 1.000 kaynak görüntülenebilir. Belirtilen etiketlere sahip 1.000'den fazla kaynağı sorgulamak için ListTagResources API'sini çağırın. Etiket anahtarının uzunluğu en fazla 64 karakter olabilir ve `acs:` veya `aliyun` ile başlayamaz. `http://` veya `https://` içeremez.
Tag.N.Value	String	Hayır	TestValue	Dosya gönderme görevine eklenecek N. etiketin değeri. N için geçerli değerler: 1 ila 20. Etiket değeri boş bir dize olabilir. Etiket değerinin uzunluğu en fazla 128 karakter olabilir ve `http://` veya `https://` içeremez.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
InvokeId	String	f-7d2a745b412b46****	Dosya gönderme görevinin kimliği.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İstek kimliği.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=SendFile
&Content='echo hello'
&InstanceId.1=i-bp185dy2o3o6n****
&Name=file.txt
&RegionId=cn-hangzhou
&TargetDir=/home
&<Common request parameters>

Başarılı yanıt örnekleri

XML formatı

HTTP/1.1 200 OK
Content-Type:application/xml

<SendFileResponse>
        <RequestId>E69EF3CC-94CD-42E7-8926-F133B86387C0</RequestId>
        <InvokeId>f-7d2a745b412b46****</InvokeId>
</SendFileResponse>

JSON formatı

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "E69EF3CC-94CD-42E7-8926-F133B86387C0",
  "InvokeId" : "f-7d2a745b412b46****"
}

Hata kodları

HTTP durum kodu	Hata kodu	Hata mesajı	Açıklama
400	RegionId.ApiNotSupported	The api is not supported in this region.	Bu işlem belirtilen bölgede gerçekleştirilemez. Bölge kimliğinin geçerli olup olmadığını kontrol edin.
400	MissingParam.InstanceId	The parameter instanceId is missing or empty.	InstanceId.N gereklidir.
400	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key gereklidir.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Belirtilen etiket anahtarı zaten var. Etiket anahtarları benzersiz olmalıdır.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.	Geçersiz Tag.N.Key değeri.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.	Geçersiz Tag.N.Value değeri.
403	FileSize.ExceedLimit	The length of file content exceeds limit.	Maksimum dosya içeriği uzunluğu aşıldı.
403	FileName.ExceedLimit	The length of file name exceeds limit.	Maksimum dosya adı uzunluğu aşıldı.
403	FileDesc.ExceedLimit	The length of file description exceeds limit.	Maksimum dosya açıklaması uzunluğu aşıldı.
403	FileTargetDir.Invalid	The target directory of file is invalid.	Geçersiz TargetDir değeri.
403	InstanceIds.ExceedLimit	The number of instance IDs exceeds the upper limit.	Maksimum örnek kimliği sayısı aşıldı.
403	FileMode.Invalid	The mode of file is invalid.	Geçersiz FileMode değeri.
403	FileContent.DecodeError	The Content can not be base64 decoded.	Dosya içeriği Base64 ile çözümlenemiyor.
403	FileContentType.Invalid	The ContentType of file is invalid.	Geçersiz ContentType değeri.
403	Operation.Forbidden	The operation is not permitted.	İşlem desteklenmiyor.
404	InvalidInstance.NotFound	The specified instances not found.	Belirtilen örnekler bulunamadı.
404	InvalidResourceGroup.NotFound	The ResourceGroup provided does not exist in our records.	Kaynak grubu kimliği bulunamadı.
500	InternalError.Dispatch	An error occurred when you dispatched the request.	İstek gönderilirken bir hata oluştu. Daha sonra tekrar deneyin.

Hata kodlarının listesi için bkz. Hizmet hata kodları.