DescribeSendFileResults - - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Bir dosya gönderdiğinizde, dosyanın belirtilen Elastic Compute Service (ECS) örneklerine gönderilmesi başarısız olabilir. Dosya gönderme sonuçlarını kontrol etmek için bu işlemi çağırabilirsiniz.
Son altı hafta içindeki dosya gönderme kayıtlarını sorgulamak için bu işlemi çağırabilirsiniz.

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	Zorunlu	Örnek	Açıklama
Action	String	Evet	DescribeSendFileResults	Gerçekleştirmek istediğiniz işlem. Değeri DescribeSendFileResults olarak ayarlayın.
RegionId	String	Evet	cn-hangzhou	ECS örneğinin bölge kimliği. En güncel bölge listesini sorgulamak için DescribeRegions işlemini çağırabilirsiniz.
ResourceGroupId	String	Hayır	rg-bp67acfmxazb4p****	Kaynak grubunun kimliği. Bu parametreyi ayarladığınızda belirtilen kaynak grubundaki dosya gönderme sonuçları sorgulanır.
InvokeId	String	Hayır	f-hz0jdfwd9f****	Dosya gönderme görevinin kimliği.
Name	String	Hayır	test.txt	Gönderim kayıtlarını sorgulamak istediğiniz dosyanın adı.
InstanceId	String	Hayır	i-hz0jdfwd9f****	Dosya gönderme kayıtlarını sorgulamak istediğiniz örneğin kimliği.
PageNumber	Long	Hayır	1	Sayfa numarası. Sayfalar 1'den başlar. Varsayılan değer: 1.
PageSize	Long	Hayır	10	Sayfa başına kayıt sayısı. Geçerli değerler: 1 ile 50 arasında. Varsayılan değer: 10.
InvocationStatus	String	Hayır	Success	Dosyanın genel gönderim durumu. Dosyanın genel gönderim durumu tüm hedef örneklerdeki dosya gönderim durumlarına göre değişir. Geçerli değerler: Pending: Dosya doğrulanıyor veya gönderiliyor. Bir veya daha fazla örnekte dosyanın gönderim durumu Pending ise dosyanın genel gönderim durumu Pending olur. Running: Dosya gönderiliyor. Bir veya daha fazla örnekte dosyanın gönderim durumu Running ise dosyanın genel gönderim durumu Running olur. Success: Dosya gönderildi. Tüm örneklerde dosyanın gönderim durumu Success ise dosyanın genel gönderim durumu Success olur. Failed: Dosya gönderilemedi. Tüm örneklerde dosyanın gönderim durumu Failed ise dosyanın genel gönderim durumu Failed olur. PartialFailed: Dosya bazı örneklere gönderildi ancak diğerlerine gönderilemedi. Bazı örneklerde dosyanın gönderim durumu Success, diğerlerinde Failed ise dosyanın genel gönderim durumu PartialFailed olur.
Tag.N.Key	String	Hayır	TestKey	N. dosya gönderme görevi etiketinin anahtarı. N için geçerli değerler: 1 ila 20. Etiket anahtarı boş bir dize olamaz. Kaynakları sorgulamak için tek bir etiket belirtildiğinde yanıtta bu etiket eklenmiş en fazla 1.000 kaynak görüntülenebilir. Kaynakları sorgulamak için birden çok etiket belirtildiğinde 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 işlemini ç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	N. dosya gönderme görevi etiketinin değeri. N için geçerli değerler: 1 ila 20. Etiket değeri boş bir dize olabilir. Uzunluğu en fazla 128 karakter olabilir ve `http://` veya `https://` içeremez.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
PageSize	Long	10	Sayfa başına kayıt sayısı.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	İsteğin kimliği.
PageNumber	Long	1	Sayfa numarası.
TotalCount	Long	2	Döndürülen toplam dosya gönderme görevi sayısı.
Invocations	Array of Invocation		Dosya gönderme kayıtları.
Invocation
CreationTime	String	2019-12-20T06:15:54Z	Dosya gönderme görevinin oluşturulduğu zaman.
InvocationStatus	String	Success	Dosyanın genel gönderim durumu. Dosyanın genel gönderim durumu tüm hedef örneklerdeki dosya gönderim durumlarına göre değişir. Geçerli değerler: Pending: Dosya doğrulanıyor veya gönderiliyordu. Bir veya daha fazla örnekte dosyanın gönderim durumu Pending ise dosyanın genel gönderim durumu Pending olur. Running: Dosya gönderiliyordu. Bir veya daha fazla örnekte dosyanın gönderim durumu Running ise dosyanın genel gönderim durumu Running olur. Success: Dosya gönderildi. Tüm örneklerde dosyanın gönderim durumu Success ise dosyanın genel gönderim durumu Success olur. Failed: Dosya gönderilemedi. Tüm örneklerde dosyanın gönderim durumu Failed ise dosyanın genel gönderim durumu Failed olur. Bir veya daha fazla örnekte dosyanın gönderim durumu aşağıdaki değerlerden biri ise dosyanın genel gönderim durumu Failed olur: Invalid: Dosya geçersiz. Aborted: Dosya örneklere gönderilemedi. Failed: Dosya örneklerde oluşturulamadı. Timeout: Dosya gönderme görevi zaman aşımına uğradı. Error: Bir hata oluştu ve dosya gönderme görevi kesintiye uğradı. PartialFailed: Dosya bazı örneklere gönderildi ancak diğerlerine gönderilemedi. Bazı örneklerde dosyanın gönderim durumu Success, diğerlerinde Failed ise dosyanın genel gönderim durumu PartialFailed olur.
ContentType	String	PlainText	Dosya içeriğinin türü. Geçerli değerler: PlainText: Dosya içeriği düz metindir. Base64: Dosya içeriği Base64 kodlamalıdır.
TargetDir	String	/home/user	Hedef dizin.
FileOwner	String	test	Dosyanın sahibi.
Description	String	This is a test file.	Dosyanın açıklaması.
VmCount	Integer	1	Hedef örneklerin sayısı.
FileMode	String	777	Dosya üzerindeki izinler.
FileGroup	String	test	Dosyanın kullanıcı grubu.
InvokeId	String	f-hz0jdfwd9f****	Dosya gönderme görevinin kimliği.
Name	String	test.txt	Dosyanın adı.
Content	String	#!/bin/bash echo "Current User is :" echo $(ps \| grep "$$" \| awk '{print $2}')	Dosyanın içeriği.
Overwrite	String	false	Hedef dizinde gönderilen dosya ile aynı ada sahip bir dosya olup olmadığının ve üzerine yazılıp yazılmayacağının belirtilmesi.
InvokeInstances	Array of InvokeInstance		Hedef örnekler.
InvokeInstance
CreationTime	String	2019-12-20T06:15:54Z	Dosya gönderme görevinin oluşturulduğu zaman.
StartTime	String	2019-12-20T06:15:54Z	Dosya gönderme görevinin örnekte çalıştırılmaya başlandığı zaman.
InvocationStatus	String	Success	Dosya gönderme görevinin durumu. Geçerli değerler: Pending: Dosya doğrulanıyor veya gönderiliyordu. Invalid: Dosya geçersizdi. Running: Dosya gönderiliyordu. Aborted: Dosya gönderilemedi. Success: Dosya gönderildi. Failed: Dosya örnekte oluşturulamadı. Error: Bir hata oluştu ve dosya gönderme görevi kesintiye uğradı. Timeout: Dosya gönderme görevi zaman aşımına uğradı.
FinishTime	String	2019-12-20T06:15:54Z	Dosya gönderme görevinin tamamlandığı zaman.
UpdateTime	String	2019-12-20T06:15:54Z	Dosya gönderme görevi durumunun güncellendiği zaman.
ErrorInfo	String	the instance is not running when create task	Dosya gönderilemediğinde veya dosya gönderme görevi çalıştırılamadığında döndürülen hata mesajı. Geçerli değerler: Null: Dosya örneğe gönderildi. the specified instance does not exists the specified instance has been released the instance is not running when create task the specified account does not exist the aliyun service is not running on the instance the aliyun service in the instance does not response the aliyun service in the instance is upgrading now the aliyun service in the instance need upgrade the command delivery has been timeout the file creation is failed due to unknown error the authority of file is invalid File content is empty the content of file is invalid File already exists File name is invalid File path is invalid Owner not exists Group not exists Mode is invalid
ErrorCode	String	InstanceNotExists	Dosya örneğe gönderilemediğinde döndürülen hata kodu. Geçerli değerler: Null: Dosya örneğe gönderildi. InstanceNotExists: Örnek mevcut değildi veya serbest bırakıldı. InstanceReleased: Dosya gönderilirken örnek serbest bırakıldı. InstanceNotRunning: Dosya gönderme görevi oluşturulurken örnek çalışmıyordu. AccountNotExists: Belirtilen hesap mevcut değildi. ClientNotRunning: Cloud Assistant Agent çalışmıyordu. ClientNotResponse: Cloud Assistant Agent yanıt vermedi. ClientIsUpgrading: Cloud Assistant Agent yükseltiliyordu. ClientNeedUpgrade: Cloud Assistant Agent'in yükseltilmesi gerekiyordu. DeliveryTimeout: Dosya gönderme görevi zaman aşımına uğradı. FileCreateFail: Dosya oluşturulamadı. FileAlreadyExists: Belirtilen dizinde aynı ada sahip bir dosya zaten mevcuttu. FileContentInvalid: Dosya içeriği geçersizdi. FileNameInvalid: Dosya adı geçersizdi. FilePathInvalid: Belirtilen dizin geçersizdi. FileAuthorityInvalid: Belirtilen dosya izinleri geçersizdi. UserGroupNotExists: Belirtilen kullanıcı grubu mevcut değildi.
InstanceId	String	i-uf614fhehhz****	Örneğin kimliği.
Tags	Array of Tag		Dosya gönderme görevinin etiketleri.
Tag
TagKey	String	owner	Dosya gönderme görevinin etiket anahtarı.
TagValue	String	zhangsan	Dosya gönderme görevinin etiket değeri.

Örnekler

Örnek istekler

https://ecs.aliyuncs.com/?Action=DescribeSendFileResults
&RegionId=cn-hangzhou
&InvokeId=f-hz0vk9****
&Name=test.txt
&InstanceId=i-bp1hsglsw****
&PageNumber=1
&PageSize=10
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<DescribeSendFileResultsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <Invocations>
        <Invocation>
            <FileMode>0644</FileMode>
            <Overwrite>false</Overwrite>
            <InvocationStatus>Success</InvocationStatus>
            <Description>This is a test file.</Description>
            <ContentType>PlainText</ContentType>
            <VmCount>1</VmCount>
            <TargetDir>/home/user</TargetDir>
            <FileGroup>test</FileGroup>
            <FileOwner>test</FileOwner>
            <InvokeInstances>
                <InvokeInstance>
                    <InvocationStatus>Success</InvocationStatus>
                    <FinishTime>2020-09-11T08:30:55Z</FinishTime>
                    <InstanceId>i-bp1hsglsw****</InstanceId>
                    <ErrorInfo/>
                    <CreationTime>2020-09-11T08:30:55Z</CreationTime>
                    <StartTime>2020-09-11T08:30:55Z</StartTime>
                    <UpdateTime>2020-09-11T08:30:55Z</UpdateTime>
                    <ErrorCode/>
                </InvokeInstance>
            </InvokeInstances>
            <Name>test.txt</Name>
            <Content>ZWNobyBoZWxsbw==</Content>
            <CreationTime>2020-09-11T08:30:55Z</CreationTime>
            <InvokeId>f-hz0vk9****</InvokeId>
        </Invocation>
    </Invocations>
</DescribeSendFileResultsResponse>

JSON biçimi

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

{
  "TotalCount" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageSize" : 10,
  "PageNumber" : 1,
  "Invocations" : {
    "Invocation" : [ {
      "FileMode" : "0644",
      "Overwrite" : false,
      "InvocationStatus" : "Success",
      "Description" : "This is a test file.",
      "ContentType" : "PlainText",
      "VmCount" : 1,
      "TargetDir" : "/home/user",
      "FileGroup" : "test",
      "FileOwner" : "test",
      "InvokeInstances" : {
        "InvokeInstance" : [ {
          "InvocationStatus" : "Success",
          "FinishTime" : "2020-09-11T08:30:55Z",
          "InstanceId" : "i-bp1hsglsw****",
          "ErrorInfo" : "",
          "CreationTime" : "2020-09-11T08:30:55Z",
          "StartTime" : "2020-09-11T08:30:55Z",
          "UpdateTime" : "2020-09-11T08:30:55Z",
          "ErrorCode" : ""
        } ]
      },
      "Name" : "test.txt",
      "Content" : "ZWNobyBoZWxsbw==",
      "CreationTime" : "2020-09-11T08:30:55Z",
      "InvokeId" : "f-hz0vk9****"
    } ]
  }
}

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	MissingParameter.TagKey	You must specify Tag.N.Key.	Tag.N.Key gereklidir.
400	Duplicate.TagKey	The Tag.N.Key contain duplicate key.	Etiket anahtarı zaten mevcut. 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.
400	InvalidParam.PageNumber	The specified parameter is invalid.	Geçersiz PageNumber değeri.
400	InvalidParam.PageSize	The specified parameter is invalid.	Geçersiz PageSize değeri.
403	Operation.Forbidden	The operation is not permitted.	İşlem desteklenmiyor.
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ı.