Uso del punto de conexión de Amazon EC2 - Guía para desarrolladores de AWS Snowball Edge

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 del punto de conexión de Amazon EC2

A continuación, encontrará información general sobre el punto de enlace de Amazon Elastic Compute Cloud (Amazon EC2). Al usar este punto de enlace, puede administrar las imágenes de máquina de Amazon (AMI) y las instancias de computación mediante programación utilizando las operaciones de la API de Amazon EC2.

Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión

Cuando utiliza elAWS CLIemitir un comando alAWS Snowball Edge, puede especificar que el punto de enlace es el punto de enlace de Amazon EC2. Tiene la posibilidad de utilizar el punto de enlace HTTPS o un punto de enlace HTTP no protegido, tal y como se muestra a continuación.

Punto de enlace HTTPS protegido

aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate

Punto de enlace HTTP no protegido

aws ec2 describe-instances --endpoint http://192.0.2.0:8008

Si utiliza el punto de enlace de HTTPS de 8243, se cifran los datos en tránsito. El cifrado está protegido con un certificado generado por Snowball Edge cuando se desbloquea. Una vez que tenga el certificado, puede guardarlo en un archivo ca-bundle.pem local. A continuación, puede configurar el perfil de la AWS CLI para incluir la ruta a su certificado, tal y como se describe a continuación.

Para asociar el certificado con el punto de enlace de Amazon EC2

  1. Connect el Snowball Edge a la alimentación eléctrica y a la red y enciéndalo.

  2. En cuanto el dispositivo termine de desbloquearse, anote su dirección IP en la red local.

  3. En un terminal de la red, asegúrese de que puede hacer ping al Snowball Edge.

  4. Ejecute el comando snowballEdge get-certificate en el terminal. Para obtener más información acerca de este comando, consulte Obtención de su certificado para la transferencia de datos.

  5. Guarde el resultado del comando snowballEdge get-certificate en un archivo, por ejemplo ca-bundle.pem.

  6. Ejecute el siguiente comando desde el terminal.

    aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem

Después de realizar este procedimiento, puede ejecutar comandos de la CLI con estas credenciales locales, su certificado y el punto de enlace especificado.

soportadasAWS CLIComandos de Amazon EC2 en un dispositivo Snowball Edge

A continuación, puede encontrar información sobre cómo especificar el punto de enlace de Amazon EC2 paraAWS CLIcommands. Para obtener información acerca de cómo instalar y configurar laAWS CLI, incluida la especificación de las regiones que desea crearAWS CLIllamadas en contra, consulte laAWS Command Line InterfaceGuía del usuario de.

Lista de Amazon EC2 compatiblesAWS CLIComandos de un dispositivo Snowball Edge

A continuación, encontrará una descripción del subconjunto deAWS CLIcomandos y opciones de Amazon EC2 compatibles con los dispositivos Snowball Edge. Si un comando o una opción no aparece en la lista siguiente, no está admitido. Puede declarar algunas opciones no admitidas con un comando. Sin embargo, no se tendrán en cuenta.

  • associate-address: asocia con una instancia la dirección IP virtual que se usará en una de las tres interfaces de red físicas en el dispositivo:

    • --instance-id: el ID de una sola instancia sbe.

    • --public-ip: la dirección IP virtual que desea usar para acceder a la instancia.

  • attach-volume: Adjunta un volumen de Amazon EBS a una instancia parada o en ejecución en el dispositivo y lo expone a la instancia con el nombre de dispositivo especificado.

    • —Dispositivovalue: el nombre del dispositivo.

    • —instance-id: ID de una instancia Amazon EC2 de destino.

    • —volume-idvalue: ID del volumen de EBS.

  • authorize-security-group-egress: añada una o varias reglas de salida a un grupo de seguridad para su uso con un dispositivo Snowball Edge. En concreto, esta acción permite que las instancias puedan enviar tráfico a uno o varios intervalos de direcciones CIDR IPv4 de destino. Para obtener más información, consulte Grupos de seguridad en dispositivos Snowball Edge.

    • —idvalue— El ID del grupo de seguridad

    • [—ip-permisosvalue] — Uno o más conjuntos de permisos de IP.

  • authorize-security-group-ingress: permite añadir una o varias reglas de entrada a un grupo de seguridad. Al llamar a authorize-security-group-ingress, debe especificar un valor para group-name o para group-id.

    • [—nombre-grupovalue]: nombre del grupo de seguridad.

    • [[—idvalue]: el ID del grupo de seguridad

    • [—ip-permisosvalue] — Uno o más conjuntos de permisos de IP.

    • [--protocol value]: protocolo IP. Los posibles valores son tcp, udp y icmp. El argumento --port es obligatorio a menos que el valor "all protocols" (todos los protocolos) esté especificado (-1).

    • [[—Puertovalue]: para TCP o UDP, el rango de puertos que se permite. Este valor puede ser un número entero específico o un intervalo (mínimo—máximo).

      En el caso de ICMP, un valor entero específico o un intervalo (type-code) en el que type representa el número de tipos de ICMP y code representa el número de códigos de ICMP. El valor -1 indica todos los códigos de ICMP para todos los tipos de ICMP. Si solo type tiene el valor -1, indica todos los códigos de ICMP para el tipo de ICMP especificado.

    • [—sidravalue] — El rango de IP de CIDR.

  • create-launch-template: permite crear una configuración de lanzamiento. Una plantilla de lanzamiento contiene los parámetros necesarios para lanzar una instancia. Al lanzar una instancia mediante RunInstances, puede especificar una plantilla de lanzamiento en lugar de proporcionar los parámetros de lanzamiento en la solicitud. Puede crear hasta 100 plantillas por dispositivo.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • --launch-template-data structure: la información para la plantilla de lanzamiento. Se admiten los siguientes atributos:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      Sintaxis de JSON:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [—versión-descripciónstring]: descripción de la primera versión de la plantilla de lanzamiento.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • create-launch-template-version: crea una nueva versión de una plantilla de lanzamiento. Puede especificar una versión existente de una plantilla de lanzamiento en la que se basará la nueva versión. Las versiones de las plantillas de lanzamiento están numeradas en el orden en el que se han creado. No se puede especificar, cambiar o sustituir la numeración de las versiones de las plantillas de lanzamiento. Puede crear hasta 100 versiones de cada plantilla de lanzamiento.

    Especifique el ID o el nombre de la plantilla de lanzamiento en la solicitud.

    • --launch-template-id string: ID de la plantilla de lanzamiento.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • --launch-template-data structure: la información para la plantilla de lanzamiento. Se admiten los siguientes atributos:

      • ImageId

      • InstanceType

      • SecurityGroupIds

      • TagSpecifications

      • UserData

      Sintaxis de JSON:

      { "ImageId":"string", "InstanceType":"sbe-c.large", "SecurityGroupIds":["string", ...], "TagSpecifications":[{"ResourceType":"instance","Tags":[{"Key":"Name","Value":"Test"}, {"Key":"Stack","Value":"Gamma"}]}], "UserData":"this is my user data" }
    • [—versión-origenstring]: el número de versión de la plantilla de lanzamiento en la que se basará la nueva. La nueva versión hereda los mismos parámetros de lanzamiento que la versión de origen, a excepción de los que especifique en launch-template-data.

    • [—versión-descripciónstring]: descripción de la primera versión de la plantilla de lanzamiento.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • create-tags: añade o sobrescribe una o varias etiquetas para el recurso especificado. Cada recurso puede tener un máximo de 50 etiquetas. Cada etiqueta consta de una clave y un valor opcional. Las claves de la etiqueta deben ser únicas para un recurso. Se admiten los siguientes recursos:

    • AMI

    • Instancia

    • Plantilla de lanzamiento

    • Security group (Grupo de seguridad)

    • Par de claves

  • create-security-group: crea un grupo de seguridad en su Snowball Edge. Puede crear hasta 50 grupos de seguridad. Cuando cree un grupo de seguridad, especifique un nombre fácil de recordar:

    • —nombre-grupovalue: nombre del grupo de seguridad.

    • --descriptionvalue: una descripción del grupo de seguridad. Su función es meramente informativa. Este valor puede tener 255 caracteres como máximo.

  • create-volume: crea un volumen de Amazon EBS que se puede asociar a una instancia del dispositivo.

    • [[—sizevalue]: el tamaño del volumen en GiBs, que puede ser de 1 GiB a 1 TB (1000 GiBs).

    • [—id de instantáneavalue]: la instantánea a partir de la cual crear el volumen.

    • [—tipo de volumenvalue]: el tipo de volumen. Si no se especifica ningún valor, el valor predeterminado es sbg1. Entre los valores posibles se incluyen:

      • sbg1 para los volúmenes magnéticos

      • sbp1 para los volúmenes SSD

    • [—especificación de etiquetasvalue]: lista de etiquetas que se aplican al volumen en el momento de su creación.

  • delete-launch-template: elimina una configuración de lanzamiento. Al eliminar una plantilla de lanzamiento, también se eliminan todas sus versiones.

    Especifique el ID o el nombre de la plantilla de lanzamiento en la solicitud.

    • --launch-template-id string: ID de la plantilla de lanzamiento.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • delete-launch-template-version: elimina una o varias versiones de una plantilla de lanzamiento. No puede eliminar la versión predeterminada de una plantilla de lanzamiento. Para poder hacerlo, primero debe asignar otra versión como predeterminada. Si la versión predeterminada es la única versión para la plantilla de lanzamiento, elimine toda la plantilla de lanzamiento con el comando delete-launch-template.

    Especifique el ID o el nombre de la plantilla de lanzamiento en la solicitud.

    • --launch-template-id string: ID de la plantilla de lanzamiento.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • —versions (lista)"string" "string": los números de versión de una o varias versiones de plantilla de lanzamiento que eliminar.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • delete-security-group: elimina un grupo de seguridad.

    Si intenta eliminar un grupo de seguridad asociado a una instancia o si otro grupo de seguridad hace referencia a este, se produce un error DependencyViolation en la operación.

    • —nombre-grupovalue: nombre del grupo de seguridad.

    • --descriptionvalue: una descripción del grupo de seguridad. Su función es meramente informativa. Este valor puede tener 255 caracteres como máximo.

  • delete-tags: elimina el conjunto de etiquetas especificado del recurso especificado (AMI, instancia de computación, plantilla de lanzamiento o grupo de seguridad).

  • delete-volumen: elimina el volumen de Amazon EBS especificado. El volumen debe tener el estado available (no debe estar asociado a ninguna instancia).

    • —volume-idvalue— El ID del volumen.

  • describe-addresses: describe una o varias de sus direcciones IP virtuales asociadas con el mismo número desbeinstancias en el dispositivo.

    • --public-ips: una o más direcciones IP virtuales asociadas con sus instancias.

  • describe-images: describe una o varias de las imágenes (AMI) que tiene a su disposición. Las imágenes a su disposición se añaden al dispositivo Snowball Edge al crear el trabajo.

    • —image-id: el ID de la AMI de Snowball de de la AMI.

  • describe-instance-attribute: describe el atributo especificado de la instancia especificada. Solo puede especificar los atributos de uno en uno. Se admiten los siguientes atributos:

    • instanceInitiatedShutdownBehavior

    • instanceType

    • userData

  • describe-instances: describe una o más de sus instancias. La respuesta devuelve los grupos de seguridad asignados a las instancias.

    • --instance-ids: los ID de una o más instancias sbe que se detuvieron en el dispositivo.

    • --page-size: el tamaño de cada página que se obtendrá en la llamada. Este valor no afecta a la cantidad de elementos que se devuelven en la salida del comando. Si se configura un tamaño de página menor se generan más llamadas al dispositivo y se recuperan menos elementos en cada llamada. Esta operación puede ayudar a evitar que las llamadas agoten el tiempo de espera.

    • --max-items: el número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona NextToken en la salida del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior.

    • --starting-token: un token para especificar dónde iniciar la paginación. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

  • describe-launch-templates: describe una o varias plantillas de lanzamiento. El comando describe-launch-templates es una operación paginada. Puede hacer varias llamadas para recuperar todo el conjunto de datos de los resultados.

    Especifique los ID o los nombres de las plantillas de lanzamiento en la solicitud.

    • --launch-template-ids (list)"string" "string"— Una lista de ID de las plantillas de lanzamiento.

    • --launch-template-names (list)"string" "string": una lista de nombres para las plantillas de lanzamiento.

    • --page-size: el tamaño de cada página que se obtendrá en la llamada. Este valor no afecta a la cantidad de elementos que se devuelven en la salida del comando. Si se configura un tamaño de página menor se generan más llamadas al dispositivo y se recuperan menos elementos en cada llamada. Esta operación puede ayudar a evitar que las llamadas agoten el tiempo de espera.

    • --max-items: el número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona NextToken en la salida del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior.

    • --starting-token: un token para especificar dónde iniciar la paginación. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • describe-launch-template-versions: describe una o varias versiones de una plantilla especificada de lanzamiento. Puede describir todas las versiones, versiones individuales o un rango de versiones. El comando describe-launch-template-versions es una operación paginada. Puede hacer varias llamadas para recuperar todo el conjunto de datos de los resultados.

    Especifique los ID o los nombres de las plantillas de lanzamiento en la solicitud.

    • --launch-template-id string: ID de la plantilla de lanzamiento.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • [—versions (lista)"string" "string"]: los números de versión de una o varias versiones de plantilla de lanzamiento que eliminar.

    • [—versión mínimastring]: el número de versión tras el que se describen las versiones de la plantilla de lanzamiento.

    • [[—Versión Versión máximastring]: el número de versión hasta el que se describen las versiones de la plantilla de lanzamiento.

    • --page-size: el tamaño de cada página que se obtendrá en la llamada. Este valor no afecta a la cantidad de elementos que se devuelven en la salida del comando. Si se configura un tamaño de página menor se generan más llamadas al dispositivo y se recuperan menos elementos en cada llamada. Esta operación puede ayudar a evitar que las llamadas agoten el tiempo de espera.

    • --max-items: el número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona NextToken en la salida del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior.

    • --starting-token: un token para especificar dónde iniciar la paginación. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • describe-security-groups: describe uno o varios de sus grupos de seguridad.

    El comando describe-security-groups es una operación paginada. Puede emitir varias llamadas a la API para recuperar todo el conjunto de datos de los resultados.

    • [—nombre-grupovalue]: nombre del grupo de seguridad.

    • [[—idvalue]: ID del grupo de seguridad.

    • [—tamaño de páginavalue]: el tamaño de cada página que se obtendrá enAWSservicio. Este tamaño no afecta a la cantidad de elementos que se devuelven en la salida del comando. Si se configura un tamaño de página menor se generan más llamadas a laAWS, recuperando menos elementos en cada llamada. Este enfoque puede ayudar a evitarAWSllamadas de servicio agotadas. Para ver ejemplos de uso, consultePaginaciónen laAWS Command Line InterfaceGuía del usuario de.

    • [[—artículosvalue]: el número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona NextToken en la salida del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior. No utilice elNextTokenelemento de respuesta directamente fuera deAWS CLI. Para ver ejemplos de uso, consultePaginaciónen laAWS Command Line InterfaceGuía del usuario de.

    • [—token de iniciovalue]: un token para especificar dónde iniciar la paginación. Este token es el valor NextToken de una respuesta anterior que estaba truncada. Para ver ejemplos de uso, consultePaginaciónen laAWS Command Line InterfaceGuía del usuario de.

  • describe-tags: describe una o varias etiquetas para el recurso especificado (image,instance, o grupo de seguridad). Con este comando, se admiten los siguientes filtros:

    • launch-template

    • resource-id

    • resource-type: image o instance

    • key

    • value

  • describe-volumes: describe los volúmenes de Amazon EBS especificados.

    • [[—artículosvalue]: el número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona NextToken en la salida del comando. Para reanudar la paginación, proporcione el valor de NextToken en el argumento starting-token de un comando posterior.

    • [—token de iniciovalue]: un token para especificar dónde iniciar la paginación. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • [—volume-idsvalue] — Uno o más ID de volumen.

  • detdetdetdetach-volume: desconecta un volumen de Amazon EBS de una instancia detenida o en ejecución.

    • [—dispositivovalue]: el nombre del dispositivo.

    • [—instance-id] — El ID de una instancia Amazon EC2 de destino.

    • —volume-idvalue— El ID del volumen.

  • disassociate-address: desasocia la dirección IP virtual de la instancia con la que está asociada.

    • —public-ip: la dirección IP virtual que desea desasociar de la instancia.

  • get-launch-template-data: recupera los datos de configuración de la instancia especificada. Puede utilizar estos datos para crear una plantilla de lanzamiento.

  • modify-launch-template: modifica una configuración de lanzamiento. Puede especificar qué versión de la plantilla de lanzamiento se establecerá como la versión predeterminada. Al lanzar una instancia sin especificar una versión de una plantilla de lanzamiento, se aplica la versión predeterminada de la plantilla de lanzamiento.

    Especifique el ID o el nombre de la plantilla de lanzamiento en la solicitud.

    • --launch-template-id string: ID de la plantilla de lanzamiento.

    • --launch-template-name string: nombre para la plantilla de lanzamiento.

    • —versión predeterminadastring: el número de versión de la plantilla de lanzamiento que establecer como la versión predeterminada.

    • —Punto de enlacesnowballEndpoint: un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API de Amazon EC2. Para obtener más información, consulte Especificación del punto de enlace de Amazon EC2 comoAWS CLIPunto de conexión.

  • modify-instance-attribute: modifica un atributo de la instancia especificada. Se admiten los siguientes atributos:

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress: elimina una o varias reglas de salida de un grupo de seguridad:

    • [[—idvalue]: el ID del grupo de seguridad

    • [—ip-permisosvalue] — Uno o más conjuntos de permisos de IP.

  • revoke-security-group-ingress: revoca una o varias reglas de entrada a un grupo de seguridad. Al llamar a revoke-security-group-ingress, debe especificar un valor para group-name o group-id.

    • [—nombre-grupovalue]: nombre del grupo de seguridad.

    • [[—idvalue]: ID del grupo de seguridad.

    • [—ip-permisosvalue] — Uno o más conjuntos de permisos de IP.

    • [--protocol value]: protocolo IP. Los posibles valores son tcp, udp y icmp. El argumento --port es obligatorio a menos que el valor "all protocols" (todos los protocolos) esté especificado (-1).

    • [[—Puertovalue]: para TCP o UDP, el rango de puertos que se permite. Un número entero específico o un intervalo (mínimo—máximo).

      En el caso de ICMP, un valor entero específico o un intervalo (type-code) en el que type representa el número de tipos de ICMP y code representa el número de códigos de ICMP. El valor -1 indica todos los códigos de ICMP para todos los tipos de ICMP. Si solo type tiene el valor -1, indica todos los códigos de ICMP para el tipo de ICMP especificado.

    • [—sidravalue] — El rango de IP de CIDR.

  • run-instances: lanza una serie de instancias de computación mediante un ID de AMI de Snowball para una AMI.

    nota

    Puede tardar hasta una hora y media en lanzar instancias de computación en un dispositivo Snowball Edge, según el tamaño y el tipo de instancia.

    • [—block-device-mappings (list)]: las entradas de mapeo de dispositivos de bloques. Se admiten los parámetros DeleteOnTermination, VolumeSize y VolumeType. Los volúmenes de arranque deben ser de tipo sbg1.

      La sintaxis JSON de este comando es la siguiente.

      { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } }
    • --count: el número de instancias que va a lanzar. Si se proporciona un solo número, se entiende que es el mínimo (el valor predeterminado es 1). Si se proporciona un intervalo con el formato min:max, se entiende que el primer número indica la cantidad mínima de instancias que se van a lanzar y el segundo número indica la cantidad máxima.

    • —image-id: el ID de la AMI de Snowball de la AMI, que puede obtener con una llamadadescribe-images. La AMI es necesaria para lanzar una instancia.

    • --InstanceInitiatedShutdownBehavior — De forma predeterminada, cuando se inicia un cierre desde la instancia (con un comando como shutdown o poweroff), la instancia se detiene. Puede cambiar este comportamiento para que se termine. Se admiten los parámetros stop y terminate. El valor predeterminado es stop. Para obtener más información, consulteCambiar el comportamiento de cierre iniciado de la instanciaen laGuía del usuario de Amazon EC2 para instancias de Linux.

    • --instance-type: el tipo de instancia sbe.

    • —launch-templatestructure: la plantilla de lanzamiento que utilizar para lanzar instancias. Cualquier parámetro que especifique en el comando run-instances anula esos mismos parámetros en la plantilla de lanzamiento. Puede especificar el nombre o el ID de una plantilla de lanzamiento, pero no ambos.

      { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" }
    • --security-group-ids : uno o varios identificadores de grupo de seguridad. Puede crear un grupo de seguridad utilizandoCreateSecurityGroup. Si no se proporciona ningún valor, el ID del grupo de seguridad predeterminado se asigna a las instancias creadas.

    • --tag-specifications: las etiquetas que aplicar a los recursos durante el lanzamiento. Solo puede etiquetar instancias durante el lanzamiento. Las etiquetas especificadas se aplican a todas las instancias que se crean durante el lanzamiento. Para etiquetar un recurso una vez que se ha creado, utilice create-tags.

    • --user-data: los datos de usuario que poner a disposición de la instancia. Si utiliza la AWS CLI, la codificación en base64 es automática y puede cargar el texto desde un archivo. De lo contrario, debe proporcionar texto codificado en base64.

    • —key-name (string): el nombre del key pair. Puede crear un key pair medianteCreateKeyPairoImportKeyPair.

      aviso

      Si no especifica un key pair, no puede conectarse a la instancia a menos que elija una AMI que esté configurada para ofrecer a los usuarios otra forma de iniciar sesión.

  • start-instances— Iniciar unsbeinstancia que ha detenido previamente. Todos los recursos asociados a la instancia se mantienen durante los procesos de inicio y detención, pero se borran si la instancia se termina.

    • --instance-ids: los ID de una o más instancias sbe que se detuvieron en el dispositivo.

  • stop-instances— Detiene unsbeinstancia que se está ejecutando. Todos los recursos asociados a la instancia se mantienen durante los procesos de inicio y detención, pero se borran si la instancia se termina.

    • --instance-ids: los ID de una o más instancias sbe que se van a detener en el dispositivo.

  • terminate-instances: apaga una o más instancias. Esta operación es idempotent; si termina una instancia más de una vez, cada llamada se ejecuta satisfactoriamente. Todos los recursos adjuntados a la instancia persisten durante los procesos de inicio y detención, pero los datos se borran si la instancia se termina.

    nota

    De forma predeterminada, cuando se utiliza un comando como shutdown o poweroff para iniciar un cierre desde la instancia, la instancia se detiene. Ahora bien, puede utilizar laInstanceInitiatedShutdownBehaviorpara cambiar este comportamiento de modo que estos comandos terminen la instancia. Para obtener más información, consulteCambiar el comportamiento de cierre iniciado de la instanciaen laGuía del usuario de Amazon EC2 para instancias de Linux.

    • —instance-ids: los ID de uno o variossbeinstancias que se van a terminar en el dispositivo. Se perderán todos los datos asociados almacenados para esas instancias.

  • create-key-pair: crea un key pair RSA de 2048 bits con el nombre especificado. Amazon EC2 almacena la clave pública y muestra la clave privada para que la guarde en un archivo. La clave privada se devuelve como clave privada PKCS #1 codificada en PEM descifrada. Si una clave con el nombre especificado ya existe, Amazon EC2 devuelve un error.

    • —key-name (string): nombre único para el key pair.

      Restricciones: Hasta 255 caracteres ASCII.

    • [—tag-specifications] (list): las etiquetas que aplicar al nuevo key pair.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ...
  • import-key-pair

    • —key-name (string): nombre único para el key pair.

      Restricciones: Hasta 255 caracteres ASCII.

    • --public-key-material (blob) — La clave pública. Para las llamadas a la API, el texto debe estar codificado en base64. Con las herramientas de la línea de comandos, la codificación base64 es automática.

    • [—tag-specifications] (list): las etiquetas que aplicar al nuevo key pair.

    { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] }
  • describe-key-pairs

    [—filters] (list) — Los filtros.

    • key-pair-id — El ID del key pair.

    • key-name: nombre del key pair.

    • tag-key: la clave de una etiqueta asignada al recurso. Utilice este filtro para buscar todos los recursos a los que se haya asignado una etiqueta con una clave específica, independientemente del valor de la etiqueta.

    • [—tag-specifications] (list): las etiquetas que aplicar al nuevo key pair.

    • tag:key — La combinación clave/valor de una etiqueta asignada al recurso. Utilice la clave de etiqueta en el nombre del filtro y el valor de la etiqueta como valor del filtro. Por ejemplo, para buscar todos los recursos que tienen una etiqueta con la claveOwneryTeam A, especifiquetag:Ownerpara el nombre del filtro yTeam Apara el valor del filtro.

    { "Name": "string", "Values": ["string", ...] } ...
  • [—key-names] (list): los nombres de los key pair.

    Valor predeterminado: Describe todos sus pares de claves.

  • [—key-pair-ids] (list): los ID de los pares de claves.

  • delete-key-pair

    • [—key-name] (string): el nombre del key pair.

    • [—key-pair-id] (string): el ID del key pair.

Operaciones de API de Amazon EC2 compatibles

A continuación, encontrará las operaciones de la API de Amazon EC2 que puede utilizar con un dispositivo Snowball Edge, con enlaces a sus descripciones en laReferencia de la API de Amazon EC2.Las llamadas al API de Amazon EC2 requieren la firma de Signature Version 4 (SigV4). Si utiliza elAWS CLIo unAWSSDK para realizar estas llamadas a la API, la firma de SigV4 es automática. De lo contrario, debe implementar su propia solución de firma de SigV4. Para obtener más información, consulte Cómo obtener y usar las credenciales locales de Amazon S3.

  • AssociateAddress: asocia una dirección IP elástica a una instancia o una interfaz de red.

  • AttachVolume: se admiten los siguientes parámetros de solicitud:

    • Device

    • InstanceId

    • VolumeId

  • AuthorizeSecurityGroupEgress: añada una o varias reglas de salida a un grupo de seguridad para su uso con un dispositivo Snowball Edge. En concreto, esta acción permite que las instancias puedan enviar tráfico a uno o varios intervalos de direcciones CIDR IPv4 de destino.

  • AuthorizeSecurityGroupIngress: permite añadir una o varias reglas de entrada a un grupo de seguridad. Al llamar AuthorizeSecurityGroupIngress, debe especificar un valor paraGroupNameoGroupId.

  • CreateVolume: se admiten los siguientes parámetros de solicitud:

    • SnapshotId

    • Size

    • VolumeType

    • TagSpecification.N

  • CreateLaunchTemplate: se admiten los siguientes parámetros de solicitud:

    • ImageId

    • InstanceType

    • SecurityGroupIds

    • TagSpecifications

    • UserData

  • CreateLaunchTemplateVersion

  • CreateTags: se admiten los siguientes parámetros de solicitud:

    • AMI

    • Instance

    • Launch template

    • Security group

  • CreateSecurityGroup: crea un grupo de seguridad en su Snowball Edge. Puede crear hasta 50 grupos de seguridad. Cuando cree un grupo de seguridad, especifique un nombre fácil de recordar.

  • DeleteLaunchTemplate

  • DeleteLaunchTemplateVersions

  • DeleteSecurityGroup: elimina un grupo de seguridad. Si intenta eliminar un grupo de seguridad asociado a una instancia o si otro grupo de seguridad hace referencia a este, se produce un error DependencyViolation en la operación.

  • DeleteTags: elimina el conjunto especificado de etiquetas del conjunto especificado de recursos.

  • DeleteVolume: se admiten los siguientes parámetros de solicitud:

    • VolumeId

  • DescribeAddresses

  • DescribeImages

  • DescribeInstanceAttribute: se admiten los siguientes atributos:

    • instanceType

    • userData

  • DescribeLaunchTemplates

  • DescribeLaunchTemplateVersions

  • DescribeInstances

  • DescribeSecurityGroups: describe uno o varios de sus grupos de seguridad.DescribeSecurityGroupses una operación paginada. Puede emitir varias llamadas a la API para recuperar todo el conjunto de datos de los resultados.

  • DescribeTags— Con este comando, se admiten los siguiente:

    • resource-id

    • resource-type— AMI o solo instancias de computación

    • key

    • value

  • DescribeVolume: se admiten los siguientes parámetros de solicitud:

    • MaxResults

    • NextToken

    • VolumeId.N

  • DetachVolume: se admiten los siguientes parámetros de solicitud:

    • Device

    • InstanceId

    • VolumeId

  • DisassociateAddress

  • GetLaunchTemplateData

  • ModifyLaunchTemplate

  • ModifyInstanceAttribute— SolouserDatase admite el atributo.

  • RevokeSecurityGroupEgress: elimina una o varias reglas de salida de un grupo de seguridad.

  • RevokeSecurityGroupIngress: revoca una o varias reglas de entrada a un grupo de seguridad. Al llamar RevokeSecurityGroupIngress, debe especificar un valor paragroup-nameogroup-id.

  • RunInstances

    nota

    Puede tardar hasta una hora y media en lanzar instancias de computación en un dispositivo Snowball Edge, según el tamaño y el tipo de instancia.

  • StartInstances

  • StopInstances: los recursos asociados a una instancia detenida persisten. Puede terminar la instancia para liberar estos recursos. Sin embargo, los datos asociados se eliminan.

  • TerminateInstances