Imagen de la máquina de Amazon es una plantilla que se utiliza para lanzar las instancias EC2. Una AMI es similar a un plano que contiene un sistema operativo y todo el software o configuraciones de aplicaciones necesarios para las instancias. Las AMI pueden estar prediseñadas o administradas de forma personalizada. AWS CLI es una poderosa utilidad para acceder y administrar imágenes mediante comandos simples como el “describir-imágenes” dominio. El “describir-imágenes” El comando se utiliza para enumerar todas las AMI configuradas para una cuenta determinada.
Esquema rápido
En este artículo, aprenderemos sobre:
- ¿Qué es el comando 'describe-images' en AWS CLI?
- ¿Cómo utilizar el comando 'describe-images' en AWS CLI?
- Conclusión
¿Qué es el comando 'describe-images' en AWS CLI?
El “describir-imágenes” El comando en AWS CLI es una operación paginada que se utiliza para enumerar todas o algunas AMI específicas dentro de una cuenta. La salida del “describir-imágenes” El comando está en forma de lista que contiene información sobre varias imágenes. Estas imágenes pueden ser públicas, privadas, definidas por el usuario o administradas por AWS. Se accede a los datos de la AMI en múltiples llamadas API al servicio cuando la paginación está habilitada.
Leer más: ¿Cómo deshabilitar la página en AWS CLI?
¿Cómo utilizar el comando 'describe-images' en AWS CLI?
Las imágenes dadas de baja son aquellas que se eliminan de AWS y ya no son compatibles con el servicio EC2 ni con la plataforma. Sin embargo, estas imágenes también se incluyen en el resultado del “describir-imágenes” dominio. El usuario puede controlar la salida del comando filtrando, consultando o especificando una AMI particular, etc. a través de múltiples parámetros diferentes.
Sintaxis
La sintaxis del “describir-imágenes” El comando se da de la siguiente manera:
aws ec2 describe-imágenes < Opciones >
Opciones
Aquí hay una breve descripción de las opciones del comando mencionado anteriormente:
| Opción | Descripciones |
| –usuarios-ejecutables | Este parámetro se utiliza para extraer y enumerar las AMI según los permisos del usuario. El usuario puede especificar 'yo', 'todos' o la identificación de la cuenta de AWS. |
| –filtros | El parámetro –filters se utiliza para enumerar detalles específicos o AMI en la salida. Hay diferentes tipos de filtros admitidos por este comando: – nombre: El usuario puede filtrar las AMI especificando el nombre. – ID del propietario: El ID de cuenta de AWS también puede filtrar las AMI describiendo únicamente aquellas imágenes que están configuradas dentro de una cuenta específica. – etiqueta: Las etiquetas son la combinación de pares clave-valor. Al especificar las etiquetas, un usuario puede filtrar fácilmente las AMI para una cuenta determinada. – ID de imagen: Otro método para filtrar las AMI es especificando el ID de la imagen. Esto solo mostrará una AMI específica. |
| –id-imagen | Este parámetro ingresa el ID de la AMI. |
| –propietarios | El parámetro –owner acepta las opciones ID de cuenta, self, amazon o aws-marketplace. Estas opciones solo enumerarán aquellas AMI que coincidan exactamente con la opción especificada. |
| –incluir-obsoleto | Este parámetro se utiliza para especificar si se enumeran las AMI obsoletas o no. Las AMI obsoletas son aquellas imágenes cuyo uso ya no se recomienda. |
| –incluir-deshabilitado | Este campo especifica si se enumeran las AMI deshabilitadas en la salida o no. |
| –ejecución en seco | El parámetro –dry-run se utiliza para determinar si el usuario tiene permiso para la acción deseada o no. Devuelve la salida en formato de error. Además, si el usuario tiene los permisos, la salida contendrá 'DryRunOperation'. Si el usuario no tiene este permiso, devolverá 'Operación no autorizada' en el resultado. |
| –cli-entrada-json | Este parámetro se utiliza para proporcionar varias instrucciones JSON a la vez en forma de plantilla para servicios de AWS. La plantilla seguida se genera mediante el parámetro “–generate-cli-skeleton”. |
| –ficha inicial | Este parámetro ingresa el valor del campo 'NextToken' de la salida. El NextToken simboliza que hay más datos para listar. Cuando el valor de NextToken se proporciona al token de inicio, comenzará a enumerar los datos de la respuesta anterior. |
| -tamaño de página | Este parámetro define el tamaño de página en cada llamada de servicio de AWS. Un tamaño de página más pequeño genera más llamadas a la API que evitan el error de tiempo de espera. Sin embargo, recupera menos datos en cada llamada. |
| –artículos máximos | El parámetro –max-items se utiliza para limitar el número de entradas que se mostrarán en la salida. |
| –generar-cli-esqueleto | Genera un esqueleto o plantilla que se debe seguir al proporcionar varias instrucciones al servicio de AWS a la vez. |
Además de estas opciones, AWS también ofrece opciones globales. Las opciones globales son comunes al comando AWS CLI y se pueden usar con diferentes comandos. El Documentación de AWS analiza varias opciones globales.
Ejemplos
Esta sección del artículo analiza varios ejemplos de “describir-imágenes” comando en AWS CLI:
- Ejemplo 1: ¿Cómo describir imágenes en AWS CLI?
- Ejemplo 2: ¿Cómo describir todas las imágenes en AWS CLI?
- Ejemplo 3: ¿Cómo describir la AMI por ID de propietario en AWS CLI?
- Ejemplo 4: ¿Cómo filtrar imágenes en AWS CLI?
- Ejemplo 5: ¿Cómo consultar la AMI en AWS CLI?
- Ejemplo 6: ¿Cómo describir imágenes obsoletas en AWS CLI?
- Ejemplo 7: ¿Cómo describir imágenes habilitadas o deshabilitadas en AWS CLI?
- Ejemplo 8: ¿Cómo describir imágenes en múltiples formatos de salida?
Ejemplo 1: ¿Cómo describir imágenes en AWS CLI?
El “describir-imágenes” El comando en AWS CLI se utiliza para enumerar los detalles de una AMI específica para una cuenta determinada. Este comando requiere el ID de imagen de la AMI. Visite el servicio EC2 y haga clic en 'CUAL' opción del panel de navegación izquierdo. Seleccione crear imagen y mostrará las configuraciones de la imagen. Dentro de Detalles sección, copie y guarde la ID de AMI:
El comando para enumerar una AMI específica se proporciona de la siguiente manera:
aws ec2 describe-imágenes --región ap-sureste- 1 --identificadores de imagen < AMIImageID >
Reemplace la
Producción
Ejemplo 2: ¿Cómo describir todas las imágenes en AWS CLI?
El comando para enumerar todas las imágenes disponibles en AWS CLI es el siguiente:
aws ec2 describe-imágenes
Producción
Esto llevará algún tiempo mostrar una lista de todas las imágenes. Continúe presionando el 'Ingresar' tecla del teclado para ver el detalle de todas las imágenes:
Ejemplo 3: ¿Cómo describir la AMI por ID de propietario en AWS CLI?
Las AMI configuradas dentro de una cuenta de AWS también pueden ser determinadas por el propietario o el ID de la cuenta. El ID de la cuenta se puede determinar haciendo clic en el nombre de usuario en la esquina superior derecha de la Consola de administración de AWS. Haga clic en el 'Copiar' icono para copiar el ID de la cuenta:
El comando se personaliza con un parámetro adicional de la siguiente manera:
aws ec2 describe-imágenes --propietarios < ID de la cuenta >
Reemplace la
Producción
Ejemplo 4: ¿Cómo filtrar imágenes en AWS CLI?
Hay diferentes filtros disponibles para extraer detalles de imágenes específicas. El usuario puede filtrar las imágenes por ID de propietario, ID de imagen, etiquetas, nombre o estado, etc. Para enumerar una imagen por su nombre, se utiliza el siguiente comando:
aws ec2 describe-imágenes --filtros 'Nombre=nombre, Valores=ec2image'
Reemplace la “imagen ec2” en Valores con el nombre de su AMI.
Producción
El valor de los pares clave-valor de la etiqueta de una AMI se puede determinar seleccionando la AMI en el panel de AMI. Esto mostrará las configuraciones de la imagen. Toque en el “Etiquetas” pestaña y copie el valor de los campos clave-valor:
Para filtrar una imagen por sus etiquetas, el comando se proporciona a continuación:
aws ec2 describe-imágenes --filtros 'Nombre=etiqueta:primera clave, Valores=primera'
Reemplace la “primera clave” en el campo Nombre con la clave. Del mismo modo, reemplace el 'primero' en Valores con el valor de la etiqueta.
Producción
Ejemplo 5: ¿Cómo consultar la AMI en AWS CLI?
El usuario puede extraer detalles específicos de una imagen de la lista mostrada utilizando el '-consulta' parámetro. El comando se da de la siguiente manera:
aws ec2 describe-imágenes --consulta 'Imágenes[*].[ImageId]'
Producción
De manera similar, el usuario también puede consultar detalles particulares de una imagen especificando la identificación de la imagen con el parámetro de consulta:
aws ec2 describe-imágenes --id-imagen < AMII > --consulta 'Imagen[*].[Tipo de imagen, descripción, estado]'
Producción
Ejemplo 6: ¿Cómo describir imágenes obsoletas en AWS CLI?
Las AMI obsoletas son aquellas imágenes cuyo uso ya no recomienda AWS. Para determinar qué imágenes están en desuso, utilice el comando que se proporciona a continuación:
aws ec2 describe-imágenes --incluir-obsoleto
Producción
Del mismo modo, el usuario también puede especificar el “–no-incluir-obsoleto” parámetro para enumerar todas las imágenes, incluidas las obsoletas:
aws ec2 describe-imágenes --no-incluir-obsoleto
Producción
Ejemplo 7: ¿Cómo describir imágenes habilitadas o deshabilitadas en AWS CLI?
El “describir-imágenes” El comando también se puede utilizar para enumerar aquellas imágenes que están deshabilitadas o no deshabilitadas para la cuenta. Esto ayudará a los usuarios a determinar qué AMI utilizar. El comando que se proporciona a continuación se utiliza para enumerar las AMI que están deshabilitadas para la cuenta:
aws ec2 describe-imágenes --incluir-deshabilitado
Producción
De manera similar, el “describir-imágenes” El comando devuelve solo aquellas AMI que no están deshabilitadas para una cuenta determinada. Para ello, utilice el siguiente comando:
aws ec2 describe-imágenes --no-incluir-deshabilitado
Producción
Ejemplo 8: ¿Cómo describir imágenes en múltiples formatos de salida?
Hay múltiples formatos de salida soportados por el “describir-imágenes” dominio. Los formatos incluyen YAML, JSON, texto o tabla. A continuación se muestra el comando para describir las imágenes en formato tabular:
aws ec2 describe-imágenes --producción mesa
Reemplace la 'mesa' valor en el campo de salida con un formato de salida diferente de su elección, como JSON, YAML o texto.
Producción
Prensa 'Ingresar' desde el teclado para seguir listando los datos:
Conclusión
El “describir-imágenes” El comando en AWS devuelve una lista de todas o de las AMI específicas para una cuenta determinada. Acepta parámetros opcionales, por ejemplo, –query, –output, etc. “describir-imágenes” El comando es útil para los desarrolladores de AWS, ya que les ayuda a comprender y decidir entre varias AMI para sus aplicaciones. Antes de usar el “describir-imágenes” comando, asegúrese de que AWS CLI esté configurado en sus máquinas locales y luego proporcione los comandos mencionados al terminal. Este artículo proporciona una comprensión profunda de la “describir-imágenes” comando con múltiples ejemplos para discutir sus diversos parámetros.