SoftwarePackageVersion

The SoftwarePackageVersion resource allows you to manage AWS IoT SoftwarePackageVersions for your IoT devices, enabling the deployment and management of software packages.

Minimal Example

Create a basic SoftwarePackageVersion with required properties and one optional property:

import AWS from "alchemy/aws/control";

const minimalSoftwarePackageVersion = await AWS.IoT.SoftwarePackageVersion("basicSoftwarePackage", {
  PackageName: "my-software-package",
  Description: "A basic software package for device management"
});

Advanced Configuration

Configure a SoftwarePackageVersion with additional attributes, SBOM, and tags for improved metadata:

const advancedSoftwarePackageVersion = await AWS.IoT.SoftwarePackageVersion("advancedSoftwarePackage", {
  PackageName: "advanced-software-package",
  Description: "An advanced software package with detailed attributes",
  Recipe: "recipe-url",
  Attributes: {
    version: "1.0.0",
    environment: "production"
  },
  Sbom: {
    format: "spdx",
    content: "sbom-content"
  },
  Tags: [
    { Key: "env", Value: "production" },
    { Key: "type", Value: "device-firmware" }
  ]
});

Example with Artifact

Create a SoftwarePackageVersion that includes an artifact for the software package:

const softwarePackageWithArtifact = await AWS.IoT.SoftwarePackageVersion("softwareWithArtifact", {
  PackageName: "firmware-package",
  Description: "Firmware package for IoT devices",
  Artifact: {
    uri: "s3://my-bucket/firmware-package.zip",
    size: 2048000 // Size in bytes
  },
  VersionName: "v1.2.3"
});

Adoption of Existing Resources

Configure the SoftwarePackageVersion to adopt an already existing resource instead of failing:

const adoptExistingSoftwarePackage = await AWS.IoT.SoftwarePackageVersion("adoptExisting", {
  PackageName: "existing-package",
  adopt: true, // Adopts if the resource already exists
  Description: "Adopting an existing software package"
});