package_versions

Creates, updates, deletes or gets a package_version resource or lists package_versions in a region

Overview

Name	package_versions
Type	Resource
Description	Registers a package version.
Id	awscc.panorama.package_versions

Fields

Name	Datatype	Description
owner_account	string	An owner account.
package_id	string	A package ID.
package_arn	string
package_version	string	A package version.
patch_version	string	A patch version.
mark_latest	boolean	Whether to mark the new version as the latest version.
is_latest_patch	boolean
package_name	string
status	string
status_description	string
registered_time	integer
region	string	AWS region.

For more information, see AWS::Panorama::PackageVersion.

Methods

Name	Accessible by	Required Params
create_resource	INSERT	PackageId, PackageVersion, PatchVersion, region
delete_resource	DELETE	Identifier, region
update_resource	UPDATE	Identifier, PatchDocument, region
get_resource	SELECT	Identifier, region

SELECT examples

Gets all properties from an individual package_version.

SELECT
  region,
  owner_account,
  package_id,
  package_arn,
  package_version,
  patch_version,
  mark_latest,
  is_latest_patch,
  package_name,
  status,
  status_description,
  registered_time,
  updated_latest_patch_version
FROM awscc.panorama.package_versions
WHERE
  region = 'us-east-1' AND
  Identifier = '{{ package_id }}|{{ package_version }}|{{ patch_version }}';

INSERT example

Use the following StackQL query and manifest file to create a new package_version resource, using stack-deploy.

Required Properties

/*+ create */
INSERT INTO awscc.panorama.package_versions (
  PackageId,
  PackageVersion,
  PatchVersion,
  region
)
SELECT
  '{{ package_id }}',
  '{{ package_version }}',
  '{{ patch_version }}',
  '{{ region }}';

All Properties

/*+ create */
INSERT INTO awscc.panorama.package_versions (
  OwnerAccount,
  PackageId,
  PackageVersion,
  PatchVersion,
  MarkLatest,
  UpdatedLatestPatchVersion,
  region
)
SELECT
  '{{ owner_account }}',
  '{{ package_id }}',
  '{{ package_version }}',
  '{{ patch_version }}',
  '{{ mark_latest }}',
  '{{ updated_latest_patch_version }}',
  '{{ region }}';

Manifest

version: 1
name: stack name
description: stack description
providers:
  - aws
globals:
  - name: region
    value: '{{ vars.AWS_REGION }}'
resources:
  - name: package_version
    props:
      - name: owner_account
        value: '{{ owner_account }}'
      - name: package_id
        value: '{{ package_id }}'
      - name: package_version
        value: '{{ package_version }}'
      - name: patch_version
        value: '{{ patch_version }}'
      - name: mark_latest
        value: '{{ mark_latest }}'
      - name: updated_latest_patch_version
        value: null

UPDATE example

Use the following StackQL query and manifest file to update a package_version resource, using stack-deploy.

/*+ update */
UPDATE awscc.panorama.package_versions
SET PatchDocument = string('{{ {
    "MarkLatest": mark_latest,
    "UpdatedLatestPatchVersion": updated_latest_patch_version
} | generate_patch_document }}')
WHERE
  region = '{{ region }}' AND
  Identifier = '{{ package_id }}|{{ package_version }}|{{ patch_version }}';

DELETE example

/*+ delete */
DELETE FROM awscc.panorama.package_versions
WHERE
  Identifier = '{{ package_id }}|{{ package_version }}|{{ patch_version }}' AND
  region = 'us-east-1';

Permissions

To operate on the package_versions resource, the following permissions are required:

Create

panorama:RegisterPackageVersion,
panorama:DescribePackageVersion,
s3:ListBucket,
s3:PutObject,
s3:GetObject,
s3:GetObjectVersion

Read

panorama:DescribePackageVersion,
s3:ListBucket,
s3:GetObject,
s3:GetObjectVersion

Update

panorama:DescribePackageVersion,
panorama:RegisterPackageVersion,
s3:ListBucket,
s3:PutObject,
s3:GetObject,
s3:GetObjectVersion

Delete

panorama:DeregisterPackageVersion,
panorama:DescribePackageVersion,
s3:DeleteObject,
s3:DeleteObjectVersion,
s3:DeleteObjectVersionTagging,
s3:ListBucket,
s3:GetObject,
s3:GetObjectVersion