Build Configuration API

A build configuration respresents settings associated with a resource that creates artifacts via builds. A build configuration is the name in packer push -name acemeinc/web.

Build configurations have many build configuration versions which represent versions of Packer templates and other associated configuration.

Build Configuration Attributes

Attribute Description Required
name The name of the build configuration, used to identify it. It has a maximum length of 50 characters and must contain only letters, numbers, dashes, underscores or periods. Yes
username The username to assign the build configuration to. You must be a member of the organization and have the ability to create the resource. Yes

Actions

The following actions can be perfomed on this resource.

Show
GET /api/v1/packer/build-configurations/:username/:name
Create
POST /api/v1/packer/build-configurations

Examples

Creating a build configuration

Creates a build configuration with the provided attributes.

$ curl https://atlas.hashicorp.com/api/v1/packer/build-configurations \
    -X POST \
    -H "X-Atlas-Token: $ATLAS_TOKEN" \
    -d build_configuration[name]='test' \
    -d build_configuration[username]='acmeinc'

Retrieving a build configuration

Returns the JSON respresentation of the build configuration.

$ curl https://atlas.hashicorp.com/api/v1/packer/build-configurations/acmeinc/test \
    -H "X-Atlas-Token: $ATLAS_TOKEN"