全部產品
Search
文件中心

Platform For AI:DescribeSendFileResults - 查詢下發檔案清單及狀態

更新時間:Dec 21, 2025

查詢營運助手下發檔案清單及狀態。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

eflo:DescribeSendFileResults

get

*Node

acs:eflo:{#regionId}:{#accountId}:node/*

請求參數

名稱

類型

必填

描述

樣本值

InvokeId

string

命令執行 ID。

t-bj038i0d6r8zoqo

NodeId

string

節點 ID

e01-cn-zvp2tgykr08

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

Id of the request

4FD06DF0-9167-5C6F-A145-F30CA4A15D54

TotalCount

string

命令總個數。

1

Invocations

object

檔案下發記錄。

Invocation

array<object>

命令執行 ID。

array<object>

FileMode

string

檔案的許可權。

0644

Overwrite

boolean

如果同名檔案在目標目錄已存在,是否覆蓋檔案。

  • true:覆蓋。

  • false:不覆蓋。

預設值為 false。

true

InvocationStatus

string

檔案的總下髮狀態。總狀態取決於本次下發的全部執行個體的共同執行狀態,可能值:

  • Pending:系統正在校正或下發檔案。存在至少一台執行個體的檔案下髮狀態為 Pending,則總執行狀態為 Pending。

  • Running:正在執行個體上下發檔案。存在至少一台執行個體的檔案下髮狀態為 Running,則總執行狀態為 Running。

  • Success:各個執行個體上的檔案下髮狀態均為 Success,則總執行狀態為 Success。

  • Failed:各個執行個體上的檔案下髮狀態均為 Failed,則總執行狀態為 Failed。執行個體上的檔案下髮狀態一項或多項為以下狀態時,傳回值均為 Failed 狀態:
    • 指定檔案參數有誤,校正失敗(Invalid)。

    • 向執行個體下發檔案失敗(Aborted)。

    • 檔案在執行個體內建立失敗(Failed)。

    • 下發檔案逾時(Timeout)。

    • 下發檔案時發生異常無法繼續(Error)。

  • PartialFailed:部分執行個體檔案下發成功且部分執行個體下發失敗。各個執行個體的檔案下髮狀態均為 Success 或 Failed,則總執行狀態為 PartialFailed。

Pending

Description

string

命令描述。

描述資訊。

ContentType

string

檔案內容類型。

PlainText:普通文本。 Base64:Base 64 編碼。 預設值為 PlainText。

PlainText

NodeCount

integer

節點數量

3

TargetDir

string

目標路徑。

/home/user

FileGroup

string

檔案的使用者組。

root

FileOwner

string

檔案的使用者。

root

Name

string

檔案下發名稱

test

Content

string

命令執行後的輸出資訊。

若 ContentEncoding 指定 PlainText,返回原始輸出資訊。 若 ContentEncoding 指定 Base64,返回 Base 64 編碼後的輸出資訊。

Base64

CreationTime

string

下發建立時間

2023-04-10T10:53:46.156+08:00

InvokeNodes

object

檔案下發記錄

InvokeNode

array<object>

節點檔案下發記錄

object

InvocationStatus

string

單台執行個體下發任務的狀態,可能值:

  • Pending:系統正在校正或下發檔案。

  • Invalid:指定檔案參數有誤,校正失敗。

  • Running:正在執行個體上下發檔案。

  • Aborted:向執行個體下發檔案失敗。

  • Success:檔案下發完成。

  • Failed:檔案在執行個體內建立失敗。

  • Error:下發檔案時發生異常無法繼續。

  • Timeout:下發檔案逾時。

Success

FinishTime

string

結束時間,格式:"2020-05-22T17:04:18"。

2023-04-10T10:53:46.156+08:00

NodeId

string

節點 id

e01-cn-9lb3c15m81j

ErrorInfo

string

命令的下發失敗或執行失敗原因的詳情,可能值:

  • 空:命令執行正常。

  • the specified instance does not exists:指定的執行個體不存在或已釋放。

  • the node has released when create task:執行命令期間,該執行個體被釋放。

  • the node is not running when create task:命令執行時,該執行個體不在運行中。

  • the command is not applicable:命令不適用於指定的執行個體。

  • the specified account does not exists:指定的帳號不存在。

  • the specified directory does not exists:指定的目錄不存在。

  • the cron job expression is invalid:指定的執行時間運算式不合法。

  • the aliyun service is not running on the instance:雲助手 Agent 未運行。

  • the aliyun service in the instance does not response:雲助手 Agent 無響應。

  • the aliyun service in the node is upgrading now:雲助手 Agent 正在升級中。

  • the aliyun service in the node need upgrade:雲助手 Agent 需要升級。

  • the command delivery has been timeout:發送命令逾時。

  • the command execution has been timeout:命令執行逾時。

  • the command execution got an exception:命令執行發生異常。

  • the command execution has been interrupted:命令執行被中斷。

  • the command execution exit code is not zero:命令執行結束,退出碼非 0。

  • the specified instance has been released:下發檔案期間,該執行個體被釋放。

the specified instance does not exists

CreationTime

string

檔案下發任務的建立時間。

2023-02-06T07:12:50Z

StartTime

string

開始時間

2023-03-30T16:00:00Z

UpdateTime

string

更新時間

2023-03-30T16:00:00Z

ErrorCode

string

檔案下發的失敗原因代碼。可能值:

空:檔案下發正常。 NodeNotExists:指定的執行個體不存在或已釋放。 NodeReleased:下發檔案期間,該執行個體被釋放。 NodeNotRunning:建立下發檔案任務時,該執行個體不在運行中。 AccountNotExists:指定的帳號不存在。 ClientNotRunning:雲助手 Agent 未運行。 ClientNotResponse:雲助手 Agent 無響應。 ClientIsUpgrading:雲助手 Agent 正在升級中。 ClientNeedUpgrade:雲助手 Agent 需要升級。 DeliveryTimeout:傳送檔案逾時。 FileCreateFail:檔案建立失敗。 FileAlreadyExists:相同路徑下存在同名檔案。 FileContentInvalid:檔案內容不合法。 FileNameInvalid:檔案名稱不合法。 FilePathInvalid:檔案路徑不合法。 FileAuthorityInvalid:檔案許可權不合法。 UserGroupNotExists:傳送檔案時指定的使用者組不存在。

AccountNotExists

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4FD06DF0-9167-5C6F-A145-F30CA4A15D54",
  "TotalCount": "1",
  "Invocations": {
    "Invocation": [
      {
        "FileMode": "0644",
        "Overwrite": true,
        "InvocationStatus": "Pending",
        "Description": "描述資訊。",
        "ContentType": "PlainText",
        "NodeCount": 3,
        "TargetDir": "\t/home/user",
        "FileGroup": "root",
        "FileOwner": "root",
        "Name": "test",
        "Content": "Base64",
        "CreationTime": "2023-04-10T10:53:46.156+08:00\n",
        "InvokeNodes": {
          "InvokeNode": [
            {
              "InvocationStatus": "Success",
              "FinishTime": "2023-04-10T10:53:46.156+08:00",
              "NodeId": "e01-cn-9lb3c15m81j",
              "ErrorInfo": "the specified instance does not exists",
              "CreationTime": "2023-02-06T07:12:50Z",
              "StartTime": "2023-03-30T16:00:00Z",
              "UpdateTime": "2023-03-30T16:00:00Z",
              "ErrorCode": "AccountNotExists"
            }
          ]
        }
      }
    ]
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情