Uso del punto de conexión compatible con Amazon EC2 - Guía para desarrolladores de AWS Snowball Edge
Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto finalCompatible con Amazon EC2AWS CLIComandos en un Snowball EdgeOperaciones de API compatibles con Amazon EC2 compatibles

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 compatible con Amazon EC2

A continuación, encontrará una descripción general del punto de conexión compatible con Amazon EC2. Con este punto de conexión, puede gestionar sus Amazon Machine Images (AMI) y sus instancias de cómputo mediante programación mediante operaciones de API compatibles con Amazon EC2.

Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final

Cuando se utiliza elAWS CLIpara emitir un comando alAWS Snowball Edgedispositivo, puede especificar que el punto final sea el punto final compatible con 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. Este cifrado se garantiza con un certificado que genera el Snowball Edge al desbloquearlo. 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 su certificado al punto final compatible con Amazon EC2

  1. Conecte el Snowball Edge a la alimentación 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. Desde 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.

Compatible con Amazon EC2AWS CLIComandos en un Snowball Edge

Puede administrar sus instancias informáticas en un dispositivo de la familia Snow a través de un punto final compatible con Amazon EC2. Este tipo de punto final admite muchos de los comandos y acciones de la CLI de Amazon EC2 delAWSSDK. Para obtener información sobre la instalación y configuración delAWS CLI, incluida la especificación de quéRegiones de AWSquieres hacerAWS CLIllamadas en contra, consulte laAWS Command Line InterfaceGuía del usuario.

Lista de productos compatibles con Amazon EC2AWS CLIComandos en un Snowball Edge

A continuación, encontrará una descripción del subconjunto deAWS CLIcomandos y opciones para 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.

  • adjuntar volumen— Adjunta un volumen de Amazon EBS a una instancia detenida o en ejecución en su dispositivo y lo expone a la instancia con el nombre de dispositivo especificado.

    • --dispositivovalue— El nombre del dispositivo.

    • --instance-id: el ID de una instancia de destino compatible con Amazon EC2.

    • --identificador de volumenvalue— El ID del volumen de EBS.

  • authorize-security-group-egress— Añade una o más 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.

    • --id de grupovalue— El ID del grupo de seguridad

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

  • authorize-security-group-ingress— Añade una o más 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 del grupovalue] — El nombre del grupo de seguridad.

    • [--group-idvalue] — El ID del grupo de seguridad

    • [--ip-permissionsvalue] — 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 van a permitir. Este valor puede ser un entero único o un rango (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.

    • [--cidrvalue] — El rango de IP del CIDR.

  • create-launch-template— Crea una plantilla 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— Un nombre para la plantilla de lanzamiento.

    • --launch-template-data structure— La información de 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"
}

    • [--version-descriptionstring]: descripción de la primera versión de la plantilla de lanzamiento.

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • 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— El ID de la plantilla de lanzamiento.

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

    • --launch-template-data structure— La información de 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"
}

    • [--fuente-versiónstring] — El número de versión de la plantilla de lanzamiento en la que se basará la nueva versión. 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.

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

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • crear etiquetas— Añade o sobrescribe una o más 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 del grupovalue— El nombre del grupo de seguridad.

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

  • crear-volumen— Crea un volumen de Amazon EBS que se puede adjuntar a una instancia del dispositivo.

    • [--tamañovalue] — El tamaño del volumen enGiBs, que puede ser de 1 GiB a 1 TB (1000GiBs).

    • [--snapshot-idvalue] — La instantánea a partir de la cual se va a 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

    • [--tag-specificationvalue]: una lista de etiquetas para aplicar al volumen durante la creación.

  • delete-launch-template— Elimina una plantilla 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— El ID de la plantilla de lanzamiento.

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

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • delete-launch-template-version— Elimina una o más 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— El ID de la plantilla de lanzamiento.

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

    • --versiones (lista)"string" "string"— Los números de versión de una o más versiones de la plantilla de lanzamiento que se van a eliminar.

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • 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 del grupovalue— El nombre del grupo de seguridad.

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

  • eliminar etiquetas— Elimina el conjunto de etiquetas especificado del recurso especificado (AMI, instancia de procesamiento, plantilla de lanzamiento o grupo de seguridad).

  • eliminar-volumen— Elimina el volumen de Amazon EBS especificado. El volumen debe tener el estado available (no debe estar asociado a ninguna instancia).

    • --identificador de volumenvalue— El ID del volumen.

  • describe-addresses— Describe una o más de sus direcciones IP virtuales asociadas al mismo número desbeinstancias en su dispositivo.

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

  • describir imágenes— Describe una o más de las imágenes (AMI) de las que dispone. Las imágenes de las que dispone se añaden al dispositivo Snowball Edge durante la creación del trabajo.

    • --image-id: el ID de AMI de Snowball 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 utilizará 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 devolverán 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 empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

  • describe-instance-status— Describe el estado de las instancias especificadas o de todas las instancias. De forma predeterminada, solo se describen las instancias en ejecución, a menos que indique específicamente que se devuelva el estado de todas las instancias. El estado de la instancia incluye los siguientes componentes:

    • Comprobaciones de estado— El dispositivo Snow comprueba el estado de las instancias compatibles con Amazon EC2 en ejecución para identificar problemas de hardware y software.

    • Estado de la instancia— Puede administrar sus instancias desde el momento en que las lanza hasta su finalización.

    Con este comando se admiten los siguientes filtros.

    • [--filters](lista)

      Los filtros.

      • instance-state-code— El código del estado de la instancia, como un entero sin signo de 16 bits. El byte alto se utiliza para la elaboración de informes del servicio interno y debe ignorarse. El byte inferior se establece en función del estado representado. Los valores válidos son 0 (pendiente), 16 (en ejecución), 32 (apagado), 48 (finalizado), 64 (detenido) y 80 (detenido).

      • instance-state-name— El estado de la instancia (pending|running|shutting-down|terminated|stopping|stopped).

      • instance-status.reachability— Filtra según el estado de la instancia donde aparece el nombrereachability(passed|failed|initializing|insufficient-data).

      • instance-status.status— El estado de la instancia (ok|impaired|initializing|insufficient-data|not-applicable).

      • system-status.reachability— Filtra el estado del sistema donde el nombre es accesibility (passed|failed|initializing|insufficient-data).

      • system-status.status— El estado del sistema de la instancia (ok|impaired|initializing|insufficient-data|not-applicable).

    • Sintaxis JSON:

      [
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

    • [--instance-ids](lista)

      Los identificadores de la instancia.

      Predeterminado: describe todas las instancias.

    • [--dry-run|--no-dry-run](booleano)

      Comprueba si tiene los permisos necesarios para la acción, sin realizar realmente la solicitud, y proporciona una respuesta de error. Si tiene los permisos necesarios, la respuesta de error esDryRunOperation.

      De lo contrario, es UnauthorizedOperation.

    • [--include-all-instances | --no-include-all-instances](booleano)

      ¿Cuándotrue, incluye el estado de salud de todos los casos. ¿Cuándofalse, incluye el estado de salud únicamente de las instancias en ejecución.

      Valor predeterminado: false

    • [--page-size](entero): el tamaño de cada página para incluir 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](entero): el número total de elementos que se devolverán 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](cadena): un token para especificar dónde empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

  • describe-launch-templates— Describe una o más 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(lista)"string" "string"— Una lista de los identificadores de las plantillas de lanzamiento.

    • --launch-template-names(lista)"string" "string"— Una lista de nombres para las plantillas de lanzamiento.

    • --page-size: el tamaño de cada página para incluir 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 devolverán 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 empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • --endpointsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • describe-launch-template-versions— Describe una o más versiones de una plantilla de lanzamiento específica. 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— El ID de la plantilla de lanzamiento.

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

    • [--versiones (lista)"string" "string"] — Los números de versión de una o más versiones de la plantilla de lanzamiento que se van a eliminar.

    • [--min-versionstring] — El número de versión tras el que se describen las versiones de la plantilla de lanzamiento.

    • [--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 para incluir 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 devolverán 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 empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

  • describe-security-groups— Describe uno o más de sus grupos de seguridad.

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

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

    • [--group-idvalue] — El ID del grupo de seguridad.

    • [--tamaño de páginavalue] — El tamaño de cada página para entrar enAWSllamada de servicio. Este tamaño no afecta a la cantidad de elementos que se devuelven en la salida del comando. Si se establece un tamaño de página más pequeño, se generan más llamadas alAWSservicio, recuperando menos elementos en cada llamada. Este enfoque puede ayudar a prevenir laAWSse agota el tiempo de espera de las llamadas de servicio. Para ver ejemplos de uso, consultePaginaciónen elAWS Command Line InterfaceGuía del usuario.

    • [--max-itemsvalue] — El número total de elementos que se devolverán 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 delAWS CLI. Para ver ejemplos de uso, consultePaginaciónen elAWS Command Line InterfaceGuía del usuario.

    • [--starting-tokenvalue]: un token para especificar dónde empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada. Para ver ejemplos de uso, consultePaginaciónen elAWS Command Line InterfaceGuía del usuario.

  • describir etiquetas— Describe una o más de las etiquetas del 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

  • describir volúmenes— Describe los volúmenes de Amazon EBS especificados.

    • [--max-itemsvalue] — El número total de elementos que se devolverán 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-tokenvalue]: un token para especificar dónde empezar a paginar. Este token es el valor NextToken de una respuesta anterior que estaba truncada.

    • [--ID de volumenvalue] — Uno o más identificadores de volumen.

  • separar volumen— Separa 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 de Amazon EC2 de destino.

    • --identificador de volumenvalue— 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 plantilla 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— El ID de la plantilla de lanzamiento.

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

    • --versión predeterminadastring— El número de versión de la plantilla de lanzamiento que se va a establecer como versión predeterminada.

    • --punto finalsnowballEndpoint— Un valor que le permite administrar sus instancias informáticas mediante programación mediante operaciones de API compatibles con Amazon EC2. Para obtener más información, consulte Especificar el punto final compatible con Amazon EC2 comoAWS CLIPunto final.

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

    • instanceInitiatedShutdownBehavior

    • userData

  • revoke-security-group-egress— Elimina una o más reglas de salida de un grupo de seguridad:

    • [--id de grupovalue] — El ID del grupo de seguridad

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

  • revoke-security-group-ingress— Revoca una o más 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 del grupovalue] — El nombre del grupo de seguridad.

    • [--group-idvalue] — El ID del grupo de seguridad.

    • [--ip-permissionsvalue] — 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 van a permitir. Un entero único o un rango (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.

    • [--cidrvalue] — El rango de IP del CIDR.

  • instancias de ejecución— Lanza varias instancias informáticas mediante el uso de un ID de AMI de Snowball como AMI.

    nota

    El lanzamiento de una instancia de cómputo en un Snowball Edge puede tardar hasta una hora y media, en función del tamaño y el tipo de la instancia.

    • [--block-device-mappings (list)]— El dispositivo de bloques que mapea las entradas. 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 — Número de instancias que se van 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 AMI de Snowball de la AMI, que puede obtener llamandodescribe-images. La AMI es necesaria para lanzar una instancia.

    • --InstanceInitiatedShutdownBehavior— De forma predeterminada, cuando inicias el cierre de la instancia (mediante 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, consultaCambiar el comportamiento de cierre iniciado por la instanciaen elGuía del usuario de Amazon EC2 para instancias de Linux.

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

    • --plantilla de lanzamientostructure— La plantilla de lanzamiento que se utilizará para lanzar las 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 más identificadores de grupo de seguridad. Puede crear un grupo de seguridad medianteCreateSecurityGroup. 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 se van a 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 se pondrán 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 par de claves. Puede crear un par de claves medianteCreateKeyPairoImportKeyPair.

      aviso

      Si no especificas un par de claves, no podrás conectarte a la instancia a menos que elijas una AMI que esté configurada para permitir a los usuarios iniciar sesión de otra forma.

  • instancias de inicio— Inicia unsbeinstancia que ha detenido anteriormente. 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.

  • instancias de parada— 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.

  • instancias de terminación— Cierra 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. Sin embargo, puede utilizar elInstanceInitiatedShutdownBehavioratributo para cambiar este comportamiento de modo que estos comandos finalicen la instancia. Para obtener más información, consultaCambiar el comportamiento de cierre iniciado por la instanciaen elGuía del usuario de Amazon EC2 para instancias de Linux.

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

  • create-key-pair— Crea un par de claves 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 una clave privada PKCS #1 sin cifrar y codificada en PEM. Si ya existe una clave con el nombre especificado, Amazon EC2 devuelve un error.

    • --key-name (string): nombre exclusivo para el par de claves.

      Restricciones: hasta 255 caracteres ASCII.

    • [--tag-specifications] (lista): las etiquetas que se van a aplicar al nuevo par de claves.

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

  • import-key-pair –

    • --key-name (string): nombre exclusivo para el par de claves.

      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. En el caso de las herramientas de línea de comandos, la codificación base64 se realiza automáticamente.

    • [--tag-specifications] (lista): las etiquetas que se van a aplicar al nuevo par de claves.

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

  • describe-key-pairs –

    [--filters] (lista): los filtros.

    • key-pair-id— El ID del par de claves.

    • key-name: el nombre del par de claves.

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

    • [--tag-specifications] (lista): las etiquetas que se van a aplicar al nuevo par de claves.

    • 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 clave Owner y el valor Team A, especifique tag:Owner para el nombre del filtro y Team A para el valor del filtro.

    {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...

  • [--key-names] (lista): los nombres de los pares de claves.

    Predeterminado: describe todos los pares de claves.

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

  • delete-key-pair –

    • [--key-name] (cadena): el nombre del par de claves.

    • [--key-pair-id] (cadena): el ID del par de claves.

Operaciones de API compatibles con Amazon EC2 compatibles

A continuación, encontrará las operaciones de API compatibles con Amazon EC2 que puede utilizar con un Snowball Edge, con enlaces a sus descripciones en laReferencia de la API de Amazon EC2.Las llamadas a la API compatibles con Amazon EC2 requieren la firma de la versión 4 (SiGv4). Si está utilizando elAWS CLIo unAWSSDK para realizar estas llamadas a la API, la firma SigV4 se gestiona por ti. De lo contrario, debe implementar su propia solución de firma de SigV4. Para obtener más información, consulte Obtener y utilizar las credenciales locales de Amazon S3.