Uso de la CLI de AWS OpsWorks Stacks - AWS OpsWorks

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.

Uso de la CLI de AWS OpsWorks Stacks

importante

AWS OpsWorks Stacks ya no acepta nuevos clientes. Los clientes actuales podrán utilizar la consola, la API, la CLI y los recursos de CloudFormation de OpsWorks con normalidad hasta el 26 de mayo de 2024, fecha en la que dejarán de dejarán de estar disponibles. A fin de prepararse para esta transición, le recomendamos que pase sus pilas a AWS Systems Manager lo antes posible. Para obtener más información, consulte AWS OpsWorks Stacks Preguntas frecuentes sobre el final de la vida útil y Migración de sus AWS OpsWorks Stacks aplicaciones a AWS Systems Manager Application Manager.

La interfaz de línea de comandos (CLI) de AWS OpsWorks Stacks proporciona la misma funcionalidad que la consola y se puede utilizar para tareas muy variadas. La CLI de AWS OpsWorks Stacks forma parte de la AWS CLI. Para obtener más información, incluido cómo instalar y configurar la AWS CLI, consulte ¿Qué es la interfaz de línea de comandos de AWS?. Para ver una descripción completa de cada comando, consulte la referencia de AWS OpsWorks Stacks.

nota

Si utiliza una estación de trabajo basada en Windows, también puede ejecutar Herramientas de AWS para Windows PowerShell para realizar operaciones de AWS OpsWorks Stacks desde la línea de comandos. Para obtener más información, consulte Herramientas de AWS para Windows PowerShell.

Los comandos de AWS OpsWorks Stacks tienen el siguiente formato general:

aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]

Si un valor de argumento es un objeto de JSON, debería aplicar la función de escape en los caracteres " o el comando podría devolver un error indicando que el formato JSON no es válido. Por ejemplo, si el objeto JSON es "{"somekey":"somevalue"}", debería aplicarle el formato "{\"somekey\":\"somevalue\"}". Una opción alternativa es poner el objeto de JSON en un archivo y usar file:// para incluirlo en la línea del comando. En el siguiente ejemplo se crea una aplicación con un objeto de origen de aplicación almacenado en appsource.json.

aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json

La mayoría de los comandos devuelven uno o varios valores, empaquetados como un objeto de JSON. Las siguientes secciones contienen algunos ejemplos. Para ver una descripción detallada de los valores de devolución para cada comando, consulte la referencia de AWS OpsWorks Stacks.

nota

Los comandos de la AWS CLI deben especificar una región, tal y como se muestra en los ejemplos. En la siguiente tabla se muestran los valores válidos para el parámetro --region. Para simplificar las cadenas de los comandos de AWS OpsWorks Stacks, configure la CLI para especificar la región predeterminada, de modo que pueda omitir el parámetro --region. Si suele trabajar en varios puntos de enlace regionales, no configure la AWS CLI para usar un punto de enlace regional predeterminado. El punto de conexión de la región Canadá (centro) está disponible en la API y en la AWS CLI solamente; no está disponible para las pilas que crea en la AWS Management Console. Para obtener más información, consulte Configuración de la región de AWS.

Nombre de la región de Código del comando
Región del este de EE. UU. (Ohio) us-east-2
Región del este de EE. UU (N. Virginia) us-east-1
Región del oeste de EE. UU (N. California) us-west-1
Región del oeste de EE. UU (Oregon) us-west-2
Canada (Central) Region ca-central-1
Europe (Ireland) Region eu-west-1
Europe (London) Region eu-west-2
Región de Europa (París) eu-west-3
Europe (Frankfurt) Region eu-central-1
Región Asia Pacífico (Tokio) ap-northeast-1
Región Asia-Pacífico (Seúl) ap-northeast-2
Región Asia-Pacífico (Mumbai) ap-south-1
Región Asia Pacífico (Singapur) ap-southeast-1
Región Asia Pacífico (Sídney) ap-southeast-2
Región América del Sur (São Paulo) sa-east-1

Para utilizar un comando de la CLI, debe contar con los permisos pertinentes. Para obtener más información acerca de los permisos de AWS OpsWorks Stacks, consulte Administración de permisos de usuario. Para determinar los permisos necesarios para un comando determinado, consulte la referencia de comandos en la página de referencia en la referencia de AWS OpsWorks Stacks.

En las secciones siguientes se describe cómo utilizar la CLI de AWS OpsWorks Stacks para realizar varias tareas comunes.