ansible / ansible.builtin / v2.6.20 / module / rds_snapshot_facts obtain facts about one or more RDS snapshots | "added in version" 2.6 of ansible.builtin" Authors: Will Thames (@willthames) preview | supported by communityansible.builtin.rds_snapshot_facts (v2.6.20) — module
pip
Install with pip install ansible==2.6.20
obtain facts about one or more RDS snapshots. These can be for unclustered snapshots or snapshots of clustered DBs (Aurora)
Aurora snapshot facts may be obtained if no identifier parameters are passed or if one of the cluster parameters are passed.
# Get facts about an snapshot - rds_snapshot_facts: db_snapshot_identifier: snapshot_name register: new_database_facts
# Get all RDS snapshots for an RDS instance - rds_snapshot_facts: db_instance_identifier: helloworld-rds-master
region: aliases: - aws_region - ec2_region description: - The AWS region to use. If not specified then the value of the AWS_REGION or EC2_REGION environment variable, if any, is used. See U(http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region) type: str profile: aliases: - aws_profile description: - The I(profile) option is mutually exclusive with the I(aws_access_key), I(aws_secret_key) and I(security_token) options. type: str aws_config: description: - A dictionary to modify the botocore configuration. - Parameters can be found at U(https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html#botocore.config.Config). type: dict endpoint_url: aliases: - ec2_url - aws_endpoint_url - s3_url description: - URL to use to connect to EC2 or your Eucalyptus cloud (by default the module will use EC2 endpoints). Ignored for modules where region is required. Must be specified for all other modules if region is not used. If not set then the value of the EC2_URL environment variable, if any, is used. type: str aws_ca_bundle: description: - The location of a CA Bundle to use when validating SSL certificates. - 'Note: The CA Bundle is read ''module'' side and may need to be explicitly copied from the controller if not run locally.' type: path snapshot_type: choices: - automated - manual - shared - public description: - Type of snapshot to find. By default both automated and manual snapshots will be returned. required: false aws_access_key: aliases: - ec2_access_key - access_key description: - C(AWS access key). If not set then the value of the C(AWS_ACCESS_KEY_ID), C(AWS_ACCESS_KEY) or C(EC2_ACCESS_KEY) environment variable is used. - The I(aws_access_key) and I(profile) options are mutually exclusive. type: str aws_secret_key: aliases: - ec2_secret_key - secret_key description: - C(AWS secret key). If not set then the value of the C(AWS_SECRET_ACCESS_KEY), C(AWS_SECRET_KEY), or C(EC2_SECRET_KEY) environment variable is used. - The I(aws_secret_key) and I(profile) options are mutually exclusive. type: str security_token: aliases: - aws_session_token - session_token - aws_security_token - access_token description: - C(AWS STS security token). If not set then the value of the C(AWS_SECURITY_TOKEN) or C(EC2_SECURITY_TOKEN) environment variable is used. - The I(security_token) and I(profile) options are mutually exclusive. - Aliases I(aws_session_token) and I(session_token) have been added in version 3.2.0. type: str validate_certs: default: true description: - When set to "no", SSL certificates will not be validated for communication with the AWS APIs. type: bool db_cluster_identifier: description: - RDS cluster name for which to find snapshots. Mutually exclusive with I(db_snapshot_identifier), I(db_instance_identifier), I(db_cluster_snapshot_identifier) required: false db_instance_identifier: description: - RDS instance name for which to find snapshots. Mutually exclusive with I(db_snapshot_identifier), I(db_cluster_identifier), I(db_cluster_snapshot_identifier) required: false db_snapshot_identifier: aliases: - snapshot_name description: - Name of an RDS (unclustered) snapshot. Mutually exclusive with I(db_instance_identifier), I(db_cluster_identifier), I(db_cluster_snapshot_identifier) required: false debug_botocore_endpoint_logs: default: 'no' description: - Use a botocore.endpoint logger to parse the unique (rather than total) "resource:action" API calls made during a task, outputing the set to the resource_actions key in the task results. Use the aws_resource_action callback to output to total list made during a playbook. The ANSIBLE_DEBUG_BOTOCORE_LOGS environment variable may also be used. type: bool db_cluster_snapshot_identifier: description: - Name of an RDS cluster snapshot. Mutually exclusive with I(db_instance_identifier), I(db_snapshot_identifier), I(db_cluster_identifier) required: false
cluster_snapshots: contains: allocated_storage: description: How many gigabytes of storage are allocated returned: always sample: 1 type: int availability_zones: description: The availability zones of the database from which the snapshot was taken returned: always sample: - ca-central-1a - ca-central-1b type: list cluster_create_time: description: Date and time the cluster was created returned: always sample: '2018-05-17T00:13:40.223000+00:00' type: string db_cluster_identifier: description: Database cluster identifier returned: always sample: test-aurora-cluster type: string db_cluster_snapshot_arn: description: ARN of the database snapshot returned: always sample: arn:aws:rds:ca-central-1:111111111111:cluster-snapshot:test-aurora-snapshot type: string db_cluster_snapshot_identifier: description: Snapshot identifier returned: always sample: test-aurora-snapshot type: string engine: description: Database engine returned: always sample: aurora type: string engine_version: description: Database engine version returned: always sample: 5.6.10a type: string iam_database_authentication_enabled: description: Whether database authentication through IAM is enabled returned: always sample: false type: bool kms_key_id: description: ID of the KMS Key encrypting the snapshot returned: always sample: arn:aws:kms:ca-central-1:111111111111:key/abcd1234-abcd-1111-aaaa-0123456789ab type: string license_model: description: License model returned: always sample: aurora type: string master_username: description: Database master username returned: always sample: shertel type: string percent_progress: description: Perecent progress of snapshot returned: always sample: 0 type: int port: description: Database port returned: always sample: 0 type: int snapshot_create_time: description: Date and time when the snapshot was created returned: always sample: '2018-05-17T00:23:23.731000+00:00' type: string snapshot_type: description: Type of snapshot returned: always sample: manual type: string status: description: Status of snapshot returned: always sample: creating type: string storage_encrypted: description: Whether the snapshot is encrypted returned: always sample: true type: bool tags: contains: {} description: Tags of the snapshot returned: always type: complex vpc_id: description: VPC of the database returned: always sample: vpc-abcd1234 type: string description: List of cluster snapshots returned: always type: complex snapshots: contains: allocated_storage: description: How many gigabytes of storage are allocated returned: always sample: 10 type: int availability_zone: description: The availability zone of the database from which the snapshot was taken returned: always sample: us-west-2b type: string db_instance_identifier: description: Database instance identifier returned: always sample: hello-world-rds type: string db_snapshot_arn: description: Snapshot ARN returned: always sample: arn:aws:rds:us-west-2:111111111111:snapshot:rds:hello-world-rds-us1-2018-05-16-04-03 type: string db_snapshot_identifier: description: Snapshot name returned: always sample: rds:hello-world-rds-us1-2018-05-16-04-03 type: string encrypted: description: Whether the snapshot was encrypted returned: always sample: true type: bool engine: description: Database engine returned: always sample: postgres type: string engine_version: description: Database engine version returned: always sample: 9.5.10 type: string iam_database_authentication_enabled: description: Whether database authentication through IAM is enabled returned: always sample: false type: bool instance_create_time: description: Time the Instance was created returned: always sample: '2017-10-10T04:00:07.434000+00:00' type: string kms_key_id: description: ID of the KMS Key encrypting the snapshot returned: always sample: arn:aws:kms:us-west-2:111111111111:key/abcd1234-1234-aaaa-0000-1234567890ab type: string license_model: description: License model returned: always sample: postgresql-license type: string master_username: description: Database master username returned: always sample: dbadmin type: string option_group_name: description: Database option group name returned: always sample: default:postgres-9-5 type: string percent_progress: description: Perecent progress of snapshot returned: always sample: 100 type: int snapshot_create_time: description: Time snapshot was created returned: always sample: '2018-05-16T04:03:33.871000+00:00' type: string snapshot_type: description: Type of snapshot returned: always sample: automated type: string status: description: Status of snapshot returned: always sample: available type: string storage_type: description: Storage type of underlying DB returned: always sample: gp2 type: string tags: contains: {} description: Snapshot tags returned: always type: complex vpc_id: description: ID of VPC containing the DB returned: always sample: vpc-abcd1234 type: string description: List of non-clustered snapshots returned: When cluster parameters are not passed type: complex