All Products
Search

This Product

    Elastic Compute Service:DescribeSendFileResults

    Document Center

    Elastic Compute Service:DescribeSendFileResults

    Last Updated:Sep 20, 2026

    Mengkueri daftar dan status file yang dikirim oleh Asisten Cloud.

    Deskripsi operasi

    Deskripsi operasi:

    • Setelah Anda mengirim file, file tersebut belum tentu terkirim. Anda harus memeriksa hasil pengiriman aktual berdasarkan Nilai kembali operasi ini. Output aktual yang berlaku.

    • Anda dapat mengkueri informasi eksekusi dari satu hari terakhir. Maksimal 1.000 entri informasi eksekusi dapat disimpan.

    • Saat melakukan kueri halaman pertama hasil, tetapkan hanya MaxResults untuk membatasi jumlah entri yang dikembalikan. Nilai NextToken yang dikembalikan dalam hasil berfungsi sebagai token untuk mengkueri halaman berikutnya. Saat melakukan kueri halaman berikutnya, tetapkan NextToken ke nilai yang diperoleh dari tanggapan sebelumnya dan tetapkan MaxResults untuk membatasi jumlah entri yang dikembalikan.

    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:DescribeSendFileResults

    get

    Instance.

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

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah Instans ECS. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

    cn-hangzhou
    ResourceGroupId

    string

    No

    ID kelompok sumber daya tempat tugas pengiriman file berada. Setelah Anda menentukan parameter ini, Anda juga harus menentukan ResourceGroupId saat mengirim file. Parameter ini memungkinkan Anda memfilter hasil pengiriman file berdasarkan kelompok sumber daya.

    rg-bp67acfmxazb4p****
    InvokeId

    string

    No

    ID eksekusi.

    f-hz0jdfwd9f****
    Name

    string

    No

    Nama file. Jika Anda menentukan parameter ini, semua catatan pengiriman file dengan nama yang ditentukan akan dikueri.

    test.txt
    InstanceId

    string

    No

    ID instans. Jika Anda menentukan parameter ini, semua catatan pengiriman file dari instans yang ditentukan akan dikueri.

    i-hz0jdfwd9f****
    PageNumber

    integer

    No

    Catatan

    Parameter ini akan segera tidak digunakan lagi. Gunakan NextToken dan MaxResults untuk melakukan kueri halaman.

    1
    PageSize

    integer

    No

    Catatan

    Parameter ini akan segera tidak digunakan lagi. Gunakan NextToken dan MaxResults untuk melakukan kueri halaman.

    10
    MaxResults

    integer

    No

    Jumlah maksimum entri per halaman untuk kueri halaman.

    Nilai maksimum: 50.

    Nilai default: 10.

    10
    NextToken

    string

    No

    Token paginasi. Tetapkan parameter ini ke nilai NextToken yang dikembalikan dalam pemanggilan API sebelumnya.

    AAAAAdDWBF2
    InvocationStatus

    string

    No

    Status pengiriman keseluruhan file. Status keseluruhan bergantung pada status eksekusi umum dari semua instans target. Nilai valid:

    • Pending: Sistem sedang memverifikasi atau mengirim file. Status keseluruhan adalah Pending jika status pengiriman file setidaknya satu instans adalah Pending.

    • Running: File sedang dikirim pada instans. Status keseluruhan adalah Running jika status pengiriman file setidaknya satu instans adalah Running.

    • Success: File terkirim. Status keseluruhan adalah Success jika status pengiriman file semua instans adalah Success.

    • Failed: File gagal dikirim. Status keseluruhan adalah Failed jika status pengiriman file semua instans adalah Failed.

    • PartialFailed: File terkirim pada beberapa instans tetapi gagal pada instans lainnya. Status keseluruhan adalah PartialFailed jika status pengiriman file semua instans adalah Success atau Failed.

    Success
    Tag

    array<object>

    No

    Tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag tugas 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 yang ditentukan tidak boleh melebihi 1.000. Jika Anda menggunakan beberapa tag untuk memfilter sumber daya, jumlah sumber daya yang dilampirkan dengan semua tag yang ditentukan tidak boleh melebihi 1.000. Jika jumlah sumber daya melebihi 1.000, panggil operasi ListTagResources untuk mengkueri sumber daya.

    Panjang kunci tag dapat mencapai 64 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    TestKey
    Value

    string

    No

    Nilai tag tugas pengiriman file. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong.

    Panjang nilai tag dapat mencapai 128 karakter dan tidak boleh mengandung http:// atau https://.

    TestValue

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Invocations

    object

    Invocation

    array<object>

    Catatan pengiriman file.

    array<object>

    Content

    string

    Konten file.

    #!/bin/bash echo "Current User is :" echo $(ps | grep "$$" | awk '{print $2}')
    ContentType

    string

    Tipe konten file. Nilai valid:

    • PlainText: teks biasa.

    • Base64: pengodean Base64.

    PlainText
    CreationTime

    string

    Pengatur waktu saat tugas pengiriman file dibuat. Pengatur waktu ditampilkan dalam format ISO 8601 UTC.

    2019-12-20T06:15:54Z
    Description

    string

    Deskripsi.

    Ini adalah file uji
    FileGroup

    string

    Kelompok pengguna file.

    test
    FileMode

    string

    Izin pada file.

    777
    FileOwner

    string

    Pemilik file.

    test
    InvocationStatus

    string

    Status pengiriman keseluruhan file. Status keseluruhan bergantung pada status eksekusi umum dari semua instans target. Nilai valid:

    • Pending: Sistem sedang memverifikasi atau mengirim file. Status keseluruhan adalah Pending jika status pengiriman file setidaknya satu instans adalah Pending.

    • Running: File sedang dikirim pada instans. Status keseluruhan adalah Running jika status pengiriman file setidaknya satu instans adalah Running.

    • Success: Status keseluruhan adalah Success jika status pengiriman file semua instans adalah Success.

    • Failed: Status keseluruhan adalah Failed jika status pengiriman file semua instans adalah Failed. Nilai Failed dikembalikan jika satu atau lebih status berikut dikembalikan untuk instans:

      • Parameter file yang ditentukan tidak valid dan verifikasi gagal (Invalid).

      • File gagal dikirim ke instans (Aborted).

      • File gagal dibuat pada instans (Failed).

      • Pengiriman file melebihi batas waktu (Timeout).

      • Terjadi pengecualian selama pengiriman file dan tugas tidak dapat dilanjutkan (Error).

    • PartialFailed: File terkirim pada beberapa instans tetapi gagal pada instans lainnya. Status keseluruhan adalah PartialFailed jika status pengiriman file semua instans adalah Success atau Failed.

    Success
    InvokeId

    string

    ID eksekusi.

    f-hz0jdfwd9f****
    InvokeInstances

    object

    InvokeInstance

    array<object>

    Instans target untuk pengiriman file.

    object

    CreationTime

    string

    Pengatur waktu saat tugas pengiriman file dibuat. Pengatur waktu ditampilkan dalam format ISO 8601 UTC.

    2019-12-20T06:15:54Z
    ErrorCode

    string

    Kode kesalahan untuk kegagalan pengiriman file. Nilai valid:

    • Empty: File terkirim.

    • InstanceNotExists: Instans yang ditentukan tidak ada atau telah dilepas.

    • InstanceReleased: Instans dilepas selama pengiriman file.

    • InstanceNotRunning: Instans tidak dalam status Running saat tugas pengiriman file dibuat.

    • AccountNotExists: Akun yang ditentukan tidak ada.

    • ClientNotRunning: Agen Asisten Cloud tidak berjalan.

    • ClientNotResponse: Agen Asisten Cloud tidak merespons.

    • ClientIsUpgrading: Agen Asisten Cloud sedang ditingkatkan.

    • ClientNeedUpgrade: Agen Asisten Cloud perlu ditingkatkan.

    • DeliveryTimeout: Pengiriman file melebihi batas waktu.

    • FileCreateFail: File gagal dibuat.

    • FileAlreadyExists: File dengan nama yang sama sudah ada di jalur yang sama.

    • FileContentInvalid: Konten file tidak valid.

    • FileNameInvalid: Nama file tidak valid.

    • FilePathInvalid: Jalur file tidak valid.

    • FileAuthorityInvalid: Izin file tidak valid.

    • UserGroupNotExists: Kelompok pengguna yang ditentukan untuk pengiriman file tidak ada.

    InstanceNotExists
    ErrorInfo

    string

    Detail kegagalan pengiriman file atau kegagalan eksekusi. Nilai valid:

    • Empty: File terkirim.

    • the specified instance does not exists: Instans yang ditentukan tidak ada atau telah dilepas.

    • the specified instance has been released.: Instans dilepas selama pengiriman file.

    • the instance is not running when create task: Instans tidak dalam status Running saat tugas pengiriman file dibuat.

    • the specified account does not exists: Akun yang ditentukan tidak ada.

    • the aliyun service is not running on the instance: layanan aliyun tidak berjalan pada instans.

    • the aliyun service in the instance does not response: Agen Asisten Cloud tidak tanggapan.

    • the aliyun service in the instance is upgrading now: Agen Asisten Cloud sedang Peningkatan.

    • the aliyun service in the instance need upgrade: Agen Asisten Cloud perlu Peningkatan.

    • the command delivery has been timeout: Pengiriman file melebihi batas pengatur waktu.

    • the file creation is failed due to unknown error: File gagal dibuat.

    • the authority of file is invalid: Izin file tidak valid.

    • File content is empty: Konten file kosong.

    • the content of file is invalid: Konten file tidak valid.

    • File already exists: File dengan nama yang sama sudah ada di jalur yang sama.

    • File name is invalid: Nama file tidak valid.

    • File path is invalid: Jalur file tidak valid.

    • Owner not exists: Pengguna tidak ada.

    • Group not exists: Kelompok pengguna tidak ada.

    • Mode is invalid: Pengaturan izin file tidak valid.

    the Instans is not Berjalan when create Tugas
    FinishTime

    string

    Pengatur waktu saat tugas pengiriman selesai. Pengatur waktu ditampilkan dalam format ISO 8601 UTC.

    2019-12-20T06:15:54Z
    InstanceId

    string

    ID instans.

    i-uf614fhehhz****
    InvocationStatus

    string

    Status pengiriman file pada satu instans. Nilai valid:

    • Pending: Sistem sedang memverifikasi atau mengirim file.

    • Invalid: Parameter file yang ditentukan tidak valid dan verifikasi gagal.

    • Running: File sedang dikirim pada instans.

    • Aborted: File gagal dikirim ke instans.

    • Success: File terkirim.

    • Failed: File gagal dibuat pada instans.

    • Error: Terjadi pengecualian selama pengiriman file dan tugas tidak dapat dilanjutkan.

    • Timeout: Pengiriman file melebihi batas waktu.

    Success
    StartTime

    string

    Pengatur waktu saat tugas pengiriman mulai berjalan pada instans. Pengatur waktu ditampilkan dalam format ISO 8601 UTC.

    2019-12-20T06:15:54Z
    UpdateTime

    string

    Pengatur waktu saat status tugas diperbarui. Pengatur waktu ditampilkan dalam format ISO 8601 UTC.

    2019-12-20T06:15:54Z
    Name

    string

    Nama file.

    test.txt
    Overwrite

    string

    Apakah penimpaan diizinkan.

    false
    Tags

    object

    Tag

    array<object>

    Informasi tag tugas pengiriman file.

    object

    Informasi tag tugas pengiriman file.

    TagKey

    string

    Kunci tag tugas pengiriman file.

    Pemilik
    TagValue

    string

    Nilai tag tugas pengiriman file.

    zhangsan
    TargetDir

    string

    Jalur tujuan.

    /home/user
    VmCount

    integer

    Jumlah instans target.

    1
    NextToken

    string

    Token paginasi yang dikembalikan dalam pemanggilan ini.

    AAAAAdDWBF2
    PageNumber

    integer

    Nomor halaman dari hasil yang dikembalikan.

    1
    PageSize

    integer

    Jumlah entri per halaman.

    10
    RequestId

    string

    ID permintaan.

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    TotalCount

    integer

    Jumlah total skrip.

    2

    Contoh

    Respons sukses

    JSONformat

    {
  "Invocations": {
    "Invocation": [
      {
        "Content": "#!/bin/bash  echo \"Current User is :\"  echo $(ps | grep \"$$\" | awk '{print $2}')",
        "ContentType": "PlainText",
        "CreationTime": "2019-12-20T06:15:54Z",
        "Description": "Ini adalah file uji",
        "FileGroup": "test",
        "FileMode": "777",
        "FileOwner": "test",
        "InvocationStatus": "Success",
        "InvokeId": "f-hz0jdfwd9f****",
        "InvokeInstances": {
          "InvokeInstance": [
            {
              "CreationTime": "2019-12-20T06:15:54Z",
              "ErrorCode": "InstanceNotExists",
              "ErrorInfo": "Instans tidak dalam status Berjalan saat tugas dibuat",
              "FinishTime": "2019-12-20T06:15:54Z",
              "InstanceId": "i-uf614fhehhz****",
              "InvocationStatus": "Success",
              "StartTime": "2019-12-20T06:15:54Z",
              "UpdateTime": "2019-12-20T06:15:54Z"
            }
          ]
        },
        "Name": "test.txt",
        "Overwrite": "false",
        "Tags": {
          "Tag": [
            {
              "TagKey": "Pemilik",
              "TagValue": "zhangsan"
            }
          ]
        },
        "TargetDir": "/home/user",
        "VmCount": 1
      }
    ]
  },
  "NextToken": "AAAAAdDWBF2",
  "PageNumber": 1,
  "PageSize": 10,
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount": 2
}

    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 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 InvalidParam.PageNumber The specified parameter is invalid.
    400 InvalidParam.PageSize The specified parameter is invalid.
    400 InvalidParameter.NextToken The specified parameter NextToken is not valid.
    400 InvalidParameter.MaxResults The specified parameter MaxResults is not valid. Parameter MaxResults 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 Operation.Forbidden The operation is not permitted. Operasi tidak diizinkan.
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. RegionId yang ditentukan tidak ada. Periksa apakah produk tersedia di wilayah ini.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.