ListExecutions - AWS Transfer Family
請求語法請求參數回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

ListExecutions

列出指定工作流程的所有進行中執行。

注意

如果找不到指定的工作流程 ID， ListExecutions會傳回ResourceNotFound例外狀況。

請求語法

{
   "MaxResults": number,
   "NextToken": "string",
   "WorkflowId": "string"
}

請求參數

如需所有動作的一般參數資訊，請參閱《Common Parameters》。

請求接受下列JSON格式的資料。

MaxResults

指定要傳回的執行數目上限。

類型：整數

有效範圍：最小值為 1。最大值為 1000。

必要：否

NextToken

ListExecutions 會在輸出中傳回 NextToken 參數。然後，您可以在後續命令中傳遞 NextToken 參數，以繼續列出其他執行。

例如，這對於分頁非常有用。如果您有 100 個工作流程的執行，您可能只想列出前 10 個。如果是這樣，請指定 API 來呼叫 max-results：

aws transfer list-executions --max-results 10

這會將前 10 個執行的詳細資訊，以及指標 （NextToken） 傳回第十一個執行。您現在可以API再次呼叫 ，並提供您收到NextToken的值：

aws transfer list-executions --max-results 10 --next-token $somePointerReturnedFromPreviousListResult

此呼叫會傳回接下來的 10 個執行，即 11 號到 20 號。然後，您可以重複呼叫，直到所有 100 個執行的詳細資訊都傳回為止。

類型：字串

長度限制：長度下限為 1。長度上限為 6144。

必要：否

WorkflowId

工作流程的唯一識別碼。

類型：字串

長度限制條件：固定長度為 19。

模式：w-([a-z0-9]{17})

必要：是

回應語法

{
   "Executions": [ 
      { 
         "ExecutionId": "string",
         "InitialFileLocation": { 
            "EfsFileLocation": { 
               "FileSystemId": "string",
               "Path": "string"
            },
            "S3FileLocation": { 
               "Bucket": "string",
               "Etag": "string",
               "Key": "string",
               "VersionId": "string"
            }
         },
         "ServiceMetadata": { 
            "UserDetails": { 
               "ServerId": "string",
               "SessionId": "string",
               "UserName": "string"
            }
         },
         "Status": "string"
      }
   ],
   "NextToken": "string",
   "WorkflowId": "string"
}

回應元素

如果動作成功，服務會傳回 HTTP 200 個回應。

服務會以 JSON 格式傳回下列資料。

Executions

傳回ListedExecution陣列中每個執行的詳細資訊。

類型：ListedExecution 物件陣列

NextToken

ListExecutions 會在輸出中傳回 NextToken 參數。然後，您可以在後續命令中傳遞 NextToken 參數，以繼續列出其他執行。

類型：字串

長度限制：長度下限為 1。長度上限為 6144。

WorkflowId

工作流程的唯一識別碼。

類型：字串

長度限制條件：固定長度為 19。

模式：w-([a-z0-9]{17})

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

InternalServiceError

當 AWS Transfer Family 服務發生錯誤時，就會擲回此例外狀況。

HTTP 狀態碼：500

InvalidNextTokenException

傳遞的NextToken參數無效。

HTTP 狀態碼：400

InvalidRequestException

當用戶端提交格式錯誤的請求時，就會擲回此例外狀況。

HTTP 狀態碼：400

ResourceNotFoundException

當 AWS Transfer Family 服務找不到資源時，就會擲回此例外狀況。

HTTP 狀態碼：400

ServiceUnavailableException

請求失敗，因為 AWS Transfer Family 服務無法使用。

HTTP 狀態碼：500

另請參閱

如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：