ecr

package
v1.99.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 10, 2020 License: Apache-2.0 Imports: 10 Imported by: 0

Documentation

Overview

Package ecr provides the client and types for making API requests to Amazon EC2 Container Registry.

Amazon Elastic Container Registry (Amazon ECR) is a managed Docker registry service. Customers can use the familiar Docker CLI to push, pull, and manage images. Amazon ECR provides a secure, scalable, and reliable registry. Amazon ECR supports private Docker repositories with resource-based permissions using IAM so that specific users or Amazon EC2 instances can access repositories and images. Developers can use the Docker CLI to author and manage images.

See https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21 for more information on this service.

See ecr package documentation for more information. https://docs.aws.amazon.com/sdk-for-go/api/service/ecr/

Using the Client

To contact Amazon EC2 Container Registry with the SDK use the New function to create a new service client. With that client you can make API requests to the service. These clients are safe to use concurrently.

See the SDK's documentation for more information on how to use the SDK. https://docs.aws.amazon.com/sdk-for-go/api/

See aws.Config documentation for more information on configuring SDK clients. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

See the Amazon EC2 Container Registry client ECR for more information on creating client for this service. https://docs.aws.amazon.com/sdk-for-go/api/service/ecr/#New

Index

Examples

Constants

View Source
const (
	// ImageFailureCodeInvalidImageDigest is a ImageFailureCode enum value
	ImageFailureCodeInvalidImageDigest = "InvalidImageDigest"

	// ImageFailureCodeInvalidImageTag is a ImageFailureCode enum value
	ImageFailureCodeInvalidImageTag = "InvalidImageTag"

	// ImageFailureCodeImageTagDoesNotMatchDigest is a ImageFailureCode enum value
	ImageFailureCodeImageTagDoesNotMatchDigest = "ImageTagDoesNotMatchDigest"

	// ImageFailureCodeImageNotFound is a ImageFailureCode enum value
	ImageFailureCodeImageNotFound = "ImageNotFound"

	// ImageFailureCodeMissingDigestAndTag is a ImageFailureCode enum value
	ImageFailureCodeMissingDigestAndTag = "MissingDigestAndTag"
)
View Source
const (
	// ImageTagMutabilityMutable is a ImageTagMutability enum value
	ImageTagMutabilityMutable = "MUTABLE"

	// ImageTagMutabilityImmutable is a ImageTagMutability enum value
	ImageTagMutabilityImmutable = "IMMUTABLE"
)
View Source
const (
	// LayerAvailabilityAvailable is a LayerAvailability enum value
	LayerAvailabilityAvailable = "AVAILABLE"

	// LayerAvailabilityUnavailable is a LayerAvailability enum value
	LayerAvailabilityUnavailable = "UNAVAILABLE"
)
View Source
const (
	// LayerFailureCodeInvalidLayerDigest is a LayerFailureCode enum value
	LayerFailureCodeInvalidLayerDigest = "InvalidLayerDigest"

	// LayerFailureCodeMissingLayerDigest is a LayerFailureCode enum value
	LayerFailureCodeMissingLayerDigest = "MissingLayerDigest"
)
View Source
const (
	// LifecyclePolicyPreviewStatusInProgress is a LifecyclePolicyPreviewStatus enum value
	LifecyclePolicyPreviewStatusInProgress = "IN_PROGRESS"

	// LifecyclePolicyPreviewStatusComplete is a LifecyclePolicyPreviewStatus enum value
	LifecyclePolicyPreviewStatusComplete = "COMPLETE"

	// LifecyclePolicyPreviewStatusExpired is a LifecyclePolicyPreviewStatus enum value
	LifecyclePolicyPreviewStatusExpired = "EXPIRED"

	// LifecyclePolicyPreviewStatusFailed is a LifecyclePolicyPreviewStatus enum value
	LifecyclePolicyPreviewStatusFailed = "FAILED"
)
View Source
const (
	// TagStatusTagged is a TagStatus enum value
	TagStatusTagged = "TAGGED"

	// TagStatusUntagged is a TagStatus enum value
	TagStatusUntagged = "UNTAGGED"

	// TagStatusAny is a TagStatus enum value
	TagStatusAny = "ANY"
)
View Source
const (

	// ErrCodeEmptyUploadException for service response error code
	// "EmptyUploadException".
	//
	// The specified layer upload does not contain any layer parts.
	ErrCodeEmptyUploadException = "EmptyUploadException"

	// ErrCodeImageAlreadyExistsException for service response error code
	// "ImageAlreadyExistsException".
	//
	// The specified image has already been pushed, and there were no changes to
	// the manifest or image tag after the last push.
	ErrCodeImageAlreadyExistsException = "ImageAlreadyExistsException"

	// ErrCodeImageNotFoundException for service response error code
	// "ImageNotFoundException".
	//
	// The image requested does not exist in the specified repository.
	ErrCodeImageNotFoundException = "ImageNotFoundException"

	// ErrCodeImageTagAlreadyExistsException for service response error code
	// "ImageTagAlreadyExistsException".
	//
	// The specified image is tagged with a tag that already exists. The repository
	// is configured for tag immutability.
	ErrCodeImageTagAlreadyExistsException = "ImageTagAlreadyExistsException"

	// ErrCodeInvalidLayerException for service response error code
	// "InvalidLayerException".
	//
	// The layer digest calculation performed by Amazon ECR upon receipt of the
	// image layer does not match the digest specified.
	ErrCodeInvalidLayerException = "InvalidLayerException"

	// ErrCodeInvalidLayerPartException for service response error code
	// "InvalidLayerPartException".
	//
	// The layer part size is not valid, or the first byte specified is not consecutive
	// to the last byte of a previous layer part upload.
	ErrCodeInvalidLayerPartException = "InvalidLayerPartException"

	// ErrCodeInvalidParameterException for service response error code
	// "InvalidParameterException".
	//
	// The specified parameter is invalid. Review the available parameters for the
	// API request.
	ErrCodeInvalidParameterException = "InvalidParameterException"

	// ErrCodeInvalidTagParameterException for service response error code
	// "InvalidTagParameterException".
	//
	// An invalid parameter has been specified. Tag keys can have a maximum character
	// length of 128 characters, and tag values can have a maximum length of 256
	// characters.
	ErrCodeInvalidTagParameterException = "InvalidTagParameterException"

	// ErrCodeLayerAlreadyExistsException for service response error code
	// "LayerAlreadyExistsException".
	//
	// The image layer already exists in the associated repository.
	ErrCodeLayerAlreadyExistsException = "LayerAlreadyExistsException"

	// ErrCodeLayerInaccessibleException for service response error code
	// "LayerInaccessibleException".
	//
	// The specified layer is not available because it is not associated with an
	// image. Unassociated image layers may be cleaned up at any time.
	ErrCodeLayerInaccessibleException = "LayerInaccessibleException"

	// ErrCodeLayerPartTooSmallException for service response error code
	// "LayerPartTooSmallException".
	//
	// Layer parts must be at least 5 MiB in size.
	ErrCodeLayerPartTooSmallException = "LayerPartTooSmallException"

	// ErrCodeLayersNotFoundException for service response error code
	// "LayersNotFoundException".
	//
	// The specified layers could not be found, or the specified layer is not valid
	// for this repository.
	ErrCodeLayersNotFoundException = "LayersNotFoundException"

	// ErrCodeLifecyclePolicyNotFoundException for service response error code
	// "LifecyclePolicyNotFoundException".
	//
	// The lifecycle policy could not be found, and no policy is set to the repository.
	ErrCodeLifecyclePolicyNotFoundException = "LifecyclePolicyNotFoundException"

	// ErrCodeLifecyclePolicyPreviewInProgressException for service response error code
	// "LifecyclePolicyPreviewInProgressException".
	//
	// The previous lifecycle policy preview request has not completed. Please try
	// again later.
	ErrCodeLifecyclePolicyPreviewInProgressException = "LifecyclePolicyPreviewInProgressException"

	// ErrCodeLifecyclePolicyPreviewNotFoundException for service response error code
	// "LifecyclePolicyPreviewNotFoundException".
	//
	// There is no dry run for this repository.
	ErrCodeLifecyclePolicyPreviewNotFoundException = "LifecyclePolicyPreviewNotFoundException"

	// ErrCodeLimitExceededException for service response error code
	// "LimitExceededException".
	//
	// The operation did not succeed because it would have exceeded a service limit
	// for your account. For more information, see Amazon ECR Default Service Limits
	// (https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html)
	// in the Amazon Elastic Container Registry User Guide.
	ErrCodeLimitExceededException = "LimitExceededException"

	// ErrCodeRepositoryAlreadyExistsException for service response error code
	// "RepositoryAlreadyExistsException".
	//
	// The specified repository already exists in the specified registry.
	ErrCodeRepositoryAlreadyExistsException = "RepositoryAlreadyExistsException"

	// ErrCodeRepositoryNotEmptyException for service response error code
	// "RepositoryNotEmptyException".
	//
	// The specified repository contains images. To delete a repository that contains
	// images, you must force the deletion with the force parameter.
	ErrCodeRepositoryNotEmptyException = "RepositoryNotEmptyException"

	// ErrCodeRepositoryNotFoundException for service response error code
	// "RepositoryNotFoundException".
	//
	// The specified repository could not be found. Check the spelling of the specified
	// repository and ensure that you are performing operations on the correct registry.
	ErrCodeRepositoryNotFoundException = "RepositoryNotFoundException"

	// ErrCodeRepositoryPolicyNotFoundException for service response error code
	// "RepositoryPolicyNotFoundException".
	//
	// The specified repository and registry combination does not have an associated
	// repository policy.
	ErrCodeRepositoryPolicyNotFoundException = "RepositoryPolicyNotFoundException"

	// ErrCodeServerException for service response error code
	// "ServerException".
	//
	// These errors are usually caused by a server-side issue.
	ErrCodeServerException = "ServerException"

	// ErrCodeTooManyTagsException for service response error code
	// "TooManyTagsException".
	//
	// The list of tags on the repository is over the limit. The maximum number
	// of tags that can be applied to a repository is 50.
	ErrCodeTooManyTagsException = "TooManyTagsException"

	// ErrCodeUploadNotFoundException for service response error code
	// "UploadNotFoundException".
	//
	// The upload could not be found, or the specified upload id is not valid for
	// this repository.
	ErrCodeUploadNotFoundException = "UploadNotFoundException"
)
View Source
const (
	ServiceName = "ecr"     // Name of service.
	EndpointsID = "api.ecr" // ID to lookup a service endpoint with.
	ServiceID   = "ECR"     // ServiceID is a unique identifer of a specific service.
)

Service information constants

View Source
const (
	// ImageActionTypeExpire is a ImageActionType enum value
	ImageActionTypeExpire = "EXPIRE"
)

Variables

This section is empty.

Functions

This section is empty.

Types

type AuthorizationData

type AuthorizationData struct {

	// A base64-encoded string that contains authorization data for the specified
	// Amazon ECR registry. When the string is decoded, it is presented in the format
	// user:password for private registry authentication using docker login.
	AuthorizationToken *string `locationName:"authorizationToken" type:"string"`

	// The Unix time in seconds and milliseconds when the authorization token expires.
	// Authorization tokens are valid for 12 hours.
	ExpiresAt *time.Time `locationName:"expiresAt" type:"timestamp"`

	// The registry URL to use for this authorization token in a docker login command.
	// The Amazon ECR registry URL format is https://aws_account_id.dkr.ecr.region.amazonaws.com.
	// For example, https://012345678910.dkr.ecr.us-east-1.amazonaws.com..
	ProxyEndpoint *string `locationName:"proxyEndpoint" type:"string"`
	// contains filtered or unexported fields
}

An object representing authorization data for an Amazon ECR registry.

func (AuthorizationData) GoString

func (s AuthorizationData) GoString() string

GoString returns the string representation

func (*AuthorizationData) SetAuthorizationToken added in v1.5.0

func (s *AuthorizationData) SetAuthorizationToken(v string) *AuthorizationData

SetAuthorizationToken sets the AuthorizationToken field's value.

func (*AuthorizationData) SetExpiresAt added in v1.5.0

func (s *AuthorizationData) SetExpiresAt(v time.Time) *AuthorizationData

SetExpiresAt sets the ExpiresAt field's value.

func (*AuthorizationData) SetProxyEndpoint added in v1.5.0

func (s *AuthorizationData) SetProxyEndpoint(v string) *AuthorizationData

SetProxyEndpoint sets the ProxyEndpoint field's value.

func (AuthorizationData) String

func (s AuthorizationData) String() string

String returns the string representation

type BatchCheckLayerAvailabilityInput

type BatchCheckLayerAvailabilityInput struct {

	// The digests of the image layers to check.
	//
	// LayerDigests is a required field
	LayerDigests []*string `locationName:"layerDigests" min:"1" type:"list" required:"true"`

	// The AWS account ID associated with the registry that contains the image layers
	// to check. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository that is associated with the image layers to check.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (BatchCheckLayerAvailabilityInput) GoString

GoString returns the string representation

func (*BatchCheckLayerAvailabilityInput) SetLayerDigests added in v1.5.0

SetLayerDigests sets the LayerDigests field's value.

func (*BatchCheckLayerAvailabilityInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*BatchCheckLayerAvailabilityInput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (BatchCheckLayerAvailabilityInput) String

String returns the string representation

func (*BatchCheckLayerAvailabilityInput) Validate added in v1.1.21

Validate inspects the fields of the type to determine if they are valid.

type BatchCheckLayerAvailabilityOutput

type BatchCheckLayerAvailabilityOutput struct {

	// Any failures associated with the call.
	Failures []*LayerFailure `locationName:"failures" type:"list"`

	// A list of image layer objects corresponding to the image layer references
	// in the request.
	Layers []*Layer `locationName:"layers" type:"list"`
	// contains filtered or unexported fields
}

func (BatchCheckLayerAvailabilityOutput) GoString

GoString returns the string representation

func (*BatchCheckLayerAvailabilityOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchCheckLayerAvailabilityOutput) SetLayers added in v1.5.0

SetLayers sets the Layers field's value.

func (BatchCheckLayerAvailabilityOutput) String

String returns the string representation

type BatchDeleteImageInput

type BatchDeleteImageInput struct {

	// A list of image ID references that correspond to images to delete. The format
	// of the imageIds reference is imageTag=tag or imageDigest=digest.
	//
	// ImageIds is a required field
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list" required:"true"`

	// The AWS account ID associated with the registry that contains the image to
	// delete. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository that contains the image to delete.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Deletes specified images within a specified repository. Images are specified with either the imageTag or imageDigest.

func (BatchDeleteImageInput) GoString

func (s BatchDeleteImageInput) GoString() string

GoString returns the string representation

func (*BatchDeleteImageInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*BatchDeleteImageInput) SetRegistryId added in v1.5.0

func (s *BatchDeleteImageInput) SetRegistryId(v string) *BatchDeleteImageInput

SetRegistryId sets the RegistryId field's value.

func (*BatchDeleteImageInput) SetRepositoryName added in v1.5.0

func (s *BatchDeleteImageInput) SetRepositoryName(v string) *BatchDeleteImageInput

SetRepositoryName sets the RepositoryName field's value.

func (BatchDeleteImageInput) String

func (s BatchDeleteImageInput) String() string

String returns the string representation

func (*BatchDeleteImageInput) Validate added in v1.1.21

func (s *BatchDeleteImageInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type BatchDeleteImageOutput

type BatchDeleteImageOutput struct {

	// Any failures associated with the call.
	Failures []*ImageFailure `locationName:"failures" type:"list"`

	// The image IDs of the deleted images.
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"`
	// contains filtered or unexported fields
}

func (BatchDeleteImageOutput) GoString

func (s BatchDeleteImageOutput) GoString() string

GoString returns the string representation

func (*BatchDeleteImageOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchDeleteImageOutput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (BatchDeleteImageOutput) String

func (s BatchDeleteImageOutput) String() string

String returns the string representation

type BatchGetImageInput

type BatchGetImageInput struct {

	// The accepted media types for the request.
	//
	// Valid values: application/vnd.docker.distribution.manifest.v1+json | application/vnd.docker.distribution.manifest.v2+json
	// | application/vnd.oci.image.manifest.v1+json
	AcceptedMediaTypes []*string `locationName:"acceptedMediaTypes" min:"1" type:"list"`

	// A list of image ID references that correspond to images to describe. The
	// format of the imageIds reference is imageTag=tag or imageDigest=digest.
	//
	// ImageIds is a required field
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list" required:"true"`

	// The AWS account ID associated with the registry that contains the images
	// to describe. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository that contains the images to describe.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (BatchGetImageInput) GoString

func (s BatchGetImageInput) GoString() string

GoString returns the string representation

func (*BatchGetImageInput) SetAcceptedMediaTypes added in v1.6.7

func (s *BatchGetImageInput) SetAcceptedMediaTypes(v []*string) *BatchGetImageInput

SetAcceptedMediaTypes sets the AcceptedMediaTypes field's value.

func (*BatchGetImageInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*BatchGetImageInput) SetRegistryId added in v1.5.0

func (s *BatchGetImageInput) SetRegistryId(v string) *BatchGetImageInput

SetRegistryId sets the RegistryId field's value.

func (*BatchGetImageInput) SetRepositoryName added in v1.5.0

func (s *BatchGetImageInput) SetRepositoryName(v string) *BatchGetImageInput

SetRepositoryName sets the RepositoryName field's value.

func (BatchGetImageInput) String

func (s BatchGetImageInput) String() string

String returns the string representation

func (*BatchGetImageInput) Validate added in v1.1.21

func (s *BatchGetImageInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type BatchGetImageOutput

type BatchGetImageOutput struct {

	// Any failures associated with the call.
	Failures []*ImageFailure `locationName:"failures" type:"list"`

	// A list of image objects corresponding to the image references in the request.
	Images []*Image `locationName:"images" type:"list"`
	// contains filtered or unexported fields
}

func (BatchGetImageOutput) GoString

func (s BatchGetImageOutput) GoString() string

GoString returns the string representation

func (*BatchGetImageOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchGetImageOutput) SetImages added in v1.5.0

func (s *BatchGetImageOutput) SetImages(v []*Image) *BatchGetImageOutput

SetImages sets the Images field's value.

func (BatchGetImageOutput) String

func (s BatchGetImageOutput) String() string

String returns the string representation

type CompleteLayerUploadInput

type CompleteLayerUploadInput struct {

	// The sha256 digest of the image layer.
	//
	// LayerDigests is a required field
	LayerDigests []*string `locationName:"layerDigests" min:"1" type:"list" required:"true"`

	// The AWS account ID associated with the registry to which to upload layers.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to associate with the image layer.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`

	// The upload ID from a previous InitiateLayerUpload operation to associate
	// with the image layer.
	//
	// UploadId is a required field
	UploadId *string `locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CompleteLayerUploadInput) GoString

func (s CompleteLayerUploadInput) GoString() string

GoString returns the string representation

func (*CompleteLayerUploadInput) SetLayerDigests added in v1.5.0

func (s *CompleteLayerUploadInput) SetLayerDigests(v []*string) *CompleteLayerUploadInput

SetLayerDigests sets the LayerDigests field's value.

func (*CompleteLayerUploadInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadInput) SetRepositoryName added in v1.5.0

func (s *CompleteLayerUploadInput) SetRepositoryName(v string) *CompleteLayerUploadInput

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadInput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (CompleteLayerUploadInput) String

func (s CompleteLayerUploadInput) String() string

String returns the string representation

func (*CompleteLayerUploadInput) Validate added in v1.1.21

func (s *CompleteLayerUploadInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CompleteLayerUploadOutput

type CompleteLayerUploadOutput struct {

	// The sha256 digest of the image layer.
	LayerDigest *string `locationName:"layerDigest" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`

	// The upload ID associated with the layer.
	UploadId *string `locationName:"uploadId" type:"string"`
	// contains filtered or unexported fields
}

func (CompleteLayerUploadOutput) GoString

func (s CompleteLayerUploadOutput) GoString() string

GoString returns the string representation

func (*CompleteLayerUploadOutput) SetLayerDigest added in v1.5.0

SetLayerDigest sets the LayerDigest field's value.

func (*CompleteLayerUploadOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadOutput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (CompleteLayerUploadOutput) String

func (s CompleteLayerUploadOutput) String() string

String returns the string representation

type CreateRepositoryInput

type CreateRepositoryInput struct {

	// The tag mutability setting for the repository. If this parameter is omitted,
	// the default setting of MUTABLE will be used which will allow image tags to
	// be overwritten. If IMMUTABLE is specified, all image tags within the repository
	// will be immutable which will prevent them from being overwritten.
	ImageTagMutability *string `locationName:"imageTagMutability" type:"string" enum:"ImageTagMutability"`

	// The name to use for the repository. The repository name may be specified
	// on its own (such as nginx-web-app) or it can be prepended with a namespace
	// to group the repository into a category (such as project-a/nginx-web-app).
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`

	// The metadata that you apply to the repository to help you categorize and
	// organize them. Each tag consists of a key and an optional value, both of
	// which you define. Tag keys can have a maximum character length of 128 characters,
	// and tag values can have a maximum length of 256 characters.
	Tags []*Tag `locationName:"tags" type:"list"`
	// contains filtered or unexported fields
}

func (CreateRepositoryInput) GoString

func (s CreateRepositoryInput) GoString() string

GoString returns the string representation

func (*CreateRepositoryInput) SetImageTagMutability added in v1.99.0

func (s *CreateRepositoryInput) SetImageTagMutability(v string) *CreateRepositoryInput

SetImageTagMutability sets the ImageTagMutability field's value.

func (*CreateRepositoryInput) SetRepositoryName added in v1.5.0

func (s *CreateRepositoryInput) SetRepositoryName(v string) *CreateRepositoryInput

SetRepositoryName sets the RepositoryName field's value.

func (*CreateRepositoryInput) SetTags added in v1.99.0

SetTags sets the Tags field's value.

func (CreateRepositoryInput) String

func (s CreateRepositoryInput) String() string

String returns the string representation

func (*CreateRepositoryInput) Validate added in v1.1.21

func (s *CreateRepositoryInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type CreateRepositoryOutput

type CreateRepositoryOutput struct {

	// The repository that was created.
	Repository *Repository `locationName:"repository" type:"structure"`
	// contains filtered or unexported fields
}

func (CreateRepositoryOutput) GoString

func (s CreateRepositoryOutput) GoString() string

GoString returns the string representation

func (*CreateRepositoryOutput) SetRepository added in v1.5.0

SetRepository sets the Repository field's value.

func (CreateRepositoryOutput) String

func (s CreateRepositoryOutput) String() string

String returns the string representation

type DeleteLifecyclePolicyInput added in v1.12.9

type DeleteLifecyclePolicyInput struct {

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteLifecyclePolicyInput) GoString added in v1.12.9

func (s DeleteLifecyclePolicyInput) GoString() string

GoString returns the string representation

func (*DeleteLifecyclePolicyInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*DeleteLifecyclePolicyInput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (DeleteLifecyclePolicyInput) String added in v1.12.9

String returns the string representation

func (*DeleteLifecyclePolicyInput) Validate added in v1.12.9

func (s *DeleteLifecyclePolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteLifecyclePolicyOutput added in v1.12.9

type DeleteLifecyclePolicyOutput struct {

	// The time stamp of the last time that the lifecycle policy was run.
	LastEvaluatedAt *time.Time `locationName:"lastEvaluatedAt" type:"timestamp"`

	// The JSON lifecycle policy text.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteLifecyclePolicyOutput) GoString added in v1.12.9

func (s DeleteLifecyclePolicyOutput) GoString() string

GoString returns the string representation

func (*DeleteLifecyclePolicyOutput) SetLastEvaluatedAt added in v1.12.9

SetLastEvaluatedAt sets the LastEvaluatedAt field's value.

func (*DeleteLifecyclePolicyOutput) SetLifecyclePolicyText added in v1.12.9

func (s *DeleteLifecyclePolicyOutput) SetLifecyclePolicyText(v string) *DeleteLifecyclePolicyOutput

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*DeleteLifecyclePolicyOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*DeleteLifecyclePolicyOutput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (DeleteLifecyclePolicyOutput) String added in v1.12.9

String returns the string representation

type DeleteRepositoryInput

type DeleteRepositoryInput struct {

	// If a repository contains images, forces the deletion.
	Force *bool `locationName:"force" type:"boolean"`

	// The AWS account ID associated with the registry that contains the repository
	// to delete. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to delete.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteRepositoryInput) GoString

func (s DeleteRepositoryInput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryInput) SetForce added in v1.5.0

SetForce sets the Force field's value.

func (*DeleteRepositoryInput) SetRegistryId added in v1.5.0

func (s *DeleteRepositoryInput) SetRegistryId(v string) *DeleteRepositoryInput

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryInput) SetRepositoryName added in v1.5.0

func (s *DeleteRepositoryInput) SetRepositoryName(v string) *DeleteRepositoryInput

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryInput) String

func (s DeleteRepositoryInput) String() string

String returns the string representation

func (*DeleteRepositoryInput) Validate added in v1.1.21

func (s *DeleteRepositoryInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteRepositoryOutput

type DeleteRepositoryOutput struct {

	// The repository that was deleted.
	Repository *Repository `locationName:"repository" type:"structure"`
	// contains filtered or unexported fields
}

func (DeleteRepositoryOutput) GoString

func (s DeleteRepositoryOutput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryOutput) SetRepository added in v1.5.0

SetRepository sets the Repository field's value.

func (DeleteRepositoryOutput) String

func (s DeleteRepositoryOutput) String() string

String returns the string representation

type DeleteRepositoryPolicyInput

type DeleteRepositoryPolicyInput struct {

	// The AWS account ID associated with the registry that contains the repository
	// policy to delete. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository that is associated with the repository policy
	// to delete.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DeleteRepositoryPolicyInput) GoString

func (s DeleteRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryPolicyInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyInput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyInput) String

String returns the string representation

func (*DeleteRepositoryPolicyInput) Validate added in v1.1.21

func (s *DeleteRepositoryPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DeleteRepositoryPolicyOutput

type DeleteRepositoryPolicyOutput struct {

	// The JSON repository policy that was deleted from the repository.
	PolicyText *string `locationName:"policyText" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteRepositoryPolicyOutput) GoString

func (s DeleteRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryPolicyOutput) SetPolicyText added in v1.5.0

SetPolicyText sets the PolicyText field's value.

func (*DeleteRepositoryPolicyOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyOutput) String

String returns the string representation

type DescribeImagesFilter added in v1.4.16

type DescribeImagesFilter struct {

	// The tag status with which to filter your DescribeImages results. You can
	// filter results based on whether they are TAGGED or UNTAGGED.
	TagStatus *string `locationName:"tagStatus" type:"string" enum:"TagStatus"`
	// contains filtered or unexported fields
}

An object representing a filter on a DescribeImages operation.

func (DescribeImagesFilter) GoString added in v1.4.16

func (s DescribeImagesFilter) GoString() string

GoString returns the string representation

func (*DescribeImagesFilter) SetTagStatus added in v1.5.0

func (s *DescribeImagesFilter) SetTagStatus(v string) *DescribeImagesFilter

SetTagStatus sets the TagStatus field's value.

func (DescribeImagesFilter) String added in v1.4.16

func (s DescribeImagesFilter) String() string

String returns the string representation

type DescribeImagesInput added in v1.4.16

type DescribeImagesInput struct {

	// The filter key and value with which to filter your DescribeImages results.
	Filter *DescribeImagesFilter `locationName:"filter" type:"structure"`

	// The list of image IDs for the requested repository.
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"`

	// The maximum number of repository results returned by DescribeImages in paginated
	// output. When this parameter is used, DescribeImages only returns maxResults
	// results in a single page along with a nextToken response element. The remaining
	// results of the initial request can be seen by sending another DescribeImages
	// request with the returned nextToken value. This value can be between 1 and
	// 1000. If this parameter is not used, then DescribeImages returns up to 100
	// results and a nextToken value, if applicable. This option cannot be used
	// when you specify images with imageIds.
	MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"`

	// The nextToken value returned from a previous paginated DescribeImages request
	// where maxResults was used and the results exceeded the value of that parameter.
	// Pagination continues from the end of the previous results that returned the
	// nextToken value. This value is null when there are no more results to return.
	// This option cannot be used when you specify images with imageIds.
	NextToken *string `locationName:"nextToken" type:"string"`

	// The AWS account ID associated with the registry that contains the repository
	// in which to describe images. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository that contains the images to describe.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (DescribeImagesInput) GoString added in v1.4.16

func (s DescribeImagesInput) GoString() string

GoString returns the string representation

func (*DescribeImagesInput) SetFilter added in v1.5.0

SetFilter sets the Filter field's value.

func (*DescribeImagesInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*DescribeImagesInput) SetMaxResults added in v1.5.0

func (s *DescribeImagesInput) SetMaxResults(v int64) *DescribeImagesInput

SetMaxResults sets the MaxResults field's value.

func (*DescribeImagesInput) SetNextToken added in v1.5.0

func (s *DescribeImagesInput) SetNextToken(v string) *DescribeImagesInput

SetNextToken sets the NextToken field's value.

func (*DescribeImagesInput) SetRegistryId added in v1.5.0

func (s *DescribeImagesInput) SetRegistryId(v string) *DescribeImagesInput

SetRegistryId sets the RegistryId field's value.

func (*DescribeImagesInput) SetRepositoryName added in v1.5.0

func (s *DescribeImagesInput) SetRepositoryName(v string) *DescribeImagesInput

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImagesInput) String added in v1.4.16

func (s DescribeImagesInput) String() string

String returns the string representation

func (*DescribeImagesInput) Validate added in v1.4.16

func (s *DescribeImagesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeImagesOutput added in v1.4.16

type DescribeImagesOutput struct {

	// A list of ImageDetail objects that contain data about the image.
	ImageDetails []*ImageDetail `locationName:"imageDetails" type:"list"`

	// The nextToken value to include in a future DescribeImages request. When the
	// results of a DescribeImages request exceed maxResults, this value can be
	// used to retrieve the next page of results. This value is null when there
	// are no more results to return.
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (DescribeImagesOutput) GoString added in v1.4.16

func (s DescribeImagesOutput) GoString() string

GoString returns the string representation

func (*DescribeImagesOutput) SetImageDetails added in v1.5.0

func (s *DescribeImagesOutput) SetImageDetails(v []*ImageDetail) *DescribeImagesOutput

SetImageDetails sets the ImageDetails field's value.

func (*DescribeImagesOutput) SetNextToken added in v1.5.0

func (s *DescribeImagesOutput) SetNextToken(v string) *DescribeImagesOutput

SetNextToken sets the NextToken field's value.

func (DescribeImagesOutput) String added in v1.4.16

func (s DescribeImagesOutput) String() string

String returns the string representation

type DescribeRepositoriesInput

type DescribeRepositoriesInput struct {

	// The maximum number of repository results returned by DescribeRepositories
	// in paginated output. When this parameter is used, DescribeRepositories only
	// returns maxResults results in a single page along with a nextToken response
	// element. The remaining results of the initial request can be seen by sending
	// another DescribeRepositories request with the returned nextToken value. This
	// value can be between 1 and 1000. If this parameter is not used, then DescribeRepositories
	// returns up to 100 results and a nextToken value, if applicable. This option
	// cannot be used when you specify repositories with repositoryNames.
	MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"`

	// The nextToken value returned from a previous paginated DescribeRepositories
	// request where maxResults was used and the results exceeded the value of that
	// parameter. Pagination continues from the end of the previous results that
	// returned the nextToken value. This value is null when there are no more results
	// to return. This option cannot be used when you specify repositories with
	// repositoryNames.
	//
	// This token should be treated as an opaque identifier that is only used to
	// retrieve the next items in a list and not for other programmatic purposes.
	NextToken *string `locationName:"nextToken" type:"string"`

	// The AWS account ID associated with the registry that contains the repositories
	// to be described. If you do not specify a registry, the default registry is
	// assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// A list of repositories to describe. If this parameter is omitted, then all
	// repositories in a registry are described.
	RepositoryNames []*string `locationName:"repositoryNames" min:"1" type:"list"`
	// contains filtered or unexported fields
}

func (DescribeRepositoriesInput) GoString

func (s DescribeRepositoriesInput) GoString() string

GoString returns the string representation

func (*DescribeRepositoriesInput) SetMaxResults added in v1.5.0

SetMaxResults sets the MaxResults field's value.

func (*DescribeRepositoriesInput) SetNextToken added in v1.5.0

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DescribeRepositoriesInput) SetRepositoryNames added in v1.5.0

func (s *DescribeRepositoriesInput) SetRepositoryNames(v []*string) *DescribeRepositoriesInput

SetRepositoryNames sets the RepositoryNames field's value.

func (DescribeRepositoriesInput) String

func (s DescribeRepositoriesInput) String() string

String returns the string representation

func (*DescribeRepositoriesInput) Validate added in v1.1.21

func (s *DescribeRepositoriesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type DescribeRepositoriesOutput

type DescribeRepositoriesOutput struct {

	// The nextToken value to include in a future DescribeRepositories request.
	// When the results of a DescribeRepositories request exceed maxResults, this
	// value can be used to retrieve the next page of results. This value is null
	// when there are no more results to return.
	NextToken *string `locationName:"nextToken" type:"string"`

	// A list of repository objects corresponding to valid repositories.
	Repositories []*Repository `locationName:"repositories" type:"list"`
	// contains filtered or unexported fields
}

func (DescribeRepositoriesOutput) GoString

func (s DescribeRepositoriesOutput) GoString() string

GoString returns the string representation

func (*DescribeRepositoriesOutput) SetNextToken added in v1.5.0

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesOutput) SetRepositories added in v1.5.0

SetRepositories sets the Repositories field's value.

func (DescribeRepositoriesOutput) String

String returns the string representation

type ECR

type ECR struct {
	*client.Client
}

ECR provides the API operation methods for making requests to Amazon EC2 Container Registry. See this package's package overview docs for details on the service.

ECR methods are safe to use concurrently. It is not safe to modify mutate any of the struct's properties though.

func New

func New(p client.ConfigProvider, cfgs ...*aws.Config) *ECR

New creates a new instance of the ECR client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.

Example:

// Create a ECR client from just a session.
svc := ecr.New(mySession)

// Create a ECR client with additional configuration
svc := ecr.New(mySession, aws.NewConfig().WithRegion("us-west-2"))

func (*ECR) BatchCheckLayerAvailability

func (c *ECR) BatchCheckLayerAvailability(input *BatchCheckLayerAvailabilityInput) (*BatchCheckLayerAvailabilityOutput, error)

BatchCheckLayerAvailability API operation for Amazon EC2 Container Registry.

Check the availability of multiple image layers in a specified registry and repository.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation BatchCheckLayerAvailability for usage and error information.

Returned Error Codes:

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchCheckLayerAvailability

func (*ECR) BatchCheckLayerAvailabilityRequest

func (c *ECR) BatchCheckLayerAvailabilityRequest(input *BatchCheckLayerAvailabilityInput) (req *request.Request, output *BatchCheckLayerAvailabilityOutput)

BatchCheckLayerAvailabilityRequest generates a "aws/request.Request" representing the client's request for the BatchCheckLayerAvailability operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See BatchCheckLayerAvailability for more information on using the BatchCheckLayerAvailability API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the BatchCheckLayerAvailabilityRequest method.
req, resp := client.BatchCheckLayerAvailabilityRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchCheckLayerAvailability

func (*ECR) BatchCheckLayerAvailabilityWithContext added in v1.8.0

func (c *ECR) BatchCheckLayerAvailabilityWithContext(ctx aws.Context, input *BatchCheckLayerAvailabilityInput, opts ...request.Option) (*BatchCheckLayerAvailabilityOutput, error)

BatchCheckLayerAvailabilityWithContext is the same as BatchCheckLayerAvailability with the addition of the ability to pass a context and additional request options.

See BatchCheckLayerAvailability for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) BatchDeleteImage

func (c *ECR) BatchDeleteImage(input *BatchDeleteImageInput) (*BatchDeleteImageOutput, error)

BatchDeleteImage API operation for Amazon EC2 Container Registry.

Deletes a list of specified images within a specified repository. Images are specified with either imageTag or imageDigest.

You can remove a tag from an image by specifying the image's tag in your request. When you remove the last tag from an image, the image is deleted from your repository.

You can completely delete an image (and all of its tags) by specifying the image's digest in your request.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation BatchDeleteImage for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchDeleteImage

Example (Shared00)

To delete multiple images

This example deletes images with the tags precise and trusty in a repository called ubuntu in the default registry for an account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.BatchDeleteImageInput{
		ImageIds: []*ecr.ImageIdentifier{
			{
				ImageTag: aws.String("precise"),
			},
		},
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.BatchDeleteImage(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) BatchDeleteImageRequest

func (c *ECR) BatchDeleteImageRequest(input *BatchDeleteImageInput) (req *request.Request, output *BatchDeleteImageOutput)

BatchDeleteImageRequest generates a "aws/request.Request" representing the client's request for the BatchDeleteImage operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See BatchDeleteImage for more information on using the BatchDeleteImage API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the BatchDeleteImageRequest method.
req, resp := client.BatchDeleteImageRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchDeleteImage

func (*ECR) BatchDeleteImageWithContext added in v1.8.0

func (c *ECR) BatchDeleteImageWithContext(ctx aws.Context, input *BatchDeleteImageInput, opts ...request.Option) (*BatchDeleteImageOutput, error)

BatchDeleteImageWithContext is the same as BatchDeleteImage with the addition of the ability to pass a context and additional request options.

See BatchDeleteImage for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) BatchGetImage

func (c *ECR) BatchGetImage(input *BatchGetImageInput) (*BatchGetImageOutput, error)

BatchGetImage API operation for Amazon EC2 Container Registry.

Gets detailed information for specified images within a specified repository. Images are specified with either imageTag or imageDigest.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation BatchGetImage for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchGetImage

Example (Shared00)

To obtain multiple images in a single request

This example obtains information for an image with a specified image digest ID from the repository named ubuntu in the current account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.BatchGetImageInput{
		ImageIds: []*ecr.ImageIdentifier{
			{
				ImageTag: aws.String("precise"),
			},
		},
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.BatchGetImage(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) BatchGetImageRequest

func (c *ECR) BatchGetImageRequest(input *BatchGetImageInput) (req *request.Request, output *BatchGetImageOutput)

BatchGetImageRequest generates a "aws/request.Request" representing the client's request for the BatchGetImage operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See BatchGetImage for more information on using the BatchGetImage API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the BatchGetImageRequest method.
req, resp := client.BatchGetImageRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchGetImage

func (*ECR) BatchGetImageWithContext added in v1.8.0

func (c *ECR) BatchGetImageWithContext(ctx aws.Context, input *BatchGetImageInput, opts ...request.Option) (*BatchGetImageOutput, error)

BatchGetImageWithContext is the same as BatchGetImage with the addition of the ability to pass a context and additional request options.

See BatchGetImage for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) CompleteLayerUpload

func (c *ECR) CompleteLayerUpload(input *CompleteLayerUploadInput) (*CompleteLayerUploadOutput, error)

CompleteLayerUpload API operation for Amazon EC2 Container Registry.

Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and upload ID. You can optionally provide a sha256 digest of the image layer for data validation purposes.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation CompleteLayerUpload for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeUploadNotFoundException "UploadNotFoundException" The upload could not be found, or the specified upload id is not valid for this repository.

  • ErrCodeInvalidLayerException "InvalidLayerException" The layer digest calculation performed by Amazon ECR upon receipt of the image layer does not match the digest specified.

  • ErrCodeLayerPartTooSmallException "LayerPartTooSmallException" Layer parts must be at least 5 MiB in size.

  • ErrCodeLayerAlreadyExistsException "LayerAlreadyExistsException" The image layer already exists in the associated repository.

  • ErrCodeEmptyUploadException "EmptyUploadException" The specified layer upload does not contain any layer parts.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CompleteLayerUpload

func (*ECR) CompleteLayerUploadRequest

func (c *ECR) CompleteLayerUploadRequest(input *CompleteLayerUploadInput) (req *request.Request, output *CompleteLayerUploadOutput)

CompleteLayerUploadRequest generates a "aws/request.Request" representing the client's request for the CompleteLayerUpload operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CompleteLayerUpload for more information on using the CompleteLayerUpload API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CompleteLayerUploadRequest method.
req, resp := client.CompleteLayerUploadRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CompleteLayerUpload

func (*ECR) CompleteLayerUploadWithContext added in v1.8.0

func (c *ECR) CompleteLayerUploadWithContext(ctx aws.Context, input *CompleteLayerUploadInput, opts ...request.Option) (*CompleteLayerUploadOutput, error)

CompleteLayerUploadWithContext is the same as CompleteLayerUpload with the addition of the ability to pass a context and additional request options.

See CompleteLayerUpload for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) CreateRepository

func (c *ECR) CreateRepository(input *CreateRepositoryInput) (*CreateRepositoryOutput, error)

CreateRepository API operation for Amazon EC2 Container Registry.

Creates an image repository.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation CreateRepository for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeInvalidTagParameterException "InvalidTagParameterException" An invalid parameter has been specified. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

  • ErrCodeTooManyTagsException "TooManyTagsException" The list of tags on the repository is over the limit. The maximum number of tags that can be applied to a repository is 50.

  • ErrCodeRepositoryAlreadyExistsException "RepositoryAlreadyExistsException" The specified repository already exists in the specified registry.

  • ErrCodeLimitExceededException "LimitExceededException" The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR Default Service Limits (https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon Elastic Container Registry User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepository

Example (Shared00)

To create a new repository

This example creates a repository called nginx-web-app inside the project-a namespace in the default registry for an account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.CreateRepositoryInput{
		RepositoryName: aws.String("project-a/nginx-web-app"),
	}

	result, err := svc.CreateRepository(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeInvalidTagParameterException:
				fmt.Println(ecr.ErrCodeInvalidTagParameterException, aerr.Error())
			case ecr.ErrCodeTooManyTagsException:
				fmt.Println(ecr.ErrCodeTooManyTagsException, aerr.Error())
			case ecr.ErrCodeRepositoryAlreadyExistsException:
				fmt.Println(ecr.ErrCodeRepositoryAlreadyExistsException, aerr.Error())
			case ecr.ErrCodeLimitExceededException:
				fmt.Println(ecr.ErrCodeLimitExceededException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) CreateRepositoryRequest

func (c *ECR) CreateRepositoryRequest(input *CreateRepositoryInput) (req *request.Request, output *CreateRepositoryOutput)

CreateRepositoryRequest generates a "aws/request.Request" representing the client's request for the CreateRepository operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See CreateRepository for more information on using the CreateRepository API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the CreateRepositoryRequest method.
req, resp := client.CreateRepositoryRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepository

func (*ECR) CreateRepositoryWithContext added in v1.8.0

func (c *ECR) CreateRepositoryWithContext(ctx aws.Context, input *CreateRepositoryInput, opts ...request.Option) (*CreateRepositoryOutput, error)

CreateRepositoryWithContext is the same as CreateRepository with the addition of the ability to pass a context and additional request options.

See CreateRepository for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DeleteLifecyclePolicy added in v1.12.9

func (c *ECR) DeleteLifecyclePolicy(input *DeleteLifecyclePolicyInput) (*DeleteLifecyclePolicyOutput, error)

DeleteLifecyclePolicy API operation for Amazon EC2 Container Registry.

Deletes the specified lifecycle policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation DeleteLifecyclePolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeLifecyclePolicyNotFoundException "LifecyclePolicyNotFoundException" The lifecycle policy could not be found, and no policy is set to the repository.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteLifecyclePolicy

func (*ECR) DeleteLifecyclePolicyRequest added in v1.12.9

func (c *ECR) DeleteLifecyclePolicyRequest(input *DeleteLifecyclePolicyInput) (req *request.Request, output *DeleteLifecyclePolicyOutput)

DeleteLifecyclePolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteLifecyclePolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteLifecyclePolicy for more information on using the DeleteLifecyclePolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteLifecyclePolicyRequest method.
req, resp := client.DeleteLifecyclePolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteLifecyclePolicy

func (*ECR) DeleteLifecyclePolicyWithContext added in v1.12.9

func (c *ECR) DeleteLifecyclePolicyWithContext(ctx aws.Context, input *DeleteLifecyclePolicyInput, opts ...request.Option) (*DeleteLifecyclePolicyOutput, error)

DeleteLifecyclePolicyWithContext is the same as DeleteLifecyclePolicy with the addition of the ability to pass a context and additional request options.

See DeleteLifecyclePolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DeleteRepository

func (c *ECR) DeleteRepository(input *DeleteRepositoryInput) (*DeleteRepositoryOutput, error)

DeleteRepository API operation for Amazon EC2 Container Registry.

Deletes an existing image repository. If a repository contains images, you must use the force option to delete it.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation DeleteRepository for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeRepositoryNotEmptyException "RepositoryNotEmptyException" The specified repository contains images. To delete a repository that contains images, you must force the deletion with the force parameter.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepository

Example (Shared00)

To force delete a repository

This example force deletes a repository named ubuntu in the default registry for an account. The force parameter is required if the repository contains images.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.DeleteRepositoryInput{
		Force:          aws.Bool(true),
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.DeleteRepository(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			case ecr.ErrCodeRepositoryNotEmptyException:
				fmt.Println(ecr.ErrCodeRepositoryNotEmptyException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) DeleteRepositoryPolicy

func (c *ECR) DeleteRepositoryPolicy(input *DeleteRepositoryPolicyInput) (*DeleteRepositoryPolicyOutput, error)

DeleteRepositoryPolicy API operation for Amazon EC2 Container Registry.

Deletes the repository policy from a specified repository.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation DeleteRepositoryPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeRepositoryPolicyNotFoundException "RepositoryPolicyNotFoundException" The specified repository and registry combination does not have an associated repository policy.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryPolicy

Example (Shared00)

To delete the policy associated with a repository

This example deletes the policy associated with the repository named ubuntu in the current account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.DeleteRepositoryPolicyInput{
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.DeleteRepositoryPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			case ecr.ErrCodeRepositoryPolicyNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryPolicyNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) DeleteRepositoryPolicyRequest

func (c *ECR) DeleteRepositoryPolicyRequest(input *DeleteRepositoryPolicyInput) (req *request.Request, output *DeleteRepositoryPolicyOutput)

DeleteRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteRepositoryPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteRepositoryPolicy for more information on using the DeleteRepositoryPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteRepositoryPolicyRequest method.
req, resp := client.DeleteRepositoryPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryPolicy

func (*ECR) DeleteRepositoryPolicyWithContext added in v1.8.0

func (c *ECR) DeleteRepositoryPolicyWithContext(ctx aws.Context, input *DeleteRepositoryPolicyInput, opts ...request.Option) (*DeleteRepositoryPolicyOutput, error)

DeleteRepositoryPolicyWithContext is the same as DeleteRepositoryPolicy with the addition of the ability to pass a context and additional request options.

See DeleteRepositoryPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DeleteRepositoryRequest

func (c *ECR) DeleteRepositoryRequest(input *DeleteRepositoryInput) (req *request.Request, output *DeleteRepositoryOutput)

DeleteRepositoryRequest generates a "aws/request.Request" representing the client's request for the DeleteRepository operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DeleteRepository for more information on using the DeleteRepository API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DeleteRepositoryRequest method.
req, resp := client.DeleteRepositoryRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepository

func (*ECR) DeleteRepositoryWithContext added in v1.8.0

func (c *ECR) DeleteRepositoryWithContext(ctx aws.Context, input *DeleteRepositoryInput, opts ...request.Option) (*DeleteRepositoryOutput, error)

DeleteRepositoryWithContext is the same as DeleteRepository with the addition of the ability to pass a context and additional request options.

See DeleteRepository for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DescribeImages added in v1.4.16

func (c *ECR) DescribeImages(input *DescribeImagesInput) (*DescribeImagesOutput, error)

DescribeImages API operation for Amazon EC2 Container Registry.

Returns metadata about the images in a repository, including image size, image tags, and creation date.

Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker registry. The output of the docker images command shows the uncompressed image size, so it may return a larger image size than the image sizes returned by DescribeImages.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation DescribeImages for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeImageNotFoundException "ImageNotFoundException" The image requested does not exist in the specified repository.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeImages

func (*ECR) DescribeImagesPages added in v1.5.0

func (c *ECR) DescribeImagesPages(input *DescribeImagesInput, fn func(*DescribeImagesOutput, bool) bool) error

DescribeImagesPages iterates over the pages of a DescribeImages operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeImages method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeImages operation.
pageNum := 0
err := client.DescribeImagesPages(params,
    func(page *ecr.DescribeImagesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) DescribeImagesPagesWithContext added in v1.8.0

func (c *ECR) DescribeImagesPagesWithContext(ctx aws.Context, input *DescribeImagesInput, fn func(*DescribeImagesOutput, bool) bool, opts ...request.Option) error

DescribeImagesPagesWithContext same as DescribeImagesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DescribeImagesRequest added in v1.4.16

func (c *ECR) DescribeImagesRequest(input *DescribeImagesInput) (req *request.Request, output *DescribeImagesOutput)

DescribeImagesRequest generates a "aws/request.Request" representing the client's request for the DescribeImages operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeImages for more information on using the DescribeImages API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeImagesRequest method.
req, resp := client.DescribeImagesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeImages

func (*ECR) DescribeImagesWithContext added in v1.8.0

func (c *ECR) DescribeImagesWithContext(ctx aws.Context, input *DescribeImagesInput, opts ...request.Option) (*DescribeImagesOutput, error)

DescribeImagesWithContext is the same as DescribeImages with the addition of the ability to pass a context and additional request options.

See DescribeImages for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DescribeRepositories

func (c *ECR) DescribeRepositories(input *DescribeRepositoriesInput) (*DescribeRepositoriesOutput, error)

DescribeRepositories API operation for Amazon EC2 Container Registry.

Describes image repositories in a registry.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation DescribeRepositories for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeRepositories

Example (Shared00)

To describe all repositories in the current account

The following example obtains a list and description of all repositories in the default registry to which the current user has access.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.DescribeRepositoriesInput{}

	result, err := svc.DescribeRepositories(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) DescribeRepositoriesPages added in v1.5.0

func (c *ECR) DescribeRepositoriesPages(input *DescribeRepositoriesInput, fn func(*DescribeRepositoriesOutput, bool) bool) error

DescribeRepositoriesPages iterates over the pages of a DescribeRepositories operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See DescribeRepositories method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a DescribeRepositories operation.
pageNum := 0
err := client.DescribeRepositoriesPages(params,
    func(page *ecr.DescribeRepositoriesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) DescribeRepositoriesPagesWithContext added in v1.8.0

func (c *ECR) DescribeRepositoriesPagesWithContext(ctx aws.Context, input *DescribeRepositoriesInput, fn func(*DescribeRepositoriesOutput, bool) bool, opts ...request.Option) error

DescribeRepositoriesPagesWithContext same as DescribeRepositoriesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) DescribeRepositoriesRequest

func (c *ECR) DescribeRepositoriesRequest(input *DescribeRepositoriesInput) (req *request.Request, output *DescribeRepositoriesOutput)

DescribeRepositoriesRequest generates a "aws/request.Request" representing the client's request for the DescribeRepositories operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See DescribeRepositories for more information on using the DescribeRepositories API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the DescribeRepositoriesRequest method.
req, resp := client.DescribeRepositoriesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeRepositories

func (*ECR) DescribeRepositoriesWithContext added in v1.8.0

func (c *ECR) DescribeRepositoriesWithContext(ctx aws.Context, input *DescribeRepositoriesInput, opts ...request.Option) (*DescribeRepositoriesOutput, error)

DescribeRepositoriesWithContext is the same as DescribeRepositories with the addition of the ability to pass a context and additional request options.

See DescribeRepositories for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) GetAuthorizationToken

func (c *ECR) GetAuthorizationToken(input *GetAuthorizationTokenInput) (*GetAuthorizationTokenOutput, error)

GetAuthorizationToken API operation for Amazon EC2 Container Registry.

Retrieves a token that is valid for a specified registry for 12 hours. This command allows you to use the docker CLI to push and pull images with Amazon ECR. If you do not specify a registry, the default registry is assumed.

The authorizationToken returned for each registry specified is a base64 encoded string that can be decoded and used in a docker login command to authenticate to a registry. The AWS CLI offers an aws ecr get-login command that simplifies the login process.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation GetAuthorizationToken for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAuthorizationToken

Example (Shared00)

To obtain an authorization token

This example gets an authorization token for your default registry.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.GetAuthorizationTokenInput{}

	result, err := svc.GetAuthorizationToken(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) GetAuthorizationTokenRequest

func (c *ECR) GetAuthorizationTokenRequest(input *GetAuthorizationTokenInput) (req *request.Request, output *GetAuthorizationTokenOutput)

GetAuthorizationTokenRequest generates a "aws/request.Request" representing the client's request for the GetAuthorizationToken operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetAuthorizationToken for more information on using the GetAuthorizationToken API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetAuthorizationTokenRequest method.
req, resp := client.GetAuthorizationTokenRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAuthorizationToken

func (*ECR) GetAuthorizationTokenWithContext added in v1.8.0

func (c *ECR) GetAuthorizationTokenWithContext(ctx aws.Context, input *GetAuthorizationTokenInput, opts ...request.Option) (*GetAuthorizationTokenOutput, error)

GetAuthorizationTokenWithContext is the same as GetAuthorizationToken with the addition of the ability to pass a context and additional request options.

See GetAuthorizationToken for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) GetDownloadUrlForLayer

func (c *ECR) GetDownloadUrlForLayer(input *GetDownloadUrlForLayerInput) (*GetDownloadUrlForLayerOutput, error)

GetDownloadUrlForLayer API operation for Amazon EC2 Container Registry.

Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image layers that are referenced in an image.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation GetDownloadUrlForLayer for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeLayersNotFoundException "LayersNotFoundException" The specified layers could not be found, or the specified layer is not valid for this repository.

  • ErrCodeLayerInaccessibleException "LayerInaccessibleException" The specified layer is not available because it is not associated with an image. Unassociated image layers may be cleaned up at any time.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetDownloadUrlForLayer

func (*ECR) GetDownloadUrlForLayerRequest

func (c *ECR) GetDownloadUrlForLayerRequest(input *GetDownloadUrlForLayerInput) (req *request.Request, output *GetDownloadUrlForLayerOutput)

GetDownloadUrlForLayerRequest generates a "aws/request.Request" representing the client's request for the GetDownloadUrlForLayer operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetDownloadUrlForLayer for more information on using the GetDownloadUrlForLayer API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetDownloadUrlForLayerRequest method.
req, resp := client.GetDownloadUrlForLayerRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetDownloadUrlForLayer

func (*ECR) GetDownloadUrlForLayerWithContext added in v1.8.0

func (c *ECR) GetDownloadUrlForLayerWithContext(ctx aws.Context, input *GetDownloadUrlForLayerInput, opts ...request.Option) (*GetDownloadUrlForLayerOutput, error)

GetDownloadUrlForLayerWithContext is the same as GetDownloadUrlForLayer with the addition of the ability to pass a context and additional request options.

See GetDownloadUrlForLayer for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) GetLifecyclePolicy added in v1.12.9

func (c *ECR) GetLifecyclePolicy(input *GetLifecyclePolicyInput) (*GetLifecyclePolicyOutput, error)

GetLifecyclePolicy API operation for Amazon EC2 Container Registry.

Retrieves the specified lifecycle policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation GetLifecyclePolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeLifecyclePolicyNotFoundException "LifecyclePolicyNotFoundException" The lifecycle policy could not be found, and no policy is set to the repository.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetLifecyclePolicy

func (*ECR) GetLifecyclePolicyPreview added in v1.12.9

func (c *ECR) GetLifecyclePolicyPreview(input *GetLifecyclePolicyPreviewInput) (*GetLifecyclePolicyPreviewOutput, error)

GetLifecyclePolicyPreview API operation for Amazon EC2 Container Registry.

Retrieves the results of the specified lifecycle policy preview request.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation GetLifecyclePolicyPreview for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeLifecyclePolicyPreviewNotFoundException "LifecyclePolicyPreviewNotFoundException" There is no dry run for this repository.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetLifecyclePolicyPreview

func (*ECR) GetLifecyclePolicyPreviewRequest added in v1.12.9

func (c *ECR) GetLifecyclePolicyPreviewRequest(input *GetLifecyclePolicyPreviewInput) (req *request.Request, output *GetLifecyclePolicyPreviewOutput)

GetLifecyclePolicyPreviewRequest generates a "aws/request.Request" representing the client's request for the GetLifecyclePolicyPreview operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetLifecyclePolicyPreview for more information on using the GetLifecyclePolicyPreview API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetLifecyclePolicyPreviewRequest method.
req, resp := client.GetLifecyclePolicyPreviewRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetLifecyclePolicyPreview

func (*ECR) GetLifecyclePolicyPreviewWithContext added in v1.12.9

func (c *ECR) GetLifecyclePolicyPreviewWithContext(ctx aws.Context, input *GetLifecyclePolicyPreviewInput, opts ...request.Option) (*GetLifecyclePolicyPreviewOutput, error)

GetLifecyclePolicyPreviewWithContext is the same as GetLifecyclePolicyPreview with the addition of the ability to pass a context and additional request options.

See GetLifecyclePolicyPreview for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) GetLifecyclePolicyRequest added in v1.12.9

func (c *ECR) GetLifecyclePolicyRequest(input *GetLifecyclePolicyInput) (req *request.Request, output *GetLifecyclePolicyOutput)

GetLifecyclePolicyRequest generates a "aws/request.Request" representing the client's request for the GetLifecyclePolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetLifecyclePolicy for more information on using the GetLifecyclePolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetLifecyclePolicyRequest method.
req, resp := client.GetLifecyclePolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetLifecyclePolicy

func (*ECR) GetLifecyclePolicyWithContext added in v1.12.9

func (c *ECR) GetLifecyclePolicyWithContext(ctx aws.Context, input *GetLifecyclePolicyInput, opts ...request.Option) (*GetLifecyclePolicyOutput, error)

GetLifecyclePolicyWithContext is the same as GetLifecyclePolicy with the addition of the ability to pass a context and additional request options.

See GetLifecyclePolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) GetRepositoryPolicy

func (c *ECR) GetRepositoryPolicy(input *GetRepositoryPolicyInput) (*GetRepositoryPolicyOutput, error)

GetRepositoryPolicy API operation for Amazon EC2 Container Registry.

Retrieves the repository policy for a specified repository.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation GetRepositoryPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeRepositoryPolicyNotFoundException "RepositoryPolicyNotFoundException" The specified repository and registry combination does not have an associated repository policy.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetRepositoryPolicy

Example (Shared00)

To get the current policy for a repository

This example obtains the repository policy for the repository named ubuntu.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.GetRepositoryPolicyInput{
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.GetRepositoryPolicy(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			case ecr.ErrCodeRepositoryPolicyNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryPolicyNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) GetRepositoryPolicyRequest

func (c *ECR) GetRepositoryPolicyRequest(input *GetRepositoryPolicyInput) (req *request.Request, output *GetRepositoryPolicyOutput)

GetRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the GetRepositoryPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See GetRepositoryPolicy for more information on using the GetRepositoryPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the GetRepositoryPolicyRequest method.
req, resp := client.GetRepositoryPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetRepositoryPolicy

func (*ECR) GetRepositoryPolicyWithContext added in v1.8.0

func (c *ECR) GetRepositoryPolicyWithContext(ctx aws.Context, input *GetRepositoryPolicyInput, opts ...request.Option) (*GetRepositoryPolicyOutput, error)

GetRepositoryPolicyWithContext is the same as GetRepositoryPolicy with the addition of the ability to pass a context and additional request options.

See GetRepositoryPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) InitiateLayerUpload

func (c *ECR) InitiateLayerUpload(input *InitiateLayerUploadInput) (*InitiateLayerUploadOutput, error)

InitiateLayerUpload API operation for Amazon EC2 Container Registry.

Notify Amazon ECR that you intend to upload an image layer.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation InitiateLayerUpload for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/InitiateLayerUpload

func (*ECR) InitiateLayerUploadRequest

func (c *ECR) InitiateLayerUploadRequest(input *InitiateLayerUploadInput) (req *request.Request, output *InitiateLayerUploadOutput)

InitiateLayerUploadRequest generates a "aws/request.Request" representing the client's request for the InitiateLayerUpload operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See InitiateLayerUpload for more information on using the InitiateLayerUpload API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the InitiateLayerUploadRequest method.
req, resp := client.InitiateLayerUploadRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/InitiateLayerUpload

func (*ECR) InitiateLayerUploadWithContext added in v1.8.0

func (c *ECR) InitiateLayerUploadWithContext(ctx aws.Context, input *InitiateLayerUploadInput, opts ...request.Option) (*InitiateLayerUploadOutput, error)

InitiateLayerUploadWithContext is the same as InitiateLayerUpload with the addition of the ability to pass a context and additional request options.

See InitiateLayerUpload for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) ListImages

func (c *ECR) ListImages(input *ListImagesInput) (*ListImagesOutput, error)

ListImages API operation for Amazon EC2 Container Registry.

Lists all the image IDs for a given repository.

You can filter images based on whether or not they are tagged by setting the tagStatus parameter to TAGGED or UNTAGGED. For example, you can filter your results to return only UNTAGGED images and then pipe that result to a BatchDeleteImage operation to delete them. Or, you can filter your results to return only TAGGED images to list all of the tags in your repository.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation ListImages for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListImages

Example (Shared00)

To list all images in a repository

This example lists all of the images in the repository named ubuntu in the default registry in the current account.

package main

import (
	"fmt"

	"github.com/aws/aws-sdk-go/aws"
	"github.com/aws/aws-sdk-go/aws/awserr"
	"github.com/aws/aws-sdk-go/aws/session"
	"github.com/aws/aws-sdk-go/service/ecr"
)

func main() {
	svc := ecr.New(session.New())
	input := &ecr.ListImagesInput{
		RepositoryName: aws.String("ubuntu"),
	}

	result, err := svc.ListImages(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			default:
				fmt.Println(aerr.Error())
			}
		} else {
			// Print the error, cast err to awserr.Error to get the Code and
			// Message from an error.
			fmt.Println(err.Error())
		}
		return
	}

	fmt.Println(result)
}
Output:

func (*ECR) ListImagesPages added in v1.5.0

func (c *ECR) ListImagesPages(input *ListImagesInput, fn func(*ListImagesOutput, bool) bool) error

ListImagesPages iterates over the pages of a ListImages operation, calling the "fn" function with the response data for each page. To stop iterating, return false from the fn function.

See ListImages method for more information on how to use this operation.

Note: This operation can generate multiple requests to a service.

// Example iterating over at most 3 pages of a ListImages operation.
pageNum := 0
err := client.ListImagesPages(params,
    func(page *ecr.ListImagesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) ListImagesPagesWithContext added in v1.8.0

func (c *ECR) ListImagesPagesWithContext(ctx aws.Context, input *ListImagesInput, fn func(*ListImagesOutput, bool) bool, opts ...request.Option) error

ListImagesPagesWithContext same as ListImagesPages except it takes a Context and allows setting request options on the pages.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) ListImagesRequest

func (c *ECR) ListImagesRequest(input *ListImagesInput) (req *request.Request, output *ListImagesOutput)

ListImagesRequest generates a "aws/request.Request" representing the client's request for the ListImages operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListImages for more information on using the ListImages API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListImagesRequest method.
req, resp := client.ListImagesRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListImages

func (*ECR) ListImagesWithContext added in v1.8.0

func (c *ECR) ListImagesWithContext(ctx aws.Context, input *ListImagesInput, opts ...request.Option) (*ListImagesOutput, error)

ListImagesWithContext is the same as ListImages with the addition of the ability to pass a context and additional request options.

See ListImages for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) ListTagsForResource added in v1.99.0

func (c *ECR) ListTagsForResource(input *ListTagsForResourceInput) (*ListTagsForResourceOutput, error)

ListTagsForResource API operation for Amazon EC2 Container Registry.

List the tags for an Amazon ECR resource.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation ListTagsForResource for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListTagsForResource

func (*ECR) ListTagsForResourceRequest added in v1.99.0

func (c *ECR) ListTagsForResourceRequest(input *ListTagsForResourceInput) (req *request.Request, output *ListTagsForResourceOutput)

ListTagsForResourceRequest generates a "aws/request.Request" representing the client's request for the ListTagsForResource operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See ListTagsForResource for more information on using the ListTagsForResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the ListTagsForResourceRequest method.
req, resp := client.ListTagsForResourceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListTagsForResource

func (*ECR) ListTagsForResourceWithContext added in v1.99.0

func (c *ECR) ListTagsForResourceWithContext(ctx aws.Context, input *ListTagsForResourceInput, opts ...request.Option) (*ListTagsForResourceOutput, error)

ListTagsForResourceWithContext is the same as ListTagsForResource with the addition of the ability to pass a context and additional request options.

See ListTagsForResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) PutImage

func (c *ECR) PutImage(input *PutImageInput) (*PutImageOutput, error)

PutImage API operation for Amazon EC2 Container Registry.

Creates or updates the image manifest and tags associated with an image.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation PutImage for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeImageAlreadyExistsException "ImageAlreadyExistsException" The specified image has already been pushed, and there were no changes to the manifest or image tag after the last push.

  • ErrCodeLayersNotFoundException "LayersNotFoundException" The specified layers could not be found, or the specified layer is not valid for this repository.

  • ErrCodeLimitExceededException "LimitExceededException" The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR Default Service Limits (https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon Elastic Container Registry User Guide.

  • ErrCodeImageTagAlreadyExistsException "ImageTagAlreadyExistsException" The specified image is tagged with a tag that already exists. The repository is configured for tag immutability.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImage

func (*ECR) PutImageRequest

func (c *ECR) PutImageRequest(input *PutImageInput) (req *request.Request, output *PutImageOutput)

PutImageRequest generates a "aws/request.Request" representing the client's request for the PutImage operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutImage for more information on using the PutImage API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutImageRequest method.
req, resp := client.PutImageRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImage

func (*ECR) PutImageTagMutability added in v1.99.0

func (c *ECR) PutImageTagMutability(input *PutImageTagMutabilityInput) (*PutImageTagMutabilityOutput, error)

PutImageTagMutability API operation for Amazon EC2 Container Registry.

Updates the image tag mutability settings for a repository.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation PutImageTagMutability for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageTagMutability

func (*ECR) PutImageTagMutabilityRequest added in v1.99.0

func (c *ECR) PutImageTagMutabilityRequest(input *PutImageTagMutabilityInput) (req *request.Request, output *PutImageTagMutabilityOutput)

PutImageTagMutabilityRequest generates a "aws/request.Request" representing the client's request for the PutImageTagMutability operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutImageTagMutability for more information on using the PutImageTagMutability API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutImageTagMutabilityRequest method.
req, resp := client.PutImageTagMutabilityRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageTagMutability

func (*ECR) PutImageTagMutabilityWithContext added in v1.99.0

func (c *ECR) PutImageTagMutabilityWithContext(ctx aws.Context, input *PutImageTagMutabilityInput, opts ...request.Option) (*PutImageTagMutabilityOutput, error)

PutImageTagMutabilityWithContext is the same as PutImageTagMutability with the addition of the ability to pass a context and additional request options.

See PutImageTagMutability for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) PutImageWithContext added in v1.8.0

func (c *ECR) PutImageWithContext(ctx aws.Context, input *PutImageInput, opts ...request.Option) (*PutImageOutput, error)

PutImageWithContext is the same as PutImage with the addition of the ability to pass a context and additional request options.

See PutImage for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) PutLifecyclePolicy added in v1.12.9

func (c *ECR) PutLifecyclePolicy(input *PutLifecyclePolicyInput) (*PutLifecyclePolicyOutput, error)

PutLifecyclePolicy API operation for Amazon EC2 Container Registry.

Creates or updates a lifecycle policy. For information about lifecycle policy syntax, see Lifecycle Policy Template (https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html).

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation PutLifecyclePolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutLifecyclePolicy

func (*ECR) PutLifecyclePolicyRequest added in v1.12.9

func (c *ECR) PutLifecyclePolicyRequest(input *PutLifecyclePolicyInput) (req *request.Request, output *PutLifecyclePolicyOutput)

PutLifecyclePolicyRequest generates a "aws/request.Request" representing the client's request for the PutLifecyclePolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See PutLifecyclePolicy for more information on using the PutLifecyclePolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the PutLifecyclePolicyRequest method.
req, resp := client.PutLifecyclePolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutLifecyclePolicy

func (*ECR) PutLifecyclePolicyWithContext added in v1.12.9

func (c *ECR) PutLifecyclePolicyWithContext(ctx aws.Context, input *PutLifecyclePolicyInput, opts ...request.Option) (*PutLifecyclePolicyOutput, error)

PutLifecyclePolicyWithContext is the same as PutLifecyclePolicy with the addition of the ability to pass a context and additional request options.

See PutLifecyclePolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) SetRepositoryPolicy

func (c *ECR) SetRepositoryPolicy(input *SetRepositoryPolicyInput) (*SetRepositoryPolicyOutput, error)

SetRepositoryPolicy API operation for Amazon EC2 Container Registry.

Applies a repository policy on a specified repository to control access permissions. For more information, see Amazon ECR Repository Policies (https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicies.html) in the Amazon Elastic Container Registry User Guide.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation SetRepositoryPolicy for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/SetRepositoryPolicy

func (*ECR) SetRepositoryPolicyRequest

func (c *ECR) SetRepositoryPolicyRequest(input *SetRepositoryPolicyInput) (req *request.Request, output *SetRepositoryPolicyOutput)

SetRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the SetRepositoryPolicy operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See SetRepositoryPolicy for more information on using the SetRepositoryPolicy API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the SetRepositoryPolicyRequest method.
req, resp := client.SetRepositoryPolicyRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/SetRepositoryPolicy

func (*ECR) SetRepositoryPolicyWithContext added in v1.8.0

func (c *ECR) SetRepositoryPolicyWithContext(ctx aws.Context, input *SetRepositoryPolicyInput, opts ...request.Option) (*SetRepositoryPolicyOutput, error)

SetRepositoryPolicyWithContext is the same as SetRepositoryPolicy with the addition of the ability to pass a context and additional request options.

See SetRepositoryPolicy for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) StartLifecyclePolicyPreview added in v1.12.9

func (c *ECR) StartLifecyclePolicyPreview(input *StartLifecyclePolicyPreviewInput) (*StartLifecyclePolicyPreviewOutput, error)

StartLifecyclePolicyPreview API operation for Amazon EC2 Container Registry.

Starts a preview of the specified lifecycle policy. This allows you to see the results before creating the lifecycle policy.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation StartLifecyclePolicyPreview for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeLifecyclePolicyNotFoundException "LifecyclePolicyNotFoundException" The lifecycle policy could not be found, and no policy is set to the repository.

  • ErrCodeLifecyclePolicyPreviewInProgressException "LifecyclePolicyPreviewInProgressException" The previous lifecycle policy preview request has not completed. Please try again later.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/StartLifecyclePolicyPreview

func (*ECR) StartLifecyclePolicyPreviewRequest added in v1.12.9

func (c *ECR) StartLifecyclePolicyPreviewRequest(input *StartLifecyclePolicyPreviewInput) (req *request.Request, output *StartLifecyclePolicyPreviewOutput)

StartLifecyclePolicyPreviewRequest generates a "aws/request.Request" representing the client's request for the StartLifecyclePolicyPreview operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See StartLifecyclePolicyPreview for more information on using the StartLifecyclePolicyPreview API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the StartLifecyclePolicyPreviewRequest method.
req, resp := client.StartLifecyclePolicyPreviewRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/StartLifecyclePolicyPreview

func (*ECR) StartLifecyclePolicyPreviewWithContext added in v1.12.9

func (c *ECR) StartLifecyclePolicyPreviewWithContext(ctx aws.Context, input *StartLifecyclePolicyPreviewInput, opts ...request.Option) (*StartLifecyclePolicyPreviewOutput, error)

StartLifecyclePolicyPreviewWithContext is the same as StartLifecyclePolicyPreview with the addition of the ability to pass a context and additional request options.

See StartLifecyclePolicyPreview for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) TagResource added in v1.99.0

func (c *ECR) TagResource(input *TagResourceInput) (*TagResourceOutput, error)

TagResource API operation for Amazon EC2 Container Registry.

Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if they are not specified in the request parameters.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation TagResource for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeInvalidTagParameterException "InvalidTagParameterException" An invalid parameter has been specified. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

  • ErrCodeTooManyTagsException "TooManyTagsException" The list of tags on the repository is over the limit. The maximum number of tags that can be applied to a repository is 50.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/TagResource

func (*ECR) TagResourceRequest added in v1.99.0

func (c *ECR) TagResourceRequest(input *TagResourceInput) (req *request.Request, output *TagResourceOutput)

TagResourceRequest generates a "aws/request.Request" representing the client's request for the TagResource operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See TagResource for more information on using the TagResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the TagResourceRequest method.
req, resp := client.TagResourceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/TagResource

func (*ECR) TagResourceWithContext added in v1.99.0

func (c *ECR) TagResourceWithContext(ctx aws.Context, input *TagResourceInput, opts ...request.Option) (*TagResourceOutput, error)

TagResourceWithContext is the same as TagResource with the addition of the ability to pass a context and additional request options.

See TagResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) UntagResource added in v1.99.0

func (c *ECR) UntagResource(input *UntagResourceInput) (*UntagResourceOutput, error)

UntagResource API operation for Amazon EC2 Container Registry.

Deletes specified tags from a resource.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation UntagResource for usage and error information.

Returned Error Codes:

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeInvalidTagParameterException "InvalidTagParameterException" An invalid parameter has been specified. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

  • ErrCodeTooManyTagsException "TooManyTagsException" The list of tags on the repository is over the limit. The maximum number of tags that can be applied to a repository is 50.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UntagResource

func (*ECR) UntagResourceRequest added in v1.99.0

func (c *ECR) UntagResourceRequest(input *UntagResourceInput) (req *request.Request, output *UntagResourceOutput)

UntagResourceRequest generates a "aws/request.Request" representing the client's request for the UntagResource operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UntagResource for more information on using the UntagResource API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UntagResourceRequest method.
req, resp := client.UntagResourceRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UntagResource

func (*ECR) UntagResourceWithContext added in v1.99.0

func (c *ECR) UntagResourceWithContext(ctx aws.Context, input *UntagResourceInput, opts ...request.Option) (*UntagResourceOutput, error)

UntagResourceWithContext is the same as UntagResource with the addition of the ability to pass a context and additional request options.

See UntagResource for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

func (*ECR) UploadLayerPart

func (c *ECR) UploadLayerPart(input *UploadLayerPartInput) (*UploadLayerPartOutput, error)

UploadLayerPart API operation for Amazon EC2 Container Registry.

Uploads an image layer part to Amazon ECR.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.

Returns awserr.Error for service API and SDK errors. Use runtime type assertions with awserr.Error's Code and Message methods to get detailed information about the error.

See the AWS API reference guide for Amazon EC2 Container Registry's API operation UploadLayerPart for usage and error information.

Returned Error Codes:

  • ErrCodeServerException "ServerException" These errors are usually caused by a server-side issue.

  • ErrCodeInvalidParameterException "InvalidParameterException" The specified parameter is invalid. Review the available parameters for the API request.

  • ErrCodeInvalidLayerPartException "InvalidLayerPartException" The layer part size is not valid, or the first byte specified is not consecutive to the last byte of a previous layer part upload.

  • ErrCodeRepositoryNotFoundException "RepositoryNotFoundException" The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.

  • ErrCodeUploadNotFoundException "UploadNotFoundException" The upload could not be found, or the specified upload id is not valid for this repository.

  • ErrCodeLimitExceededException "LimitExceededException" The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR Default Service Limits (https://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon Elastic Container Registry User Guide.

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UploadLayerPart

func (*ECR) UploadLayerPartRequest

func (c *ECR) UploadLayerPartRequest(input *UploadLayerPartInput) (req *request.Request, output *UploadLayerPartOutput)

UploadLayerPartRequest generates a "aws/request.Request" representing the client's request for the UploadLayerPart operation. The "output" return value will be populated with the request's response once the request completes successfully.

Use "Send" method on the returned Request to send the API call to the service. the "output" return value is not valid until after Send returns without error.

See UploadLayerPart for more information on using the UploadLayerPart API call, and error handling.

This method is useful when you want to inject custom logic or configuration into the SDK's request lifecycle. Such as custom headers, or retry logic.

// Example sending a request using the UploadLayerPartRequest method.
req, resp := client.UploadLayerPartRequest(params)

err := req.Send()
if err == nil { // resp is now filled
    fmt.Println(resp)
}

See also, https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UploadLayerPart

func (*ECR) UploadLayerPartWithContext added in v1.8.0

func (c *ECR) UploadLayerPartWithContext(ctx aws.Context, input *UploadLayerPartInput, opts ...request.Option) (*UploadLayerPartOutput, error)

UploadLayerPartWithContext is the same as UploadLayerPart with the addition of the ability to pass a context and additional request options.

See UploadLayerPart for details on how to use this API operation.

The context must be non-nil and will be used for request cancellation. If the context is nil a panic will occur. In the future the SDK may create sub-contexts for http.Requests. See https://golang.org/pkg/context/ for more information on using Contexts.

type GetAuthorizationTokenInput

type GetAuthorizationTokenInput struct {

	// A list of AWS account IDs that are associated with the registries for which
	// to get authorization tokens. If you do not specify a registry, the default
	// registry is assumed.
	RegistryIds []*string `locationName:"registryIds" min:"1" type:"list"`
	// contains filtered or unexported fields
}

func (GetAuthorizationTokenInput) GoString

func (s GetAuthorizationTokenInput) GoString() string

GoString returns the string representation

func (*GetAuthorizationTokenInput) SetRegistryIds added in v1.5.0

SetRegistryIds sets the RegistryIds field's value.

func (GetAuthorizationTokenInput) String

String returns the string representation

func (*GetAuthorizationTokenInput) Validate added in v1.1.21

func (s *GetAuthorizationTokenInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetAuthorizationTokenOutput

type GetAuthorizationTokenOutput struct {

	// A list of authorization token data objects that correspond to the registryIds
	// values in the request.
	AuthorizationData []*AuthorizationData `locationName:"authorizationData" type:"list"`
	// contains filtered or unexported fields
}

func (GetAuthorizationTokenOutput) GoString

func (s GetAuthorizationTokenOutput) GoString() string

GoString returns the string representation

func (*GetAuthorizationTokenOutput) SetAuthorizationData added in v1.5.0

SetAuthorizationData sets the AuthorizationData field's value.

func (GetAuthorizationTokenOutput) String

String returns the string representation

type GetDownloadUrlForLayerInput

type GetDownloadUrlForLayerInput struct {

	// The digest of the image layer to download.
	//
	// LayerDigest is a required field
	LayerDigest *string `locationName:"layerDigest" type:"string" required:"true"`

	// The AWS account ID associated with the registry that contains the image layer
	// to download. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository that is associated with the image layer to download.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetDownloadUrlForLayerInput) GoString

func (s GetDownloadUrlForLayerInput) GoString() string

GoString returns the string representation

func (*GetDownloadUrlForLayerInput) SetLayerDigest added in v1.5.0

SetLayerDigest sets the LayerDigest field's value.

func (*GetDownloadUrlForLayerInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*GetDownloadUrlForLayerInput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (GetDownloadUrlForLayerInput) String

String returns the string representation

func (*GetDownloadUrlForLayerInput) Validate added in v1.1.21

func (s *GetDownloadUrlForLayerInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetDownloadUrlForLayerOutput

type GetDownloadUrlForLayerOutput struct {

	// The pre-signed Amazon S3 download URL for the requested layer.
	DownloadUrl *string `locationName:"downloadUrl" type:"string"`

	// The digest of the image layer to download.
	LayerDigest *string `locationName:"layerDigest" type:"string"`
	// contains filtered or unexported fields
}

func (GetDownloadUrlForLayerOutput) GoString

func (s GetDownloadUrlForLayerOutput) GoString() string

GoString returns the string representation

func (*GetDownloadUrlForLayerOutput) SetDownloadUrl added in v1.5.0

SetDownloadUrl sets the DownloadUrl field's value.

func (*GetDownloadUrlForLayerOutput) SetLayerDigest added in v1.5.0

SetLayerDigest sets the LayerDigest field's value.

func (GetDownloadUrlForLayerOutput) String

String returns the string representation

type GetLifecyclePolicyInput added in v1.12.9

type GetLifecyclePolicyInput struct {

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetLifecyclePolicyInput) GoString added in v1.12.9

func (s GetLifecyclePolicyInput) GoString() string

GoString returns the string representation

func (*GetLifecyclePolicyInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*GetLifecyclePolicyInput) SetRepositoryName added in v1.12.9

func (s *GetLifecyclePolicyInput) SetRepositoryName(v string) *GetLifecyclePolicyInput

SetRepositoryName sets the RepositoryName field's value.

func (GetLifecyclePolicyInput) String added in v1.12.9

func (s GetLifecyclePolicyInput) String() string

String returns the string representation

func (*GetLifecyclePolicyInput) Validate added in v1.12.9

func (s *GetLifecyclePolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetLifecyclePolicyOutput added in v1.12.9

type GetLifecyclePolicyOutput struct {

	// The time stamp of the last time that the lifecycle policy was run.
	LastEvaluatedAt *time.Time `locationName:"lastEvaluatedAt" type:"timestamp"`

	// The JSON lifecycle policy text.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (GetLifecyclePolicyOutput) GoString added in v1.12.9

func (s GetLifecyclePolicyOutput) GoString() string

GoString returns the string representation

func (*GetLifecyclePolicyOutput) SetLastEvaluatedAt added in v1.12.9

func (s *GetLifecyclePolicyOutput) SetLastEvaluatedAt(v time.Time) *GetLifecyclePolicyOutput

SetLastEvaluatedAt sets the LastEvaluatedAt field's value.

func (*GetLifecyclePolicyOutput) SetLifecyclePolicyText added in v1.12.9

func (s *GetLifecyclePolicyOutput) SetLifecyclePolicyText(v string) *GetLifecyclePolicyOutput

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*GetLifecyclePolicyOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*GetLifecyclePolicyOutput) SetRepositoryName added in v1.12.9

func (s *GetLifecyclePolicyOutput) SetRepositoryName(v string) *GetLifecyclePolicyOutput

SetRepositoryName sets the RepositoryName field's value.

func (GetLifecyclePolicyOutput) String added in v1.12.9

func (s GetLifecyclePolicyOutput) String() string

String returns the string representation

type GetLifecyclePolicyPreviewInput added in v1.12.9

type GetLifecyclePolicyPreviewInput struct {

	// An optional parameter that filters results based on image tag status and
	// all tags, if tagged.
	Filter *LifecyclePolicyPreviewFilter `locationName:"filter" type:"structure"`

	// The list of imageIDs to be included.
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"`

	// The maximum number of repository results returned by GetLifecyclePolicyPreviewRequest
	// in paginated output. When this parameter is used, GetLifecyclePolicyPreviewRequest
	// only returns maxResults results in a single page along with a nextToken response
	// element. The remaining results of the initial request can be seen by sending
	// another GetLifecyclePolicyPreviewRequest request with the returned nextToken
	// value. This value can be between 1 and 1000. If this parameter is not used,
	// then GetLifecyclePolicyPreviewRequest returns up to 100 results and a nextToken
	// value, if applicable. This option cannot be used when you specify images
	// with imageIds.
	MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"`

	// The nextToken value returned from a previous paginated GetLifecyclePolicyPreviewRequest
	// request where maxResults was used and the results exceeded the value of that
	// parameter. Pagination continues from the end of the previous results that
	// returned the nextToken value. This value is null when there are no more results
	// to return. This option cannot be used when you specify images with imageIds.
	NextToken *string `locationName:"nextToken" type:"string"`

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetLifecyclePolicyPreviewInput) GoString added in v1.12.9

GoString returns the string representation

func (*GetLifecyclePolicyPreviewInput) SetFilter added in v1.12.9

SetFilter sets the Filter field's value.

func (*GetLifecyclePolicyPreviewInput) SetImageIds added in v1.12.9

SetImageIds sets the ImageIds field's value.

func (*GetLifecyclePolicyPreviewInput) SetMaxResults added in v1.12.9

SetMaxResults sets the MaxResults field's value.

func (*GetLifecyclePolicyPreviewInput) SetNextToken added in v1.12.9

SetNextToken sets the NextToken field's value.

func (*GetLifecyclePolicyPreviewInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*GetLifecyclePolicyPreviewInput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (GetLifecyclePolicyPreviewInput) String added in v1.12.9

String returns the string representation

func (*GetLifecyclePolicyPreviewInput) Validate added in v1.12.9

func (s *GetLifecyclePolicyPreviewInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetLifecyclePolicyPreviewOutput added in v1.12.9

type GetLifecyclePolicyPreviewOutput struct {

	// The JSON lifecycle policy text.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The nextToken value to include in a future GetLifecyclePolicyPreview request.
	// When the results of a GetLifecyclePolicyPreview request exceed maxResults,
	// this value can be used to retrieve the next page of results. This value is
	// null when there are no more results to return.
	NextToken *string `locationName:"nextToken" type:"string"`

	// The results of the lifecycle policy preview request.
	PreviewResults []*LifecyclePolicyPreviewResult `locationName:"previewResults" type:"list"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`

	// The status of the lifecycle policy preview request.
	Status *string `locationName:"status" type:"string" enum:"LifecyclePolicyPreviewStatus"`

	// The list of images that is returned as a result of the action.
	Summary *LifecyclePolicyPreviewSummary `locationName:"summary" type:"structure"`
	// contains filtered or unexported fields
}

func (GetLifecyclePolicyPreviewOutput) GoString added in v1.12.9

GoString returns the string representation

func (*GetLifecyclePolicyPreviewOutput) SetLifecyclePolicyText added in v1.12.9

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*GetLifecyclePolicyPreviewOutput) SetNextToken added in v1.12.9

SetNextToken sets the NextToken field's value.

func (*GetLifecyclePolicyPreviewOutput) SetPreviewResults added in v1.12.9

SetPreviewResults sets the PreviewResults field's value.

func (*GetLifecyclePolicyPreviewOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*GetLifecyclePolicyPreviewOutput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (*GetLifecyclePolicyPreviewOutput) SetStatus added in v1.12.9

SetStatus sets the Status field's value.

func (*GetLifecyclePolicyPreviewOutput) SetSummary added in v1.12.9

SetSummary sets the Summary field's value.

func (GetLifecyclePolicyPreviewOutput) String added in v1.12.9

String returns the string representation

type GetRepositoryPolicyInput

type GetRepositoryPolicyInput struct {

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository with the policy to retrieve.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (GetRepositoryPolicyInput) GoString

func (s GetRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*GetRepositoryPolicyInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*GetRepositoryPolicyInput) SetRepositoryName added in v1.5.0

func (s *GetRepositoryPolicyInput) SetRepositoryName(v string) *GetRepositoryPolicyInput

SetRepositoryName sets the RepositoryName field's value.

func (GetRepositoryPolicyInput) String

func (s GetRepositoryPolicyInput) String() string

String returns the string representation

func (*GetRepositoryPolicyInput) Validate added in v1.1.21

func (s *GetRepositoryPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type GetRepositoryPolicyOutput

type GetRepositoryPolicyOutput struct {

	// The JSON repository policy text associated with the repository.
	PolicyText *string `locationName:"policyText" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (GetRepositoryPolicyOutput) GoString

func (s GetRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*GetRepositoryPolicyOutput) SetPolicyText added in v1.5.0

SetPolicyText sets the PolicyText field's value.

func (*GetRepositoryPolicyOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*GetRepositoryPolicyOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (GetRepositoryPolicyOutput) String

func (s GetRepositoryPolicyOutput) String() string

String returns the string representation

type Image

type Image struct {

	// An object containing the image tag and image digest associated with an image.
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure"`

	// The image manifest associated with the image.
	ImageManifest *string `locationName:"imageManifest" type:"string"`

	// The AWS account ID associated with the registry containing the image.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository associated with the image.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

An object representing an Amazon ECR image.

func (Image) GoString

func (s Image) GoString() string

GoString returns the string representation

func (*Image) SetImageId added in v1.5.0

func (s *Image) SetImageId(v *ImageIdentifier) *Image

SetImageId sets the ImageId field's value.

func (*Image) SetImageManifest added in v1.5.0

func (s *Image) SetImageManifest(v string) *Image

SetImageManifest sets the ImageManifest field's value.

func (*Image) SetRegistryId added in v1.5.0

func (s *Image) SetRegistryId(v string) *Image

SetRegistryId sets the RegistryId field's value.

func (*Image) SetRepositoryName added in v1.5.0

func (s *Image) SetRepositoryName(v string) *Image

SetRepositoryName sets the RepositoryName field's value.

func (Image) String

func (s Image) String() string

String returns the string representation

type ImageDetail added in v1.4.16

type ImageDetail struct {

	// The sha256 digest of the image manifest.
	ImageDigest *string `locationName:"imageDigest" type:"string"`

	// The date and time, expressed in standard JavaScript date format, at which
	// the current image was pushed to the repository.
	ImagePushedAt *time.Time `locationName:"imagePushedAt" type:"timestamp"`

	// The size, in bytes, of the image in the repository.
	//
	// Beginning with Docker version 1.9, the Docker client compresses image layers
	// before pushing them to a V2 Docker registry. The output of the docker images
	// command shows the uncompressed image size, so it may return a larger image
	// size than the image sizes returned by DescribeImages.
	ImageSizeInBytes *int64 `locationName:"imageSizeInBytes" type:"long"`

	// The list of tags associated with this image.
	ImageTags []*string `locationName:"imageTags" type:"list"`

	// The AWS account ID associated with the registry to which this image belongs.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to which this image belongs.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

An object that describes an image returned by a DescribeImages operation.

func (ImageDetail) GoString added in v1.4.16

func (s ImageDetail) GoString() string

GoString returns the string representation

func (*ImageDetail) SetImageDigest added in v1.5.0

func (s *ImageDetail) SetImageDigest(v string) *ImageDetail

SetImageDigest sets the ImageDigest field's value.

func (*ImageDetail) SetImagePushedAt added in v1.5.0

func (s *ImageDetail) SetImagePushedAt(v time.Time) *ImageDetail

SetImagePushedAt sets the ImagePushedAt field's value.

func (*ImageDetail) SetImageSizeInBytes added in v1.5.0

func (s *ImageDetail) SetImageSizeInBytes(v int64) *ImageDetail

SetImageSizeInBytes sets the ImageSizeInBytes field's value.

func (*ImageDetail) SetImageTags added in v1.5.0

func (s *ImageDetail) SetImageTags(v []*string) *ImageDetail

SetImageTags sets the ImageTags field's value.

func (*ImageDetail) SetRegistryId added in v1.5.0

func (s *ImageDetail) SetRegistryId(v string) *ImageDetail

SetRegistryId sets the RegistryId field's value.

func (*ImageDetail) SetRepositoryName added in v1.5.0

func (s *ImageDetail) SetRepositoryName(v string) *ImageDetail

SetRepositoryName sets the RepositoryName field's value.

func (ImageDetail) String added in v1.4.16

func (s ImageDetail) String() string

String returns the string representation

type ImageFailure

type ImageFailure struct {

	// The code associated with the failure.
	FailureCode *string `locationName:"failureCode" type:"string" enum:"ImageFailureCode"`

	// The reason for the failure.
	FailureReason *string `locationName:"failureReason" type:"string"`

	// The image ID associated with the failure.
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure"`
	// contains filtered or unexported fields
}

An object representing an Amazon ECR image failure.

func (ImageFailure) GoString

func (s ImageFailure) GoString() string

GoString returns the string representation

func (*ImageFailure) SetFailureCode added in v1.5.0

func (s *ImageFailure) SetFailureCode(v string) *ImageFailure

SetFailureCode sets the FailureCode field's value.

func (*ImageFailure) SetFailureReason added in v1.5.0

func (s *ImageFailure) SetFailureReason(v string) *ImageFailure

SetFailureReason sets the FailureReason field's value.

func (*ImageFailure) SetImageId added in v1.5.0

func (s *ImageFailure) SetImageId(v *ImageIdentifier) *ImageFailure

SetImageId sets the ImageId field's value.

func (ImageFailure) String

func (s ImageFailure) String() string

String returns the string representation

type ImageIdentifier

type ImageIdentifier struct {

	// The sha256 digest of the image manifest.
	ImageDigest *string `locationName:"imageDigest" type:"string"`

	// The tag used for the image.
	ImageTag *string `locationName:"imageTag" min:"1" type:"string"`
	// contains filtered or unexported fields
}

An object with identifying information for an Amazon ECR image.

func (ImageIdentifier) GoString

func (s ImageIdentifier) GoString() string

GoString returns the string representation

func (*ImageIdentifier) SetImageDigest added in v1.5.0

func (s *ImageIdentifier) SetImageDigest(v string) *ImageIdentifier

SetImageDigest sets the ImageDigest field's value.

func (*ImageIdentifier) SetImageTag added in v1.5.0

func (s *ImageIdentifier) SetImageTag(v string) *ImageIdentifier

SetImageTag sets the ImageTag field's value.

func (ImageIdentifier) String

func (s ImageIdentifier) String() string

String returns the string representation

func (*ImageIdentifier) Validate added in v1.99.0

func (s *ImageIdentifier) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InitiateLayerUploadInput

type InitiateLayerUploadInput struct {

	// The AWS account ID associated with the registry to which you intend to upload
	// layers. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to which you intend to upload layers.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (InitiateLayerUploadInput) GoString

func (s InitiateLayerUploadInput) GoString() string

GoString returns the string representation

func (*InitiateLayerUploadInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*InitiateLayerUploadInput) SetRepositoryName added in v1.5.0

func (s *InitiateLayerUploadInput) SetRepositoryName(v string) *InitiateLayerUploadInput

SetRepositoryName sets the RepositoryName field's value.

func (InitiateLayerUploadInput) String

func (s InitiateLayerUploadInput) String() string

String returns the string representation

func (*InitiateLayerUploadInput) Validate added in v1.1.21

func (s *InitiateLayerUploadInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type InitiateLayerUploadOutput

type InitiateLayerUploadOutput struct {

	// The size, in bytes, that Amazon ECR expects future layer part uploads to
	// be.
	PartSize *int64 `locationName:"partSize" type:"long"`

	// The upload ID for the layer upload. This parameter is passed to further UploadLayerPart
	// and CompleteLayerUpload operations.
	UploadId *string `locationName:"uploadId" type:"string"`
	// contains filtered or unexported fields
}

func (InitiateLayerUploadOutput) GoString

func (s InitiateLayerUploadOutput) GoString() string

GoString returns the string representation

func (*InitiateLayerUploadOutput) SetPartSize added in v1.5.0

SetPartSize sets the PartSize field's value.

func (*InitiateLayerUploadOutput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (InitiateLayerUploadOutput) String

func (s InitiateLayerUploadOutput) String() string

String returns the string representation

type Layer

type Layer struct {

	// The availability status of the image layer.
	LayerAvailability *string `locationName:"layerAvailability" type:"string" enum:"LayerAvailability"`

	// The sha256 digest of the image layer.
	LayerDigest *string `locationName:"layerDigest" type:"string"`

	// The size, in bytes, of the image layer.
	LayerSize *int64 `locationName:"layerSize" type:"long"`

	// The media type of the layer, such as application/vnd.docker.image.rootfs.diff.tar.gzip
	// or application/vnd.oci.image.layer.v1.tar+gzip.
	MediaType *string `locationName:"mediaType" type:"string"`
	// contains filtered or unexported fields
}

An object representing an Amazon ECR image layer.

func (Layer) GoString

func (s Layer) GoString() string

GoString returns the string representation

func (*Layer) SetLayerAvailability added in v1.5.0

func (s *Layer) SetLayerAvailability(v string) *Layer

SetLayerAvailability sets the LayerAvailability field's value.

func (*Layer) SetLayerDigest added in v1.5.0

func (s *Layer) SetLayerDigest(v string) *Layer

SetLayerDigest sets the LayerDigest field's value.

func (*Layer) SetLayerSize added in v1.5.0

func (s *Layer) SetLayerSize(v int64) *Layer

SetLayerSize sets the LayerSize field's value.

func (*Layer) SetMediaType added in v1.6.7

func (s *Layer) SetMediaType(v string) *Layer

SetMediaType sets the MediaType field's value.

func (Layer) String

func (s Layer) String() string

String returns the string representation

type LayerFailure

type LayerFailure struct {

	// The failure code associated with the failure.
	FailureCode *string `locationName:"failureCode" type:"string" enum:"LayerFailureCode"`

	// The reason for the failure.
	FailureReason *string `locationName:"failureReason" type:"string"`

	// The layer digest associated with the failure.
	LayerDigest *string `locationName:"layerDigest" type:"string"`
	// contains filtered or unexported fields
}

An object representing an Amazon ECR image layer failure.

func (LayerFailure) GoString

func (s LayerFailure) GoString() string

GoString returns the string representation

func (*LayerFailure) SetFailureCode added in v1.5.0

func (s *LayerFailure) SetFailureCode(v string) *LayerFailure

SetFailureCode sets the FailureCode field's value.

func (*LayerFailure) SetFailureReason added in v1.5.0

func (s *LayerFailure) SetFailureReason(v string) *LayerFailure

SetFailureReason sets the FailureReason field's value.

func (*LayerFailure) SetLayerDigest added in v1.5.0

func (s *LayerFailure) SetLayerDigest(v string) *LayerFailure

SetLayerDigest sets the LayerDigest field's value.

func (LayerFailure) String

func (s LayerFailure) String() string

String returns the string representation

type LifecyclePolicyPreviewFilter added in v1.12.9

type LifecyclePolicyPreviewFilter struct {

	// The tag status of the image.
	TagStatus *string `locationName:"tagStatus" type:"string" enum:"TagStatus"`
	// contains filtered or unexported fields
}

The filter for the lifecycle policy preview.

func (LifecyclePolicyPreviewFilter) GoString added in v1.12.9

func (s LifecyclePolicyPreviewFilter) GoString() string

GoString returns the string representation

func (*LifecyclePolicyPreviewFilter) SetTagStatus added in v1.12.9

SetTagStatus sets the TagStatus field's value.

func (LifecyclePolicyPreviewFilter) String added in v1.12.9

String returns the string representation

type LifecyclePolicyPreviewResult added in v1.12.9

type LifecyclePolicyPreviewResult struct {

	// The type of action to be taken.
	Action *LifecyclePolicyRuleAction `locationName:"action" type:"structure"`

	// The priority of the applied rule.
	AppliedRulePriority *int64 `locationName:"appliedRulePriority" min:"1" type:"integer"`

	// The sha256 digest of the image manifest.
	ImageDigest *string `locationName:"imageDigest" type:"string"`

	// The date and time, expressed in standard JavaScript date format, at which
	// the current image was pushed to the repository.
	ImagePushedAt *time.Time `locationName:"imagePushedAt" type:"timestamp"`

	// The list of tags associated with this image.
	ImageTags []*string `locationName:"imageTags" type:"list"`
	// contains filtered or unexported fields
}

The result of the lifecycle policy preview.

func (LifecyclePolicyPreviewResult) GoString added in v1.12.9

func (s LifecyclePolicyPreviewResult) GoString() string

GoString returns the string representation

func (*LifecyclePolicyPreviewResult) SetAction added in v1.12.9

SetAction sets the Action field's value.

func (*LifecyclePolicyPreviewResult) SetAppliedRulePriority added in v1.12.9

func (s *LifecyclePolicyPreviewResult) SetAppliedRulePriority(v int64) *LifecyclePolicyPreviewResult

SetAppliedRulePriority sets the AppliedRulePriority field's value.

func (*LifecyclePolicyPreviewResult) SetImageDigest added in v1.12.9

SetImageDigest sets the ImageDigest field's value.

func (*LifecyclePolicyPreviewResult) SetImagePushedAt added in v1.12.9

SetImagePushedAt sets the ImagePushedAt field's value.

func (*LifecyclePolicyPreviewResult) SetImageTags added in v1.12.9

SetImageTags sets the ImageTags field's value.

func (LifecyclePolicyPreviewResult) String added in v1.12.9

String returns the string representation

type LifecyclePolicyPreviewSummary added in v1.12.9

type LifecyclePolicyPreviewSummary struct {

	// The number of expiring images.
	ExpiringImageTotalCount *int64 `locationName:"expiringImageTotalCount" type:"integer"`
	// contains filtered or unexported fields
}

The summary of the lifecycle policy preview request.

func (LifecyclePolicyPreviewSummary) GoString added in v1.12.9

GoString returns the string representation

func (*LifecyclePolicyPreviewSummary) SetExpiringImageTotalCount added in v1.12.9

func (s *LifecyclePolicyPreviewSummary) SetExpiringImageTotalCount(v int64) *LifecyclePolicyPreviewSummary

SetExpiringImageTotalCount sets the ExpiringImageTotalCount field's value.

func (LifecyclePolicyPreviewSummary) String added in v1.12.9

String returns the string representation

type LifecyclePolicyRuleAction added in v1.12.9

type LifecyclePolicyRuleAction struct {

	// The type of action to be taken.
	Type *string `locationName:"type" type:"string" enum:"ImageActionType"`
	// contains filtered or unexported fields
}

The type of action to be taken.

func (LifecyclePolicyRuleAction) GoString added in v1.12.9

func (s LifecyclePolicyRuleAction) GoString() string

GoString returns the string representation

func (*LifecyclePolicyRuleAction) SetType added in v1.12.9

SetType sets the Type field's value.

func (LifecyclePolicyRuleAction) String added in v1.12.9

func (s LifecyclePolicyRuleAction) String() string

String returns the string representation

type ListImagesFilter added in v1.4.0

type ListImagesFilter struct {

	// The tag status with which to filter your ListImages results. You can filter
	// results based on whether they are TAGGED or UNTAGGED.
	TagStatus *string `locationName:"tagStatus" type:"string" enum:"TagStatus"`
	// contains filtered or unexported fields
}

An object representing a filter on a ListImages operation.

func (ListImagesFilter) GoString added in v1.4.0

func (s ListImagesFilter) GoString() string

GoString returns the string representation

func (*ListImagesFilter) SetTagStatus added in v1.5.0

func (s *ListImagesFilter) SetTagStatus(v string) *ListImagesFilter

SetTagStatus sets the TagStatus field's value.

func (ListImagesFilter) String added in v1.4.0

func (s ListImagesFilter) String() string

String returns the string representation

type ListImagesInput

type ListImagesInput struct {

	// The filter key and value with which to filter your ListImages results.
	Filter *ListImagesFilter `locationName:"filter" type:"structure"`

	// The maximum number of image results returned by ListImages in paginated output.
	// When this parameter is used, ListImages only returns maxResults results in
	// a single page along with a nextToken response element. The remaining results
	// of the initial request can be seen by sending another ListImages request
	// with the returned nextToken value. This value can be between 1 and 1000.
	// If this parameter is not used, then ListImages returns up to 100 results
	// and a nextToken value, if applicable.
	MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"`

	// The nextToken value returned from a previous paginated ListImages request
	// where maxResults was used and the results exceeded the value of that parameter.
	// Pagination continues from the end of the previous results that returned the
	// nextToken value. This value is null when there are no more results to return.
	//
	// This token should be treated as an opaque identifier that is only used to
	// retrieve the next items in a list and not for other programmatic purposes.
	NextToken *string `locationName:"nextToken" type:"string"`

	// The AWS account ID associated with the registry that contains the repository
	// in which to list images. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository with image IDs to be listed.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (ListImagesInput) GoString

func (s ListImagesInput) GoString() string

GoString returns the string representation

func (*ListImagesInput) SetFilter added in v1.5.0

SetFilter sets the Filter field's value.

func (*ListImagesInput) SetMaxResults added in v1.5.0

func (s *ListImagesInput) SetMaxResults(v int64) *ListImagesInput

SetMaxResults sets the MaxResults field's value.

func (*ListImagesInput) SetNextToken added in v1.5.0

func (s *ListImagesInput) SetNextToken(v string) *ListImagesInput

SetNextToken sets the NextToken field's value.

func (*ListImagesInput) SetRegistryId added in v1.5.0

func (s *ListImagesInput) SetRegistryId(v string) *ListImagesInput

SetRegistryId sets the RegistryId field's value.

func (*ListImagesInput) SetRepositoryName added in v1.5.0

func (s *ListImagesInput) SetRepositoryName(v string) *ListImagesInput

SetRepositoryName sets the RepositoryName field's value.

func (ListImagesInput) String

func (s ListImagesInput) String() string

String returns the string representation

func (*ListImagesInput) Validate added in v1.1.21

func (s *ListImagesInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListImagesOutput

type ListImagesOutput struct {

	// The list of image IDs for the requested repository.
	ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"`

	// The nextToken value to include in a future ListImages request. When the results
	// of a ListImages request exceed maxResults, this value can be used to retrieve
	// the next page of results. This value is null when there are no more results
	// to return.
	NextToken *string `locationName:"nextToken" type:"string"`
	// contains filtered or unexported fields
}

func (ListImagesOutput) GoString

func (s ListImagesOutput) GoString() string

GoString returns the string representation

func (*ListImagesOutput) SetImageIds added in v1.5.0

func (s *ListImagesOutput) SetImageIds(v []*ImageIdentifier) *ListImagesOutput

SetImageIds sets the ImageIds field's value.

func (*ListImagesOutput) SetNextToken added in v1.5.0

func (s *ListImagesOutput) SetNextToken(v string) *ListImagesOutput

SetNextToken sets the NextToken field's value.

func (ListImagesOutput) String

func (s ListImagesOutput) String() string

String returns the string representation

type ListTagsForResourceInput added in v1.99.0

type ListTagsForResourceInput struct {

	// The Amazon Resource Name (ARN) that identifies the resource for which to
	// list the tags. Currently, the only supported resource is an Amazon ECR repository.
	//
	// ResourceArn is a required field
	ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (ListTagsForResourceInput) GoString added in v1.99.0

func (s ListTagsForResourceInput) GoString() string

GoString returns the string representation

func (*ListTagsForResourceInput) SetResourceArn added in v1.99.0

SetResourceArn sets the ResourceArn field's value.

func (ListTagsForResourceInput) String added in v1.99.0

func (s ListTagsForResourceInput) String() string

String returns the string representation

func (*ListTagsForResourceInput) Validate added in v1.99.0

func (s *ListTagsForResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type ListTagsForResourceOutput added in v1.99.0

type ListTagsForResourceOutput struct {

	// The tags for the resource.
	Tags []*Tag `locationName:"tags" type:"list"`
	// contains filtered or unexported fields
}

func (ListTagsForResourceOutput) GoString added in v1.99.0

func (s ListTagsForResourceOutput) GoString() string

GoString returns the string representation

func (*ListTagsForResourceOutput) SetTags added in v1.99.0

SetTags sets the Tags field's value.

func (ListTagsForResourceOutput) String added in v1.99.0

func (s ListTagsForResourceOutput) String() string

String returns the string representation

type PutImageInput

type PutImageInput struct {

	// The image manifest corresponding to the image to be uploaded.
	//
	// ImageManifest is a required field
	ImageManifest *string `locationName:"imageManifest" type:"string" required:"true"`

	// The tag to associate with the image. This parameter is required for images
	// that use the Docker Image Manifest V2 Schema 2 or OCI formats.
	ImageTag *string `locationName:"imageTag" min:"1" type:"string"`

	// The AWS account ID associated with the registry that contains the repository
	// in which to put the image. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository in which to put the image.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutImageInput) GoString

func (s PutImageInput) GoString() string

GoString returns the string representation

func (*PutImageInput) SetImageManifest added in v1.5.0

func (s *PutImageInput) SetImageManifest(v string) *PutImageInput

SetImageManifest sets the ImageManifest field's value.

func (*PutImageInput) SetImageTag added in v1.6.7

func (s *PutImageInput) SetImageTag(v string) *PutImageInput

SetImageTag sets the ImageTag field's value.

func (*PutImageInput) SetRegistryId added in v1.5.0

func (s *PutImageInput) SetRegistryId(v string) *PutImageInput

SetRegistryId sets the RegistryId field's value.

func (*PutImageInput) SetRepositoryName added in v1.5.0

func (s *PutImageInput) SetRepositoryName(v string) *PutImageInput

SetRepositoryName sets the RepositoryName field's value.

func (PutImageInput) String

func (s PutImageInput) String() string

String returns the string representation

func (*PutImageInput) Validate added in v1.1.21

func (s *PutImageInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutImageOutput

type PutImageOutput struct {

	// Details of the image uploaded.
	Image *Image `locationName:"image" type:"structure"`
	// contains filtered or unexported fields
}

func (PutImageOutput) GoString

func (s PutImageOutput) GoString() string

GoString returns the string representation

func (*PutImageOutput) SetImage added in v1.5.0

func (s *PutImageOutput) SetImage(v *Image) *PutImageOutput

SetImage sets the Image field's value.

func (PutImageOutput) String

func (s PutImageOutput) String() string

String returns the string representation

type PutImageTagMutabilityInput added in v1.99.0

type PutImageTagMutabilityInput struct {

	// The tag mutability setting for the repository. If MUTABLE is specified, image
	// tags can be overwritten. If IMMUTABLE is specified, all image tags within
	// the repository will be immutable which will prevent them from being overwritten.
	//
	// ImageTagMutability is a required field
	ImageTagMutability *string `locationName:"imageTagMutability" type:"string" required:"true" enum:"ImageTagMutability"`

	// The AWS account ID associated with the registry that contains the repository
	// in which to update the image tag mutability settings. If you do not specify
	// a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository in which to update the image tag mutability settings.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutImageTagMutabilityInput) GoString added in v1.99.0

func (s PutImageTagMutabilityInput) GoString() string

GoString returns the string representation

func (*PutImageTagMutabilityInput) SetImageTagMutability added in v1.99.0

func (s *PutImageTagMutabilityInput) SetImageTagMutability(v string) *PutImageTagMutabilityInput

SetImageTagMutability sets the ImageTagMutability field's value.

func (*PutImageTagMutabilityInput) SetRegistryId added in v1.99.0

SetRegistryId sets the RegistryId field's value.

func (*PutImageTagMutabilityInput) SetRepositoryName added in v1.99.0

SetRepositoryName sets the RepositoryName field's value.

func (PutImageTagMutabilityInput) String added in v1.99.0

String returns the string representation

func (*PutImageTagMutabilityInput) Validate added in v1.99.0

func (s *PutImageTagMutabilityInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutImageTagMutabilityOutput added in v1.99.0

type PutImageTagMutabilityOutput struct {

	// The image tag mutability setting for the repository.
	ImageTagMutability *string `locationName:"imageTagMutability" type:"string" enum:"ImageTagMutability"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (PutImageTagMutabilityOutput) GoString added in v1.99.0

func (s PutImageTagMutabilityOutput) GoString() string

GoString returns the string representation

func (*PutImageTagMutabilityOutput) SetImageTagMutability added in v1.99.0

func (s *PutImageTagMutabilityOutput) SetImageTagMutability(v string) *PutImageTagMutabilityOutput

SetImageTagMutability sets the ImageTagMutability field's value.

func (*PutImageTagMutabilityOutput) SetRegistryId added in v1.99.0

SetRegistryId sets the RegistryId field's value.

func (*PutImageTagMutabilityOutput) SetRepositoryName added in v1.99.0

SetRepositoryName sets the RepositoryName field's value.

func (PutImageTagMutabilityOutput) String added in v1.99.0

String returns the string representation

type PutLifecyclePolicyInput added in v1.12.9

type PutLifecyclePolicyInput struct {

	// The JSON repository policy text to apply to the repository.
	//
	// LifecyclePolicyText is a required field
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string" required:"true"`

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to receive the policy.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (PutLifecyclePolicyInput) GoString added in v1.12.9

func (s PutLifecyclePolicyInput) GoString() string

GoString returns the string representation

func (*PutLifecyclePolicyInput) SetLifecyclePolicyText added in v1.12.9

func (s *PutLifecyclePolicyInput) SetLifecyclePolicyText(v string) *PutLifecyclePolicyInput

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*PutLifecyclePolicyInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*PutLifecyclePolicyInput) SetRepositoryName added in v1.12.9

func (s *PutLifecyclePolicyInput) SetRepositoryName(v string) *PutLifecyclePolicyInput

SetRepositoryName sets the RepositoryName field's value.

func (PutLifecyclePolicyInput) String added in v1.12.9

func (s PutLifecyclePolicyInput) String() string

String returns the string representation

func (*PutLifecyclePolicyInput) Validate added in v1.12.9

func (s *PutLifecyclePolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type PutLifecyclePolicyOutput added in v1.12.9

type PutLifecyclePolicyOutput struct {

	// The JSON repository policy text.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (PutLifecyclePolicyOutput) GoString added in v1.12.9

func (s PutLifecyclePolicyOutput) GoString() string

GoString returns the string representation

func (*PutLifecyclePolicyOutput) SetLifecyclePolicyText added in v1.12.9

func (s *PutLifecyclePolicyOutput) SetLifecyclePolicyText(v string) *PutLifecyclePolicyOutput

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*PutLifecyclePolicyOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*PutLifecyclePolicyOutput) SetRepositoryName added in v1.12.9

func (s *PutLifecyclePolicyOutput) SetRepositoryName(v string) *PutLifecyclePolicyOutput

SetRepositoryName sets the RepositoryName field's value.

func (PutLifecyclePolicyOutput) String added in v1.12.9

func (s PutLifecyclePolicyOutput) String() string

String returns the string representation

type Repository

type Repository struct {

	// The date and time, in JavaScript date format, when the repository was created.
	CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"`

	// The tag mutability setting for the repository.
	ImageTagMutability *string `locationName:"imageTagMutability" type:"string" enum:"ImageTagMutability"`

	// The AWS account ID associated with the registry that contains the repository.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The Amazon Resource Name (ARN) that identifies the repository. The ARN contains
	// the arn:aws:ecr namespace, followed by the region of the repository, AWS
	// account ID of the repository owner, repository namespace, and repository
	// name. For example, arn:aws:ecr:region:012345678910:repository/test.
	RepositoryArn *string `locationName:"repositoryArn" type:"string"`

	// The name of the repository.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`

	// The URI for the repository. You can use this URI for Docker push or pull
	// operations.
	RepositoryUri *string `locationName:"repositoryUri" type:"string"`
	// contains filtered or unexported fields
}

An object representing a repository.

func (Repository) GoString

func (s Repository) GoString() string

GoString returns the string representation

func (*Repository) SetCreatedAt added in v1.5.0

func (s *Repository) SetCreatedAt(v time.Time) *Repository

SetCreatedAt sets the CreatedAt field's value.

func (*Repository) SetImageTagMutability added in v1.99.0

func (s *Repository) SetImageTagMutability(v string) *Repository

SetImageTagMutability sets the ImageTagMutability field's value.

func (*Repository) SetRegistryId added in v1.5.0

func (s *Repository) SetRegistryId(v string) *Repository

SetRegistryId sets the RegistryId field's value.

func (*Repository) SetRepositoryArn added in v1.5.0

func (s *Repository) SetRepositoryArn(v string) *Repository

SetRepositoryArn sets the RepositoryArn field's value.

func (*Repository) SetRepositoryName added in v1.5.0

func (s *Repository) SetRepositoryName(v string) *Repository

SetRepositoryName sets the RepositoryName field's value.

func (*Repository) SetRepositoryUri added in v1.5.0

func (s *Repository) SetRepositoryUri(v string) *Repository

SetRepositoryUri sets the RepositoryUri field's value.

func (Repository) String

func (s Repository) String() string

String returns the string representation

type SetRepositoryPolicyInput

type SetRepositoryPolicyInput struct {

	// If the policy you are attempting to set on a repository policy would prevent
	// you from setting another policy in the future, you must force the SetRepositoryPolicy
	// operation. This is intended to prevent accidental repository lock outs.
	Force *bool `locationName:"force" type:"boolean"`

	// The JSON repository policy text to apply to the repository. For more information,
	// see Amazon ECR Repository Policy Examples (https://docs.aws.amazon.com/AmazonECR/latest/userguide/RepositoryPolicyExamples.html)
	// in the Amazon Elastic Container Registry User Guide.
	//
	// PolicyText is a required field
	PolicyText *string `locationName:"policyText" type:"string" required:"true"`

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to receive the policy.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (SetRepositoryPolicyInput) GoString

func (s SetRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*SetRepositoryPolicyInput) SetForce added in v1.5.0

SetForce sets the Force field's value.

func (*SetRepositoryPolicyInput) SetPolicyText added in v1.5.0

SetPolicyText sets the PolicyText field's value.

func (*SetRepositoryPolicyInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*SetRepositoryPolicyInput) SetRepositoryName added in v1.5.0

func (s *SetRepositoryPolicyInput) SetRepositoryName(v string) *SetRepositoryPolicyInput

SetRepositoryName sets the RepositoryName field's value.

func (SetRepositoryPolicyInput) String

func (s SetRepositoryPolicyInput) String() string

String returns the string representation

func (*SetRepositoryPolicyInput) Validate added in v1.1.21

func (s *SetRepositoryPolicyInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type SetRepositoryPolicyOutput

type SetRepositoryPolicyOutput struct {

	// The JSON repository policy text applied to the repository.
	PolicyText *string `locationName:"policyText" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

func (SetRepositoryPolicyOutput) GoString

func (s SetRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*SetRepositoryPolicyOutput) SetPolicyText added in v1.5.0

SetPolicyText sets the PolicyText field's value.

func (*SetRepositoryPolicyOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*SetRepositoryPolicyOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (SetRepositoryPolicyOutput) String

func (s SetRepositoryPolicyOutput) String() string

String returns the string representation

type StartLifecyclePolicyPreviewInput added in v1.12.9

type StartLifecyclePolicyPreviewInput struct {

	// The policy to be evaluated against. If you do not specify a policy, the current
	// policy for the repository is used.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The AWS account ID associated with the registry that contains the repository.
	// If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to be evaluated.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (StartLifecyclePolicyPreviewInput) GoString added in v1.12.9

GoString returns the string representation

func (*StartLifecyclePolicyPreviewInput) SetLifecyclePolicyText added in v1.12.9

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*StartLifecyclePolicyPreviewInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*StartLifecyclePolicyPreviewInput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (StartLifecyclePolicyPreviewInput) String added in v1.12.9

String returns the string representation

func (*StartLifecyclePolicyPreviewInput) Validate added in v1.12.9

Validate inspects the fields of the type to determine if they are valid.

type StartLifecyclePolicyPreviewOutput added in v1.12.9

type StartLifecyclePolicyPreviewOutput struct {

	// The JSON repository policy text.
	LifecyclePolicyText *string `locationName:"lifecyclePolicyText" min:"100" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`

	// The status of the lifecycle policy preview request.
	Status *string `locationName:"status" type:"string" enum:"LifecyclePolicyPreviewStatus"`
	// contains filtered or unexported fields
}

func (StartLifecyclePolicyPreviewOutput) GoString added in v1.12.9

GoString returns the string representation

func (*StartLifecyclePolicyPreviewOutput) SetLifecyclePolicyText added in v1.12.9

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*StartLifecyclePolicyPreviewOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*StartLifecyclePolicyPreviewOutput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (*StartLifecyclePolicyPreviewOutput) SetStatus added in v1.12.9

SetStatus sets the Status field's value.

func (StartLifecyclePolicyPreviewOutput) String added in v1.12.9

String returns the string representation

type Tag added in v1.99.0

type Tag struct {

	// One part of a key-value pair that make up a tag. A key is a general label
	// that acts like a category for more specific tag values.
	Key *string `type:"string"`

	// The optional part of a key-value pair that make up a tag. A value acts as
	// a descriptor within a tag category (key).
	Value *string `type:"string"`
	// contains filtered or unexported fields
}

The metadata that you apply to a resource to help you categorize and organize them. Each tag consists of a key and an optional value, both of which you define. Tag keys can have a maximum character length of 128 characters, and tag values can have a maximum length of 256 characters.

func (Tag) GoString added in v1.99.0

func (s Tag) GoString() string

GoString returns the string representation

func (*Tag) SetKey added in v1.99.0

func (s *Tag) SetKey(v string) *Tag

SetKey sets the Key field's value.

func (*Tag) SetValue added in v1.99.0

func (s *Tag) SetValue(v string) *Tag

SetValue sets the Value field's value.

func (Tag) String added in v1.99.0

func (s Tag) String() string

String returns the string representation

type TagResourceInput added in v1.99.0

type TagResourceInput struct {

	// The Amazon Resource Name (ARN) of the the resource to which to add tags.
	// Currently, the only supported resource is an Amazon ECR repository.
	//
	// ResourceArn is a required field
	ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"`

	// The tags to add to the resource. A tag is an array of key-value pairs. Tag
	// keys can have a maximum character length of 128 characters, and tag values
	// can have a maximum length of 256 characters.
	//
	// Tags is a required field
	Tags []*Tag `locationName:"tags" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (TagResourceInput) GoString added in v1.99.0

func (s TagResourceInput) GoString() string

GoString returns the string representation

func (*TagResourceInput) SetResourceArn added in v1.99.0

func (s *TagResourceInput) SetResourceArn(v string) *TagResourceInput

SetResourceArn sets the ResourceArn field's value.

func (*TagResourceInput) SetTags added in v1.99.0

func (s *TagResourceInput) SetTags(v []*Tag) *TagResourceInput

SetTags sets the Tags field's value.

func (TagResourceInput) String added in v1.99.0

func (s TagResourceInput) String() string

String returns the string representation

func (*TagResourceInput) Validate added in v1.99.0

func (s *TagResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type TagResourceOutput added in v1.99.0

type TagResourceOutput struct {
	// contains filtered or unexported fields
}

func (TagResourceOutput) GoString added in v1.99.0

func (s TagResourceOutput) GoString() string

GoString returns the string representation

func (TagResourceOutput) String added in v1.99.0

func (s TagResourceOutput) String() string

String returns the string representation

type UntagResourceInput added in v1.99.0

type UntagResourceInput struct {

	// The Amazon Resource Name (ARN) of the resource from which to remove tags.
	// Currently, the only supported resource is an Amazon ECR repository.
	//
	// ResourceArn is a required field
	ResourceArn *string `locationName:"resourceArn" type:"string" required:"true"`

	// The keys of the tags to be removed.
	//
	// TagKeys is a required field
	TagKeys []*string `locationName:"tagKeys" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (UntagResourceInput) GoString added in v1.99.0

func (s UntagResourceInput) GoString() string

GoString returns the string representation

func (*UntagResourceInput) SetResourceArn added in v1.99.0

func (s *UntagResourceInput) SetResourceArn(v string) *UntagResourceInput

SetResourceArn sets the ResourceArn field's value.

func (*UntagResourceInput) SetTagKeys added in v1.99.0

func (s *UntagResourceInput) SetTagKeys(v []*string) *UntagResourceInput

SetTagKeys sets the TagKeys field's value.

func (UntagResourceInput) String added in v1.99.0

func (s UntagResourceInput) String() string

String returns the string representation

func (*UntagResourceInput) Validate added in v1.99.0

func (s *UntagResourceInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UntagResourceOutput added in v1.99.0

type UntagResourceOutput struct {
	// contains filtered or unexported fields
}

func (UntagResourceOutput) GoString added in v1.99.0

func (s UntagResourceOutput) GoString() string

GoString returns the string representation

func (UntagResourceOutput) String added in v1.99.0

func (s UntagResourceOutput) String() string

String returns the string representation

type UploadLayerPartInput

type UploadLayerPartInput struct {

	// The base64-encoded layer part payload.
	//
	// LayerPartBlob is automatically base64 encoded/decoded by the SDK.
	//
	// LayerPartBlob is a required field
	LayerPartBlob []byte `locationName:"layerPartBlob" type:"blob" required:"true"`

	// The integer value of the first byte of the layer part.
	//
	// PartFirstByte is a required field
	PartFirstByte *int64 `locationName:"partFirstByte" type:"long" required:"true"`

	// The integer value of the last byte of the layer part.
	//
	// PartLastByte is a required field
	PartLastByte *int64 `locationName:"partLastByte" type:"long" required:"true"`

	// The AWS account ID associated with the registry to which you are uploading
	// layer parts. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository to which you are uploading layer parts.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`

	// The upload ID from a previous InitiateLayerUpload operation to associate
	// with the layer part upload.
	//
	// UploadId is a required field
	UploadId *string `locationName:"uploadId" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (UploadLayerPartInput) GoString

func (s UploadLayerPartInput) GoString() string

GoString returns the string representation

func (*UploadLayerPartInput) SetLayerPartBlob added in v1.5.0

func (s *UploadLayerPartInput) SetLayerPartBlob(v []byte) *UploadLayerPartInput

SetLayerPartBlob sets the LayerPartBlob field's value.

func (*UploadLayerPartInput) SetPartFirstByte added in v1.5.0

func (s *UploadLayerPartInput) SetPartFirstByte(v int64) *UploadLayerPartInput

SetPartFirstByte sets the PartFirstByte field's value.

func (*UploadLayerPartInput) SetPartLastByte added in v1.5.0

func (s *UploadLayerPartInput) SetPartLastByte(v int64) *UploadLayerPartInput

SetPartLastByte sets the PartLastByte field's value.

func (*UploadLayerPartInput) SetRegistryId added in v1.5.0

func (s *UploadLayerPartInput) SetRegistryId(v string) *UploadLayerPartInput

SetRegistryId sets the RegistryId field's value.

func (*UploadLayerPartInput) SetRepositoryName added in v1.5.0

func (s *UploadLayerPartInput) SetRepositoryName(v string) *UploadLayerPartInput

SetRepositoryName sets the RepositoryName field's value.

func (*UploadLayerPartInput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (UploadLayerPartInput) String

func (s UploadLayerPartInput) String() string

String returns the string representation

func (*UploadLayerPartInput) Validate added in v1.1.21

func (s *UploadLayerPartInput) Validate() error

Validate inspects the fields of the type to determine if they are valid.

type UploadLayerPartOutput

type UploadLayerPartOutput struct {

	// The integer value of the last byte received in the request.
	LastByteReceived *int64 `locationName:"lastByteReceived" type:"long"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository name associated with the request.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`

	// The upload ID associated with the request.
	UploadId *string `locationName:"uploadId" type:"string"`
	// contains filtered or unexported fields
}

func (UploadLayerPartOutput) GoString

func (s UploadLayerPartOutput) GoString() string

GoString returns the string representation

func (*UploadLayerPartOutput) SetLastByteReceived added in v1.5.0

func (s *UploadLayerPartOutput) SetLastByteReceived(v int64) *UploadLayerPartOutput

SetLastByteReceived sets the LastByteReceived field's value.

func (*UploadLayerPartOutput) SetRegistryId added in v1.5.0

func (s *UploadLayerPartOutput) SetRegistryId(v string) *UploadLayerPartOutput

SetRegistryId sets the RegistryId field's value.

func (*UploadLayerPartOutput) SetRepositoryName added in v1.5.0

func (s *UploadLayerPartOutput) SetRepositoryName(v string) *UploadLayerPartOutput

SetRepositoryName sets the RepositoryName field's value.

func (*UploadLayerPartOutput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (UploadLayerPartOutput) String

func (s UploadLayerPartOutput) String() string

String returns the string representation

Directories

Path Synopsis
Package ecriface provides an interface to enable mocking the Amazon EC2 Container Registry service client for testing your code.
Package ecriface provides an interface to enable mocking the Amazon EC2 Container Registry service client for testing your code.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL