As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Usando o endpoint EC2 compatível com a Amazon em um Snowball Edge A seguir, você encontrará uma visão geral do endpoint EC2 compatível com a Amazon. Usando esse endpoint, você pode gerenciar suas Amazon Machine Images (AMIs) e computar instâncias de forma programática usando operações de API compatíveis com a EC2 Amazon. ## Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge Ao usar o AWS CLI para emitir um comando para o AWS Snowball Edge dispositivo, você pode especificar que o endpoint é EC2 compatível com a Amazon. Você tem a opção de usar o endpoint HTTPS ou um endpoint HTTP desprotegido, como mostrado a seguir. **Endpoint HTTPS protegido** ``` aws ec2 describe-instances --endpoint https://192.0.2.0:8243 --ca-bundle path/to/certificate ``` **Endpoint HTTP desprotegido** ``` aws ec2 describe-instances --endpoint http://192.0.2.0:8008 ``` Se você usar o endpoint HTTPS de `8243`, os dados em trânsito são criptografados. Essa criptografia é garantida com um certificado gerado pelo Snowball Edge quando é desbloqueado. Depois de receber o certificado, você poderá salvá-lo em um arquivo local `ca-bundle.pem`. Então você poderá configurar sua AWS CLI para incluir o caminho do seu certificado, conforme descrito a seguir. **Para associar seu certificado ao endpoint EC2 compatível com a Amazon** 1. Conecte o Snowball Edge à alimentação e à rede e, depois, ative-o. 1. Depois que o dispositivo terminar de desbloquear, anote o endereço IP dele na sua rede local. 1. Em um terminal na rede, verifique se é possível fazer ping no Snowball Edge. 1. Execute o comando `snowballEdge get-certificate` no seu terminal. Para obter mais informações sobre este comando, consulte [Gerenciando certificados de chave pública no Snowball Edge](snowball-edge-certificates-cli.md). 1. Salve a saída do comando `snowballEdge get-certificate` em um arquivo, por exemplo, `ca-bundle.pem`. 1. Execute o seguinte comando no seu terminal. ``` aws configure set profile.snowballEdge.ca_bundle /path/to/ca-bundle.pem ``` Depois de concluir o procedimento, execute comandos da CLI com essas credenciais locais, com o certificado e com o endpoint especificado. ## EC2 AWS CLI Comandos compatíveis com a Amazon suportados em um Snowball Edge Você pode gerenciar suas instâncias computacionais em um dispositivo Snowball Edge por meio de um endpoint compatível com a EC2 Amazon. Esse tipo de endpoint suporta muitos dos comandos e ações da Amazon EC2 CLI do. AWS SDKs Para obter informações sobre como instalar e configurar o AWS CLI, incluindo especificar para quem Regiões da AWS você deseja fazer AWS CLI chamadas, consulte o [Guia do AWS Command Line Interface usuário](https://docs.aws.amazon.com/cli/latest/userguide/). ### Lista de AWS CLI comandos EC2 compatíveis com suporte em um Snowball Edge A seguir, você encontrará uma descrição do subconjunto de AWS CLI comandos e opções da Amazon EC2 que são compatíveis com dispositivos Snowball Edge. Se um comando ou opção não estiver listado abaixo, não é compatível. É possível declarar algumas opções não compatíveis junto com um comando. No entanto, elas são ignoradas. + [associate-address](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-address.html) – associa um endereço IP virtual a uma instância para o uso em uma das três interfaces de rede físicas no dispositivo: + --instance-id – o ID de uma única instância `sbe`. + --public-ip – o endereço IP virtual que deseja usar para acessar a instância. + [attach-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/attach-volume.html): anexa um volume do Amazon EBS a uma instância em execução ou interrompida no dispositivo e o expõe para a instância com o nome de dispositivo especificado. + --device `value`: o nome do dispositivo. + --instance-id — O ID de uma instância de destino compatível com a Amazon. EC2 + --volume-id `value`: o ID do volume do EBS. + [authorize-security-group-egress](https://docs.aws.amazon.com/cli/latest/reference/ec2/authorize-security-group-egress.html)— Adiciona uma ou mais regras de saída a um grupo de segurança para uso com um dispositivo Snowball Edge. Especificamente, essa ação permite que as instâncias enviem tráfego para um ou mais intervalos de endereços IPv4 CIDR de destino. Para obter mais informações, consulte [Controle do tráfego de rede com grupos de segurança no Snowball Edge](edge-security-groups.md). + --group-id `value`: o ID do grupo de segurança + [--ip-permissions `value`]: um ou mais conjuntos de permissões de IP. + [authorize-security-group-ingress](https://docs.aws.amazon.com/cli/latest/reference/ec2/authorize-security-group-ingress.html)— Adiciona uma ou mais regras de entrada a um grupo de segurança. Ao chamar `authorize-security-group-ingress`, você deve especificar um valor para `group-name` ou para `group-id`. + [--group-name `value`]: o nome do grupo de segurança. + [--group-id `value`]: o ID do grupo de segurança + [--ip-permissions `value`]: um ou mais conjuntos de permissões de IP. + [--protocol `value`] o protocolo IP. Os valores possíveis são `tcp`, `udp` e `icmp`. O argumento `--port` é obrigatório, a menos que o valor "all protocols (todos os protocolos)" seja especificado (-1). + [--port `value`]: para TCP ou UDP, o intervalo de portas a ser permitido. Esse valor pode ser um único número inteiro ou um intervalo (mínimo - máximo). Para ICMP, um único número inteiro ou um intervalo (`type`-`code`) em que `type` representa o número do tipo ICMP e `code` representa o número do código ICMP. Um valor de -1 indica todos os códigos ICMP para todos os tipos ICMP. Um valor de -1 para `type` indica todos os códigos ICMP para o tipo ICMP especificado. + [--cidr `value`]: o intervalo de IPs CIDR. + [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html)— Cria um modelo de lançamento. Um *modelo de execução *contém os parâmetros para executar uma instância. Ao executar uma instância usando `RunInstances`, é possível especificar um modelo de execução em vez de fornecer os parâmetros de execução na solicitação. É possível criar até cem modelos por dispositivo. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + -- launch-template-data `structure` — As informações do modelo de lançamento. Há suporte para os seguintes atributos: + `ImageId` + `InstanceType` + `SecurityGroupIds` + `TagSpecifications` + `UserData` Sintaxe do 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-description `string`]: uma descrição para a primeira versão do modelo de inicialização. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [create-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template-version.html)— Cria uma nova versão para um modelo de lançamento. Você pode especificar uma versão existente de um modelo de execução para servir como base para a nova versão. As versões de modelo de execução são numeradas na ordem em que são criadas. Não é possível especificar, alterar ou substituir a numeração das versões do modelo de execução. Você pode criar até 100 versões de cada modelo de execução. Especifique na solicitação o ID ou o nome do modelo de execução. + -- launch-template-id `string` — O ID do modelo de lançamento. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + -- launch-template-data `structure` — As informações do modelo de lançamento. Há suporte para os seguintes atributos: + `ImageId` + `InstanceType` + `SecurityGroupIds` + `TagSpecifications` + `UserData` Sintaxe do 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" } ``` + [--source-version `string`]: o número de versão do modelo de execução que servirá como base para a nova versão. A nova versão herda os mesmos parâmetros de execução da versão de origem, exceto os parâmetros especificados em `launch-template-data`. + [--version-description `string`]: uma descrição para a primeira versão do modelo de inicialização. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [create-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-tags.html) – adiciona ou substitui uma ou mais tags do atributo especificado. Cada recurso pode ter um máximo de 50 tags. Cada tag consiste em uma chave e um valor opcional. As chaves de tag devem ser exclusivas para um recurso. Há suporte para os seguintes atributos: + AMI + Instância + Modelo de execução + Grupo de segurança + Par de chaves + [create-security-group](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-security-group.html)— Cria um grupo de segurança no seu Snowball Edge. Você pode criar até 50 grupos de segurança. Ao criar um grupo de segurança, você especifica um nome amigável de sua escolha: + --group-name `value`: o nome do grupo de segurança. + --description `value`: uma descrição do grupo de segurança. Isso é apenas informativo. Esse valor pode ter até 255 caracteres. + [create-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-volume.html): cria um volume do EBS que pode ser anexado a uma instância no dispositivo. + [--size`value`] — O tamanho do volume de entrada GiBs, que pode ser de 1 GiB a 1 TB ( GiBs1000). + [--snapshot-id `value`]: o ID do snapshot a partir do qual criar o volume. + [--volume-type `value`]: o tipo de volume. Se nenhum valor for especificado, o padrão será `sbg1`. Os valores possíveis incluem o seguinte: + `sbg1` para volumes magnéticos + `sbp1` para volumes SSD + [--tag-specification `value`]: uma lista de tags a serem aplicadas ao volume durante a criação. + [delete-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-launch-template.html)— Exclui um modelo de lançamento. A exclusão de um modelo de execução excluirá todas as suas versões. Especifique na solicitação o ID ou o nome do modelo de execução. + -- launch-template-id `string` — O ID do modelo de lançamento. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [delete-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-launch-template-version.html)— Exclui uma ou mais versões de um modelo de lançamento. Não é possível excluir a versão padrão de um modelo de execução; primeiro é necessário atribuir outra versão como padrão. Se a versão padrão for a única versão para o modelo de execução, exclua todo o modelo de execução usando o comando `delete-launch-template`. Especifique na solicitação o ID ou o nome do modelo de execução. + -- launch-template-id `string` — O ID do modelo de lançamento. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + --versions (list) `"string" "string"`: os números de versão de uma ou mais versões do modelo de inicialização a serem excluídas. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [delete-security-group](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-security-group.html)— Exclui um grupo de segurança. Se você tentar excluir um grupo de segurança associado a uma instância ou referenciado por outro grupo de segurança, ocorrerá uma falha na operação com `DependencyViolation`. + --group-name `value`: o nome do grupo de segurança. + --description `value`: uma descrição do grupo de segurança. Isso é apenas informativo. Esse valor pode ter até 255 caracteres. + [delete-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-tags.html): exclui o conjunto de tags especificado do atributo especificado (AMI, instância de computação, modelo de execução ou grupo de segurança). + [delete-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-volume.html): exclui o volume do Amazon EBS especificado. O volume deve estar no estado `available` (não anexado a uma instância). + --volume-id `value`: o ID do volume. + [describe-address](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-addresses.html): descreve um ou mais endereços IP virtuais associados ao mesmo número de instâncias `sbe` no dispositivo. + --public-ips – um ou mais endereços IP virtuais associados às instâncias. + [describe-images](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-images.html) — Descreve uma ou mais das imagens (AMIs) disponíveis para você. As imagens disponíveis são adicionadas ao dispositivo Snowball Edge durante a criação do trabalho. + --image-id: o ID do Snowball da AMI. + [describe-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-attribute.html)— Descreve o atributo especificado da instância especificada. Você só pode pesquisar um atributo de cada vez. Há suporte para os seguintes atributos: + `instanceInitiatedShutdownBehavior` + `instanceType` + `userData` + [describe-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instances.html) – descreve uma ou mais instâncias. A resposta retorna todos os grupos de segurança atribuídos às instâncias. + --instance-ids — A IDs de uma ou mais `sbe` instâncias que foram interrompidas no dispositivo. + --page-size: o tamanho de cada página para obtenção na chamada. Esse valor não afeta o número de itens retornados na saída do comando. Definir um tamanho de página menor resulta em mais chamadas para o dispositivo, recuperando menos itens em cada chamada. Fazer isso pode ajudar a evitar que as chamadas atinjam o tempo limite. + --max-items: o número total de itens para retornar na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. + --starting-token: um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. + [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html)— Descreve o status das instâncias especificadas ou de todas as suas instâncias. Por padrão, somente as instâncias em execução são descritas, a menos que você indique especificamente para exibir o status de todas as instâncias. O status da instância inclui os seguintes componentes: + **Verificações de status** — O dispositivo Snow realiza verificações de status na execução EC2 de instâncias compatíveis com a Amazon para identificar problemas de hardware e software. + **Estado da instância**: é possível gerenciar as instâncias desde o momento em que as inicia até o encerramento. Com esse comando, os filtros a seguir são compatíveis. + `[--filters]` (lista) Os filtros. + `instance-state-code`: o código do estado da instância, como um valor inteiro não assinado de 16 bits. O byte alto é usado para fins de geração de relatórios de serviços internos e deve ser ignorado. O byte baixo é definido com base no estado representado. Os valores válidos são 0 (pendente), 16 (em execução), 32 (desligando), 48 (encerrado), 64 (interrompendo) e 80 (interrompido). + `instance-state-name`: o estado da instância (`pending` \$1 `running` \$1 `shutting-down` \$1 `terminated` \$1 `stopping` \$1 `stopped`). + `instance-status.reachability`: filtra o status da instância em que o nome é `reachability` (`passed` \$1 `failed` \$1 `initializing` \$1 `insufficient-data`). + `instance-status.status`: o status da instância (`ok` \$1 `impaired` \$1 `initializing` \$1 `insufficient-data` \$1 `not-applicable`). + `system-status.reachability`: filtra o status do sistema em que o nome é acessibilidade (`passed` \$1 `failed` \$1 `initializing` \$1 `insufficient-data`). + `system-status.status`: o status do sistema da instância (`ok` \$1 `impaired` \$1 `initializing` \$1 `insufficient-data` \$1 `not-applicable`). + Sintaxe do JSON: ``` [ { "Name": "string", "Values": ["string", ...] } ... ] ``` + `[--instance-ids]` (lista) A instância IDs. Padrão: descreve todas as instâncias. + `[--dry-run|--no-dry-run]` (booliano) Confere se você tem as permissões necessárias para a ação, sem realmente fazer a solicitação, e fornece uma resposta de erro. Se você tiver as permissões necessárias, a resposta do erro será`DryRunOperation`. Caso contrário, ele será `UnauthorizedOperation`. + `[--include-all-instances | --no-include-all-instances]` (booliano) Quando `true`, inclui o status de integridade de todas as instâncias. Quando `false`, inclui o status de integridade somente das instâncias em execução. Padrão: `false` + `[--page-size]` (valor inteiro): o tamanho de cada página a ser obtida na chamada. Esse valor não afeta o número de itens retornados na saída do comando. Definir um tamanho de página menor resulta em mais chamadas para o dispositivo, recuperando menos itens em cada chamada. Fazer isso pode ajudar a evitar que as chamadas atinjam o tempo limite. + `[--max-items]` (valor inteiro): o número total de itens a serem gerados na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. + `[--starting-token]` (string): um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. + [describe-launch-templates](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-templates.html)— Descreve um ou mais modelos de lançamento. O comando `describe-launch-templates` é uma operação paginada. Você pode realizar várias chamadas para recuperar todo o conjunto de dados de resultados. Especifique o modelo de lançamento IDs ou os nomes do modelo de lançamento na solicitação. + -- launch-template-ids (lista) `"string" "string"` — Uma lista IDs dos modelos de lançamento. + -- launch-template-names (list) `"string" "string"` — Uma lista de nomes para os modelos de lançamento. + --page-size: o tamanho de cada página para obtenção na chamada. Esse valor não afeta o número de itens retornados na saída do comando. Definir um tamanho de página menor resulta em mais chamadas para o dispositivo, recuperando menos itens em cada chamada. Fazer isso pode ajudar a evitar que as chamadas atinjam o tempo limite. + --max-items: o número total de itens para retornar na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. + --starting-token: um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html)— Descreve uma ou mais versões de um modelo de lançamento especificado. Você pode descrever todas as versões, versões individuais ou um intervalo de versões. O comando `describe-launch-template-versions` é uma operação paginada. Você pode realizar várias chamadas para recuperar todo o conjunto de dados de resultados. Especifique o modelo de lançamento IDs ou os nomes do modelo de lançamento na solicitação. + -- launch-template-id `string` — O ID do modelo de lançamento. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + [--versions (list) `"string" "string"`]: os números de versão de uma ou mais versões do modelo de inicialização a serem excluídas. + [--min-version `string`]: o número da versão a partir da qual serão descritas versões do modelo de inicialização. + [--max-version `string`: o número da versão até a qual serão descritas versões do modelo de inicialização. + --page-size: o tamanho de cada página para obtenção na chamada. Esse valor não afeta o número de itens retornados na saída do comando. Definir um tamanho de página menor resulta em mais chamadas para o dispositivo, recuperando menos itens em cada chamada. Fazer isso pode ajudar a evitar que as chamadas atinjam o tempo limite. + --max-items: o número total de itens para retornar na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. + --starting-token: um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [describe-security-groups](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-security-groups.html)— Descreve um ou mais dos seus grupos de segurança. O comando `describe-security-groups` é uma operação paginada. É possível emitir várias chamadas da API para recuperar todo o conjunto de dados de resultados. + [--group-name `value`]: o nome do grupo de segurança. + [--group-id `value`]: o ID do grupo de segurança. + [--page-size`value`] — O tamanho de cada página para entrar na chamada de serviço. AWS Esse tamanho não afeta o número de itens retornados na saída do comando. A configuração de um tamanho menor de página ocasiona mais chamadas ao serviço da AWS recuperando menos itens em cada chamada. Essa abordagem pode ajudar a evitar que as chamadas AWS de serviço atinjam o tempo limite. Para obter exemplos de uso, consulte [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) no *Guia do usuário da AWS Command Line Interface *. + [--max-items `value`]: o número total de itens a serem exibidos na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. Não use o elemento de resposta `NextToken` diretamente fora da AWS CLI. Para obter exemplos de uso, consulte [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) no *Guia do usuário da AWS Command Line Interface *. + [--starting-token `value`]: um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. Para obter exemplos de uso, consulte [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) no *Guia do usuário da AWS Command Line Interface *. + [describe-tags](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-tags.html): descreve uma ou mais das tags para o atributo especificado (`image`, `instance` ou grupo de segurança). Com esse comando, há suporte para os seguintes filtros: + launch-template + resource-id + resource-type – `image` ou `instance` + key + valor + [describe-volumes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-volumes.html): descreve os volumes do Amazon EBS especificados. + [--max-items `value`]: o número total de itens a serem exibidos na saída do comando. Se o número total de itens disponíveis for maior que o valor especificado, um `NextToken` será fornecido na saída do comando. Para retomar a paginação, forneça o valor `NextToken` no argumento `starting-token` de um comando subsequente. + [--starting-token `value`]: um token para especificar onde iniciar a paginação. Esse token é o valor `NextToken` de uma resposta truncada anteriormente. + [--volume-ids`value`] — Um ou mais volumes. IDs + [detach-volume](https://docs.aws.amazon.com/cli/latest/reference/ec2/detach-volume.html): desanexa um volume do Amazon EBS de uma instância interrompida ou em execução. + [--device `value`]: o nome do dispositivo. + [--instance-id] — O ID de uma instância de destino da Amazon. EC2 + --volume-id `value`: o ID do volume. + [disassociate-address](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-address.html) – desassocia um endereço IP virtual da instância com a qual está associado. + --public-ip: o endereço IP virtual que você deseja dissociar da instância. + [get-launch-template-data](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-launch-template-data.html)— Recupera os dados de configuração da instância especificada. Use esses dados para criar um modelo de execução. + --instance-id – o ID de uma única instância `sbe`. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [modify-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-launch-template.html)— Modifica um modelo de lançamento. Você pode especificar qual versão do modelo de execução será definida como versão padrão. Ao executar uma instância sem especificar uma versão do modelo de execução, a versão padrão do modelo de execução será aplicada. Especifique na solicitação o ID ou o nome do modelo de execução. + -- launch-template-id `string` — O ID do modelo de lançamento. + -- launch-template-name `string` — Um nome para o modelo de lançamento. + --default-version `string`: o número da versão do modelo de inicialização a ser definida como versão padrão. + --endpoint `snowballEndpoint` — Um valor que permite gerenciar suas instâncias computacionais programaticamente usando operações de API compatíveis com a Amazon EC2. Para obter mais informações, consulte [Especificando o endpoint EC2 compatível como o endpoint AWS CLI em um Snowball Edge](#using-ec2-adapter-cli-endpoint). + [modify-instance-attribute](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-attribute.html)— Modifica um atributo da instância especificada. Há suporte para os seguintes atributos: + `instanceInitiatedShutdownBehavior` + `userData` + [revoke-security-group-egress](https://docs.aws.amazon.com/cli/latest/reference/ec2/revoke-security-group-egress.html)— Remove uma ou mais regras de saída de um grupo de segurança: + [--group-id `value`]: o ID do grupo de segurança + [--ip-permissions `value`]: um ou mais conjuntos de permissões de IP. + [revoke-security-group-ingress](https://docs.aws.amazon.com/cli/latest/reference/ec2/revoke-security-group-ingress.html)— Revoga uma ou mais regras de entrada em um grupo de segurança. Ao chamar `revoke-security-group-ingress`, você deve especificar um valor para `group-name` ou para`group-id`. + [--group-name `value`]: o nome do grupo de segurança. + [--group-id `value`]: o ID do grupo de segurança. + [--ip-permissions `value`]: um ou mais conjuntos de permissões de IP. + [--protocol `value`] o protocolo IP. Os valores possíveis são `tcp`, `udp` e `icmp`. O argumento `--port` é obrigatório, a menos que o valor "all protocols (todos os protocolos)" seja especificado (-1). + [--port `value`]: para TCP ou UDP, o intervalo de portas a ser permitido. Um único número inteiro ou um intervalo (mínimo - máximo). Para ICMP, um único número inteiro ou um intervalo (`type`-`code`) em que `type` representa o número do tipo ICMP e `code` representa o número do código ICMP. Um valor de -1 indica todos os códigos ICMP para todos os tipos ICMP. Um valor de -1 para `type` indica todos os códigos ICMP para o tipo ICMP especificado. + [--cidr `value`: o intervalo de IPs CIDR. + [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html): inicia várias instâncias de computação usando um ID do Snowball de uma AMI. **nota** Pode levar até uma hora e meia para iniciar uma instância de computação em um Snowball Edge, dependendo do tamanho e do tipo de instância. + [-- block-device-mappings `(list)]` — As entradas de mapeamento do dispositivo de bloqueio. Os parâmetros `DeleteOnTermination`, `VolumeSize`, e `VolumeType` têm suporte. Os volumes de devem ser do tipo `sbg1`. A sintaxe JSON para esse comando é conforme a seguir. ``` { "DeviceName": "/dev/sdh", "Ebs": { "DeleteOnTermination": true|false, "VolumeSize": 100, "VolumeType": "sbp1"|"sbg1" } } ``` + --count: número de instâncias a serem iniciadas. Se um único número for fornecido, é considerado como mínimo para iniciar (o padrão é 1). Se um intervalo for fornecido na forma `min:max`, o primeiro número será interpretado como o número mínimo de instâncias a serem iniciadas e o segundo será interpretado como o número máximo de instâncias a serem iniciadas. + --image-id: o ID do Snowball da AMI, que pode ser obtido chamando `describe-images`. É necessária uma AMI para executar uma instância. + -- InstanceInitiatedShutdownBehavior — Por padrão, quando você inicia um desligamento da sua instância (usando um comando como shutdown ou poweroff), a instância é interrompida. É possível alterar esse comportamento para que, em vez disso, seja encerrada. Os parâmetros `stop` e `terminate` são compatíveis. O padrão é `stop`. Para obter mais informações, consulte [Alteração do comportamento de desligamento iniciado pela instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior) no *Guia do EC2 usuário da Amazon para instâncias Linux*. + --instance-type – o tipo de instância `sbe`. + --launch-template `structure`: o modelo de inicialização a ser usado para iniciar as instâncias. Os parâmetros especificados no comando `run-instances` substituem os mesmos parâmetros no modelo de execução. Você pode especificar o nome ou o ID de um modelo de execução, mas não ambos. ``` { "LaunchTemplateId": "string", "LaunchTemplateName": "string", "Version": "string" } ``` + -- security-group-ids — Um ou mais grupos de segurança IDs. Você pode criar um grupo de segurança usando [CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html)o. Se nenhum valor for fornecido, o ID do grupo de segurança padrão será atribuído às instâncias criadas. + --tag-specifications: as tags a serem aplicadas aos recursos durante a execução. Só é possível marcar instâncias na execução. As tags especificadas são aplicadas a todas as instâncias que são criadas durante a execução. Para marcar um recurso após sua criação, use `create-tags`. + --user-data: os dados de usuário que são disponibilizados para a instância. Se você estiver usando o AWS CLI, a codificação base64 será executada para você e você poderá carregar o texto de um arquivo. Caso contrário, você deve fornecer o texto codificado em base64. + --key-name (string): o nome do par de chaves. É possível criar um par de chaves usando `CreateKeyPair` ou `ImportKeyPair`. **Atenção** Se você não especificar um par de chaves, não conseguirá se conectar à instância a menos que selecione uma AMI configurada para permitir aos usuários uma maneira de fazer login. + [start-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/start-instances.html): inicia uma instância `sbe` interrompida anteriormente. Todos os recursos anexados à instância persistem durante inícios e interrupções, mas são apagados se a instância for encerrada. + --instance-ids — A IDs de uma ou mais `sbe` instâncias que foram interrompidas no dispositivo. + [stop-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/stop-instances.html): interrompe uma instância `sbe` em execução. Todos os recursos anexados à instância persistem durante inícios e interrupções, mas são apagados se a instância for encerrada. + --instance-ids — A IDs de uma ou mais `sbe` instâncias a serem interrompidas no dispositivo. + [terminate-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/terminate-instances.html): desliga uma ou mais instâncias. Essa operação é idempotente. Se você encerrar uma instância mais de uma vez, cada chamada será bem-sucedida. Todos os atributos anexados à instância persistem aos inícios e interrupções, mas os dados são apagados se a instância for encerrada. **nota** Por padrão, ao usar um comando como `shutdown` ou `poweroff` para iniciar um desligamento em sua instância, a instância será interrompida. No entanto, é possível usar o atributo `InstanceInitiatedShutdownBehavior` para alterar o comportamento para que esses comandos encerrem a instância. Para obter mais informações, consulte [Alteração do comportamento de desligamento iniciado pela instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html#Using_ChangingInstanceInitiatedShutdownBehavior) no *Guia do EC2 usuário da Amazon para instâncias Linux*. + --instance-ids — A IDs de uma ou mais `sbe` instâncias a serem encerradas no dispositivo. Todos os dados associados armazenados para essas instâncias serão perdidos. + [create-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-key-pair.html)— Cria um par de chaves RSA de 2048 bits com o nome especificado. A Amazon EC2 armazena a chave pública e exibe a chave privada para você salvar em um arquivo. A chave privada é gerada como uma chave privada PKCS\$11 codificada por PEM descriptografada. Se uma chave com o nome especificado já existir, a Amazon EC2 retornará um erro. + --key-name (string): um nome exclusivo para o par de chaves. Restrições: até 255 caracteres ASCII. + [--tag-specifications] (list): as tags a serem aplicadas ao novo par de chaves. ``` { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ... ``` + [import-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/import-key-pair.html) – + --key-name (string): um nome exclusivo para o par de chaves. Restrições: até 255 caracteres ASCII. + -- public-key-material (blob) — A chave pública. Para chamadas da API, o texto deve ser codificado em base64. Para ferramentas de linha de comando, a codificação base64 é realizada para você. + [--tag-specifications] (list): as tags a serem aplicadas ao novo par de chaves. ``` { "ResourceType": "image"|"instance"|"key-pair"|"launch-template"|"security-group", "Tags": [ { "Key": "string", "Value": "string" } ... ] } ``` + [describe-key-pairs](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-key-pairs.html) – [--filters] (list): os filtros. + key-pair-id — O ID do par de chaves. + key-name: o nome do par de chaves. + tag-key: a chave de uma tag atribuída ao recurso. Use esse filtro para encontrar todos os recursos atribuídos a uma tag com uma chave específica, independentemente do valor da tag. + [--tag-specifications] (list): as tags a serem aplicadas ao novo par de chaves. + tag:key — A key/value combinação de uma tag atribuída ao recurso. Use a chave de etiqueta no nome do filtro e o valor da etiqueta como o valor do filtro. Por exemplo, para encontrar todos os recursos que têm uma etiqueta com a chave `Owner` e o valor `Team A`, especifique `tag:Owner` para o nome do filtro e `Team A` no valor do filtro. ``` { "Name": "string", "Values": ["string", ...] } ... ``` + [--key-names] (list): os nomes dos pares de chaves. Padrão: descreve todos os pares de chaves. + [--key-pair-ids] (lista) — O IDs dos pares de chaves. + [delete-key-pair](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-key-pair.html) – + [--key-name] (string): o nome do par de chaves. + [--key-pair-id] (string) — O ID do par de chaves. ## Operações de API EC2 compatíveis com a Amazon suportadas em um Snowball Edge A seguir, você encontrará operações EC2 de API compatíveis com a Amazon que podem ser usadas com o Snowball Edge, com links para suas descrições na * EC2 Amazon* API Reference.As chamadas EC2 de API compatíveis com a Amazon exigem a assinatura do Signature Version 4 (SigV4). Se você estiver usando o AWS CLI ou um AWS SDK para fazer essas chamadas de API, a assinatura SigV4 é feita para você. Caso contrário, você precisará implementar sua própria solução de assinatura do SigV4. Para obter mais informações, consulte [Obter e usar credenciais locais do Amazon S3 no Snowball Edge](using-adapter.md#adapter-credentials). + [AssociateAddress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AssociateAddress.html)— Associa um endereço IP elástico a uma instância ou interface de rede. + [AttachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AttachVolume.html)— Os seguintes parâmetros de solicitação são suportados: + `Device` + `InstanceId` + `VolumeId` + [AuthorizeSecurityGroupEgress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupEgress.html)— Adiciona uma ou mais regras de saída a um grupo de segurança para uso com um dispositivo Snowball Edge. Especificamente, essa ação permite que as instâncias enviem tráfego para um ou mais intervalos de endereços IPv4 CIDR de destino. + [AuthorizeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_AuthorizeSecurityGroupIngress.html)— Adiciona uma ou mais regras de entrada a um grupo de segurança. Ao chamar AuthorizeSecurityGroupIngress, você deve especificar um valor para `GroupName` ou`GroupId`. + [CreateVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateVolume.html)— Os seguintes parâmetros de solicitação são suportados: + `SnapshotId` + `Size` + `VolumeType` + `TagSpecification.N` + [CreateLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplate.html)— Os seguintes parâmetros de solicitação são suportados: + `ImageId` + `InstanceType` + `SecurityGroupIds` + `TagSpecifications` + `UserData` + [CreateLaunchTemplateVersion](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateLaunchTemplateVersion.html) + [CreateTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateTags.html)— Os seguintes parâmetros de solicitação são suportados: + `AMI` + `Instance` + `Launch template` + `Security group` + [CreateSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_CreateSecurityGroup.html)— Cria um grupo de segurança no seu Snowball Edge. Você pode criar até 50 grupos de segurança. Ao criar um grupo de segurança, você especifica um nome amigável de sua escolha. + [DeleteLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteLaunchTemplate.html) + [DeleteLaunchTemplateVersions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteLaunchTemplateVersions.html) + [DeleteSecurityGroup](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteSecurityGroup.html)— Exclui um grupo de segurança. Se você tentar excluir um grupo de segurança associado a uma instância ou referenciado por outro grupo de segurança, ocorrerá uma falha na operação com `DependencyViolation`. + [DeleteTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteTags.html)— Exclui o conjunto especificado de tags do conjunto especificado de recursos. + [DeleteVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DeleteVolume.html)— Os seguintes parâmetros de solicitação são suportados: + `VolumeId` + [DescribeAddresses](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAddresses.html) + [DescribeImages](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeImages.html) + [DescribeInstanceAttribute](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceAttribute.html)— Os seguintes atributos são suportados: + `instanceType` + `userData` + [DescribeInstanceStatus](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstanceStatus.html) + [DescribeLaunchTemplates](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeLaunchTemplates.html) + [DescribeLaunchTemplateVersions](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeLaunchTemplateVersions.html) + [DescribeInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeInstances.html) + [DescribeSecurityGroups](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeSecurityGroups.html)— Descreve um ou mais dos seus grupos de segurança. `DescribeSecurityGroups`é uma operação paginada. É possível emitir várias chamadas da API para recuperar todo o conjunto de dados de resultados. + [DescribeTags](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeTags.html)— Com esse comando, os seguintes filtros são suportados: + `resource-id` + `resource-type`: apenas AMI ou instância de computação + `key` + `value` + [DescribeVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeVolumes.html)— Os seguintes parâmetros de solicitação são suportados: + `MaxResults` + `NextToken` + `VolumeId.N` + [DetachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DetachVolumes.html)— Os seguintes parâmetros de solicitação são suportados: + `Device` + `InstanceId` + `VolumeId` + [DisassociateAddress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DisassociateAddress.html) + [GetLaunchTemplateData](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_GetLaunchTemplateData.html) + [ModifyLaunchTemplate](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyLaunchTemplate.html) + [ModifyInstanceAttribute](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyInstanceAttribute.html)— Somente o `userData` atributo é suportado. + [RevokeSecurityGroupEgress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RevokeSecurityGroupEgress.html)— Remove uma ou mais regras de saída de um grupo de segurança. + [RevokeSecurityGroupIngress](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RevokeSecurityGroupIngress.html)— Revoga uma ou mais regras de entrada em um grupo de segurança. Ao chamar RevokeSecurityGroupIngress, você deve especificar um valor para `group-name` ou`group-id`. + [RunInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) – **nota** Pode levar até uma hora e meia para iniciar uma instância de computação em um Snowball Edge, dependendo do tamanho e do tipo de instância. + [StartInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StartInstances.html) + [StopInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_StopInstances.html)— Os recursos associados a uma instância parada persistem. Você pode encerrar a instância para liberar esses atributos. No entanto, todos os dados associados serão excluídos. + [TerminateInstances](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_TerminateInstances.html)