ListDeploymentJobs - AWS RoboMaker

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

ListDeploymentJobs

Esta acción ya no está disponible.

importante

Esta API ya no es compatible. Para más información, consulte la actualización del 2 de mayo de 2022 en la página Política de soporte.

Devuelve una lista de trabajos de implementación para una flota. Si lo desea, puede añadir filtros para recuperar trabajos de implementación específicos.

Sintaxis de la solicitud

POST /listDeploymentJobs HTTP/1.1 Content-type: application/json { "filters": [ { "name": "string", "values": [ "string" ] } ], "maxResults": number, "nextToken": "string" }

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

filters

Filtros opcionales para limitar los resultados.

Se admiten los nombres de filtro status y fleetName. Al filtrar, debe usar el valor completo del elemento filtrado. Puede usar hasta tres filtros, pero deben ser para un único elemento con el mismo nombre. Por ejemplo, si busca elementos con el estado InProgress o el estado Pending.

Tipo: matriz de objetos Filter

Miembros de la matriz: número fijo de 1 artículo.

Obligatorio: no

maxResults

Cuando se usa este parámetro, ListDeploymentJobs solo devuelve maxResults resultados en una sola página junto con un elemento de respuesta nextToken. Los resultados restantes de la solicitud inicial se pueden ver enviando otra solicitud de ListDeploymentJobs con el valor nextToken devuelto. Este valor debe estar entre 1 y 200. Si no se usa este parámetro, ListDeploymentJobs devuelve hasta 200 resultados y un valor nextToken, si corresponde.

Tipo: entero

Obligatorio: no

nextToken

Si la solicitud paginada anterior no devolvió todos los resultados restantes, el valor del parámetro nextToken del objeto de respuesta se establece en un token. Para recuperar el siguiente conjunto de resultados, vuelva a llamar a ListDeploymentJobs y asigne ese token al parámetro nextToken del objeto de solicitud. Si no quedan resultados, el NextToken parámetro del objeto de respuesta anterior se establece en null.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Patrón: [a-zA-Z0-9_.\-\/+=]*

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "deploymentJobs": [ { "arn": "string", "createdAt": number, "deploymentApplicationConfigs": [ { "application": "string", "applicationVersion": "string", "launchConfig": { "environmentVariables": { "string" : "string" }, "launchFile": "string", "packageName": "string", "postLaunchFile": "string", "preLaunchFile": "string" } } ], "deploymentConfig": { "concurrentDeploymentPercentage": number, "downloadConditionFile": { "bucket": "string", "etag": "string", "key": "string" }, "failureThresholdPercentage": number, "robotDeploymentTimeoutInSeconds": number }, "failureCode": "string", "failureReason": "string", "fleet": "string", "status": "string" } ], "nextToken": "string" }

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

deploymentJobs

Una lista con los trabajos de implementación que cumplen los criterios de la solicitud.

Tipo: matriz de objetos DeploymentJob

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 elementos.

nextToken

Si la solicitud paginada anterior no devolvió todos los resultados restantes, el valor del parámetro nextToken del objeto de respuesta se establece en un token. Para recuperar el siguiente conjunto de resultados, vuelva a llamar a ListDeploymentJobs y asigne ese token al parámetro nextToken del objeto de solicitud. Si no quedan resultados, el NextToken parámetro del objeto de respuesta anterior se establece en nulo.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Patrón: [a-zA-Z0-9_.\-\/+=]*

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

InternalServerException

AWS RoboMaker ha tenido un problema con el servicio. Pruebe la llamada de nuevo.

Código de estado HTTP: 500

InvalidParameterException

Un parámetro especificado en una solicitud no es válido, no se admite o no se puede utilizar. El mensaje devuelto proporciona una explicación del valor del error.

Código de estado HTTP: 400

ResourceNotFoundException

El recurso especificado no existe.

Código de estado HTTP: 400

ThrottlingException

AWS RoboMaker no puede procesar la solicitud temporalmente. Pruebe la llamada de nuevo.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: