API Gateway canary deployment with Terraform

Hi!

We would like to deploy API changes with Terraform to the canary-enabled stage, something similar to "Canary deployment" section here: https://aws.amazon.com/blogs/compute/performing-canary-deployments-for-service-integrations-with-amazon-api-gateway/

Our simplified Terraform configuration looks like this:

resource "aws_api_gateway_rest_api" "canary" {
  name = "canary-poc"
  endpoint_configuration {
    types = ["REGIONAL"]
  }
  body = jsonencode({
    openapi = "3.0.1"
    info = {
      title   = "canary-poc"
      version = "1.0"
    }
    paths = {
      "/path" = {
        get = {
          x-amazon-apigateway-integration = {
            httpMethod           = "POST"
            payloadFormatVersion = "1.0"
            type                 = "AWS_PROXY"
            uri                  = ...
          }
        }
      }
    }
  })
}

resource "aws_api_gateway_deployment" "canary" {
  rest_api_id = aws_api_gateway_rest_api.canary.id
  triggers = {
    redeployment = sha1(jsonencode(aws_api_gateway_rest_api.canary.body))
  }
  lifecycle {
    create_before_destroy = true
  }
}

resource "aws_api_gateway_stage" "canary" {
  deployment_id = aws_api_gateway_deployment.canary.id
  rest_api_id   = aws_api_gateway_rest_api.canary.id
  stage_name    = ...
  canary_settings {
    percent_traffic = 50.0
  }
}

resource "aws_api_gateway_base_path_mapping" "canary" {
  api_id      = aws_api_gateway_rest_api.canary.id
  stage_name  = aws_api_gateway_stage.canary.stage_name
  domain_name = aws_api_gateway_domain_name.canary.domain_name
}

If I load API changes and deploy manually in AWS Console to the canary-enabled stage the previous deploy is correctly attached to the current stage and newly deployed one to the canary:

I can then promote canary:

However when I deploy API changes to the canary-enabled stage with TF, AWS does not correctly attach the deployment -- it is not attached to the canary:

The deployment history in the stage is not kept -- every time I deploy with Terraform, the previous deployment is deleted (due to deployment resource create_before_destroy lifecycle rule in TF):

Deployment resource create_before_destroy lifecycle rule in TF is recommended to avoid cycle errors: https://github.com/hashicorp/terraform-provider-aws/issues/11344 https://registry.terraform.io/providers/hashicorp/aws/4.38.0/docs/resources/api_gateway_deployment

Is there any way to configure deployment in Terraform to have IaC canary deployments?