[ aws . imagebuilder ]

get-container-recipe

Description

Retrieves a container recipe.

See also: AWS API Documentation

See ‘aws help’ for descriptions of global parameters.

Synopsis

  get-container-recipe
--container-recipe-arn <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]

Options

--container-recipe-arn (string)

The Amazon Resource Name (ARN) of the container recipe to retrieve.

--cli-input-json | --cli-input-yaml (string) Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See ‘aws help’ for descriptions of global parameters.

Output

requestId -> (string)

The request ID that uniquely identifies this request.

containerRecipe -> (structure)

The container recipe object that is returned.

arn -> (string)

The Amazon Resource Name (ARN) of the container recipe.

containerType -> (string)

Specifies the type of container, such as Docker.

name -> (string)

The name of the container recipe.

description -> (string)

The description of the container recipe.

platform -> (string)

The system platform for the container, such as Windows or Linux.

owner -> (string)

The owner of the container recipe.

version -> (string)

The semantic version of the container recipe (<major>.<minor>.<patch>).

components -> (list)

Components for build and test that are included in the container recipe.

(structure)

Configuration details of the component.

componentArn -> (string)

The Amazon Resource Name (ARN) of the component.

dockerfileTemplateData -> (string)

Dockerfiles are text documents that are used to build Docker containers, and ensure that they contain all of the elements required by the application running inside. The template data consists of contextual variables where Image Builder places build information or scripts, based on your container image recipe.

kmsKeyId -> (string)

Identifies which KMS key is used to encrypt the container image for distribution to the target Region.

encrypted -> (boolean)

A flag that indicates if the target container is encrypted.

parentImage -> (string)

The source image for the container recipe.

dateCreated -> (string)

The date when this container recipe was created.

tags -> (map)

Tags that are attached to the container recipe.

key -> (string)

value -> (string)

workingDirectory -> (string)

The working directory for use during build and test workflows.

targetRepository -> (structure)

The destination repository for the container image.

service -> (string)

Specifies the service in which this image was registered.

repositoryName -> (string)

The name of the container repository where the output container image is stored. This name is prefixed by the repository location.