CLI da AWS é uma ferramenta poderosa baseada em comandos para fácil acesso e gerenciamento de serviços AWS. Com este utilitário, os usuários podem comunicar, configurar, automatizar, baixar ou manipular diretamente os recursos. Como o nome sugere, ele opera com comandos que aceitam vários sinalizadores. Um desses comandos é o “descrever sub-redes” comando na AWS CLI.
Esboço rápido
Este artigo cobre os seguintes aspectos:
- Qual é o comando description-subnet na AWS CLI?
- Como usar o comando descreva-subnet no AWS CLI?
- Conclusão
Antes de entender o “descrever sub-redes” comando, vamos primeiro entender o conceito de VPCs. Na AWS, o Nuvem privada virtual (VPC) é uma rede de recursos globais que fornece controle e gerenciamento total das redes, recursos e conectividade aos seus usuários. Dentro da VPC, existem diferentes sub-redes. A sub-rede é uma ampla variedade de endereços IP. Após configurar uma VPC, o usuário pode adicionar recursos, por exemplo, instâncias EC2, bancos de dados relacionais, etc. Esses recursos serão acessíveis globalmente com os endereços IP atribuídos nas sub-redes da VPC.
Consulte Mais informação: Como usar VPC | Primeiros passos com AWS
O que é o comando “describe-subnets” no AWS CLI?
O “descrever sub-redes” O comando lista todas as sub-redes de uma determinada conta. Ele suporta paginação por padrão, que pode ser desabilitada usando o “–não-paginar” bandeira. O “descrever sub-redes” O comando na AWS CLI emite várias chamadas de API para o serviço para recuperar os dados quando a paginação está habilitada.
Consulte Mais informação: Como desabilitar a página no AWS CLI?
Como usar o comando “describe-subnets” no AWS CLI?
Existem diversas opções disponíveis para filtragem, consulta, especificação de sub-redes ou exibição de dados em diferentes formatos de saída. Este comando é comumente usado com a instância EC2.
Sintaxe
A sintaxe do comando é a seguinte:
aws ec2 descreve sub-redes < Opções >
Opções
Abaixo está uma breve descrição das opções para o “descrever sub-redes” comando:
| Opções | Descrição |
| –filtros | A opção –filters é usada para extrair os detalhes específicos dos dados. A seguir estão os diferentes tipos de filtros suportados pelo “descrever sub-redes” comando:
– zona de disponibilidade: Esta opção serve para filtrar usando a zona de disponibilidade da sub-rede. – ID da zona de disponibilidade: Refere-se ao ID da zona de disponibilidade. – Disponibilidade-contagem de endereços IP: O número de endereços IPv4 disponíveis. – Bloco CIDR: Esta opção refere-se ao bloco CIDR IPV4. O bloco CIDR fornecido pelo usuário deve corresponder exatamente àquele dentro de uma sub-rede. – ID do proprietário: O ID da conta do proprietário da sub-rede – marcação: Os pares chave-valor que formam uma tag também podem ser usados como um tipo de filtro para extrair resultados específicos.
Vários tipos de filtro também estão disponíveis. Para ler mais sobre eles, consulte o Documentação da AWS. |
| –subnet-ids | Este parâmetro insere o ID de uma sub-rede específica para listagem. |
| -funcionamento a seco | Este parâmetro verifica se o usuário tem permissão para as ações ou não. A saída está no formato de erro. Se o usuário estiver equipado com a permissão necessária, a saída conterá o “Operação DryRun” . Por outro lado, se o usuário não contiver nenhuma permissão para a ação, a saída conterá o “Operação não autorizada” . Para desativar esta funcionalidade, use o “–sem simulação” opção. |
| –cli-input-json | O –cli-input-json é usado para fornecer várias instruções JSON de uma vez para o serviço AWS. As instruções são fornecidas no formato JSON que é gerado pelo “–gerar-cli-esqueleto” parâmetro. |
| –token inicial | O parâmetro aceita o valor do PróximoToken parâmetro. É do tipo string e o NextToken é gerado quando há mais dados para listar. O valor do NextToken fornecido para este campo especificará onde iniciar a paginação. |
| -tamanho da página | Este parâmetro especifica o tamanho da página que será usado em cada chamada de serviço da AWS. Tamanho de página menor resulta em mais chamadas de API para o serviço. Isso evita o tempo limite, recuperando menos dados em cada chamada de serviço. |
| –max-itens | O parâmetro –max-items exibe dados limitados por resposta. Se houver mais dados para listar, a saída do comando conterá o “Próximo Token” valor que retomará a listagem dos dados quando o comando for executado novamente. |
| –gerar-cli-esqueleto | Este parâmetro é usado para criar o esqueleto ou modelo JSON para que várias instruções sejam fornecidas de uma vez. Este modelo é usado pelo parâmetro –cli-input-json. |
Existem também opções globais disponíveis que podem ser usadas com “descrever sub-redes” comando. Opções globais são aquelas opções que podem ser usadas com vários comandos da AWS CLI. Para ler sobre essas opções, consulte o Documentação da AWS .
Exemplos
Esta seção do artigo demonstra o uso desses sinalizadores com o “ descrever sub-redes” comando:
- Exemplo 1: Como descrever todas as sub-redes usando o comando “describe-subnets”?
- Exemplo 2: Como descrever uma sub-rede específica por meio do comando “describe-subnets”?
- Exemplo 3: Como filtrar detalhes de uma sub-rede por meio do comando “describe-subnets”?
- Exemplo 4: Como determinar permissões por meio do comando “describe-subnets”?
- Exemplo 5: Como exibir a saída em vários formatos usando o comando “describe-subnets”?
- Exemplo 6: Como listar um número limitado de sub-redes por meio do comando “describe-subnets”?
- Exemplo 7: Como consultar detalhes específicos de uma sub-rede por meio dos comandos “describe-subnets”?
- Exemplo 8: Como listar tags de sub-rede usando o comando “describe-subnet”?
Exemplo 1: Como descrever todas as sub-redes usando o comando “describe-subnets”?
Para listar todas as sub-redes de uma determinada conta, use o seguinte comando:
aws ec2 descreve sub-redes
Saída
Exemplo 2: Como descrever uma sub-rede específica por meio do comando “describe-subnets”?
Para adquirir o ID da sub-rede da sua instância EC2, clique na instância EC2 em seu painel. Isso exibirá a configuração da instância EC2. Clique no “Rede” guia da interface exibida. Dentro do “Detalhes da rede” seção, copie o ID da sub-rede do “ID da sub-rede” campo:
Para listar uma sub-rede específica, o comando é dado da seguinte forma:
aws ec2 descreve sub-redes --subnet-ids < sub-rede >
Substitua o
Saída
Exemplo 3: Como filtrar detalhes de uma sub-rede por meio do comando “describe-subnets”?
Diferentes filtros estão disponíveis para filtrar as sub-redes, ou seja, zonas de disponibilidade, ID do proprietário, bloco CIDR, etc. Para determinar a zona de disponibilidade para sua instância do EC2, clique no nome da instância no painel do EC2. Isso exibirá as configurações da instância EC2 dentro do “Rede” aba. Nesta guia, localize o “Zona de disponibilidade” e copie o ID dele:
Para filtrar as sub-redes com base na zona de disponibilidade , o comando é dado abaixo:
aws ec2 descreve sub-redes --filtros 'Nome=zona de disponibilidade,Valores=ap-sudeste-1b'
Substitua o valor “ ap-sudeste-1b ”Com o nome da zona de disponibilidade copiado.
Saída
O ID da conta AWS pode ser determinado clicando no nome de usuário no canto superior direito. Copie o ID da conta clicando no 'cópia de' ícone na lista suspensa para copiar o ID da conta:
Similarmente a filtrar as sub-redes com base no ID da conta do usuário, o seguinte comando é usado:
aws ec2 descreve sub-redes --filtros 'Nome=id do proprietário, Valores=
Substitua o “
Saída
A saída do comando é a seguinte:
Exemplo 4: Como determinar permissões por meio do comando “describe-subnets”?
Para determinar as permissões para uma sub-rede específica, o -funcionamento a seco opção é usada. Este campo segue o formato de erro e é utilizado da seguinte forma:
aws ec2 descreve sub-redes --funcionamento a seco
Saída
A saída do comando é a seguinte:
Por outro lado, caso o usuário queira desabilitar esta opção e listar todos os balanceadores de carga, utilize o seguinte comando:
aws ec2 descreve sub-redes --no-dry-run
Saída
A saída do comando é a seguinte:
Exemplo 5: Como exibir a saída em vários formatos usando o comando “describe-subnets”?
Vários formatos de saída são suportados pelo descrever sub-redes comando da AWS. Isso inclui JSON, YAML ou texto. O usuário pode simplesmente substituir o valor do campo –output:
aws ec2 descreve sub-redes --saída mesa
Substitua o mesa valor no -saída campo com diferentes formatos de saída, ou seja, JSON, YAML ou texto.
Saída
A saída do comando é a seguinte:
Exemplo 6: Como listar um número limitado de sub-redes por meio do comando “describe-subnets”?
O –max-items é usado para limitar o número de sub-redes em uma única resposta:
aws ec2 descreve sub-redes --max-itens 1
Substitua o valor “1” por qualquer valor numérico de sua escolha entre 1 e 1000.
Saída
A saída do comando é a seguinte:
Forneça o valor do NextToken da saída para o –token inicial . Este token continuará listando os dados do próximo balanceador de carga em diante:
aws ec2 descreve sub-redes --token inicial < PróximoToken >
Substitua
Saída
A saída do código é a seguinte:
Exemplo 7: Como consultar detalhes específicos de uma sub-rede por meio do comando “describe-subnet”?
A saída do “descrever sub-redes” O comando consiste em uma matriz de sub-rede. Para extrair as informações específicas do array Subnet, o seguinte comando é usado:
aws ec2 descreve sub-redes --consulta 'Sub-redes[*].SubnetId'
Saída
A saída do comando é a seguinte:
Exemplo 8: Como listar tags de sub-rede usando o comando “describe-subnets”?
Outro método de filtrar as sub-redes é usar tags. Uma tag é um par de chaves chave-valor. 59 tags podem ser associadas a um único recurso AWS. Para determinar a chave de uma sub-rede, visite o “VPC” serviço pesquisando-o na barra de pesquisa do AWS Management Console. Clique na opção “Sub-rede” no painel de serviço VPC:
De Sub-redes painel, selecione uma sub-rede. Isso exibirá suas configurações. Clique no 'Tag' guia e copie o nome e o valor na guia 'Chave' e 'Valor' Campos:
O seguinte comando é usado para filtrar as sub-redes por tags:
aws ec2 descreve sub-redes --filtros 'Nome=tag:
Substitua o valor “
Saída
A saída do comando é a seguinte:
Isso é tudo deste guia.
Conclusão
Para listar sub-redes na AWS CLI, use o “descrever sub-redes” comando. Ele descreve todas ou sub-redes específicas em uma VPC e aceita diversas opções para ações distintas. Para usuários da AWS, o “descrever sub-redes” O comando pode ajudar na configuração e solução de problemas da rede. Para usar este comando, configure a AWS CLI e forneça os comandos acima ao terminal. Este artigo é uma demonstração passo a passo do uso do descrever sub-redes comando na AWS CLI.