ecr

package
v1.10.8-0...-b95fc66 Latest Latest
Warning

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

 Go to latest Published: Jul 6, 2017 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Overview

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

Amazon EC2 Container Registry (Amazon ECR) is a managed AWS 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 AWS 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 use the client for Amazon EC2 Container Registry you will first need to create a new instance of it.

When creating a client for an AWS service you'll first need to have a Session already created. The Session provides configuration that can be shared between multiple service clients. Additional configuration can be applied to the Session and service's client when they are constructed. The aws package's Config type contains several fields such as Region for the AWS Region the client should make API requests too. The optional Config value can be provided as the variadic argument for Sessions and client creation.

Once the service's client is created you can use it to make API requests the AWS service. These clients are safe to use concurrently. 

// Create a session to share configuration, and load external configuration.
sess := session.Must(session.NewSession())

// Create the service's client with the session.
svc := ecr.New(sess)

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

See aws package's Config type for more information on configuration options. https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config

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

Once the client is created you can make an API request to the service. Each API method takes a input parameter, and returns the service response and an error.

The API method will document which error codes the service can be returned by the operation if the service models the API operation's errors. These errors will also be available as const strings prefixed with "ErrCode". 

result, err := svc.BatchCheckLayerAvailability(params)
if err != nil {
    // Cast err to awserr.Error to handle specific error codes.
    aerr, ok := err.(awserr.Error)
    if ok && aerr.Code() == <error code to check for> {
        // Specific error code handling
    }
    return err
}

fmt.Println("BatchCheckLayerAvailability result:")
fmt.Println(result)

Using the Client with Context

The service's client also provides methods to make API requests with a Context value. This allows you to control the timeout, and cancellation of pending requests. These methods also take request Option as variadic parameter to apply additional configuration to the API request. 

ctx := context.Background()

result, err := svc.BatchCheckLayerAvailabilityWithContext(ctx, params)

See the request package documentation for more information on using Context pattern with the SDK. https://docs.aws.amazon.com/sdk-for-go/api/aws/request/

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 (
	// 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 (
	// TagStatusTagged is a TagStatus enum value
	TagStatusTagged = "TAGGED"

	// TagStatusUntagged is a TagStatus enum value
	TagStatusUntagged = "UNTAGGED"
)
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 are no changes to
	// the manifest or image tag since the last push.
	ErrCodeImageAlreadyExistsException = "ImageAlreadyExistsException"

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

	// 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"

	// 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"

	// 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
	// (http://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html)
	// in the Amazon EC2 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"

	// 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"       // Service endpoint prefix API calls made to.
	EndpointsID = ServiceName // Service ID for Regions and Endpoints metadata.
)

Service information constants

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" timestampFormat:"unix"`

	// 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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/AuthorizationData

func (AuthorizationData) GoString 

func (s AuthorizationData) GoString() string

GoString returns the string representation

func (*AuthorizationData) SetAuthorizationToken 

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

SetAuthorizationToken sets the AuthorizationToken field's value.

func (*AuthorizationData) SetExpiresAt 

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

SetExpiresAt sets the ExpiresAt field's value.

func (*AuthorizationData) SetProxyEndpoint 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchCheckLayerAvailabilityRequest

func (BatchCheckLayerAvailabilityInput) GoString 

func (s BatchCheckLayerAvailabilityInput) GoString() string

GoString returns the string representation

func (*BatchCheckLayerAvailabilityInput) SetLayerDigests 

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

SetLayerDigests sets the LayerDigests field's value.

func (*BatchCheckLayerAvailabilityInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*BatchCheckLayerAvailabilityInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (BatchCheckLayerAvailabilityInput) String 

func (s BatchCheckLayerAvailabilityInput) String() string

String returns the string representation

func (*BatchCheckLayerAvailabilityInput) Validate 

func (s *BatchCheckLayerAvailabilityInput) Validate() error

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchCheckLayerAvailabilityResponse

func (BatchCheckLayerAvailabilityOutput) GoString 

func (s BatchCheckLayerAvailabilityOutput) GoString() string

GoString returns the string representation

func (*BatchCheckLayerAvailabilityOutput) SetFailures 

func (s *BatchCheckLayerAvailabilityOutput) SetFailures(v []*LayerFailure) *BatchCheckLayerAvailabilityOutput

SetFailures sets the Failures field's value.

func (*BatchCheckLayerAvailabilityOutput) SetLayers 

func (s *BatchCheckLayerAvailabilityOutput) SetLayers(v []*Layer) *BatchCheckLayerAvailabilityOutput

SetLayers sets the Layers field's value.

func (BatchCheckLayerAvailabilityOutput) String 

func (s BatchCheckLayerAvailabilityOutput) String() 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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchDeleteImageRequest

func (BatchDeleteImageInput) GoString 

func (s BatchDeleteImageInput) GoString() string

GoString returns the string representation

func (*BatchDeleteImageInput) SetImageIds 

func (s *BatchDeleteImageInput) SetImageIds(v []*ImageIdentifier) *BatchDeleteImageInput

SetImageIds sets the ImageIds field's value.

func (*BatchDeleteImageInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*BatchDeleteImageInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchDeleteImageResponse

func (BatchDeleteImageOutput) GoString 

func (s BatchDeleteImageOutput) GoString() string

GoString returns the string representation

func (*BatchDeleteImageOutput) SetFailures 

func (s *BatchDeleteImageOutput) SetFailures(v []*ImageFailure) *BatchDeleteImageOutput

SetFailures sets the Failures field's value.

func (*BatchDeleteImageOutput) SetImageIds 

func (s *BatchDeleteImageOutput) SetImageIds(v []*ImageIdentifier) *BatchDeleteImageOutput

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchGetImageRequest

func (BatchGetImageInput) GoString 

func (s BatchGetImageInput) GoString() string

GoString returns the string representation

func (*BatchGetImageInput) SetAcceptedMediaTypes 

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

SetAcceptedMediaTypes sets the AcceptedMediaTypes field's value.

func (*BatchGetImageInput) SetImageIds 

func (s *BatchGetImageInput) SetImageIds(v []*ImageIdentifier) *BatchGetImageInput

SetImageIds sets the ImageIds field's value.

func (*BatchGetImageInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*BatchGetImageInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/BatchGetImageResponse

func (BatchGetImageOutput) GoString 

func (s BatchGetImageOutput) GoString() string

GoString returns the string representation

func (*BatchGetImageOutput) SetFailures 

func (s *BatchGetImageOutput) SetFailures(v []*ImageFailure) *BatchGetImageOutput

SetFailures sets the Failures field's value.

func (*BatchGetImageOutput) SetImages 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CompleteLayerUploadRequest

func (CompleteLayerUploadInput) GoString 

func (s CompleteLayerUploadInput) GoString() string

GoString returns the string representation

func (*CompleteLayerUploadInput) SetLayerDigests 

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

SetLayerDigests sets the LayerDigests field's value.

func (*CompleteLayerUploadInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadInput) SetUploadId 

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

SetUploadId sets the UploadId field's value.

func (CompleteLayerUploadInput) String 

func (s CompleteLayerUploadInput) String() string

String returns the string representation

func (*CompleteLayerUploadInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CompleteLayerUploadResponse

func (CompleteLayerUploadOutput) GoString 

func (s CompleteLayerUploadOutput) GoString() string

GoString returns the string representation

func (*CompleteLayerUploadOutput) SetLayerDigest 

func (s *CompleteLayerUploadOutput) SetLayerDigest(v string) *CompleteLayerUploadOutput

SetLayerDigest sets the LayerDigest field's value.

func (*CompleteLayerUploadOutput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadOutput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadOutput) SetUploadId 

func (s *CompleteLayerUploadOutput) SetUploadId(v string) *CompleteLayerUploadOutput

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 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"`
	// contains filtered or unexported fields
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepositoryRequest

func (CreateRepositoryInput) GoString 

func (s CreateRepositoryInput) GoString() string

GoString returns the string representation

func (*CreateRepositoryInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (CreateRepositoryInput) String 

func (s CreateRepositoryInput) String() string

String returns the string representation

func (*CreateRepositoryInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/CreateRepositoryResponse

func (CreateRepositoryOutput) GoString 

func (s CreateRepositoryOutput) GoString() string

GoString returns the string representation

func (*CreateRepositoryOutput) SetRepository 

func (s *CreateRepositoryOutput) SetRepository(v *Repository) *CreateRepositoryOutput

SetRepository sets the Repository field's value.

func (CreateRepositoryOutput) String 

func (s CreateRepositoryOutput) String() string

String returns the string representation

type DeleteRepositoryInput 

type DeleteRepositoryInput struct {

	// Force the deletion of the repository if it contains images.
	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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryRequest

func (DeleteRepositoryInput) GoString 

func (s DeleteRepositoryInput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryInput) SetForce 

func (s *DeleteRepositoryInput) SetForce(v bool) *DeleteRepositoryInput

SetForce sets the Force field's value.

func (*DeleteRepositoryInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryResponse

func (DeleteRepositoryOutput) GoString 

func (s DeleteRepositoryOutput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryOutput) SetRepository 

func (s *DeleteRepositoryOutput) SetRepository(v *Repository) *DeleteRepositoryOutput

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryPolicyRequest

func (DeleteRepositoryPolicyInput) GoString 

func (s DeleteRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryPolicyInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyInput) String 

func (s DeleteRepositoryPolicyInput) String() string

String returns the string representation

func (*DeleteRepositoryPolicyInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DeleteRepositoryPolicyResponse

func (DeleteRepositoryPolicyOutput) GoString 

func (s DeleteRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*DeleteRepositoryPolicyOutput) SetPolicyText 

func (s *DeleteRepositoryPolicyOutput) SetPolicyText(v string) *DeleteRepositoryPolicyOutput

SetPolicyText sets the PolicyText field's value.

func (*DeleteRepositoryPolicyOutput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyOutput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyOutput) String 

func (s DeleteRepositoryPolicyOutput) String() string

String returns the string representation

type DescribeImagesFilter 

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeImagesFilter

func (DescribeImagesFilter) GoString 

func (s DescribeImagesFilter) GoString() string

GoString returns the string representation

func (*DescribeImagesFilter) SetTagStatus 

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

SetTagStatus sets the TagStatus field's value.

func (DescribeImagesFilter) String 

func (s DescribeImagesFilter) String() string

String returns the string representation

type DescribeImagesInput 

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
	// 100. If this parameter is not used, then DescribeImages 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 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.
	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"`

	// A list of repositories to describe. If this parameter is omitted, then all
	// repositories in a registry are described.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeImagesRequest

func (DescribeImagesInput) GoString 

func (s DescribeImagesInput) GoString() string

GoString returns the string representation

func (*DescribeImagesInput) SetFilter 

func (s *DescribeImagesInput) SetFilter(v *DescribeImagesFilter) *DescribeImagesInput

SetFilter sets the Filter field's value.

func (*DescribeImagesInput) SetImageIds 

func (s *DescribeImagesInput) SetImageIds(v []*ImageIdentifier) *DescribeImagesInput

SetImageIds sets the ImageIds field's value.

func (*DescribeImagesInput) SetMaxResults 

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

SetMaxResults sets the MaxResults field's value.

func (*DescribeImagesInput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (*DescribeImagesInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*DescribeImagesInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImagesInput) String 

func (s DescribeImagesInput) String() string

String returns the string representation

func (*DescribeImagesInput) Validate 

func (s *DescribeImagesInput) Validate() error

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

type DescribeImagesOutput 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeImagesResponse

func (DescribeImagesOutput) GoString 

func (s DescribeImagesOutput) GoString() string

GoString returns the string representation

func (*DescribeImagesOutput) SetImageDetails 

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

SetImageDetails sets the ImageDetails field's value.

func (*DescribeImagesOutput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (DescribeImagesOutput) String 

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 100. If this parameter is not used, then DescribeRepositories
	// 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 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 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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeRepositoriesRequest

func (DescribeRepositoriesInput) GoString 

func (s DescribeRepositoriesInput) GoString() string

GoString returns the string representation

func (*DescribeRepositoriesInput) SetMaxResults 

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

SetMaxResults sets the MaxResults field's value.

func (*DescribeRepositoriesInput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*DescribeRepositoriesInput) SetRepositoryNames 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/DescribeRepositoriesResponse

func (DescribeRepositoriesOutput) GoString 

func (s DescribeRepositoriesOutput) GoString() string

GoString returns the string representation

func (*DescribeRepositoriesOutput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesOutput) SetRepositories 

func (s *DescribeRepositoriesOutput) SetRepositories(v []*Repository) *DescribeRepositoriesOutput

SetRepositories sets the Repositories field's value.

func (DescribeRepositoriesOutput) String 

func (s DescribeRepositoriesOutput) String() 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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See BatchCheckLayerAvailability for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchCheckLayerAvailability method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) BatchCheckLayerAvailabilityWithContext 

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See BatchDeleteImage for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchDeleteImage method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) BatchDeleteImageWithContext 

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See BatchGetImage for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchGetImage method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) BatchGetImageWithContext 

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.

Inform Amazon ECR that the image layer upload for a specified registry, repository name, and upload ID, has completed. 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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See CompleteLayerUpload for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CompleteLayerUpload method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) CompleteLayerUploadWithContext 

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.

  • 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 (http://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon EC2 Container Registry User Guide.

Please also see 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.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 can be used to capture response data after the request's "Send" method is called.

See CreateRepository for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateRepository method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) CreateRepositoryWithContext 

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) 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.

Please also see 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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See DeleteRepositoryPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteRepositoryPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) DeleteRepositoryPolicyWithContext 

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 can be used to capture response data after the request's "Send" method is called.

See DeleteRepository for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteRepository method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) DeleteRepositoryWithContext 

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 

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.

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

func (*ECR) DescribeImagesPages 

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 *DescribeImagesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) DescribeImagesPagesWithContext 

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 

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 can be used to capture response data after the request's "Send" method is called.

See DescribeImages for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeImages method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) DescribeImagesWithContext 

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.

Please also see 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 

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 *DescribeRepositoriesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) DescribeRepositoriesPagesWithContext 

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 can be used to capture response data after the request's "Send" method is called.

See DescribeRepositories for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeRepositories method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) DescribeRepositoriesWithContext 

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See GetAuthorizationToken for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetAuthorizationToken method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) GetAuthorizationTokenWithContext 

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See GetDownloadUrlForLayer for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetDownloadUrlForLayer method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) GetDownloadUrlForLayerWithContext 

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) 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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See GetRepositoryPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetRepositoryPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) GetRepositoryPolicyWithContext 

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See InitiateLayerUpload for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the InitiateLayerUpload method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) InitiateLayerUploadWithContext 

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.

Please also see 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 

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 *ListImagesOutput, lastPage bool) bool {
        pageNum++
        fmt.Println(page)
        return pageNum <= 3
    })

func (*ECR) ListImagesPagesWithContext 

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 can be used to capture response data after the request's "Send" method is called.

See ListImages for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListImages method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) ListImagesWithContext 

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) 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 are no changes to the manifest or image tag since 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 (http://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon EC2 Container Registry User Guide.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See PutImage for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutImage method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) PutImageWithContext 

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) 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.

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.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See SetRepositoryPolicy for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the SetRepositoryPolicy method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) SetRepositoryPolicyWithContext 

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) 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 (http://docs.aws.amazon.com/AmazonECR/latest/userguide/service_limits.html) in the Amazon EC2 Container Registry User Guide.

Please also see 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 can be used to capture response data after the request's "Send" method is called.

See UploadLayerPart for usage and error information.

Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UploadLayerPart method directly instead.

Note: You must call the "Send" method on the returned request object in order to execute the request. 

// 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)
}

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

func (*ECR) UploadLayerPartWithContext 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAuthorizationTokenRequest

func (GetAuthorizationTokenInput) GoString 

func (s GetAuthorizationTokenInput) GoString() string

GoString returns the string representation

func (*GetAuthorizationTokenInput) SetRegistryIds 

func (s *GetAuthorizationTokenInput) SetRegistryIds(v []*string) *GetAuthorizationTokenInput

SetRegistryIds sets the RegistryIds field's value.

func (GetAuthorizationTokenInput) String 

func (s GetAuthorizationTokenInput) String() string

String returns the string representation

func (*GetAuthorizationTokenInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetAuthorizationTokenResponse

func (GetAuthorizationTokenOutput) GoString 

func (s GetAuthorizationTokenOutput) GoString() string

GoString returns the string representation

func (*GetAuthorizationTokenOutput) SetAuthorizationData 

func (s *GetAuthorizationTokenOutput) SetAuthorizationData(v []*AuthorizationData) *GetAuthorizationTokenOutput

SetAuthorizationData sets the AuthorizationData field's value.

func (GetAuthorizationTokenOutput) String 

func (s GetAuthorizationTokenOutput) String() 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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetDownloadUrlForLayerRequest

func (GetDownloadUrlForLayerInput) GoString 

func (s GetDownloadUrlForLayerInput) GoString() string

GoString returns the string representation

func (*GetDownloadUrlForLayerInput) SetLayerDigest 

func (s *GetDownloadUrlForLayerInput) SetLayerDigest(v string) *GetDownloadUrlForLayerInput

SetLayerDigest sets the LayerDigest field's value.

func (*GetDownloadUrlForLayerInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*GetDownloadUrlForLayerInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (GetDownloadUrlForLayerInput) String 

func (s GetDownloadUrlForLayerInput) String() string

String returns the string representation

func (*GetDownloadUrlForLayerInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetDownloadUrlForLayerResponse

func (GetDownloadUrlForLayerOutput) GoString 

func (s GetDownloadUrlForLayerOutput) GoString() string

GoString returns the string representation

func (*GetDownloadUrlForLayerOutput) SetDownloadUrl 

func (s *GetDownloadUrlForLayerOutput) SetDownloadUrl(v string) *GetDownloadUrlForLayerOutput

SetDownloadUrl sets the DownloadUrl field's value.

func (*GetDownloadUrlForLayerOutput) SetLayerDigest 

func (s *GetDownloadUrlForLayerOutput) SetLayerDigest(v string) *GetDownloadUrlForLayerOutput

SetLayerDigest sets the LayerDigest field's value.

func (GetDownloadUrlForLayerOutput) String 

func (s GetDownloadUrlForLayerOutput) String() string

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 whose policy you want to retrieve.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetRepositoryPolicyRequest

func (GetRepositoryPolicyInput) GoString 

func (s GetRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*GetRepositoryPolicyInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*GetRepositoryPolicyInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/GetRepositoryPolicyResponse

func (GetRepositoryPolicyOutput) GoString 

func (s GetRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*GetRepositoryPolicyOutput) SetPolicyText 

func (s *GetRepositoryPolicyOutput) SetPolicyText(v string) *GetRepositoryPolicyOutput

SetPolicyText sets the PolicyText field's value.

func (*GetRepositoryPolicyOutput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*GetRepositoryPolicyOutput) SetRepositoryName 

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

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/Image

func (Image) GoString 

func (s Image) GoString() string

GoString returns the string representation

func (*Image) SetImageId 

func (s *Image) SetImageId(v *ImageIdentifier) *Image

SetImageId sets the ImageId field's value.

func (*Image) SetImageManifest 

func (s *Image) SetImageManifest(v string) *Image

SetImageManifest sets the ImageManifest field's value.

func (*Image) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*Image) SetRepositoryName 

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 

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" timestampFormat:"unix"`

	// 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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ImageDetail

func (ImageDetail) GoString 

func (s ImageDetail) GoString() string

GoString returns the string representation

func (*ImageDetail) SetImageDigest 

func (s *ImageDetail) SetImageDigest(v string) *ImageDetail

SetImageDigest sets the ImageDigest field's value.

func (*ImageDetail) SetImagePushedAt 

func (s *ImageDetail) SetImagePushedAt(v time.Time) *ImageDetail

SetImagePushedAt sets the ImagePushedAt field's value.

func (*ImageDetail) SetImageSizeInBytes 

func (s *ImageDetail) SetImageSizeInBytes(v int64) *ImageDetail

SetImageSizeInBytes sets the ImageSizeInBytes field's value.

func (*ImageDetail) SetImageTags 

func (s *ImageDetail) SetImageTags(v []*string) *ImageDetail

SetImageTags sets the ImageTags field's value.

func (*ImageDetail) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*ImageDetail) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (ImageDetail) String 

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ImageFailure

func (ImageFailure) GoString 

func (s ImageFailure) GoString() string

GoString returns the string representation

func (*ImageFailure) SetFailureCode 

func (s *ImageFailure) SetFailureCode(v string) *ImageFailure

SetFailureCode sets the FailureCode field's value.

func (*ImageFailure) SetFailureReason 

func (s *ImageFailure) SetFailureReason(v string) *ImageFailure

SetFailureReason sets the FailureReason field's value.

func (*ImageFailure) SetImageId 

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" type:"string"`
	// contains filtered or unexported fields
}

An object with identifying information for an Amazon ECR image. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ImageIdentifier

func (ImageIdentifier) GoString 

func (s ImageIdentifier) GoString() string

GoString returns the string representation

func (*ImageIdentifier) SetImageDigest 

func (s *ImageIdentifier) SetImageDigest(v string) *ImageIdentifier

SetImageDigest sets the ImageDigest field's value.

func (*ImageIdentifier) SetImageTag 

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

type InitiateLayerUploadInput 

type InitiateLayerUploadInput struct {

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

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

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/InitiateLayerUploadRequest

func (InitiateLayerUploadInput) GoString 

func (s InitiateLayerUploadInput) GoString() string

GoString returns the string representation

func (*InitiateLayerUploadInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*InitiateLayerUploadInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/InitiateLayerUploadResponse

func (InitiateLayerUploadOutput) GoString 

func (s InitiateLayerUploadOutput) GoString() string

GoString returns the string representation

func (*InitiateLayerUploadOutput) SetPartSize 

func (s *InitiateLayerUploadOutput) SetPartSize(v int64) *InitiateLayerUploadOutput

SetPartSize sets the PartSize field's value.

func (*InitiateLayerUploadOutput) SetUploadId 

func (s *InitiateLayerUploadOutput) SetUploadId(v string) *InitiateLayerUploadOutput

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/Layer

func (Layer) GoString 

func (s Layer) GoString() string

GoString returns the string representation

func (*Layer) SetLayerAvailability 

func (s *Layer) SetLayerAvailability(v string) *Layer

SetLayerAvailability sets the LayerAvailability field's value.

func (*Layer) SetLayerDigest 

func (s *Layer) SetLayerDigest(v string) *Layer

SetLayerDigest sets the LayerDigest field's value.

func (*Layer) SetLayerSize 

func (s *Layer) SetLayerSize(v int64) *Layer

SetLayerSize sets the LayerSize field's value.

func (*Layer) SetMediaType 

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/LayerFailure

func (LayerFailure) GoString 

func (s LayerFailure) GoString() string

GoString returns the string representation

func (*LayerFailure) SetFailureCode 

func (s *LayerFailure) SetFailureCode(v string) *LayerFailure

SetFailureCode sets the FailureCode field's value.

func (*LayerFailure) SetFailureReason 

func (s *LayerFailure) SetFailureReason(v string) *LayerFailure

SetFailureReason sets the FailureReason field's value.

func (*LayerFailure) SetLayerDigest 

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 ListImagesFilter 

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. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListImagesFilter

func (ListImagesFilter) GoString 

func (s ListImagesFilter) GoString() string

GoString returns the string representation

func (*ListImagesFilter) SetTagStatus 

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

SetTagStatus sets the TagStatus field's value.

func (ListImagesFilter) String 

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 100. 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
	// to list images in. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The repository whose image IDs are to be listed.
	//
	// RepositoryName is a required field
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"`
	// contains filtered or unexported fields
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListImagesRequest

func (ListImagesInput) GoString 

func (s ListImagesInput) GoString() string

GoString returns the string representation

func (*ListImagesInput) SetFilter 

func (s *ListImagesInput) SetFilter(v *ListImagesFilter) *ListImagesInput

SetFilter sets the Filter field's value.

func (*ListImagesInput) SetMaxResults 

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

SetMaxResults sets the MaxResults field's value.

func (*ListImagesInput) SetNextToken 

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

SetNextToken sets the NextToken field's value.

func (*ListImagesInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*ListImagesInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/ListImagesResponse

func (ListImagesOutput) GoString 

func (s ListImagesOutput) GoString() string

GoString returns the string representation

func (*ListImagesOutput) SetImageIds 

func (s *ListImagesOutput) SetImageIds(v []*ImageIdentifier) *ListImagesOutput

SetImageIds sets the ImageIds field's value.

func (*ListImagesOutput) SetNextToken 

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 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" 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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageRequest

func (PutImageInput) GoString 

func (s PutImageInput) GoString() string

GoString returns the string representation

func (*PutImageInput) SetImageManifest 

func (s *PutImageInput) SetImageManifest(v string) *PutImageInput

SetImageManifest sets the ImageManifest field's value.

func (*PutImageInput) SetImageTag 

func (s *PutImageInput) SetImageTag(v string) *PutImageInput

SetImageTag sets the ImageTag field's value.

func (*PutImageInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*PutImageInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/PutImageResponse

func (PutImageOutput) GoString 

func (s PutImageOutput) GoString() string

GoString returns the string representation

func (*PutImageOutput) SetImage 

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 Repository 

type Repository struct {

	// The date and time, in JavaScript date/time format, when the repository was
	// created.
	CreatedAt *time.Time `locationName:"createdAt" type:"timestamp" timestampFormat:"unix"`

	// 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, the
	// AWS account ID of the repository owner, the repository namespace, and then
	// the 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 and pull
	// operations.
	RepositoryUri *string `locationName:"repositoryUri" type:"string"`
	// contains filtered or unexported fields
}

An object representing a repository. Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/Repository

func (Repository) GoString 

func (s Repository) GoString() string

GoString returns the string representation

func (*Repository) SetCreatedAt 

func (s *Repository) SetCreatedAt(v time.Time) *Repository

SetCreatedAt sets the CreatedAt field's value.

func (*Repository) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*Repository) SetRepositoryArn 

func (s *Repository) SetRepositoryArn(v string) *Repository

SetRepositoryArn sets the RepositoryArn field's value.

func (*Repository) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (*Repository) SetRepositoryUri 

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.
	//
	// 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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/SetRepositoryPolicyRequest

func (SetRepositoryPolicyInput) GoString 

func (s SetRepositoryPolicyInput) GoString() string

GoString returns the string representation

func (*SetRepositoryPolicyInput) SetForce 

func (s *SetRepositoryPolicyInput) SetForce(v bool) *SetRepositoryPolicyInput

SetForce sets the Force field's value.

func (*SetRepositoryPolicyInput) SetPolicyText 

func (s *SetRepositoryPolicyInput) SetPolicyText(v string) *SetRepositoryPolicyInput

SetPolicyText sets the PolicyText field's value.

func (*SetRepositoryPolicyInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*SetRepositoryPolicyInput) SetRepositoryName 

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 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/SetRepositoryPolicyResponse

func (SetRepositoryPolicyOutput) GoString 

func (s SetRepositoryPolicyOutput) GoString() string

GoString returns the string representation

func (*SetRepositoryPolicyOutput) SetPolicyText 

func (s *SetRepositoryPolicyOutput) SetPolicyText(v string) *SetRepositoryPolicyOutput

SetPolicyText sets the PolicyText field's value.

func (*SetRepositoryPolicyOutput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*SetRepositoryPolicyOutput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (SetRepositoryPolicyOutput) String 

func (s SetRepositoryPolicyOutput) 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 that you are uploading layer
	// parts to. If you do not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The name of the repository that you are uploading layer parts to.
	//
	// 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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UploadLayerPartRequest

func (UploadLayerPartInput) GoString 

func (s UploadLayerPartInput) GoString() string

GoString returns the string representation

func (*UploadLayerPartInput) SetLayerPartBlob 

func (s *UploadLayerPartInput) SetLayerPartBlob(v []byte) *UploadLayerPartInput

SetLayerPartBlob sets the LayerPartBlob field's value.

func (*UploadLayerPartInput) SetPartFirstByte 

func (s *UploadLayerPartInput) SetPartFirstByte(v int64) *UploadLayerPartInput

SetPartFirstByte sets the PartFirstByte field's value.

func (*UploadLayerPartInput) SetPartLastByte 

func (s *UploadLayerPartInput) SetPartLastByte(v int64) *UploadLayerPartInput

SetPartLastByte sets the PartLastByte field's value.

func (*UploadLayerPartInput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*UploadLayerPartInput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (*UploadLayerPartInput) SetUploadId 

func (s *UploadLayerPartInput) SetUploadId(v string) *UploadLayerPartInput

SetUploadId sets the UploadId field's value.

func (UploadLayerPartInput) String 

func (s UploadLayerPartInput) String() string

String returns the string representation

func (*UploadLayerPartInput) Validate 

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
}

Please also see https://docs.aws.amazon.com/goto/WebAPI/ecr-2015-09-21/UploadLayerPartResponse

func (UploadLayerPartOutput) GoString 

func (s UploadLayerPartOutput) GoString() string

GoString returns the string representation

func (*UploadLayerPartOutput) SetLastByteReceived 

func (s *UploadLayerPartOutput) SetLastByteReceived(v int64) *UploadLayerPartOutput

SetLastByteReceived sets the LastByteReceived field's value.

func (*UploadLayerPartOutput) SetRegistryId 

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

SetRegistryId sets the RegistryId field's value.

func (*UploadLayerPartOutput) SetRepositoryName 

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

SetRepositoryName sets the RepositoryName field's value.

func (*UploadLayerPartOutput) SetUploadId 

func (s *UploadLayerPartOutput) SetUploadId(v string) *UploadLayerPartOutput

SetUploadId sets the UploadId field's value.

func (UploadLayerPartOutput) String 

func (s UploadLayerPartOutput) String() string

String returns the string representation

Source Files

View all Source files

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
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.