日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

DescribeSendFileResults - 查詢云助手下發文件列表及狀態

調用DescribeSendFileResults查詢云助手下發文件列表及狀態。

接口說明:

  • 當您下發文件后,不代表文件一定成功下發。您需要通過接口返回值查看實際下發結果,并以實際輸出結果為準。
  • 您可以查詢最近 6 周的下發記錄。
  • 分頁查詢首頁時,僅需設置MaxResults以限制返回信息的條目數,返回結果中的NextToken將作為查詢后續頁的憑證。查詢后續頁時,將NextToken參數設置為上一次返回結果中獲取到的NextToken作為查詢憑證,并設置MaxResults限制返回條目數。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀?。≧ead)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
ecs:DescribeSendFileResultsget
*Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

請求參數

名稱類型必填描述示例值
RegionIdstring

ECS 實例所在的地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
ResourceGroupIdstring

文件下發的資源組 ID。傳入該參數后,需要在下發文件時指定 ResourceGroupId,支持篩選出對應的文件下發結果。

rg-bp67acfmxazb4p****
InvokeIdstring

執行 ID。

f-hz0jdfwd9f****
Namestring

文件名稱。傳入該參數后,將查詢該名稱文件的所有的下發記錄。

test.txt
InstanceIdstring

實例 ID。傳入該參數后,將查詢該實例所有的文件下發記錄。

i-hz0jdfwd9f****
PageNumberlong
說明 該參數即將下線,推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。
1
PageSizelong
說明 該參數即將下線,推薦您使用 NextToken 與 MaxResults 完成分頁查詢操作。
10
MaxResultsinteger

分頁查詢時每頁的最大條目數。

最大值為 50。

默認值為 10。

10
NextTokenstring

查詢憑證(Token),取值為上一次 API 調用返回的 NextToken 參數值。

AAAAAdDWBF2
InvocationStatusstring

文件的總下發狀態。總狀態取決于本次下發的全部實例的共同執行狀態,取值范圍:

  • Pending:系統正在校驗或下發文件。存在至少一臺實例的文件下發狀態為 Pending,則總執行狀態為 Pending。
  • Running:正在實例上下發文件。存在至少一臺實例的文件下發狀態為 Running,則總執行狀態為 Running。
  • Success:下發成功。各個實例上的文件下發狀態均為 Success,則總執行狀態為 Success。
  • Failed:下發失敗。各個實例上的文件下發狀態均為 Failed,則總執行狀態為 Failed。
  • PartialFailed:部分實例文件下發成功且部分實例下發失敗。各個實例的文件下發狀態均為 Success 或 Failed,則總執行狀態為 PartialFailed。
Success
Tagarray<object>

標簽列表。

object

標簽列表。

Keystring

文件下發的標簽鍵。N 的取值范圍為 1~20。一旦傳入該值,則不允許為空字符串。

使用一個標簽過濾資源,查詢到該標簽下的資源數量不能超過 1000 個。使用多個標簽過濾資源,查詢到同時綁定了多個標簽的資源數量不能超過 1000 個。如果資源數量超過 1000 個,您需要使用 ListTagResources 接口進行查詢。

最多支持 64 個字符,不能以aliyunacs:開頭,不能包含http://https://。

TestKey
Valuestring

文件下發的標簽值。N 的取值范圍為 1~20。該值可以為空字符串。

最多支持 128 個字符,不能包含http://https://。

TestValue

返回參數

名稱類型描述示例值
object
PageSizelong

每頁行數。

10
RequestIdstring

請求 ID。

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

查詢結果的當前頁碼。

1
TotalCountlong

腳本總個數。

2
NextTokenstring

本次調用返回的查詢憑證值。

AAAAAdDWBF2
Invocationsarray<object>

文件下發記錄。

Invocationobject
CreationTimestring

文件下發任務創建時間。

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

文件的總下發狀態。總狀態取決于本次下發的全部實例的共同執行狀態,可能值:

  • Pending:系統正在校驗或下發文件。存在至少一臺實例的文件下發狀態為 Pending,則總執行狀態為 Pending。
  • Running:正在實例上下發文件。存在至少一臺實例的文件下發狀態為 Running,則總執行狀態為 Running。
  • Success:各個實例上的文件下發狀態均為 Success,則總執行狀態為 Success。
  • Failed:各個實例上的文件下發狀態均為 Failed,則總執行狀態為 Failed。實例上的文件下發狀態一項或多項為以下狀態時,返回值均為 Failed 狀態:
    • 指定文件參數有誤,校驗失敗(Invalid)。
    • 向實例下發文件失?。ˋborted)。
    • 文件在實例內創建失敗(Failed)。
    • 下發文件超時(Timeout)。
    • 下發文件時發生異常無法繼續(Error)。
  • PartialFailed:部分實例文件下發成功且部分實例下發失敗。各個實例的文件下發狀態均為 Success 或 Failed,則總執行狀態為 PartialFailed。
Success
ContentTypestring

文件內容類型。可能值:

  • PlainText:普通文本。
  • Base64:Base64 編碼。
PlainText
TargetDirstring

目標路徑。

/home/user
FileOwnerstring

文件的用戶。

test
Descriptionstring

描述信息。

This is a test file.
VmCountinteger

下發實例的數量。

1
FileModestring

文件的權限。

777
FileGroupstring

文件的用戶組。

test
InvokeIdstring

執行 ID。

f-hz0jdfwd9f****
Namestring

文件名稱。

test.txt
Contentstring

文件內容。

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

是否允許覆蓋。

false
InvokeInstancesarray<object>

下發文件目標實例集類型。

InvokeInstanceobject
CreationTimestring

文件下發任務的創建時間。

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

下發任務在實例中開始執行的時間。

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

單臺實例下發任務的狀態,可能值:

  • Pending:系統正在校驗或下發文件。
  • Invalid:指定文件參數有誤,校驗失敗。
  • Running:正在實例上下發文件。
  • Aborted:向實例下發文件失敗。
  • Success:文件下發完成。
  • Failed:文件在實例內創建失敗。
  • Error:下發文件時發生異常無法繼續。
  • Timeout:下發文件超時。
Success
FinishTimestring

下發任務的結束時間。

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

任務狀態的更新時間。

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

文件下發的失敗或執行失敗原因詳情??赡苤担?/p>

  • 空:文件下發正常。
  • 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 exists:指定的賬號不存在。
  • 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 instance is upgrading now:云助手 Agent 正在升級中。
  • the aliyun service in the instance need upgrade:云助手 Agent 需要升級。
  • 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:文件權限設置不合法。
the instance is not running when create task
ErrorCodestring

文件下發的失敗原因代碼。可能值:

  • 空:文件下發正常。
  • InstanceNotExists:指定的實例不存在或已釋放。
  • InstanceReleased:下發文件期間,該實例被釋放。
  • InstanceNotRunning:創建下發文件任務時,該實例不在運行中。
  • AccountNotExists:指定的賬號不存在。
  • ClientNotRunning:云助手 Agent 未運行。
  • ClientNotResponse:云助手 Agent 無響應。
  • ClientIsUpgrading:云助手 Agent 正在升級中。
  • ClientNeedUpgrade:云助手 Agent 需要升級。
  • DeliveryTimeout:發送文件超時。
  • FileCreateFail:文件創建失敗。
  • FileAlreadyExists:相同路徑下存在同名文件。
  • FileContentInvalid:文件內容不合法。
  • FileNameInvalid:文件名不合法。
  • FilePathInvalid:文件路徑不合法。
  • FileAuthorityInvalid:文件權限不合法。
  • UserGroupNotExists:發送文件時指定的用戶組不存在。
InstanceNotExists
InstanceIdstring

實例 ID。

i-uf614fhehhz****
Tagsarray<object>

文件下發的標簽信息。

Tagobject

文件下發的標簽信息。

TagKeystring

文件下發的標簽鍵。

owner
TagValuestring

文件下發的標簽值。

zhangsan

示例

正常返回示例

JSON格式

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

錯誤碼

HTTP status code錯誤碼錯誤信息描述
400RegionId.ApiNotSupportedThe api is not supported in this region.指定地域下不支持調用 API。請檢查 RegionId 參數取值是否正確。
400NumberExceed.TagsThe Tags parameter number is exceed.標簽個數超過最大限制。
400MissingParameter.TagKeyYou must specify Tag.N.Key.請指定標簽鍵。
400Duplicate.TagKeyThe Tag.N.Key contain duplicate key.標簽中存在重復的鍵,請保持鍵的唯一性。
400InvalidTagKey.MalformedThe specified Tag.n.Key is not valid.指定的標簽鍵參數有誤。
400InvalidTagValue.MalformedThe specified Tag.n.Value is not valid.指定的標簽值參數有誤。
400InvalidParam.PageNumberThe specified parameter is invalid.指定的 PageNumber 參數無效。
400InvalidParam.PageSizeThe specified parameter is invalid.指定的 PageSize 參數無效。
400InvalidParameter.NextTokenThe specified parameter NextToken is not valid.指定的參數NextToken不合法。
400InvalidParameter.MaxResultsThe specified parameter MaxResults is not valid.指定的參數MaxResults不合法。
403Operation.ForbiddenThe operation is not permitted.該操作是不被允許的。
404InvalidRegionId.NotFoundThe RegionId provided does not exist in our records.提供的RegionId不存在
500InternalError.DispatchAn error occurred when you dispatched the request.發送請求時發生錯誤,請稍后重試。

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

變更歷史

變更時間變更內容概要操作
2024-12-05OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更查看變更詳情
2023-12-21OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更、OpenAPI 返回結構發生變更查看變更詳情
2023-09-19OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更查看變更詳情
2023-05-12OpenAPI 錯誤碼發生變更查看變更詳情
2022-02-25OpenAPI 錯誤碼發生變更查看變更詳情