1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. ec2
  6. FcaPolicy

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi
aws-native logo aws-native logo AWS Cloud Control

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.86.0
published on Wednesday, Nov 18, 2026 by Pulumi

    A Flex Cost Allocation (FCA) policy defines how shared network costs (data transfer, data processing) are allocated and reported for network resources such as NAT gateways, EC2 instances, and VPC peering connections.

    Create FcaPolicy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new FcaPolicy(name: string, args: FcaPolicyArgs, opts?: CustomResourceOptions);
    @overload
    def FcaPolicy(resource_name: str,
                  args: FcaPolicyArgs,
                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def FcaPolicy(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  network_resource_type: Optional[FcaPolicyNetworkResourceType] = None,
                  description: Optional[str] = None,
                  instance_fca_policy_document: Optional[FcaPolicyInstanceFcaPolicyDocumentArgs] = None,
                  nat_fca_policy_document: Optional[FcaPolicyNatFcaPolicyDocumentArgs] = None,
                  pcx_fca_policy_document: Optional[FcaPolicyPcxFcaPolicyDocumentArgs] = None,
                  show_back_enabled: Optional[bool] = None,
                  tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewFcaPolicy(ctx *Context, name string, args FcaPolicyArgs, opts ...ResourceOption) (*FcaPolicy, error)
    public FcaPolicy(string name, FcaPolicyArgs args, CustomResourceOptions? opts = null)
    public FcaPolicy(String name, FcaPolicyArgs args)
    public FcaPolicy(String name, FcaPolicyArgs args, CustomResourceOptions options)
    
    type: aws-native:ec2:FcaPolicy
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    
    resource "aws-native_ec2_fca_policy" "name" {
        # resource properties
    }

    Parameters

    name string
    The unique name of the resource.
    args FcaPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args FcaPolicyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args FcaPolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args FcaPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args FcaPolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    FcaPolicy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The FcaPolicy resource accepts the following input properties:

    NetworkResourceType FcaPolicyNetworkResourceType
    The type of network resource the FCA policy applies to.
    Description string
    The description of the FCA policy.
    InstanceFcaPolicyDocument FcaPolicyInstanceFcaPolicyDocumentArgs
    NatFcaPolicyDocument FcaPolicyNatFcaPolicyDocumentArgs
    PcxFcaPolicyDocument FcaPolicyPcxFcaPolicyDocumentArgs
    ShowBackEnabled bool
    Indicates whether show-back reporting is enabled for the FCA policy.
    Tags TagArgs
    The tags for the FCA policy.
    network_resource_type "natgw" | "pcx" | "ec2"
    The type of network resource the FCA policy applies to.
    description string
    The description of the FCA policy.
    instance_fca_policy_document object
    nat_fca_policy_document object
    pcx_fca_policy_document object
    show_back_enabled bool
    Indicates whether show-back reporting is enabled for the FCA policy.
    tags list(object)
    The tags for the FCA policy.
    networkResourceType FcaPolicyNetworkResourceType
    The type of network resource the FCA policy applies to.
    description String
    The description of the FCA policy.
    instanceFcaPolicyDocument FcaPolicyInstanceFcaPolicyDocument
    natFcaPolicyDocument FcaPolicyNatFcaPolicyDocument
    pcxFcaPolicyDocument FcaPolicyPcxFcaPolicyDocument
    showBackEnabled Boolean
    Indicates whether show-back reporting is enabled for the FCA policy.
    tags List<Tag>
    The tags for the FCA policy.
    networkResourceType FcaPolicyNetworkResourceType
    The type of network resource the FCA policy applies to.
    description string
    The description of the FCA policy.
    instanceFcaPolicyDocument FcaPolicyInstanceFcaPolicyDocument
    natFcaPolicyDocument FcaPolicyNatFcaPolicyDocument
    pcxFcaPolicyDocument FcaPolicyPcxFcaPolicyDocument
    showBackEnabled boolean
    Indicates whether show-back reporting is enabled for the FCA policy.
    tags Tag[]
    The tags for the FCA policy.
    network_resource_type FcaPolicyNetworkResourceType
    The type of network resource the FCA policy applies to.
    description str
    The description of the FCA policy.
    instance_fca_policy_document FcaPolicyInstanceFcaPolicyDocumentArgs
    nat_fca_policy_document FcaPolicyNatFcaPolicyDocumentArgs
    pcx_fca_policy_document FcaPolicyPcxFcaPolicyDocumentArgs
    show_back_enabled bool
    Indicates whether show-back reporting is enabled for the FCA policy.
    tags Sequence[TagArgs]
    The tags for the FCA policy.
    networkResourceType "natgw" | "pcx" | ""
    The type of network resource the FCA policy applies to.
    description String
    The description of the FCA policy.
    instanceFcaPolicyDocument Property Map
    natFcaPolicyDocument Property Map
    pcxFcaPolicyDocument Property Map
    showBackEnabled Boolean
    Indicates whether show-back reporting is enabled for the FCA policy.
    tags List<Property Map>
    The tags for the FCA policy.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the FcaPolicy resource produces the following output properties:

    Arn string
    The Amazon Resource Name (ARN) of the FCA policy.
    FcaPolicyId string
    The ID of the FCA policy.
    Id string
    The provider-assigned unique ID for this managed resource.
    LatestVersion int
    The latest version number of the FCA policy.
    OwnerAccount string
    The AWS account ID that owns the FCA policy.
    PolicyCreatedAt string
    The timestamp when the FCA policy was created.
    VersionExpectedEffectiveAt string
    The timestamp when the latest version of the FCA policy is expected to take effect.
    Arn string
    The Amazon Resource Name (ARN) of the FCA policy.
    FcaPolicyId string
    The ID of the FCA policy.
    Id string
    The provider-assigned unique ID for this managed resource.
    LatestVersion int
    The latest version number of the FCA policy.
    OwnerAccount string
    The AWS account ID that owns the FCA policy.
    PolicyCreatedAt string
    The timestamp when the FCA policy was created.
    VersionExpectedEffectiveAt string
    The timestamp when the latest version of the FCA policy is expected to take effect.
    arn string
    The Amazon Resource Name (ARN) of the FCA policy.
    fca_policy_id string
    The ID of the FCA policy.
    id string
    The provider-assigned unique ID for this managed resource.
    latest_version number
    The latest version number of the FCA policy.
    owner_account string
    The AWS account ID that owns the FCA policy.
    policy_created_at string
    The timestamp when the FCA policy was created.
    version_expected_effective_at string
    The timestamp when the latest version of the FCA policy is expected to take effect.
    arn String
    The Amazon Resource Name (ARN) of the FCA policy.
    fcaPolicyId String
    The ID of the FCA policy.
    id String
    The provider-assigned unique ID for this managed resource.
    latestVersion Integer
    The latest version number of the FCA policy.
    ownerAccount String
    The AWS account ID that owns the FCA policy.
    policyCreatedAt String
    The timestamp when the FCA policy was created.
    versionExpectedEffectiveAt String
    The timestamp when the latest version of the FCA policy is expected to take effect.
    arn string
    The Amazon Resource Name (ARN) of the FCA policy.
    fcaPolicyId string
    The ID of the FCA policy.
    id string
    The provider-assigned unique ID for this managed resource.
    latestVersion number
    The latest version number of the FCA policy.
    ownerAccount string
    The AWS account ID that owns the FCA policy.
    policyCreatedAt string
    The timestamp when the FCA policy was created.
    versionExpectedEffectiveAt string
    The timestamp when the latest version of the FCA policy is expected to take effect.
    arn str
    The Amazon Resource Name (ARN) of the FCA policy.
    fca_policy_id str
    The ID of the FCA policy.
    id str
    The provider-assigned unique ID for this managed resource.
    latest_version int
    The latest version number of the FCA policy.
    owner_account str
    The AWS account ID that owns the FCA policy.
    policy_created_at str
    The timestamp when the FCA policy was created.
    version_expected_effective_at str
    The timestamp when the latest version of the FCA policy is expected to take effect.
    arn String
    The Amazon Resource Name (ARN) of the FCA policy.
    fcaPolicyId String
    The ID of the FCA policy.
    id String
    The provider-assigned unique ID for this managed resource.
    latestVersion Number
    The latest version number of the FCA policy.
    ownerAccount String
    The AWS account ID that owns the FCA policy.
    policyCreatedAt String
    The timestamp when the FCA policy was created.
    versionExpectedEffectiveAt String
    The timestamp when the latest version of the FCA policy is expected to take effect.

    Look up Existing FcaPolicy Resource

    Get an existing FcaPolicy resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, opts?: CustomResourceOptions): FcaPolicy
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None) -> FcaPolicy
    func GetFcaPolicy(ctx *Context, name string, id IDInput, state *FcaPolicyState, opts ...ResourceOption) (*FcaPolicy, error)
    public static FcaPolicy Get(string name, Input<string> id, CustomResourceOptions? opts = null)
    public static FcaPolicy get(String name, Output<String> id, CustomResourceOptions options)
    resources:  existingFcaPolicy:    type: aws-native:ec2:FcaPolicy    get:      id: ${id}
    import {
      to = aws-native_ec2_fca_policy.example
      id = "${id}"
    }
    
    name string
    The unique name of the resulting resource.
    id Input<ID>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resulting resource.
    id str
    The unique provider ID of the resource to look up.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resulting resource.
    id IDInput
    The unique provider ID of the resource to look up.
    state FcaPolicyState
    Pass nil. This resource has no state arguments.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resulting resource.
    id Input<string>
    The unique provider ID of the resource to look up.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resulting resource.
    id Output<String>
    The unique provider ID of the resource to look up.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Supporting Types

    FcaPolicyCidrMapping, FcaPolicyCidrMappingArgs

    A single CIDR range to label mapping.

    CidrLabel string
    The label for the CIDR range.
    CidrRange string
    The CIDR range.
    CidrLabel string
    The label for the CIDR range.
    CidrRange string
    The CIDR range.
    cidr_label string
    The label for the CIDR range.
    cidr_range string
    The CIDR range.
    cidrLabel String
    The label for the CIDR range.
    cidrRange String
    The CIDR range.
    cidrLabel string
    The label for the CIDR range.
    cidrRange string
    The CIDR range.
    cidr_label str
    The label for the CIDR range.
    cidr_range str
    The CIDR range.
    cidrLabel String
    The label for the CIDR range.
    cidrRange String
    The CIDR range.

    FcaPolicyCidrRangeSpecifications, FcaPolicyCidrRangeSpecificationsArgs

    CIDR range specifications, used when the reporting granularity is 'cidr'.

    Prefixes List<Pulumi.AwsNative.Ec2.Inputs.FcaPolicyCidrMapping>
    The CIDR range to label mappings.
    PrefixesType string
    The type of prefixes the mappings apply to.
    Prefixes []FcaPolicyCidrMapping
    The CIDR range to label mappings.
    PrefixesType string
    The type of prefixes the mappings apply to.
    prefixes list(object)
    The CIDR range to label mappings.
    prefixes_type string
    The type of prefixes the mappings apply to.
    prefixes List<FcaPolicyCidrMapping>
    The CIDR range to label mappings.
    prefixesType String
    The type of prefixes the mappings apply to.
    prefixes FcaPolicyCidrMapping[]
    The CIDR range to label mappings.
    prefixesType string
    The type of prefixes the mappings apply to.
    prefixes Sequence[FcaPolicyCidrMapping]
    The CIDR range to label mappings.
    prefixes_type str
    The type of prefixes the mappings apply to.
    prefixes List<Property Map>
    The CIDR range to label mappings.
    prefixesType String
    The type of prefixes the mappings apply to.

    FcaPolicyDimensionListItem

    NameValue
    DataTransferdata-transfer
    DataProcessingdata-processing
    NameValue
    FcaPolicyDimensionListItemDataTransferdata-transfer
    FcaPolicyDimensionListItemDataProcessingdata-processing
    Value
    data-transfer
    data-processing
    NameValue
    DataTransferdata-transfer
    DataProcessingdata-processing
    NameValue
    DataTransferdata-transfer
    DataProcessingdata-processing
    NameValue
    DATA_TRANSFERdata-transfer
    DATA_PROCESSINGdata-processing
    Value
    data-transfer
    data-processing

    FcaPolicyInstanceFcaPolicyDocument, FcaPolicyInstanceFcaPolicyDocumentArgs

    The FCA policy document for EC2 instance cost allocation.

    FcaPolicyNatFcaPolicyDocument, FcaPolicyNatFcaPolicyDocumentArgs

    The FCA policy document for NAT gateway cost allocation.

    FcaPolicyNetworkResourceType

    The type of network resource the FCA policy applies to.

    NameValue
    Natgwnatgw
    Pcxpcx
    Ec2ec2
    NameValue
    FcaPolicyNetworkResourceTypeNatgwnatgw
    FcaPolicyNetworkResourceTypePcxpcx
    FcaPolicyNetworkResourceTypeEc2ec2
    Value
    natgw
    pcx
    ec2
    NameValue
    Natgwnatgw
    Pcxpcx
    Ec2ec2
    NameValue
    Natgwnatgw
    Pcxpcx
    Ec2ec2
    NameValue
    NATGWnatgw
    PCXpcx
    EC2ec2
    Value
    natgw
    pcx
    ec2

    FcaPolicyPcxFcaPolicyDocument, FcaPolicyPcxFcaPolicyDocumentArgs

    The FCA policy document for VPC peering connection cost allocation.

    FcaPolicyReportingGranularityListItem

    NameValue
    Enieni
    Ec2ec2
    Subnetsubnet
    Vpcvpc
    Accountaccount
    PeeringIdpeering-id
    Cidrcidr
    NameValue
    FcaPolicyReportingGranularityListItemEnieni
    FcaPolicyReportingGranularityListItemEc2ec2
    FcaPolicyReportingGranularityListItemSubnetsubnet
    FcaPolicyReportingGranularityListItemVpcvpc
    FcaPolicyReportingGranularityListItemAccountaccount
    FcaPolicyReportingGranularityListItemPeeringIdpeering-id
    FcaPolicyReportingGranularityListItemCidrcidr
    Value
    eni
    ec2
    subnet
    vpc
    account
    peering-id
    cidr
    NameValue
    Enieni
    Ec2ec2
    Subnetsubnet
    Vpcvpc
    Accountaccount
    PeeringIdpeering-id
    Cidrcidr
    NameValue
    Enieni
    Ec2ec2
    Subnetsubnet
    Vpcvpc
    Accountaccount
    PeeringIdpeering-id
    Cidrcidr
    NameValue
    ENIeni
    EC2ec2
    SUBNETsubnet
    VPCvpc
    ACCOUNTaccount
    PEERING_IDpeering-id
    CIDRcidr
    Value
    eni
    ec2
    subnet
    vpc
    account
    peering-id
    cidr

    Tag, TagArgs

    A set of tags to apply to the resource.

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo AWS Cloud Control

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.86.0
    published on Wednesday, Nov 18, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial