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.
Esqueletos y archivos de entrada de AWS CLI
La mayoría de los comandos de AWS CLI aceptan todas las entradas de parámetros de un archivo. Estas plantillas se pueden generar mediante opción generate-cli-skeleton
.
Sobre esqueletos y archivos de entrada de AWS CLI
La mayoría de los comandos de AWS Command Line Interface (AWS CLI) pueden aceptar todas las entradas de parámetros desde un archivo con los parámetros --cli-input-json
y --cli-input-yaml
.
Esos mismos comandos proporcionan de forma efectiva el parámetro --generate-cli-skeleton
para generar un archivo en formato JSON o YAML con todos los parámetros que pueda editar y completar. A continuación, puede ejecutar el comando con el parámetro --cli-input-json
o --cli-input-yaml
relevante y apuntar al archivo cumplimentado.
importante
Varios comandos de AWS CLI no se corresponden directamente con operaciones individuales de la API de AWS, como los aws s3
comandos de --generate-cli-skeleton
o --cli-input-json
y --cli-input-yaml
descritos en este tema. Si no sabe si un determinado comando admite estos parámetros, ejecute el siguiente comando sustituyendo los nombres del servicio
y el comando
con los que quiera usar.
$
aws service command
help
El resultado incluye una sección Synopsis
que muestra los parámetros que admite el comando especificado.
$
aws iam list-users help
... SYNOPSIS list-users ... [--cli-input-json | --cli-input-yaml] ... [--generate-cli-skeleton <value>] ...
El parámetro --generate-cli-skeleton
hace que el comando no se ejecute, sino que genere y muestre una plantilla de parámetros que se puede personalizar y utilizar como entrada de otro comando posterior. La plantilla generada incluye todos los parámetros que admite el comando.
El parámetro --generate-cli-skeleton
acepta uno de los siguientes valores:
-
input
: la plantilla generada incluye todos los parámetros de entrada formateados como JSON. Este es el valor predeterminado. -
yaml-input
: la plantilla generada incluye todos los parámetros de entrada formateados como YAML. -
output
: la plantilla generada incluye todos los parámetros de salida formateados como JSON. Actualmente, no puede solicitar los parámetros de salida en formato YAML.
Como la AWS CLI es esencialmente un "encapsulador" de la API del servicio, el archivo de esqueleto espera que el usuario haga referencia a todos los parámetros utilizando los nombres de parámetro de la API subyacente. Es probable que este nombre sea distinto al nombre del parámetro de la AWS CLI. Por ejemplo, un parámetro de la AWS CLI llamado user-name
podría corresponderse con un parámetro de la API de servicio de AWS llamado UserName
(observe cómo se usan las mayúsculas y que falta un guion). Le recomendamos que utilice la opción --generate-cli-skeleton
para generar la plantilla con los nombres de parámetros "correctos" con el fin de evitar errores. También puede consultar la Guía de referencia de la API del servicio para ver los nombres de los parámetros esperados. Puede eliminar cualquier parámetro de la plantilla que no sea necesario y para el que no desee proporcionar un valor.
Por ejemplo, si ejecuta el siguiente comando, se genera la plantilla de parámetros para el comando Amazon Elastic Compute Cloud (Amazon EC2) run-instances.
Generación de un esqueleto de comandos
Para generar y utilizar un archivo de esqueleto de parámetros
-
Ejecute el comando con el parámetro
--generate-cli-skeleton
para producir la salida en formato JSON o YAML y dirigirla a un archivo para guardarla. -
Abra el archivo de esqueleto de parámetros en el editor de texto y quite todos los parámetros que no necesite. Por ejemplo, puede reducir la plantilla hasta dejarla tal y como se muestra a continuación. Asegúrese de que el código JSON o YAML del archivo sigue siendo válido después de eliminar los elementos que no necesita.
En este ejemplo, dejamos el parámetro
DryRun
establecido entrue
para utilizar la característica “dry run” (simulacro) de Amazon EC2. Esta característica le permite probar el comando de forma segura sin crear ni modificar ningún recurso. -
Rellene los valores restantes con valores adecuados para su escenario. En este ejemplo, proporcionamos el tipo de instancia, el nombre de la clave, el grupo de seguridad y el identificador de Amazon Machine Image (AMI) que vamos a utilizar. En este ejemplo, se presupone que la región apropiada es la región de AWS predeterminada. La AMI
ami-dfc39aef
es una imagen de Amazon Linux de 64 bits alojada en la regiónus-west-2
. Si utiliza una región diferente, debe encontrar el ID apropiado de la AMI que desea utilizar. -
Ejecute el comando con los parámetros completados pasando el archivo de plantilla relleno al parámetro
--cli-input-json
ocli-input-yaml
al utilizar el prefijofile://
. La AWS CLI interpreta la ruta como una ruta relativa al directorio de trabajo actual, por lo que el siguiente ejemplo, en el que solo aparece el nombre de archivo y no la ruta, buscará el archivo directamente en el directorio de trabajo actual.El error del simulacro indica que el código JSON o YAML está formado correctamente y que los valores de los parámetros son válidos. Si se informa de cualquier otro problema en la salida, corríjalo y repita el paso anterior hasta que aparezca el mensaje "
Request would have succeeded
". -
Ahora puede establecer el parámetro
DryRun
enfalse
para deshabilitar el simulacro. -
Ejecute el comando para que
run-instances
lance una instancia de Amazon EC2 y muestre los detalles que se generan cuando el lanzamiento se realiza correctamente. El parámetro--output
controla el formato de salida, independientemente del formato de la plantilla de parámetros de entrada.