RDS Subnet Group

6 min

Resumo

Cria, modifica e deleta grupos subnets RDS.

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
aws_access_key aliases: ec2_access_key, access_key	string		Chave de acesso AWS. Se não for definido, o valor da variável de ambiente AWS_ACCESS_KEY_ID, AWS_ACCESS_KEY ou EC2_ACCESS_KEY será usado.
aws_ca_bundle	path		A localização de um pacote CA para usar ao validar certificados SSL.Usado apenas para módulos baseados em boto3.Observação: o pacote CA é lido no lado do 'módulo' e pode precisar ser copiado explicitamente do controlador se não for executado localmente.
aws_secret_key aliases: ec2_secret_key, secret_key	string		Chave secreta da AWS. Se não for definido, o valor da variável de ambiente AWS_SECRET_ACCESS_KEY, AWS_SECRET_KEY ou EC2_SECRET_KEY será usado.
debug_botocore_endpoint_logs	boolean	Escolhas: - true - false(default)	Use um registrador botocore.endpoint para analisar as chamadas de API únicas (em vez do total) "resource:action" feitas durante uma tarefa, gerando o conjunto para a chave resource_actions nos resultados da tarefa. Use o retorno de chamada aws_resource_action para enviar para a lista total feita durante uma cartilha.
description	string		Descrição da database do grupo subnet. Requerido quando state=present.
ec2_url	string		URL a ser usada para se conectar ao EC2 ou à sua nuvem de eucalipto (por padrão, o módulo usará pontos finais EC2). Ignorado para módulos onde a região é necessária. Deve ser especificado para todos os outros módulos se a região não for usada. Se não for definido, o valor da variável de ambiente EC2_URL, se houver, será usado.
name	string		Identificador do database do grupo subnet
profile	string		Usa um perfil boto. Só funciona com boto >= 2.24.0.
region aliases: aws_region, ec2_region	string		A região da AWS a ser usada. Se não for especificado, o valor da variável de ambiente AWS_REGION ou EC2_REGION, se houver, será usado. Consulte http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region
security_token aliases: access_token	string		Token de segurança AWS STS. Se não for definido, o valor da variável de ambiente AWS_SECURITY_TOKEN ou EC2_SECURITY_TOKEN será usado.
state	string	Escolhas: - absent -present(default)	Especifica se o subnet deve estar presente ou ausente.
subnet	list/elements=string		Lista de IDs dos subnets que fazem parte do database do grupo subnet. Requerido quando state=present.
validate_certs	boolean	Escolhas: - true - false(default)	Quando definido como "false", os certificados SSL não serão validados para versões boto >= 2.6.0.

Extende fragmentos da documentação do módulo aws e ec2.

Notas

Nota

Se os parâmetros não forem definidos no módulo, as seguintes variáveis de ambiente podem ser usadas em ordem decrescente de precedência:
- AWS_URL ou EC2_URL,
- AWS_ACCESS_KEY_ID ou AWS_ACCESS_KEY ou EC2_ACCESS_KEY,
- AWS_SECRET_ACCESS_KEY ou AWS_SECRET_KEY ou EC2_SECRET_KEY,
- AWS_SECURITY_TOKEN ou EC2_SECURITY_TOKEN,
- AWS_REGION ou EC2_REGION
O Atmosphereusa o arquivo de configuração boto (geralmente ~/.boto) se nenhuma credencial for fornecida. Veja https://boto.readthedocs.io/en/latest/boto_config_tut.html
AWS_REGION ou EC2_REGION geralmente podem ser usados para especificar a região da AWS, quando necessário, mas isso também pode ser configurado no arquivo de configuração boto.

Exemplos

- name: Add or change a subnet group
  community.aws.rds_subnet_group:
    state: present
    name: norwegian-blue
    description: My Fancy Ex Parrot Subnet Group
    subnets:
      - subnet-aaaaaaaa
      - subnet-bbbbbbbb

- name: Remove a subnet group
  community.aws.rds_subnet_group:
    state: absent
    name: norwegian-blue

Valores retornados

Chave	Tipo	Retornado quando	Descrição
subnet_group	complex	state=present	Dict de valores do grupo subnet do DB

Subcampos de subnet group

Chave	Tipo	Retornado quando	Descrição
db_subnet_group_arn	string	state=present	O ARN do grupo subnet do DB
db_subnet_group_description	string	state=present	A descrição do grupo subnet do DB
db_subnet_group_name	string	state=present	O nome do grupo subnet do DB
description	string	state=present	A descriação do grupo subnet do DB
name	string	state=present	O nome do grupo subnet do DB
status	string	state=present	Status do grupo subnet do DB
subnet_group_status	string	state=present	Status do grupo subnet do DB
subnet_ids	list / elements=string	state=present	Contém uma lista dos IDs dos subnets
subnets	list / elements=string	state=present	Contém uma lista dos IDs dos subnets (Veja: https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/rds.html#RDS.Client.describe_db_subnet_groups)
vpc_id	string	state=present	O VpcId do grupo subnet do DB