範例：使用命令控制車輛轉向模式 (AWS CLI)

為轉向模式操作建立命令資源

使用 create-commandCLI 建立您要傳送到裝置的命令。在此範例中，指定：

aws iot create-command \ 
    --command-id TurnOffSteeringMode \ 
    --role-arn "arn:aws:iam:accountId:role/FwCommandExecutionRole" \
    --display-name "Turn off steering mode" \ 
    --namespace AWS-IoT-FleetWise \
    --mandatory-parameters '[
      {
        "name": "$actuatorPath.Vehicle.Chassis.SteeringWheel.TurnOffSteeringMode",
        "defaultValue": { "S": "true" }
      }
    ]'

下列輸出顯示來自 CLI 的範例回應，其中 ap-south-1和 123456789012是 AWS 區域 和 AWS 帳戶 ID 的範例。

{
    "commandId": "TurnOffSteeringMode",
    "commandArn": "arn:aws:iot:ap-south-1:123456789012:command/TurnOffSteeringMode"
}

如需使用此命令的其他範例，請參閱 建立命令資源。

擷取命令的相關資訊

執行下列命令來擷取命令的相關資訊，其中 command-id是從上方 create-command操作輸出中的命令 ID。

aws iot get-command --command-id TurnOffSteeringMode

執行此命令會產生下列回應。您將看到建立命令的時間、上次更新的時間、您指定的任何參數，以及命令是否可在裝置上執行。

{
    "commandId": "TurnOffSteeringMode",
    "commandArn": "arn:aws:iot:ap-south-1:123456789012:command/TurnOffSteeringMode",
    "namespace": "AWS-IoT-FleetWise",
    "mandatoryParameters":[
        {
            "name": "$actuatorPath.Vehicle.Chassis.SteeringWheel.TurnOffSteeringMode",
            "defaultValue": {"S": "true" }
        }
    ],
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "lastUpdatedAt": "2024-03-23T00:50:10.095000-07:00",
    "deprecated": false
}

如需使用此命令的其他範例，請參閱 擷取命令的相關資訊。

啟動命令執行

執行下列命令以開始執行命令，其中 command-arn是從get-command上方操作輸出中的命令 ARN。target-arn 是您執行命令的目標裝置的 ARN，例如 myVehicle。

在此範例中，由於您在建立命令時提供參數的預設值，因此 start-command-execution CLI 可以在執行命令時使用這些值。您也可以選擇在使用 CLI 時，透過為參數指定不同的值來覆寫預設值。

aws iot-data start-command-execution \    
    --command-arn arn:aws:iot:ap-south-1:123456789012:command/TurnOffSteeringMode \
    --target-arn arn:aws:iot:ap-south-1:123456789012:thing/myVehicle

執行此命令會傳回命令執行 ID。您可以使用此 ID 查詢命令執行狀態、詳細資訊和命令執行歷史記錄。

{
    "executionId": "07e4b780-7eca-4ffd-b772-b76358da5542"
}

如需使用 CLI 的其他範例，請參閱 傳送命令 (AWS CLI)。

擷取命令執行的相關資訊

執行下列命令，以擷取您在目標裝置上執行之命令的相關資訊。指定execution-id您從上方取得做為start-command-execution操作輸出的 ，以及 target-arn，這是您要鎖定之裝置的 ARN。

aws iot get-command-execution \    
    --execution-id <"07e4b780-7eca-4ffd-b772-b76358da5542"> \ 
    --target-arn arn:aws:iot:us-east-1:<account>:thing/myVehicle

執行此命令會傳回命令執行、執行狀態、開始執行的時間，以及完成時間的相關資訊。例如，以下回應顯示命令在目標裝置上成功執行，且轉向模式已關閉。

{
    "executionId": "07e4b780-7eca-4ffd-b772-b76358da5542",
    "commandArn": "arn:aws:iot:ap-south-1:123456789012:command/TurnOffSteeringMode",
    "targetArn": "arn:aws:iot:ap-south-1:123456789012:thing/myVehicle",
    "result": "SUCCEEDED",
     "statusReason": {
        "reasonCode": "65536",
        "reasonDescription": "SUCCESS"
    },
    "result": {
        "KeyName": {
            "S": "",
            "B": true,
            "BIN": null
        }
    },
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "completedAt": "2024-03-23T00:50:10.095000-07:00",
    "parameters": '{
         "$actuatorPath.Vehicle.Chassis.SteeringWheel.TurnOffSteeringMode":
         { "S": "true" }
    }' 
}

（選用） 棄用命令資源

執行下列命令以取代命令，其中 command-id是從get-command上方操作輸出中的命令 ID。

aws iot update-command \    
   --command-id TurnOffSteeringMode \    
   --deprecated

執行此命令會傳回輸出，顯示命令已棄用。您也可以使用 CLI 還原命令。

{
    "commandId": "TurnOffSteeringMode",
    "deprecated": true,
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00"
}

刪除 命令

執行下列命令來刪除由 指定的命令command-id。

aws iot delete-command --command-id TurnOffSteeringMode

如果刪除請求成功，您會看到 HTTP statusCode為 202 或 204，這取決於您是否將命令標記為棄用，以及何時棄用。如需詳細資訊和範例，請參閱 刪除命令資源。

您可以使用 get-command CLI 來驗證命令是否已從您的帳戶中移除。

（選用） 刪除命令執行

根據預設，所有命令執行都會在您建立後的六個月內刪除。您可以使用 GetCommandExecution API 中的 timeToLive 參數來檢視此資訊。

或者，如果您的命令執行變成終端機，例如當您的執行狀態為 SUCCEEDED、 FAILED或 之一時REJECTED，您可以刪除命令執行。執行下列命令來刪除執行，其中 execution-id是上述get-command-execution操作輸出中的執行 ID。

aws iot delete-command-execution \ 
            --execution-id "07e4b780-7eca-4ffd-b772-b76358da5542"

您可以使用 get-command-execution CLI 來驗證命令執行是否已從您的帳戶中移除。