# ram-acceptance

Accepts pending AWS RAM resource share invitations. This module must run
using a provider authenticated as the receiving account, which the calling
stack passes in explicitly through the `providers` map.

## Usage

```hcl
module "ram_acceptance" {
  source  = "hcassc.jfrog.io/iac-tf-modules-virtual__networking/ram-acceptance/aws"
  version = "0.1.0"
  providers = {
    aws = aws.receiver
  }

  share_invitations = {
    example_share = {
      share_arn = module.ram_share.resource_share_arns["example_share"]
    }
  }
}
```

<!-- BEGIN_TF_DOCS — DO NOT EDIT BELOW THIS LINE -->

## Requirements

| Name                                                                     | Version            |
| ------------------------------------------------------------------------ | ------------------ |
| <a name="requirement_terraform"></a> [terraform](#requirement_terraform) | >= 1.15.0, < 2.0.0 |
| <a name="requirement_aws"></a> [aws](#requirement_aws)                   | >= 6.0, < 7.0      |

## Providers

| Name                                             | Version       |
| ------------------------------------------------ | ------------- |
| <a name="provider_aws"></a> [aws](#provider_aws) | >= 6.0, < 7.0 |

## Resources

| Name                                                                                                                                            | Type     |
| ----------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| [aws_ram_resource_share_accepter.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ram_resource_share_accepter) | resource |

## Inputs

| Name                                                                                 | Description                                                                                                                                                                                                                                                          | Type                                                     | Default | Required |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- | ------- | :------: |
| <a name="input_share_invitations"></a> [share_invitations](#input_share_invitations) | Map of RAM resource share invitations to accept.<br/>share_arn is required and must reference a share for which this<br/>account is the invited principal. The calling stack must pass in<br/>a provider authenticated as the receiving account for this invocation. | <pre>map(object({<br/> share_arn = string<br/> }))</pre> | `{}`    |    no    |
| <a name="input_tags"></a> [tags](#input_tags)                                        | Tags applied to all resources in this module.                                                                                                                                                                                                                        | `map(string)`                                            | `{}`    |    no    |

## Outputs

| Name                                                                 | Description                                                                                                                 |
| -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| <a name="output_invitations"></a> [invitations](#output_invitations) | Map of invitation keys to full acceptance details — status, share ID, sender/receiver account IDs, and resource share name. |

<!-- END_TF_DOCS — DO NOT EDIT ABOVE THIS LINE -->