@pulumi/aws 6.0.0-alpha.6 → 6.0.0-alpha.8

package/apigateway/authorizer.d.ts

@@ -3,6 +3,61 @@ import { RestApi } from "./index";
 /**
  * Provides an API Gateway Authorizer.
  *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const demoRestApi = new aws.apigateway.RestApi("demoRestApi", {});
+ * const invocationAssumeRole = aws.iam.getPolicyDocument({
+ *     statements: [{
+ *         effect: "Allow",
+ *         principals: [{
+ *             type: "Service",
+ *             identifiers: ["apigateway.amazonaws.com"],
+ *         }],
+ *         actions: ["sts:AssumeRole"],
+ *     }],
+ * });
+ * const invocationRole = new aws.iam.Role("invocationRole", {
+ *     path: "/",
+ *     assumeRolePolicy: invocationAssumeRole.then(invocationAssumeRole => invocationAssumeRole.json),
+ * });
+ * const lambdaAssumeRole = aws.iam.getPolicyDocument({
+ *     statements: [{
+ *         effect: "Allow",
+ *         actions: ["sts:AssumeRole"],
+ *         principals: [{
+ *             type: "Service",
+ *             identifiers: ["lambda.amazonaws.com"],
+ *         }],
+ *     }],
+ * });
+ * const lambda = new aws.iam.Role("lambda", {assumeRolePolicy: lambdaAssumeRole.then(lambdaAssumeRole => lambdaAssumeRole.json)});
+ * const authorizer = new aws.lambda.Function("authorizer", {
+ *     code: new pulumi.asset.FileArchive("lambda-function.zip"),
+ *     role: lambda.arn,
+ *     handler: "exports.example",
+ * });
+ * const demoAuthorizer = new aws.apigateway.Authorizer("demoAuthorizer", {
+ *     restApi: demoRestApi.id,
+ *     authorizerUri: authorizer.invokeArn,
+ *     authorizerCredentials: invocationRole.arn,
+ * });
+ * const invocationPolicyPolicyDocument = aws.iam.getPolicyDocumentOutput({
+ *     statements: [{
+ *         effect: "Allow",
+ *         actions: ["lambda:InvokeFunction"],
+ *         resources: [authorizer.arn],
+ *     }],
+ * });
+ * const invocationPolicyRolePolicy = new aws.iam.RolePolicy("invocationPolicyRolePolicy", {
+ *     role: invocationRole.id,
+ *     policy: invocationPolicyPolicyDocument.apply(invocationPolicyPolicyDocument => invocationPolicyPolicyDocument.json),
+ * });
+ * ```
+ *
  * ## Import
  *
  * terraform import {

package/apigateway/authorizer.js

@@ -8,6 +8,61 @@ const utilities = require("../utilities");
 /**
  * Provides an API Gateway Authorizer.
  *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const demoRestApi = new aws.apigateway.RestApi("demoRestApi", {});
+ * const invocationAssumeRole = aws.iam.getPolicyDocument({
+ *     statements: [{
+ *         effect: "Allow",
+ *         principals: [{
+ *             type: "Service",
+ *             identifiers: ["apigateway.amazonaws.com"],
+ *         }],
+ *         actions: ["sts:AssumeRole"],
+ *     }],
+ * });
+ * const invocationRole = new aws.iam.Role("invocationRole", {
+ *     path: "/",
+ *     assumeRolePolicy: invocationAssumeRole.then(invocationAssumeRole => invocationAssumeRole.json),
+ * });
+ * const lambdaAssumeRole = aws.iam.getPolicyDocument({
+ *     statements: [{
+ *         effect: "Allow",
+ *         actions: ["sts:AssumeRole"],
+ *         principals: [{
+ *             type: "Service",
+ *             identifiers: ["lambda.amazonaws.com"],
+ *         }],
+ *     }],
+ * });
+ * const lambda = new aws.iam.Role("lambda", {assumeRolePolicy: lambdaAssumeRole.then(lambdaAssumeRole => lambdaAssumeRole.json)});
+ * const authorizer = new aws.lambda.Function("authorizer", {
+ *     code: new pulumi.asset.FileArchive("lambda-function.zip"),
+ *     role: lambda.arn,
+ *     handler: "exports.example",
+ * });
+ * const demoAuthorizer = new aws.apigateway.Authorizer("demoAuthorizer", {
+ *     restApi: demoRestApi.id,
+ *     authorizerUri: authorizer.invokeArn,
+ *     authorizerCredentials: invocationRole.arn,
+ * });
+ * const invocationPolicyPolicyDocument = aws.iam.getPolicyDocumentOutput({
+ *     statements: [{
+ *         effect: "Allow",
+ *         actions: ["lambda:InvokeFunction"],
+ *         resources: [authorizer.arn],
+ *     }],
+ * });
+ * const invocationPolicyRolePolicy = new aws.iam.RolePolicy("invocationPolicyRolePolicy", {
+ *     role: invocationRole.id,
+ *     policy: invocationPolicyPolicyDocument.apply(invocationPolicyPolicyDocument => invocationPolicyPolicyDocument.json),
+ * });
+ * ```
+ *
  * ## Import
  *
  * terraform import {

package/apigateway/authorizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"authorizer.js","sourceRoot":"","sources":["../../apigateway/authorizer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"authorizer.js","sourceRoot":"","sources":["../../apigateway/authorizer.ts"],"names":[],"mappings":"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"}

package/apigateway/methodSettings.d.ts

@@ -9,6 +9,9 @@ import { RestApi } from "./index";
  *
  * ## Example Usage
  *
+ * ### End-to-end
+ * ### Basic Usage
+ *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as aws from "@pulumi/aws";
@@ -63,6 +66,75 @@ import { RestApi } from "./index";
  *     },
  * });
  * ```
+ * ### CloudWatch Logging and Tracing
+ *
+ * The AWS Console API Gateway Editor displays multiple options for CloudWatch Logs that don't directly map to the options in the AWS API and Pulumi. These examples show the `settings` blocks that are equivalent to the options the AWS Console gives for CloudWatch Logs.
+ * ### Off
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "OFF",
+ *     },
+ * });
+ * ```
+ * ### Errors Only
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "ERROR",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: false,
+ *     },
+ * });
+ * ```
+ * ### Errors and Info Logs
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "INFO",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: false,
+ *     },
+ * });
+ * ```
+ * ### Full Request and Response Logs
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "INFO",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: true,
+ *     },
+ * });
+ * ```
  *
  * ## Import
  *

package/apigateway/methodSettings.js

@@ -12,6 +12,9 @@ const utilities = require("../utilities");
  *
  * ## Example Usage
  *
+ * ### End-to-end
+ * ### Basic Usage
+ *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as aws from "@pulumi/aws";
@@ -66,6 +69,75 @@ const utilities = require("../utilities");
  *     },
  * });
  * ```
+ * ### CloudWatch Logging and Tracing
+ *
+ * The AWS Console API Gateway Editor displays multiple options for CloudWatch Logs that don't directly map to the options in the AWS API and Pulumi. These examples show the `settings` blocks that are equivalent to the options the AWS Console gives for CloudWatch Logs.
+ * ### Off
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "OFF",
+ *     },
+ * });
+ * ```
+ * ### Errors Only
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "ERROR",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: false,
+ *     },
+ * });
+ * ```
+ * ### Errors and Info Logs
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "INFO",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: false,
+ *     },
+ * });
+ * ```
+ * ### Full Request and Response Logs
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const pathSpecific = new aws.apigateway.MethodSettings("pathSpecific", {
+ *     restApi: aws_api_gateway_rest_api.example.id,
+ *     stageName: aws_api_gateway_stage.example.stage_name,
+ *     methodPath: "path1/GET",
+ *     settings: {
+ *         loggingLevel: "INFO",
+ *         metricsEnabled: true,
+ *         dataTraceEnabled: true,
+ *     },
+ * });
+ * ```
  *
  * ## Import
  *

package/apigateway/methodSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"methodSettings.js","sourceRoot":"","sources":["../../apigateway/methodSettings.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAIzC,0CAA0C;AAI1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,MAAa,cAAe,SAAQ,MAAM,CAAC,cAAc;IACrD;;;;;;;;OAQG;IACI,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,EAA2B,EAAE,KAA2B,EAAE,IAAmC;QACzH,OAAO,IAAI,cAAc,CAAC,IAAI,EAAO,KAAK,kCAAO,IAAI,KAAE,EAAE,EAAE,EAAE,IAAG,CAAC;IACrE,CAAC;IAKD;;;OAGG;IACI,MAAM,CAAC,UAAU,CAAC,GAAQ;QAC7B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACnC,OAAO,KAAK,CAAC;SAChB;QACD,OAAO,GAAG,CAAC,cAAc,CAAC,KAAK,cAAc,CAAC,YAAY,CAAC;IAC/D,CAAC;IA2BD,YAAY,IAAY,EAAE,WAAsD,EAAE,IAAmC;QACjH,IAAI,cAAc,GAAkB,EAAE,CAAC;QACvC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,EAAE,EAAE;YACT,MAAM,KAAK,GAAG,WAA8C,CAAC;YAC7D,cAAc,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YACpE,cAAc,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,cAAc,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,cAAc,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;SACrE;aAAM;YACH,MAAM,IAAI,GAAG,WAA6C,CAAC;YAC3D,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;aAC7D;YACD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACpD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;aAC1D;YACD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACrD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;aAC3D;YACD,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE;gBACtD,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;aAC5D;YACD,cAAc,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAClE,cAAc,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5D,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,cAAc,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;SACnE;QACD,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,CAAC,CAAC;QACnE,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;;AAnFL,wCAoFC;AAtEG,gBAAgB;AACO,2BAAY,GAAG,8CAA8C,CAAC"}
+{"version":3,"file":"methodSettings.js","sourceRoot":"","sources":["../../apigateway/methodSettings.ts"],"names":[],"mappings":"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"}

package/apigateway/stage.d.ts

@@ -54,7 +54,7 @@ import { Deployment, RestApi } from "./index";
  * ```
  * ### Managing the API Logging CloudWatch Log Group
  *
- * API Gateway provides the ability to [enable CloudWatch API logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-logging.html). To manage the CloudWatch Log Group when this feature is enabled, the `aws.cloudwatch.LogGroup` resource can be used where the name matches the API Gateway naming convention. If the CloudWatch Log Group previously exists, import the `aws.cloudwatch.LogGroup` resource into TODO as a one time operation. You can recreate the environment without import.
+ * API Gateway provides the ability to [enable CloudWatch API logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-logging.html). To manage the CloudWatch Log Group when this feature is enabled, the `aws.cloudwatch.LogGroup` resource can be used where the name matches the API Gateway naming convention. If the CloudWatch Log Group previously exists, import the `aws.cloudwatch.LogGroup` resource into Pulumi as a one time operation. You can recreate the environment without import.
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";

package/apigateway/stage.js

@@ -57,7 +57,7 @@ const utilities = require("../utilities");
  * ```
  * ### Managing the API Logging CloudWatch Log Group
  *
- * API Gateway provides the ability to [enable CloudWatch API logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-logging.html). To manage the CloudWatch Log Group when this feature is enabled, the `aws.cloudwatch.LogGroup` resource can be used where the name matches the API Gateway naming convention. If the CloudWatch Log Group previously exists, import the `aws.cloudwatch.LogGroup` resource into TODO as a one time operation. You can recreate the environment without import.
+ * API Gateway provides the ability to [enable CloudWatch API logging](https://docs.aws.amazon.com/apigateway/latest/developerguide/set-up-logging.html). To manage the CloudWatch Log Group when this feature is enabled, the `aws.cloudwatch.LogGroup` resource can be used where the name matches the API Gateway naming convention. If the CloudWatch Log Group previously exists, import the `aws.cloudwatch.LogGroup` resource into Pulumi as a one time operation. You can recreate the environment without import.
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";

package/appmesh/virtualRouter.d.ts

@@ -8,7 +8,7 @@ import * as outputs from "../types/output";
  *
  * Because of backward incompatible API changes (read [here](https://github.com/awslabs/aws-app-mesh-examples/issues/92) and [here](https://github.com/awslabs/aws-app-mesh-examples/issues/94)), `aws.appmesh.VirtualRouter` resource definitions created with provider versions earlier than v2.3.0 will need to be modified:
  *
- * * Remove service `serviceNames` from the `spec` argument. AWS has created a `aws.appmesh.VirtualService` resource for each service name. Import these resource using `TODO import`.
+ * * Remove service `serviceNames` from the `spec` argument. AWS has created a `aws.appmesh.VirtualService` resource for each service name. Import these resource using `pulumi import`.
  *
  * * Add a `listener` configuration block to the `spec` argument.
  *

package/appmesh/virtualRouter.js

@@ -12,7 +12,7 @@ const utilities = require("../utilities");
  *
  * Because of backward incompatible API changes (read [here](https://github.com/awslabs/aws-app-mesh-examples/issues/92) and [here](https://github.com/awslabs/aws-app-mesh-examples/issues/94)), `aws.appmesh.VirtualRouter` resource definitions created with provider versions earlier than v2.3.0 will need to be modified:
  *
- * * Remove service `serviceNames` from the `spec` argument. AWS has created a `aws.appmesh.VirtualService` resource for each service name. Import these resource using `TODO import`.
+ * * Remove service `serviceNames` from the `spec` argument. AWS has created a `aws.appmesh.VirtualService` resource for each service name. Import these resource using `pulumi import`.
  *
  * * Add a `listener` configuration block to the `spec` argument.
  *

package/athena/database.d.ts

@@ -23,7 +23,7 @@ import * as outputs from "../types/output";
  *
  *  to = aws_athena_database.example
  *
- *  id = "example" } Using `pulumi import`, import Athena Databases using their name. For exampleconsole % pulumi import aws_athena_database.example example Certain resource arguments, like `encryption_configuration` and `bucket`, do not have an API method for reading the information after creation. If the argument is set in the TODO configuration on an imported resource, TODO will always show a difference. To workaround this behavior, either omit the argument from the TODO configuration or use `ignore_changes` to hide the difference. For exampleterraform resource "aws_athena_database" "example" {
+ *  id = "example" } Using `pulumi import`, import Athena Databases using their name. For exampleconsole % pulumi import aws_athena_database.example example Certain resource arguments, like `encryption_configuration` and `bucket`, do not have an API method for reading the information after creation. If the argument is set in the Pulumi program on an imported resource, Pulumi will always show a difference. To workaround this behavior, either omit the argument from the Pulumi program or use `ignore_changes` to hide the difference. For exampleterraform resource "aws_athena_database" "example" {
  *
  *  name
  *

package/athena/database.js

@@ -27,7 +27,7 @@ const utilities = require("../utilities");
  *
  *  to = aws_athena_database.example
  *
- *  id = "example" } Using `pulumi import`, import Athena Databases using their name. For exampleconsole % pulumi import aws_athena_database.example example Certain resource arguments, like `encryption_configuration` and `bucket`, do not have an API method for reading the information after creation. If the argument is set in the TODO configuration on an imported resource, TODO will always show a difference. To workaround this behavior, either omit the argument from the TODO configuration or use `ignore_changes` to hide the difference. For exampleterraform resource "aws_athena_database" "example" {
+ *  id = "example" } Using `pulumi import`, import Athena Databases using their name. For exampleconsole % pulumi import aws_athena_database.example example Certain resource arguments, like `encryption_configuration` and `bucket`, do not have an API method for reading the information after creation. If the argument is set in the Pulumi program on an imported resource, Pulumi will always show a difference. To workaround this behavior, either omit the argument from the Pulumi program or use `ignore_changes` to hide the difference. For exampleterraform resource "aws_athena_database" "example" {
  *
  *  name
  *

package/autoscaling/policy.d.ts

@@ -32,7 +32,7 @@ import * as outputs from "../types/output";
  *     autoscalingGroupName: bar.name,
  * });
  * ```
- * ### Create target tarcking scaling policy using metric math
+ * ### Create target tracking scaling policy using metric math
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";

package/autoscaling/policy.js

@@ -36,7 +36,7 @@ const utilities = require("../utilities");
  *     autoscalingGroupName: bar.name,
  * });
  * ```
- * ### Create target tarcking scaling policy using metric math
+ * ### Create target tracking scaling policy using metric math
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";

package/budgets/getBudget.d.ts

@@ -45,9 +45,12 @@ export interface GetBudgetResult {
      * Object containing [AutoAdjustData] which determines the budget amount for an auto-adjusting budget.
      */
     readonly autoAdjustDatas: outputs.budgets.GetBudgetAutoAdjustData[];
+    /**
+     * Boolean indicating whether this budget has been exceeded.
+     */
     readonly budgetExceeded: boolean;
     /**
-     * The total amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage that you want to track with your budget. Contains object Spend
+     * The total amount of cost, usage, RI utilization, RI coverage, Savings Plans utilization, or Savings Plans coverage that you want to track with your budget. Contains object Spend.
      */
     readonly budgetLimits: outputs.budgets.GetBudgetBudgetLimit[];
     /**

package/budgets/getBudget.js.map

@@ -1 +1 @@
-{"version":3,"file":"getBudget.js","sourceRoot":"","sources":["../../budgets/getBudget.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAIzC,0CAA0C;AAE1C;;;;;;;;;;;;;;GAcG;AACH,SAAgB,SAAS,CAAC,IAAmB,EAAE,IAA2B;IAEtE,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iCAAiC,EAAE;QAC5D,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,YAAY,EAAE,IAAI,CAAC,UAAU;KAChC,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AARD,8BAQC;AAgFD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe,CAAC,IAAyB,EAAE,IAA2B;IAClF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACpE,CAAC;AAFD,0CAEC"}
+{"version":3,"file":"getBudget.js","sourceRoot":"","sources":["../../budgets/getBudget.ts"],"names":[],"mappings":";AAAA,wFAAwF;AACxF,iFAAiF;;;AAEjF,yCAAyC;AAIzC,0CAA0C;AAE1C;;;;;;;;;;;;;;GAcG;AACH,SAAgB,SAAS,CAAC,IAAmB,EAAE,IAA2B;IAEtE,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,oBAAoB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,iCAAiC,EAAE;QAC5D,WAAW,EAAE,IAAI,CAAC,SAAS;QAC3B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,YAAY,EAAE,IAAI,CAAC,UAAU;KAChC,EAAE,IAAI,CAAC,CAAC;AACb,CAAC;AARD,8BAQC;AAmFD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,eAAe,CAAC,IAAyB,EAAE,IAA2B;IAClF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAA;AACpE,CAAC;AAFD,0CAEC"}

package/cloudfront/distribution.d.ts

@@ -8,6 +8,235 @@ import * as outputs from "../types/output";
  *
  * > **NOTE:** CloudFront distributions take about 15 minutes to reach a deployed state after creation or modification. During this time, deletes to resources will be blocked. If you need to delete a distribution that is enabled and you do not want to wait, you need to use the `retainOnDelete` flag.
  *
+ * ## Example Usage
+ *
+ * The following example below creates a CloudFront distribution with an S3 origin.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const bucketV2 = new aws.s3.BucketV2("bucketV2", {tags: {
+ *     Name: "My bucket",
+ * }});
+ * const bAcl = new aws.s3.BucketAclV2("bAcl", {
+ *     bucket: bucketV2.id,
+ *     acl: "private",
+ * });
+ * const s3OriginId = "myS3Origin";
+ * const s3Distribution = new aws.cloudfront.Distribution("s3Distribution", {
+ *     origins: [{
+ *         domainName: bucketV2.bucketRegionalDomainName,
+ *         originAccessControlId: aws_cloudfront_origin_access_control["default"].id,
+ *         originId: s3OriginId,
+ *     }],
+ *     enabled: true,
+ *     isIpv6Enabled: true,
+ *     comment: "Some comment",
+ *     defaultRootObject: "index.html",
+ *     loggingConfig: {
+ *         includeCookies: false,
+ *         bucket: "mylogs.s3.amazonaws.com",
+ *         prefix: "myprefix",
+ *     },
+ *     aliases: [
+ *         "mysite.example.com",
+ *         "yoursite.example.com",
+ *     ],
+ *     defaultCacheBehavior: {
+ *         allowedMethods: [
+ *             "DELETE",
+ *             "GET",
+ *             "HEAD",
+ *             "OPTIONS",
+ *             "PATCH",
+ *             "POST",
+ *             "PUT",
+ *         ],
+ *         cachedMethods: [
+ *             "GET",
+ *             "HEAD",
+ *         ],
+ *         targetOriginId: s3OriginId,
+ *         forwardedValues: {
+ *             queryString: false,
+ *             cookies: {
+ *                 forward: "none",
+ *             },
+ *         },
+ *         viewerProtocolPolicy: "allow-all",
+ *         minTtl: 0,
+ *         defaultTtl: 3600,
+ *         maxTtl: 86400,
+ *     },
+ *     orderedCacheBehaviors: [
+ *         {
+ *             pathPattern: "/content/immutable/*",
+ *             allowedMethods: [
+ *                 "GET",
+ *                 "HEAD",
+ *                 "OPTIONS",
+ *             ],
+ *             cachedMethods: [
+ *                 "GET",
+ *                 "HEAD",
+ *                 "OPTIONS",
+ *             ],
+ *             targetOriginId: s3OriginId,
+ *             forwardedValues: {
+ *                 queryString: false,
+ *                 headers: ["Origin"],
+ *                 cookies: {
+ *                     forward: "none",
+ *                 },
+ *             },
+ *             minTtl: 0,
+ *             defaultTtl: 86400,
+ *             maxTtl: 31536000,
+ *             compress: true,
+ *             viewerProtocolPolicy: "redirect-to-https",
+ *         },
+ *         {
+ *             pathPattern: "/content/*",
+ *             allowedMethods: [
+ *                 "GET",
+ *                 "HEAD",
+ *                 "OPTIONS",
+ *             ],
+ *             cachedMethods: [
+ *                 "GET",
+ *                 "HEAD",
+ *             ],
+ *             targetOriginId: s3OriginId,
+ *             forwardedValues: {
+ *                 queryString: false,
+ *                 cookies: {
+ *                     forward: "none",
+ *                 },
+ *             },
+ *             minTtl: 0,
+ *             defaultTtl: 3600,
+ *             maxTtl: 86400,
+ *             compress: true,
+ *             viewerProtocolPolicy: "redirect-to-https",
+ *         },
+ *     ],
+ *     priceClass: "PriceClass_200",
+ *     restrictions: {
+ *         geoRestriction: {
+ *             restrictionType: "whitelist",
+ *             locations: [
+ *                 "US",
+ *                 "CA",
+ *                 "GB",
+ *                 "DE",
+ *             ],
+ *         },
+ *     },
+ *     tags: {
+ *         Environment: "production",
+ *     },
+ *     viewerCertificate: {
+ *         cloudfrontDefaultCertificate: true,
+ *     },
+ * });
+ * ```
+ *
+ * The example below creates a CloudFront distribution with an origin group for failover routing:
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const s3Distribution = new aws.cloudfront.Distribution("s3Distribution", {
+ *     originGroups: [{
+ *         originId: "groupS3",
+ *         failoverCriteria: {
+ *             statusCodes: [
+ *                 403,
+ *                 404,
+ *                 500,
+ *                 502,
+ *             ],
+ *         },
+ *         members: [
+ *             {
+ *                 originId: "primaryS3",
+ *             },
+ *             {
+ *                 originId: "failoverS3",
+ *             },
+ *         ],
+ *     }],
+ *     origins: [
+ *         {
+ *             domainName: aws_s3_bucket.primary.bucket_regional_domain_name,
+ *             originId: "primaryS3",
+ *             s3OriginConfig: {
+ *                 originAccessIdentity: aws_cloudfront_origin_access_identity["default"].cloudfront_access_identity_path,
+ *             },
+ *         },
+ *         {
+ *             domainName: aws_s3_bucket.failover.bucket_regional_domain_name,
+ *             originId: "failoverS3",
+ *             s3OriginConfig: {
+ *                 originAccessIdentity: aws_cloudfront_origin_access_identity["default"].cloudfront_access_identity_path,
+ *             },
+ *         },
+ *     ],
+ *     defaultCacheBehavior: {
+ *         targetOriginId: "groupS3",
+ *     },
+ * });
+ * // ... other configuration ...
+ * ```
+ *
+ * CloudFront distribution using [managed policies](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-managed-cache-policies.html) (ex: CachingDisabled):
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as aws from "@pulumi/aws";
+ *
+ * const s3OriginId = "myS3Origin";
+ * const s3Distribution = new aws.cloudfront.Distribution("s3Distribution", {
+ *     origins: [{
+ *         domainName: aws_s3_bucket.primary.bucket_regional_domain_name,
+ *         originId: "myS3Origin",
+ *         s3OriginConfig: {
+ *             originAccessIdentity: aws_cloudfront_origin_access_identity["default"].cloudfront_access_identity_path,
+ *         },
+ *     }],
+ *     enabled: true,
+ *     isIpv6Enabled: true,
+ *     comment: "Some comment",
+ *     defaultRootObject: "index.html",
+ *     defaultCacheBehavior: {
+ *         cachePolicyId: "4135ea2d-6df8-44a3-9df3-4b5a84be39ad",
+ *         allowedMethods: [
+ *             "GET",
+ *             "HEAD",
+ *             "OPTIONS",
+ *         ],
+ *         targetOriginId: s3OriginId,
+ *     },
+ *     restrictions: {
+ *         geoRestriction: {
+ *             restrictionType: "whitelist",
+ *             locations: [
+ *                 "US",
+ *                 "CA",
+ *                 "GB",
+ *                 "DE",
+ *             ],
+ *         },
+ *     },
+ *     viewerCertificate: {
+ *         cloudfrontDefaultCertificate: true,
+ *     },
+ * });
+ * // ... other configuration ...
+ * ```
+ *
  * ## Import
  *
  * terraform import {