{
  "slug": "import-files-can-declare-and-reference-explicit-providers-19e699de2703",
  "title": "Import files can declare and reference explicit providers",
  "tools": [
    "pulumi"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-23T15:10:53.000Z",
  "announced_at": "2026-07-23T15:10:53.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When importing resources that need an explicit provider, declare the provider in `resources` and reference its name from each imported resource’s `provider` field. Run `pulumi import --file <path>` to import the JSON file.",
    "examples": [
      "pulumi import --file <path-to-import.json>",
      "{\n  \"resources\": [\n    { \"type\": \"pulumi:providers:aws\", \"name\": \"my-prov\" },\n    { \"type\": \"aws:s3/bucket:Bucket\", \"name\": \"thing\", \"id\": \"<resource-id>\", \"provider\": \"my-prov\" }\n  ],\n  \"providerInputs\": { \"my-prov\": { \"region\": \"eu-west-1\" } }\n}"
    ],
    "gotchas": [
      "Version: 3.254.0",
      "resources (required): List of resources to import.",
      "resources[].provider: Name of the provider resource; the docs say the referenced name must be in `nameTable`.",
      "providerInputs: Release-note example maps a provider name to its inputs; official import schema documentation does not document this key or its sub-keys.",
      "--file (required): Path to the JSON-encoded file containing resources to import.",
      "Prerequisite: Use a Pulumi stack and have the provider configured so it can locate the target resource.",
      "Docs conflict: The current CLI reference is generated for Pulumi CLI v3.268.0, newer than the card’s v3.254.0. Its import-file schema does not document `providerInputs`; the release-note example is retained as the evidence for that key."
    ]
  },
  "why_it_matters": "Import resources with explicit providers from an import file.",
  "sources": [
    "https://github.com/pulumi/pulumi/releases/tag/v3.254.0",
    "https://github.com/pulumi/pulumi/pull/23972",
    "https://www.pulumi.com/docs/iac/cli/commands/pulumi_import/",
    "https://www.pulumi.com/docs/iac/guides/migration/import/"
  ],
  "rank": 0.96023,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-db92204a075abc3e-21:gate",
    "evidence_hash": "9147e70e72029a01014200c42dbc3aba7fcc4b548c9090eafe541348506ba681"
  },
  "review": {
    "draft_hash": "c970f08da677c3c84a3c0413b5e1789d651e274d33d6d72d6832384746c7cea9",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.62 (>= 0.6 needed)."
  }
}