Amazon Billing policy examples - Amazon Billing
Allow IAM users to view your billing informationAllow IAM users to view your billing information and carbon footprint reportAllow IAM users to access the reports console pageDeny IAM users access to the Billing and Cost Management consolesDeny Amazon Console cost and usage widget access for member accountsDeny Amazon Console cost and usage widget access for specific IAM users and rolesAllow IAM users to view your billing information, but deny access to carbon footprint reportAllow IAM users to access carbon footprint reporting, but deny access to billing informationAllow full access to Amazon services but deny IAM users access to the Billing and Cost Management consolesAllow IAM users to view the Billing and Cost Management consoles except for account settingsAllow IAM users to modify billing informationDeny access to account settings, but allow full access to all other billing and usage informationDeposit reports into an Amazon S3 bucketFind products and pricesView costs and usageEnable and disable Amazon RegionsView and manage cost categoriesCreate, view, edit, or delete Amazon Cost and Usage ReportsView and manage purchase ordersView and update the Cost Explorer preferences pageView, create, update, and delete using the Cost Explorer reports pageView, create, update, and delete reservation and Savings Plans alertsAllow read-only access to Amazon Cost Anomaly DetectionAllow Amazon Budgets to apply IAM policies and SCPsAllow Amazon Budgets to apply IAM policies and SCPs and target EC2 and RDS instancesAllow IAM users to view, create, and update your Fapiao settings informationAllow IAM users to view US tax exemptions and create Amazon Web Services Support casesAllow IAM users to view and update your real name information(For customers with a billing or contact address in India) Allow read-only access to customer verification information(For customers with a billing or contact address in India) View, create, and update customer verification informationView Amazon Migration Acceleration Program information in the Billing console
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Amazon Billing policy examples

Note

The following Amazon Identity and Access Management (IAM) actions have reached the end of standard support:

  • aws-portal namespace

  • purchase-orders:ViewPurchaseOrders

  • purchase-orders:ModifyPurchaseOrders

If you're using Amazon Organizations, you can use the bulk policy migrator scripts to update polices from your payer account. You can also use the old to granular action mapping reference to verify the IAM actions that need to be added.

For more information, see the Changes to Amazon Billing, Amazon Cost Management, and Account Consoles Permission blog.

If you have an Amazon Web Services account, or are a part of an Amazon Organizations created on or after November 16, 2023, 11:00 AM (PDT), the fine-grained actions are already in effect in your organization.

Important

This topic contains example policies that you can attach to your IAM user or group to control access to your account's billing information and tools. The following basic rules apply to IAM policies for Billing and Cost Management:

  • Version is always 2012-10-17.

  • Effect is always Allow or Deny.

  • Action is the name of the action or a wildcard (*).

    The action prefix is budgets for Amazon Budgets, cur for Amazon Cost and Usage Reports, aws-portal for Amazon Billing, or ce for Cost Explorer.

  • Resource is always * for Amazon Billing.

    For actions that are performed on a budget resource, specify the budget Amazon Resource Name (ARN).

  • It's possible to have multiple statements in one policy.

For a list of actions policies for the Amazon Cost Management console, see Amazon Cost Management policy examples in the Amazon Cost Management user guide.

Topics

Allow IAM users to view your billing information

To allow an IAM user to view your billing information without giving the IAM user access to sensitive account information, use a policy similar to the following example policy. Such a policy prevents users from accessing your password and account activity reports. This policy allows IAM users to view the following Billing and Cost Management console pages, without giving them access to the Account Settings or Reports console pages:

  • Dashboard

  • Cost Explorer

  • Bills

  • Orders and invoices

  • Consolidated Billing

  • Preferences

  • Credits

  • Advance Payment

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-portal:ViewBilling",
            "Resource": "*"
        }
    ]
}

Allow IAM users to view your billing information and carbon footprint report

To allow an IAM user to view both billing information and carbon footprint reporting, use a policy similar to the following example. This policy prevents users from accessing your password and account activity reports. This policy allows IAM users to view the following Billing and Cost Management console pages, without giving them access to the Account Settings or Reports console pages:

  • Dashboard

  • Cost Explorer

  • Bills

  • Orders and invoices

  • Consolidated Billing

  • Preferences

  • Credits

  • Advance Payment

  • The Amazon customer carbon footprint tool section of the Amazon Cost and Usage Reports page

{
    "Version": "2012-10-17",
    "Statement": [
        {"Effect": "Allow",
            "Action": "aws-portal:ViewBilling",
            "Resource": "*"
        },
        {"Effect": "Allow",
            "Action": "sustainability:GetCarbonFootprintSummary",
            "Resource": "*"
        }
    ]
}

Allow IAM users to access the reports console page

To allow an IAM user to access the Reports console page and to view the usage reports that contain account activity information, use a policy similar to this example policy.

For definitions of each action, see Amazon Billing actions.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewUsage",
                "aws-portal:ViewBilling",
                "cur:DescribeReportDefinitions",
                "cur:PutReportDefinition",
                "cur:DeleteReportDefinition",
                "cur:ModifyReportDefinition"
            ],
            "Resource": "*"
        }
    ]
}

Deny IAM users access to the Billing and Cost Management consoles

To explicitly deny an IAM user access to the all Billing and Cost Management console pages, use a policy similar to this example policy.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "aws-portal:*",
            "Resource": "*"
        }
    ]
}

Deny Amazon Console cost and usage widget access for member accounts

To restrict member (linked) account access to cost and usage data, use your management (payer) account to access the Cost Explorer preferences tab and uncheck Linked Account Access. This will deny access to cost and usage data from the Cost Explorer (Amazon Cost Management) console, Cost Explorer API, and Amazon Console Home page's cost and usage widget regardless of the IAM actions a member account’s IAM user or role has.

Deny Amazon Console cost and usage widget access for specific IAM users and roles

To deny Amazon Console cost and usage widget access for specific IAM users and roles, use the permissions policy below.

Note

Adding this policy to an IAM user or role will deny users access to Cost Explorer (Amazon Cost Management) console and Cost Explorer APIs as well.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "ce:*",
            "Resource": "*"
        }
    ]
}

Allow IAM users to view your billing information, but deny access to carbon footprint report

To allow an IAM user to both billing information in the Billing and Cost Management consoles, but doesn't allow access to the Amazon customer carbon footprint tool. This tool is located in the Amazon Cost and Usage Reports page.

{
    "Version": "2012-10-17",
    "Statement": [
        {"Effect": "Allow",
            "Action": "aws-portal:ViewBilling",
            "Resource": "*"
        },
        {"Effect": "Deny",
            "Action": "sustainability:GetCarbonFootprintSummary",
            "Resource": "*"
        }
    ]
}

Allow IAM users to access carbon footprint reporting, but deny access to billing information

To allow an IAM users to access the Amazon customer carbon footprint tool in the Amazon Cost and Usage Reports page, but denies access to view billing information in the Billing and Cost Management consoles.

{
    "Version": "2012-10-17",
    "Statement": [
        {"Effect": "Deny",
            "Action": "aws-portal:ViewBilling",
            "Resource": "*"
        },
        {"Effect": "Allow",
            "Action": "sustainability:GetCarbonFootprintSummary",
            "Resource": "*"
        }
    ]
}

Allow full access to Amazon services but deny IAM users access to the Billing and Cost Management consoles

To deny IAM users access to everything on the Billing and Cost Management console, use the following policy. Deny user access to Amazon Identity and Access Management (IAM) to prevent access to the policies that control access to billing information and tools.

Important

This policy doesn't allow any actions. Use this policy in combination with other policies that allow specific actions.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": [
                "aws-portal:*",
                "iam:*"
            ],
            "Resource": "*"
        }
    ]
}

Allow IAM users to view the Billing and Cost Management consoles except for account settings

This policy allows read-only access to all of the Billing and Cost Management console. This includes the Payments Method and Reports console pages. However, this policy denies access to the Account Settings page. This means it protects the account password, contact information, and security questions. 

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-portal:View*",
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": "aws-portal:*Account",
            "Resource": "*"
        }
    ]
}

Allow IAM users to modify billing information

To allow IAM users to modify account billing information in the Billing and Cost Management console, allow IAM users to view your billing information. The following policy example allows an IAM user to modify the Consolidated Billing, Preferences, and Credits console pages. It also allows an IAM user to view the following Billing and Cost Management console pages:

  • Dashboard

  • Cost Explorer

  • Bills

  • Orders and invoices

  • Advance Payment

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "aws-portal:*Billing",
            "Resource": "*"
        }
    ]
}

Deny access to account settings, but allow full access to all other billing and usage information

To protect your account password, contact information, and security questions, deny IAM user access to Account Settings while still enabling full access to the rest of the functionality in the Billing and Cost Management console. The following is an example policy.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "aws-portal:*Billing",
                "aws-portal:*Usage",
                "aws-portal:*PaymentMethods"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Deny",
            "Action": "aws-portal:*Account",
            "Resource": "*"
        }
    ]
}

Deposit reports into an Amazon S3 bucket

The following policy allows Billing and Cost Management to save your detailed Amazon bills to an Amazon S3 bucket if you own both the Amazon account and the Amazon S3 bucket. This policy must be applied to the Amazon S3 bucket, rather than an IAM user. This is because it's a resource-based policy, not a user-based policy. We recommend that you deny IAM user access to the bucket for IAM users who don't need access to your bills.

Replace DOC-EXAMPLE-BUCKET1 with the name of your bucket.

For more information, see Using Bucket Policies and User Policies in the Amazon Simple Storage Service User Guide.

{
  "Version": "2012-10-17",
  "Statement": [
  {
    "Effect": "Allow",
    "Principal": {
      "Service": "billingreports.amazonaws.com"
    },
    "Action": [
      "s3:GetBucketAcl",
      "s3:GetBucketPolicy"
    ],
    "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET1"
  },
  {
    "Effect": "Allow",
    "Principal": {
      "Service": "billingreports.amazonaws.com"
    },
    "Action": "s3:PutObject",
    "Resource": "arn:aws:s3:::DOC-EXAMPLE-BUCKET1/*"
  }
  ]
}

Find products and prices

To allow an IAM user to use the Amazon Price List Service API, use the following policy to grant them access.

This policy grants permission to use both the Amazon Price List Bulk API Amazon Price List Query API.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "pricing:DescribeServices",
                "pricing:GetAttributeValues",
                "pricing:GetProducts",
                "pricing:GetPriceListFileUrl",
                "pricing:ListPriceLists"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}

View costs and usage

To allow IAM users to use the Amazon Cost Explorer API, use the following policy to grant them access.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ce:*"
      ],
      "Resource": [
        "*"
      ]
    }
  ]
}

Enable and disable Amazon Regions

For an example IAM policy that allows users to enable and disable Regions, see Amazon: Allows Enabling and Disabling Amazon Regions in the IAM User Guide.

View and manage cost categories

To allow IAM users to use, view, and manage cost categories, use the following policy to grant them access.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": [
        "aws-portal:ViewBilling",
        "ce:GetCostAndUsage",
        "ce:DescribeCostCategoryDefinition",
        "ce:UpdateCostCategoryDefinition",
        "ce:CreateCostCategoryDefinition",
        "ce:DeleteCostCategoryDefinition",
        "ce:ListCostCategoryDefinitions",
        "ce:TagResource",
        "ce:UntagResource",
        "ce:ListTagsForResource",
        "pricing:DescribeServices"
      ],
      "Resource": "*"
    }
  ]
}

Create, view, edit, or delete Amazon Cost and Usage Reports

This policy allows an IAM user to create, view, edit, or delete sample-report using the API.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ManageSampleReport",
            "Effect": "Allow",
			"Action": [
                "cur:PutReportDefinition", 
                "cur:DeleteReportDefinition",
                "cur:ModifyReportDefinition"
            ],
            "Resource": "arn:aws:cur:*:123456789012:definition/sample-report"
        },
        {
            "Sid": "DescribeReportDefs",
            "Effect": "Allow",
            "Action": "cur:DescribeReportDefinitions",
            "Resource": "*"
        }
    ]
}

View and manage purchase orders

This policy allows an IAM user to view and manage purchase orders, using the following policy to grant access.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling",
                "purchase-orders:*"
            ],
            "Resource": "*"
        }
    ]
}

View and update the Cost Explorer preferences page

This policy allows an IAM user to view and update using the Cost Explorer preferences page.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": [
        "aws-portal:ViewBilling",
        "ce:UpdatePreferences"
       ],
      "Resource": "*"
    }
  ]
}

The following policy allows IAM users to view Cost Explorer, but deny permission to view or edit the Preferences page.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:GetPreferences",
                "ce:UpdatePreferences"
            ],
            "Resource": "*"
        }
    ]
}

The following policy allows IAM users to view Cost Explorer, but deny permission to edit the Preferences page.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:UpdatePreferences"
            ],
            "Resource": "*"
        }
    ]
}

View, create, update, and delete using the Cost Explorer reports page

This policy allows an IAM user to view, create, update, and delete using the Cost Explorer reports page.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": [
        "aws-portal:ViewBilling",
        "ce:CreateReport",
        "ce:UpdateReport",
        "ce:DeleteReport"
       ],
      "Resource": "*"
    }
  ]
}

The following policy allows IAM users to view Cost Explorer, but deny permission to view or edit the Reports page.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:DescribeReport",
                "ce:CreateReport",
                "ce:UpdateReport",
                "ce:DeleteReport"
            ],
            "Resource": "*"
        }
    ]
}

The following policy allows IAM users to view Cost Explorer, but deny permission to edit the Reports page.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:CreateReport",
                "ce:UpdateReport",
                "ce:DeleteReport"
            ],
            "Resource": "*"
        }
    ]
}

View, create, update, and delete reservation and Savings Plans alerts

This policy allows an IAM user to view, create, update, and delete reservation expiration alerts and Savings Plans alerts. To edit reservation expiration alerts or Savings Plans alerts, a user needs all three granular actions: ce:CreateNotificationSubscription, ce:UpdateNotificationSubscription, and ce:DeleteNotificationSubscription.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": [
        "aws-portal:ViewBilling",
        "ce:CreateNotificationSubscription",
        "ce:UpdateNotificationSubscription",
        "ce:DeleteNotificationSubscription"
       ],
      "Resource": "*"
    }
  ]
}

The following policy allows IAM users to view Cost Explorer, but denies permission to view or edit the Reservation Expiration Alerts and Savings Plans alert pages.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:DescribeNotificationSubscription",
                "ce:CreateNotificationSubscription",
                "ce:UpdateNotificationSubscription",
                "ce:DeleteNotificationSubscription"
            ],
            "Resource": "*"
        }
    ]
}

The following policy allows IAM users to view Cost Explorer, but denies permission to edit the Reservation Expiration Alerts and Savings Plans alert pages.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "aws-portal:ViewBilling"
            ],
            "Resource": "*"
        },
        {
            "Sid": "VisualEditor1",
            "Effect": "Deny",
            "Action": [
                "ce:CreateNotificationSubscription",
                "ce:UpdateNotificationSubscription",
                "ce:DeleteNotificationSubscription"
            ],
            "Resource": "*"
        }
    ]
}

Allow read-only access to Amazon Cost Anomaly Detection

To allow IAM users read-only access to Amazon Cost Anomaly Detection, use the following policy to grant them access. ce:ProvideAnomalyFeedback is optional as a part of the read-only access.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "ce:Get*"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Allow Amazon Budgets to apply IAM policies and SCPs

This policy allows Amazon Budgets to apply IAM policies and service control policies (SCPs) on behalf of the user.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "iam:AttachGroupPolicy",
        "iam:AttachRolePolicy",
        "iam:AttachUserPolicy",
        "iam:DetachGroupPolicy",
        "iam:DetachRolePolicy",
        "iam:DetachUserPolicy",
        "organizations:AttachPolicy",
        "organizations:DetachPolicy"
      ],
      "Resource": "*"
    }
  ]
}

Allow Amazon Budgets to apply IAM policies and SCPs and target EC2 and RDS instances

This policy allows Amazon Budgets to apply IAM policies and service control policies (SCPs), and to target Amazon EC2 and Amazon RDS instances on behalf of the user.

Trust policy

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "budgets.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Permissions policy

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeInstanceStatus",
        "ec2:StartInstances",
        "ec2:StopInstances",
        "iam:AttachGroupPolicy",
        "iam:AttachRolePolicy",
        "iam:AttachUserPolicy",
        "iam:DetachGroupPolicy",
        "iam:DetachRolePolicy",
        "iam:DetachUserPolicy",
        "organizations:AttachPolicy",
        "organizations:DetachPolicy",
        "rds:DescribeDBInstances",
        "rds:StartDBInstance",
        "rds:StopDBInstance",
        "ssm:StartAutomationExecution"
      ],
      "Resource": "*"
    }
  ]
}

Allow IAM users to view, create, and update your Fapiao settings information

This policy allows an IAM user to view, create, and update your Fapiao settings information without giving the IAM user access to sensitive account information.

For definitions of each action, see Amazon Billing actions


{
"Version": "2012-10-17",
    "Statement": [
        {"Effect": "Allow",
            "Action": [
                "fapiao:GetAccountFapiaoSetting",
                "fapiao:UpdateAccountFapiaoInformation",
                "fapiao:UpdateAccountMailingAddress",
                "fapiao:CreateAccountFapiaoSetting"
            ],
            "Resource": "*"
        }
    ]
}

Allow IAM users to view US tax exemptions and create Amazon Web Services Support cases

This policy allows an IAM user to view US tax exemptions and create Amazon Web Services Support cases to upload exemption certificates in the tax exemption console.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "aws-portal:*",
                "tax:GetExemptions",
                "tax:UpdateExemptions",
                "support:CreateCase",
                "support:AddAttachmentsToSet"
            ],
            "Resource": [
                "*"
            ],
            "Effect": "Allow"
        }
    ]
}

Allow IAM users to view and update your real name information

This policy allows an IAM user to view and update the account's real name information.

For definitions of each action, see Amazon Billing actions.


{
"Version": "2012-10-17",
    "Statement": [
        {"Effect": "Allow",
            "Action": [
                "cloudassist:DescribeAccountRealNameInformation",
                "cloudassist:UpdateAccountRealNameInformation"
            ],
            "Resource": "*"
        }
    ]
}

(For customers with a billing or contact address in India) Allow read-only access to customer verification information

This policy allows IAM users read-only access to customer verification information.

For definitions of each action, see Amazon Billing actions.

{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "customer-verification:GetCustomerVerificationEligibility",
            "customer-verification:GetCustomerVerificationDetails"
        ],
        "Resource": "*"
    }]
}

(For customers with a billing or contact address in India) View, create, and update customer verification information

This policy allows IAM users to manage their customer verification information.

For definitions of each action, see Amazon Billing actions

{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "customer-verification:CreateCustomerVerificationDetails",
            "customer-verification:UpdateCustomerVerificationDetails",
            "customer-verification:GetCustomerVerificationEligibility",
            "customer-verification:GetCustomerVerificationDetails"
        ],
        "Resource": "*"
    }]
}

View Amazon Migration Acceleration Program information in the Billing console

This policy allows IAM users to view the Migration Acceleration Program agreements, credits, and eligible spend for the payer's account in the Billing console.

For definitions of each action, see Amazon Billing actions.

{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "mapcredit:ListQuarterSpend",
            "mapcredit:ListQuarterCredits",
            "mapcredit:ListAssociatedPrograms"
        ],
        "Resource": "*"
    }]
}