ecr

package
Version: v1.44.192 Latest Latest
Warning

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

Go to latest
Published: Feb 1, 2023 License: Apache-2.0 Imports: 10 Imported by: 713

Documentation

Overview

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

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

Amazon ECR has service endpoints in each supported Region. For more information, see Amazon ECR endpoints (https://docs.aws.amazon.com/general/latest/gr/ecr.html) in the Amazon Web Services General Reference.

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

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

Using the Client

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

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

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

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

Index

Examples

Constants

View Source
const (
	// EncryptionTypeAes256 is a EncryptionType enum value
	EncryptionTypeAes256 = "AES256"

	// EncryptionTypeKms is a EncryptionType enum value
	EncryptionTypeKms = "KMS"
)
View Source
const (
	// FindingSeverityInformational is a FindingSeverity enum value
	FindingSeverityInformational = "INFORMATIONAL"

	// FindingSeverityLow is a FindingSeverity enum value
	FindingSeverityLow = "LOW"

	// FindingSeverityMedium is a FindingSeverity enum value
	FindingSeverityMedium = "MEDIUM"

	// FindingSeverityHigh is a FindingSeverity enum value
	FindingSeverityHigh = "HIGH"

	// FindingSeverityCritical is a FindingSeverity enum value
	FindingSeverityCritical = "CRITICAL"

	// FindingSeverityUndefined is a FindingSeverity enum value
	FindingSeverityUndefined = "UNDEFINED"
)
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"

	// ImageFailureCodeImageReferencedByManifestList is a ImageFailureCode enum value
	ImageFailureCodeImageReferencedByManifestList = "ImageReferencedByManifestList"

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

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

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

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

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

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

	// LifecyclePolicyPreviewStatusFailed is a LifecyclePolicyPreviewStatus enum value
	LifecyclePolicyPreviewStatusFailed = "FAILED"
)
View Source
const (
	// ReplicationStatusInProgress is a ReplicationStatus enum value
	ReplicationStatusInProgress = "IN_PROGRESS"

	// ReplicationStatusComplete is a ReplicationStatus enum value
	ReplicationStatusComplete = "COMPLETE"

	// ReplicationStatusFailed is a ReplicationStatus enum value
	ReplicationStatusFailed = "FAILED"
)
View Source
const (
	// ScanFrequencyScanOnPush is a ScanFrequency enum value
	ScanFrequencyScanOnPush = "SCAN_ON_PUSH"

	// ScanFrequencyContinuousScan is a ScanFrequency enum value
	ScanFrequencyContinuousScan = "CONTINUOUS_SCAN"

	// ScanFrequencyManual is a ScanFrequency enum value
	ScanFrequencyManual = "MANUAL"
)
View Source
const (
	// ScanStatusInProgress is a ScanStatus enum value
	ScanStatusInProgress = "IN_PROGRESS"

	// ScanStatusComplete is a ScanStatus enum value
	ScanStatusComplete = "COMPLETE"

	// ScanStatusFailed is a ScanStatus enum value
	ScanStatusFailed = "FAILED"

	// ScanStatusUnsupportedImage is a ScanStatus enum value
	ScanStatusUnsupportedImage = "UNSUPPORTED_IMAGE"

	// ScanStatusActive is a ScanStatus enum value
	ScanStatusActive = "ACTIVE"

	// ScanStatusPending is a ScanStatus enum value
	ScanStatusPending = "PENDING"

	// ScanStatusScanEligibilityExpired is a ScanStatus enum value
	ScanStatusScanEligibilityExpired = "SCAN_ELIGIBILITY_EXPIRED"

	// ScanStatusFindingsUnavailable is a ScanStatus enum value
	ScanStatusFindingsUnavailable = "FINDINGS_UNAVAILABLE"
)
View Source
const (
	// ScanTypeBasic is a ScanType enum value
	ScanTypeBasic = "BASIC"

	// ScanTypeEnhanced is a ScanType enum value
	ScanTypeEnhanced = "ENHANCED"
)
View Source
const (
	// TagStatusTagged is a TagStatus enum value
	TagStatusTagged = "TAGGED"

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

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

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

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

	// ErrCodeImageDigestDoesNotMatchException for service response error code
	// "ImageDigestDoesNotMatchException".
	//
	// The specified image digest does not match the digest that Amazon ECR calculated
	// for the image.
	ErrCodeImageDigestDoesNotMatchException = "ImageDigestDoesNotMatchException"

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

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

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

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

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

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

	// ErrCodeKmsException for service response error code
	// "KmsException".
	//
	// The operation failed due to a KMS exception.
	ErrCodeKmsException = "KmsException"

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

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

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

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

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

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

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

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

	// ErrCodePullThroughCacheRuleAlreadyExistsException for service response error code
	// "PullThroughCacheRuleAlreadyExistsException".
	//
	// A pull through cache rule with these settings already exists for the private
	// registry.
	ErrCodePullThroughCacheRuleAlreadyExistsException = "PullThroughCacheRuleAlreadyExistsException"

	// ErrCodePullThroughCacheRuleNotFoundException for service response error code
	// "PullThroughCacheRuleNotFoundException".
	//
	// The pull through cache rule was not found. Specify a valid pull through cache
	// rule and try again.
	ErrCodePullThroughCacheRuleNotFoundException = "PullThroughCacheRuleNotFoundException"

	// ErrCodeReferencedImagesNotFoundException for service response error code
	// "ReferencedImagesNotFoundException".
	//
	// The manifest list is referencing an image that does not exist.
	ErrCodeReferencedImagesNotFoundException = "ReferencedImagesNotFoundException"

	// ErrCodeRegistryPolicyNotFoundException for service response error code
	// "RegistryPolicyNotFoundException".
	//
	// The registry doesn't have an associated registry policy.
	ErrCodeRegistryPolicyNotFoundException = "RegistryPolicyNotFoundException"

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

	// ErrCodeScanNotFoundException for service response error code
	// "ScanNotFoundException".
	//
	// The specified image scan could not be found. Ensure that image scanning is
	// enabled on the repository and try again.
	ErrCodeScanNotFoundException = "ScanNotFoundException"

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

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

	// ErrCodeUnsupportedImageTypeException for service response error code
	// "UnsupportedImageTypeException".
	//
	// The image is of a type that cannot be scanned.
	ErrCodeUnsupportedImageTypeException = "UnsupportedImageTypeException"

	// ErrCodeUnsupportedUpstreamRegistryException for service response error code
	// "UnsupportedUpstreamRegistryException".
	//
	// The specified upstream registry isn't supported.
	ErrCodeUnsupportedUpstreamRegistryException = "UnsupportedUpstreamRegistryException"

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

	// ErrCodeValidationException for service response error code
	// "ValidationException".
	//
	// There was an exception validating this request.
	ErrCodeValidationException = "ValidationException"
)
View Source
const (
	ServiceName = "ecr"     // Name of service.
	EndpointsID = "api.ecr" // ID to lookup a service endpoint with.
	ServiceID   = "ECR"     // ServiceID is a unique identifier of a specific service.
)

Service information constants

View Source
const (
	// ImageActionTypeExpire is a ImageActionType enum value
	ImageActionTypeExpire = "EXPIRE"
)
View Source
const (
	// RepositoryFilterTypePrefixMatch is a RepositoryFilterType enum value
	RepositoryFilterTypePrefixMatch = "PREFIX_MATCH"
)
View Source
const (
	// ScanningConfigurationFailureCodeRepositoryNotFound is a ScanningConfigurationFailureCode enum value
	ScanningConfigurationFailureCodeRepositoryNotFound = "REPOSITORY_NOT_FOUND"
)
View Source
const (
	// ScanningRepositoryFilterTypeWildcard is a ScanningRepositoryFilterType enum value
	ScanningRepositoryFilterTypeWildcard = "WILDCARD"
)

Variables

This section is empty.

Functions

func EncryptionType_Values added in v1.34.3

func EncryptionType_Values() []string

EncryptionType_Values returns all elements of the EncryptionType enum

func FindingSeverity_Values added in v1.34.3

func FindingSeverity_Values() []string

FindingSeverity_Values returns all elements of the FindingSeverity enum

func ImageActionType_Values added in v1.34.3

func ImageActionType_Values() []string

ImageActionType_Values returns all elements of the ImageActionType enum

func ImageFailureCode_Values added in v1.34.3

func ImageFailureCode_Values() []string

ImageFailureCode_Values returns all elements of the ImageFailureCode enum

func ImageTagMutability_Values added in v1.34.3

func ImageTagMutability_Values() []string

ImageTagMutability_Values returns all elements of the ImageTagMutability enum

func LayerAvailability_Values added in v1.34.3

func LayerAvailability_Values() []string

LayerAvailability_Values returns all elements of the LayerAvailability enum

func LayerFailureCode_Values added in v1.34.3

func LayerFailureCode_Values() []string

LayerFailureCode_Values returns all elements of the LayerFailureCode enum

func LifecyclePolicyPreviewStatus_Values added in v1.34.3

func LifecyclePolicyPreviewStatus_Values() []string

LifecyclePolicyPreviewStatus_Values returns all elements of the LifecyclePolicyPreviewStatus enum

func ReplicationStatus_Values added in v1.40.46

func ReplicationStatus_Values() []string

ReplicationStatus_Values returns all elements of the ReplicationStatus enum

func RepositoryFilterType_Values added in v1.40.46

func RepositoryFilterType_Values() []string

RepositoryFilterType_Values returns all elements of the RepositoryFilterType enum

func ScanFrequency_Values added in v1.42.15

func ScanFrequency_Values() []string

ScanFrequency_Values returns all elements of the ScanFrequency enum

func ScanStatus_Values added in v1.34.3

func ScanStatus_Values() []string

ScanStatus_Values returns all elements of the ScanStatus enum

func ScanType_Values added in v1.42.15

func ScanType_Values() []string

ScanType_Values returns all elements of the ScanType enum

func ScanningConfigurationFailureCode_Values added in v1.42.15

func ScanningConfigurationFailureCode_Values() []string

ScanningConfigurationFailureCode_Values returns all elements of the ScanningConfigurationFailureCode enum

func ScanningRepositoryFilterType_Values added in v1.42.15

func ScanningRepositoryFilterType_Values() []string

ScanningRepositoryFilterType_Values returns all elements of the ScanningRepositoryFilterType enum

func TagStatus_Values added in v1.34.3

func TagStatus_Values() []string

TagStatus_Values returns all elements of the TagStatus enum

Types

type Attribute added in v1.25.20

type Attribute struct {

	// The attribute key.
	//
	// Key is a required field
	Key *string `locationName:"key" min:"1" type:"string" required:"true"`

	// The value assigned to the attribute key.
	Value *string `locationName:"value" min:"1" type:"string"`
	// contains filtered or unexported fields
}

This data type is used in the ImageScanFinding data type.

func (Attribute) GoString added in v1.25.20

func (s Attribute) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*Attribute) SetKey added in v1.25.20

func (s *Attribute) SetKey(v string) *Attribute

SetKey sets the Key field's value.

func (*Attribute) SetValue added in v1.25.20

func (s *Attribute) SetValue(v string) *Attribute

SetValue sets the Value field's value.

func (Attribute) String added in v1.25.20

func (s Attribute) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type AuthorizationData

type AuthorizationData struct {

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

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

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

An object representing authorization data for an Amazon ECR registry.

func (AuthorizationData) GoString

func (s AuthorizationData) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AuthorizationData) SetAuthorizationToken added in v1.5.0

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

SetAuthorizationToken sets the AuthorizationToken field's value.

func (*AuthorizationData) SetExpiresAt added in v1.5.0

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

SetExpiresAt sets the ExpiresAt field's value.

func (*AuthorizationData) SetProxyEndpoint added in v1.5.0

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

SetProxyEndpoint sets the ProxyEndpoint field's value.

func (AuthorizationData) String

func (s AuthorizationData) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type AwsEcrContainerImageDetails added in v1.42.15

type AwsEcrContainerImageDetails struct {

	// The architecture of the Amazon ECR container image.
	Architecture *string `locationName:"architecture" type:"string"`

	// The image author of the Amazon ECR container image.
	Author *string `locationName:"author" type:"string"`

	// The image hash of the Amazon ECR container image.
	ImageHash *string `locationName:"imageHash" type:"string"`

	// The image tags attached to the Amazon ECR container image.
	ImageTags []*string `locationName:"imageTags" type:"list"`

	// The platform of the Amazon ECR container image.
	Platform *string `locationName:"platform" type:"string"`

	// The date and time the Amazon ECR container image was pushed.
	PushedAt *time.Time `locationName:"pushedAt" type:"timestamp"`

	// The registry the Amazon ECR container image belongs to.
	Registry *string `locationName:"registry" type:"string"`

	// The name of the repository the Amazon ECR container image resides in.
	RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"`
	// contains filtered or unexported fields
}

The image details of the Amazon ECR container image.

func (AwsEcrContainerImageDetails) GoString added in v1.42.15

func (s AwsEcrContainerImageDetails) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*AwsEcrContainerImageDetails) SetArchitecture added in v1.42.15

SetArchitecture sets the Architecture field's value.

func (*AwsEcrContainerImageDetails) SetAuthor added in v1.42.15

SetAuthor sets the Author field's value.

func (*AwsEcrContainerImageDetails) SetImageHash added in v1.42.15

SetImageHash sets the ImageHash field's value.

func (*AwsEcrContainerImageDetails) SetImageTags added in v1.42.15

SetImageTags sets the ImageTags field's value.

func (*AwsEcrContainerImageDetails) SetPlatform added in v1.42.15

SetPlatform sets the Platform field's value.

func (*AwsEcrContainerImageDetails) SetPushedAt added in v1.42.15

SetPushedAt sets the PushedAt field's value.

func (*AwsEcrContainerImageDetails) SetRegistry added in v1.42.15

SetRegistry sets the Registry field's value.

func (*AwsEcrContainerImageDetails) SetRepositoryName added in v1.42.15

SetRepositoryName sets the RepositoryName field's value.

func (AwsEcrContainerImageDetails) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

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 Amazon Web Services account ID associated with the registry that contains
	// the image layers to check. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

func (BatchCheckLayerAvailabilityInput) GoString

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchCheckLayerAvailabilityInput) SetLayerDigests added in v1.5.0

SetLayerDigests sets the LayerDigests field's value.

func (*BatchCheckLayerAvailabilityInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*BatchCheckLayerAvailabilityInput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (BatchCheckLayerAvailabilityInput) String

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchCheckLayerAvailabilityInput) Validate added in v1.1.21

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

type BatchCheckLayerAvailabilityOutput

type BatchCheckLayerAvailabilityOutput struct {

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

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

func (BatchCheckLayerAvailabilityOutput) GoString

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchCheckLayerAvailabilityOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchCheckLayerAvailabilityOutput) SetLayers added in v1.5.0

SetLayers sets the Layers field's value.

func (BatchCheckLayerAvailabilityOutput) String

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

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 Amazon Web Services account ID associated with the registry that contains
	// the image to delete. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

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

func (BatchDeleteImageInput) GoString

func (s BatchDeleteImageInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchDeleteImageInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*BatchDeleteImageInput) SetRegistryId added in v1.5.0

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

SetRegistryId sets the RegistryId field's value.

func (*BatchDeleteImageInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (BatchDeleteImageInput) String

func (s BatchDeleteImageInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchDeleteImageInput) Validate added in v1.1.21

func (s *BatchDeleteImageInput) Validate() error

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

type BatchDeleteImageOutput

type BatchDeleteImageOutput struct {

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

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

func (BatchDeleteImageOutput) GoString

func (s BatchDeleteImageOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchDeleteImageOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchDeleteImageOutput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (BatchDeleteImageOutput) String

func (s BatchDeleteImageOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

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 Amazon Web Services account ID associated with the registry that contains
	// the images to describe. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

func (BatchGetImageInput) GoString

func (s BatchGetImageInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetImageInput) SetAcceptedMediaTypes added in v1.6.7

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

SetAcceptedMediaTypes sets the AcceptedMediaTypes field's value.

func (*BatchGetImageInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*BatchGetImageInput) SetRegistryId added in v1.5.0

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

SetRegistryId sets the RegistryId field's value.

func (*BatchGetImageInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (BatchGetImageInput) String

func (s BatchGetImageInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetImageInput) Validate added in v1.1.21

func (s *BatchGetImageInput) Validate() error

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

type BatchGetImageOutput

type BatchGetImageOutput struct {

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

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

func (BatchGetImageOutput) GoString

func (s BatchGetImageOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetImageOutput) SetFailures added in v1.5.0

SetFailures sets the Failures field's value.

func (*BatchGetImageOutput) SetImages added in v1.5.0

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

SetImages sets the Images field's value.

func (BatchGetImageOutput) String

func (s BatchGetImageOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type BatchGetRepositoryScanningConfigurationInput added in v1.42.15

type BatchGetRepositoryScanningConfigurationInput struct {

	// One or more repository names to get the scanning configuration for.
	//
	// RepositoryNames is a required field
	RepositoryNames []*string `locationName:"repositoryNames" min:"1" type:"list" required:"true"`
	// contains filtered or unexported fields
}

func (BatchGetRepositoryScanningConfigurationInput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetRepositoryScanningConfigurationInput) SetRepositoryNames added in v1.42.15

SetRepositoryNames sets the RepositoryNames field's value.

func (BatchGetRepositoryScanningConfigurationInput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetRepositoryScanningConfigurationInput) Validate added in v1.42.15

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

type BatchGetRepositoryScanningConfigurationOutput added in v1.42.15

type BatchGetRepositoryScanningConfigurationOutput struct {

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

	// The scanning configuration for the requested repositories.
	ScanningConfigurations []*RepositoryScanningConfiguration `locationName:"scanningConfigurations" type:"list"`
	// contains filtered or unexported fields
}

func (BatchGetRepositoryScanningConfigurationOutput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*BatchGetRepositoryScanningConfigurationOutput) SetFailures added in v1.42.15

SetFailures sets the Failures field's value.

func (*BatchGetRepositoryScanningConfigurationOutput) SetScanningConfigurations added in v1.42.15

SetScanningConfigurations sets the ScanningConfigurations field's value.

func (BatchGetRepositoryScanningConfigurationOutput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

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 Amazon Web Services account ID associated with the registry to which
	// to upload layers. If you do not specify a registry, the default registry
	// is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

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

func (CompleteLayerUploadInput) GoString

func (s CompleteLayerUploadInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CompleteLayerUploadInput) SetLayerDigests added in v1.5.0

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

SetLayerDigests sets the LayerDigests field's value.

func (*CompleteLayerUploadInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadInput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (CompleteLayerUploadInput) String

func (s CompleteLayerUploadInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CompleteLayerUploadInput) Validate added in v1.1.21

func (s *CompleteLayerUploadInput) Validate() error

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

type CompleteLayerUploadOutput

type CompleteLayerUploadOutput struct {

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

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

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

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

func (CompleteLayerUploadOutput) GoString

func (s CompleteLayerUploadOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CompleteLayerUploadOutput) SetLayerDigest added in v1.5.0

SetLayerDigest sets the LayerDigest field's value.

func (*CompleteLayerUploadOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*CompleteLayerUploadOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (*CompleteLayerUploadOutput) SetUploadId added in v1.5.0

SetUploadId sets the UploadId field's value.

func (CompleteLayerUploadOutput) String

func (s CompleteLayerUploadOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type CreatePullThroughCacheRuleInput added in v1.42.15

type CreatePullThroughCacheRuleInput struct {

	// The repository name prefix to use when caching images from the source registry.
	//
	// EcrRepositoryPrefix is a required field
	EcrRepositoryPrefix *string `locationName:"ecrRepositoryPrefix" min:"2" type:"string" required:"true"`

	// The Amazon Web Services account ID associated with the registry to create
	// the pull through cache rule for. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The registry URL of the upstream public registry to use as the source for
	// the pull through cache rule.
	//
	// UpstreamRegistryUrl is a required field
	UpstreamRegistryUrl *string `locationName:"upstreamRegistryUrl" type:"string" required:"true"`
	// contains filtered or unexported fields
}

func (CreatePullThroughCacheRuleInput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreatePullThroughCacheRuleInput) SetEcrRepositoryPrefix added in v1.42.15

SetEcrRepositoryPrefix sets the EcrRepositoryPrefix field's value.

func (*CreatePullThroughCacheRuleInput) SetRegistryId added in v1.42.15

SetRegistryId sets the RegistryId field's value.

func (*CreatePullThroughCacheRuleInput) SetUpstreamRegistryUrl added in v1.42.15

SetUpstreamRegistryUrl sets the UpstreamRegistryUrl field's value.

func (CreatePullThroughCacheRuleInput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreatePullThroughCacheRuleInput) Validate added in v1.42.15

func (s *CreatePullThroughCacheRuleInput) Validate() error

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

type CreatePullThroughCacheRuleOutput added in v1.42.15

type CreatePullThroughCacheRuleOutput struct {

	// The date and time, in JavaScript date format, when the pull through cache
	// rule was created.
	CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"`

	// The Amazon ECR repository prefix associated with the pull through cache rule.
	EcrRepositoryPrefix *string `locationName:"ecrRepositoryPrefix" min:"2" type:"string"`

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

	// The upstream registry URL associated with the pull through cache rule.
	UpstreamRegistryUrl *string `locationName:"upstreamRegistryUrl" type:"string"`
	// contains filtered or unexported fields
}

func (CreatePullThroughCacheRuleOutput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreatePullThroughCacheRuleOutput) SetCreatedAt added in v1.42.15

SetCreatedAt sets the CreatedAt field's value.

func (*CreatePullThroughCacheRuleOutput) SetEcrRepositoryPrefix added in v1.42.15

SetEcrRepositoryPrefix sets the EcrRepositoryPrefix field's value.

func (*CreatePullThroughCacheRuleOutput) SetRegistryId added in v1.42.15

SetRegistryId sets the RegistryId field's value.

func (*CreatePullThroughCacheRuleOutput) SetUpstreamRegistryUrl added in v1.42.15

SetUpstreamRegistryUrl sets the UpstreamRegistryUrl field's value.

func (CreatePullThroughCacheRuleOutput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type CreateRepositoryInput

type CreateRepositoryInput struct {

	// The encryption configuration for the repository. This determines how the
	// contents of your repository are encrypted at rest.
	EncryptionConfiguration *EncryptionConfiguration `locationName:"encryptionConfiguration" type:"structure"`

	// The image scanning configuration for the repository. This determines whether
	// images are scanned for known vulnerabilities after being pushed to the repository.
	ImageScanningConfiguration *ImageScanningConfiguration `locationName:"imageScanningConfiguration" type:"structure"`

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

	// The Amazon Web Services account ID associated with the registry to create
	// the repository. If you do not specify a registry, the default registry is
	// assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

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

func (CreateRepositoryInput) GoString

func (s CreateRepositoryInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreateRepositoryInput) SetEncryptionConfiguration added in v1.33.15

func (s *CreateRepositoryInput) SetEncryptionConfiguration(v *EncryptionConfiguration) *CreateRepositoryInput

SetEncryptionConfiguration sets the EncryptionConfiguration field's value.

func (*CreateRepositoryInput) SetImageScanningConfiguration added in v1.25.20

func (s *CreateRepositoryInput) SetImageScanningConfiguration(v *ImageScanningConfiguration) *CreateRepositoryInput

SetImageScanningConfiguration sets the ImageScanningConfiguration field's value.

func (*CreateRepositoryInput) SetImageTagMutability added in v1.21.5

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

SetImageTagMutability sets the ImageTagMutability field's value.

func (*CreateRepositoryInput) SetRegistryId added in v1.40.46

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

SetRegistryId sets the RegistryId field's value.

func (*CreateRepositoryInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (*CreateRepositoryInput) SetTags added in v1.16.7

SetTags sets the Tags field's value.

func (CreateRepositoryInput) String

func (s CreateRepositoryInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreateRepositoryInput) Validate added in v1.1.21

func (s *CreateRepositoryInput) Validate() error

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

type CreateRepositoryOutput

type CreateRepositoryOutput struct {

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

func (CreateRepositoryOutput) GoString

func (s CreateRepositoryOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CreateRepositoryOutput) SetRepository added in v1.5.0

SetRepository sets the Repository field's value.

func (CreateRepositoryOutput) String

func (s CreateRepositoryOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type CvssScore added in v1.42.15

type CvssScore struct {

	// The base CVSS score used for the finding.
	BaseScore *float64 `locationName:"baseScore" type:"double"`

	// The vector string of the CVSS score.
	ScoringVector *string `locationName:"scoringVector" type:"string"`

	// The source of the CVSS score.
	Source *string `locationName:"source" type:"string"`

	// The version of CVSS used for the score.
	Version *string `locationName:"version" type:"string"`
	// contains filtered or unexported fields
}

The CVSS score for a finding.

func (CvssScore) GoString added in v1.42.15

func (s CvssScore) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CvssScore) SetBaseScore added in v1.42.15

func (s *CvssScore) SetBaseScore(v float64) *CvssScore

SetBaseScore sets the BaseScore field's value.

func (*CvssScore) SetScoringVector added in v1.42.15

func (s *CvssScore) SetScoringVector(v string) *CvssScore

SetScoringVector sets the ScoringVector field's value.

func (*CvssScore) SetSource added in v1.42.15

func (s *CvssScore) SetSource(v string) *CvssScore

SetSource sets the Source field's value.

func (*CvssScore) SetVersion added in v1.42.15

func (s *CvssScore) SetVersion(v string) *CvssScore

SetVersion sets the Version field's value.

func (CvssScore) String added in v1.42.15

func (s CvssScore) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type CvssScoreAdjustment added in v1.42.15

type CvssScoreAdjustment struct {

	// The metric used to adjust the CVSS score.
	Metric *string `locationName:"metric" type:"string"`

	// The reason the CVSS score has been adjustment.
	Reason *string `locationName:"reason" type:"string"`
	// contains filtered or unexported fields
}

Details on adjustments Amazon Inspector made to the CVSS score for a finding.

func (CvssScoreAdjustment) GoString added in v1.42.15

func (s CvssScoreAdjustment) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CvssScoreAdjustment) SetMetric added in v1.42.15

SetMetric sets the Metric field's value.

func (*CvssScoreAdjustment) SetReason added in v1.42.15

SetReason sets the Reason field's value.

func (CvssScoreAdjustment) String added in v1.42.15

func (s CvssScoreAdjustment) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type CvssScoreDetails added in v1.42.15

type CvssScoreDetails struct {

	// An object that contains details about adjustment Amazon Inspector made to
	// the CVSS score.
	Adjustments []*CvssScoreAdjustment `locationName:"adjustments" type:"list"`

	// The CVSS score.
	Score *float64 `locationName:"score" type:"double"`

	// The source for the CVSS score.
	ScoreSource *string `locationName:"scoreSource" type:"string"`

	// The vector for the CVSS score.
	ScoringVector *string `locationName:"scoringVector" type:"string"`

	// The CVSS version used in scoring.
	Version *string `locationName:"version" type:"string"`
	// contains filtered or unexported fields
}

Information about the CVSS score.

func (CvssScoreDetails) GoString added in v1.42.15

func (s CvssScoreDetails) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*CvssScoreDetails) SetAdjustments added in v1.42.15

func (s *CvssScoreDetails) SetAdjustments(v []*CvssScoreAdjustment) *CvssScoreDetails

SetAdjustments sets the Adjustments field's value.

func (*CvssScoreDetails) SetScore added in v1.42.15

func (s *CvssScoreDetails) SetScore(v float64) *CvssScoreDetails

SetScore sets the Score field's value.

func (*CvssScoreDetails) SetScoreSource added in v1.42.15

func (s *CvssScoreDetails) SetScoreSource(v string) *CvssScoreDetails

SetScoreSource sets the ScoreSource field's value.

func (*CvssScoreDetails) SetScoringVector added in v1.42.15

func (s *CvssScoreDetails) SetScoringVector(v string) *CvssScoreDetails

SetScoringVector sets the ScoringVector field's value.

func (*CvssScoreDetails) SetVersion added in v1.42.15

func (s *CvssScoreDetails) SetVersion(v string) *CvssScoreDetails

SetVersion sets the Version field's value.

func (CvssScoreDetails) String added in v1.42.15

func (s CvssScoreDetails) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeleteLifecyclePolicyInput added in v1.12.9

type DeleteLifecyclePolicyInput struct {

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

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

func (DeleteLifecyclePolicyInput) GoString added in v1.12.9

func (s DeleteLifecyclePolicyInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteLifecyclePolicyInput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*DeleteLifecyclePolicyInput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (DeleteLifecyclePolicyInput) String added in v1.12.9

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteLifecyclePolicyInput) Validate added in v1.12.9

func (s *DeleteLifecyclePolicyInput) Validate() error

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

type DeleteLifecyclePolicyOutput added in v1.12.9

type DeleteLifecyclePolicyOutput struct {

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

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

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

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

func (DeleteLifecyclePolicyOutput) GoString added in v1.12.9

func (s DeleteLifecyclePolicyOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteLifecyclePolicyOutput) SetLastEvaluatedAt added in v1.12.9

SetLastEvaluatedAt sets the LastEvaluatedAt field's value.

func (*DeleteLifecyclePolicyOutput) SetLifecyclePolicyText added in v1.12.9

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

SetLifecyclePolicyText sets the LifecyclePolicyText field's value.

func (*DeleteLifecyclePolicyOutput) SetRegistryId added in v1.12.9

SetRegistryId sets the RegistryId field's value.

func (*DeleteLifecyclePolicyOutput) SetRepositoryName added in v1.12.9

SetRepositoryName sets the RepositoryName field's value.

func (DeleteLifecyclePolicyOutput) String added in v1.12.9

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeletePullThroughCacheRuleInput added in v1.42.15

type DeletePullThroughCacheRuleInput struct {

	// The Amazon ECR repository prefix associated with the pull through cache rule
	// to delete.
	//
	// EcrRepositoryPrefix is a required field
	EcrRepositoryPrefix *string `locationName:"ecrRepositoryPrefix" min:"2" type:"string" required:"true"`

	// The Amazon Web Services account ID associated with the registry that contains
	// the pull through cache rule. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`
	// contains filtered or unexported fields
}

func (DeletePullThroughCacheRuleInput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeletePullThroughCacheRuleInput) SetEcrRepositoryPrefix added in v1.42.15

SetEcrRepositoryPrefix sets the EcrRepositoryPrefix field's value.

func (*DeletePullThroughCacheRuleInput) SetRegistryId added in v1.42.15

SetRegistryId sets the RegistryId field's value.

func (DeletePullThroughCacheRuleInput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeletePullThroughCacheRuleInput) Validate added in v1.42.15

func (s *DeletePullThroughCacheRuleInput) Validate() error

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

type DeletePullThroughCacheRuleOutput added in v1.42.15

type DeletePullThroughCacheRuleOutput struct {

	// The timestamp associated with the pull through cache rule.
	CreatedAt *time.Time `locationName:"createdAt" type:"timestamp"`

	// The Amazon ECR repository prefix associated with the request.
	EcrRepositoryPrefix *string `locationName:"ecrRepositoryPrefix" min:"2" type:"string"`

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

	// The upstream registry URL associated with the pull through cache rule.
	UpstreamRegistryUrl *string `locationName:"upstreamRegistryUrl" type:"string"`
	// contains filtered or unexported fields
}

func (DeletePullThroughCacheRuleOutput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeletePullThroughCacheRuleOutput) SetCreatedAt added in v1.42.15

SetCreatedAt sets the CreatedAt field's value.

func (*DeletePullThroughCacheRuleOutput) SetEcrRepositoryPrefix added in v1.42.15

SetEcrRepositoryPrefix sets the EcrRepositoryPrefix field's value.

func (*DeletePullThroughCacheRuleOutput) SetRegistryId added in v1.42.15

SetRegistryId sets the RegistryId field's value.

func (*DeletePullThroughCacheRuleOutput) SetUpstreamRegistryUrl added in v1.42.15

SetUpstreamRegistryUrl sets the UpstreamRegistryUrl field's value.

func (DeletePullThroughCacheRuleOutput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeleteRegistryPolicyInput added in v1.36.4

type DeleteRegistryPolicyInput struct {
	// contains filtered or unexported fields
}

func (DeleteRegistryPolicyInput) GoString added in v1.36.4

func (s DeleteRegistryPolicyInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (DeleteRegistryPolicyInput) String added in v1.36.4

func (s DeleteRegistryPolicyInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeleteRegistryPolicyOutput added in v1.36.4

type DeleteRegistryPolicyOutput struct {

	// The contents of the registry permissions policy that was deleted.
	PolicyText *string `locationName:"policyText" type:"string"`

	// The registry ID associated with the request.
	RegistryId *string `locationName:"registryId" type:"string"`
	// contains filtered or unexported fields
}

func (DeleteRegistryPolicyOutput) GoString added in v1.36.4

func (s DeleteRegistryPolicyOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRegistryPolicyOutput) SetPolicyText added in v1.36.4

SetPolicyText sets the PolicyText field's value.

func (*DeleteRegistryPolicyOutput) SetRegistryId added in v1.36.4

SetRegistryId sets the RegistryId field's value.

func (DeleteRegistryPolicyOutput) String added in v1.36.4

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeleteRepositoryInput

type DeleteRepositoryInput struct {

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

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

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

func (DeleteRepositoryInput) GoString

func (s DeleteRepositoryInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryInput) SetForce added in v1.5.0

SetForce sets the Force field's value.

func (*DeleteRepositoryInput) SetRegistryId added in v1.5.0

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

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryInput) String

func (s DeleteRepositoryInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryInput) Validate added in v1.1.21

func (s *DeleteRepositoryInput) Validate() error

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

type DeleteRepositoryOutput

type DeleteRepositoryOutput struct {

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

func (DeleteRepositoryOutput) GoString

func (s DeleteRepositoryOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryOutput) SetRepository added in v1.5.0

SetRepository sets the Repository field's value.

func (DeleteRepositoryOutput) String

func (s DeleteRepositoryOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DeleteRepositoryPolicyInput

type DeleteRepositoryPolicyInput struct {

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

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

func (DeleteRepositoryPolicyInput) GoString

func (s DeleteRepositoryPolicyInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryPolicyInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyInput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyInput) String

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryPolicyInput) Validate added in v1.1.21

func (s *DeleteRepositoryPolicyInput) Validate() error

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

type DeleteRepositoryPolicyOutput

type DeleteRepositoryPolicyOutput struct {

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

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

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

func (DeleteRepositoryPolicyOutput) GoString

func (s DeleteRepositoryPolicyOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DeleteRepositoryPolicyOutput) SetPolicyText added in v1.5.0

SetPolicyText sets the PolicyText field's value.

func (*DeleteRepositoryPolicyOutput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DeleteRepositoryPolicyOutput) SetRepositoryName added in v1.5.0

SetRepositoryName sets the RepositoryName field's value.

func (DeleteRepositoryPolicyOutput) String

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeImageReplicationStatusInput added in v1.40.46

type DescribeImageReplicationStatusInput struct {

	// An object with identifying information for an image in an Amazon ECR repository.
	//
	// ImageId is a required field
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure" required:"true"`

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

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

func (DescribeImageReplicationStatusInput) GoString added in v1.40.46

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageReplicationStatusInput) SetImageId added in v1.40.46

SetImageId sets the ImageId field's value.

func (*DescribeImageReplicationStatusInput) SetRegistryId added in v1.40.46

SetRegistryId sets the RegistryId field's value.

func (*DescribeImageReplicationStatusInput) SetRepositoryName added in v1.40.46

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImageReplicationStatusInput) String added in v1.40.46

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageReplicationStatusInput) Validate added in v1.40.46

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

type DescribeImageReplicationStatusOutput added in v1.40.46

type DescribeImageReplicationStatusOutput struct {

	// An object with identifying information for an image in an Amazon ECR repository.
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure"`

	// The replication status details for the images in the specified repository.
	ReplicationStatuses []*ImageReplicationStatus `locationName:"replicationStatuses" type:"list"`

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

func (DescribeImageReplicationStatusOutput) GoString added in v1.40.46

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageReplicationStatusOutput) SetImageId added in v1.40.46

SetImageId sets the ImageId field's value.

func (*DescribeImageReplicationStatusOutput) SetReplicationStatuses added in v1.40.46

SetReplicationStatuses sets the ReplicationStatuses field's value.

func (*DescribeImageReplicationStatusOutput) SetRepositoryName added in v1.40.46

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImageReplicationStatusOutput) String added in v1.40.46

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeImageScanFindingsInput added in v1.25.20

type DescribeImageScanFindingsInput struct {

	// An object with identifying information for an image in an Amazon ECR repository.
	//
	// ImageId is a required field
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure" required:"true"`

	// The maximum number of image scan results returned by DescribeImageScanFindings
	// in paginated output. When this parameter is used, DescribeImageScanFindings
	// 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 DescribeImageScanFindings request with the returned nextToken value.
	// This value can be between 1 and 1000. If this parameter is not used, then
	// DescribeImageScanFindings 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 DescribeImageScanFindings
	// 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 Amazon Web Services account ID associated with the registry that contains
	// the repository in which to describe the image scan findings for. If you do
	// not specify a registry, the default registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`

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

func (DescribeImageScanFindingsInput) GoString added in v1.25.20

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageScanFindingsInput) SetImageId added in v1.25.20

SetImageId sets the ImageId field's value.

func (*DescribeImageScanFindingsInput) SetMaxResults added in v1.25.20

SetMaxResults sets the MaxResults field's value.

func (*DescribeImageScanFindingsInput) SetNextToken added in v1.25.20

SetNextToken sets the NextToken field's value.

func (*DescribeImageScanFindingsInput) SetRegistryId added in v1.25.20

SetRegistryId sets the RegistryId field's value.

func (*DescribeImageScanFindingsInput) SetRepositoryName added in v1.25.20

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImageScanFindingsInput) String added in v1.25.20

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageScanFindingsInput) Validate added in v1.25.20

func (s *DescribeImageScanFindingsInput) Validate() error

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

type DescribeImageScanFindingsOutput added in v1.25.20

type DescribeImageScanFindingsOutput struct {

	// An object with identifying information for an image in an Amazon ECR repository.
	ImageId *ImageIdentifier `locationName:"imageId" type:"structure"`

	// The information contained in the image scan findings.
	ImageScanFindings *ImageScanFindings `locationName:"imageScanFindings" type:"structure"`

	// The current state of the scan.
	ImageScanStatus *ImageScanStatus `locationName:"imageScanStatus" type:"structure"`

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

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

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

func (DescribeImageScanFindingsOutput) GoString added in v1.25.20

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImageScanFindingsOutput) SetImageId added in v1.25.20

SetImageId sets the ImageId field's value.

func (*DescribeImageScanFindingsOutput) SetImageScanFindings added in v1.25.20

SetImageScanFindings sets the ImageScanFindings field's value.

func (*DescribeImageScanFindingsOutput) SetImageScanStatus added in v1.25.20

SetImageScanStatus sets the ImageScanStatus field's value.

func (*DescribeImageScanFindingsOutput) SetNextToken added in v1.25.20

SetNextToken sets the NextToken field's value.

func (*DescribeImageScanFindingsOutput) SetRegistryId added in v1.25.20

SetRegistryId sets the RegistryId field's value.

func (*DescribeImageScanFindingsOutput) SetRepositoryName added in v1.25.20

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImageScanFindingsOutput) String added in v1.25.20

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeImagesFilter added in v1.4.16

type DescribeImagesFilter struct {

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

An object representing a filter on a DescribeImages operation.

func (DescribeImagesFilter) GoString added in v1.4.16

func (s DescribeImagesFilter) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImagesFilter) SetTagStatus added in v1.5.0

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

SetTagStatus sets the TagStatus field's value.

func (DescribeImagesFilter) String added in v1.4.16

func (s DescribeImagesFilter) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeImagesInput added in v1.4.16

type DescribeImagesInput struct {

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

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

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

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

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

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

func (DescribeImagesInput) GoString added in v1.4.16

func (s DescribeImagesInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImagesInput) SetFilter added in v1.5.0

SetFilter sets the Filter field's value.

func (*DescribeImagesInput) SetImageIds added in v1.5.0

SetImageIds sets the ImageIds field's value.

func (*DescribeImagesInput) SetMaxResults added in v1.5.0

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

SetMaxResults sets the MaxResults field's value.

func (*DescribeImagesInput) SetNextToken added in v1.5.0

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

SetNextToken sets the NextToken field's value.

func (*DescribeImagesInput) SetRegistryId added in v1.5.0

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

SetRegistryId sets the RegistryId field's value.

func (*DescribeImagesInput) SetRepositoryName added in v1.5.0

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

SetRepositoryName sets the RepositoryName field's value.

func (DescribeImagesInput) String added in v1.4.16

func (s DescribeImagesInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImagesInput) Validate added in v1.4.16

func (s *DescribeImagesInput) Validate() error

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

type DescribeImagesOutput added in v1.4.16

type DescribeImagesOutput struct {

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

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

func (DescribeImagesOutput) GoString added in v1.4.16

func (s DescribeImagesOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeImagesOutput) SetImageDetails added in v1.5.0

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

SetImageDetails sets the ImageDetails field's value.

func (*DescribeImagesOutput) SetNextToken added in v1.5.0

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

SetNextToken sets the NextToken field's value.

func (DescribeImagesOutput) String added in v1.4.16

func (s DescribeImagesOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribePullThroughCacheRulesInput added in v1.42.15

type DescribePullThroughCacheRulesInput struct {

	// The Amazon ECR repository prefixes associated with the pull through cache
	// rules to return. If no repository prefix value is specified, all pull through
	// cache rules are returned.
	EcrRepositoryPrefixes []*string `locationName:"ecrRepositoryPrefixes" min:"1" type:"list"`

	// The maximum number of pull through cache rules returned by DescribePullThroughCacheRulesRequest
	// in paginated output. When this parameter is used, DescribePullThroughCacheRulesRequest
	// 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 DescribePullThroughCacheRulesRequest request with the returned nextToken
	// value. This value can be between 1 and 1000. If this parameter is not used,
	// then DescribePullThroughCacheRulesRequest 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 DescribePullThroughCacheRulesRequest
	// 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 Amazon Web Services account ID associated with the registry to return
	// the pull through cache rules for. If you do not specify a registry, the default
	// registry is assumed.
	RegistryId *string `locationName:"registryId" type:"string"`
	// contains filtered or unexported fields
}

func (DescribePullThroughCacheRulesInput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribePullThroughCacheRulesInput) SetEcrRepositoryPrefixes added in v1.42.15

SetEcrRepositoryPrefixes sets the EcrRepositoryPrefixes field's value.

func (*DescribePullThroughCacheRulesInput) SetMaxResults added in v1.42.15

SetMaxResults sets the MaxResults field's value.

func (*DescribePullThroughCacheRulesInput) SetNextToken added in v1.42.15

SetNextToken sets the NextToken field's value.

func (*DescribePullThroughCacheRulesInput) SetRegistryId added in v1.42.15

SetRegistryId sets the RegistryId field's value.

func (DescribePullThroughCacheRulesInput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribePullThroughCacheRulesInput) Validate added in v1.42.15

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

type DescribePullThroughCacheRulesOutput added in v1.42.15

type DescribePullThroughCacheRulesOutput struct {

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

	// The details of the pull through cache rules.
	PullThroughCacheRules []*PullThroughCacheRule `locationName:"pullThroughCacheRules" type:"list"`
	// contains filtered or unexported fields
}

func (DescribePullThroughCacheRulesOutput) GoString added in v1.42.15

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribePullThroughCacheRulesOutput) SetNextToken added in v1.42.15

SetNextToken sets the NextToken field's value.

func (*DescribePullThroughCacheRulesOutput) SetPullThroughCacheRules added in v1.42.15

SetPullThroughCacheRules sets the PullThroughCacheRules field's value.

func (DescribePullThroughCacheRulesOutput) String added in v1.42.15

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeRegistryInput added in v1.36.4

type DescribeRegistryInput struct {
	// contains filtered or unexported fields
}

func (DescribeRegistryInput) GoString added in v1.36.4

func (s DescribeRegistryInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (DescribeRegistryInput) String added in v1.36.4

func (s DescribeRegistryInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeRegistryOutput added in v1.36.4

type DescribeRegistryOutput struct {

	// The ID of the registry.
	RegistryId *string `locationName:"registryId" type:"string"`

	// The replication configuration for the registry.
	ReplicationConfiguration *ReplicationConfiguration `locationName:"replicationConfiguration" type:"structure"`
	// contains filtered or unexported fields
}

func (DescribeRegistryOutput) GoString added in v1.36.4

func (s DescribeRegistryOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeRegistryOutput) SetRegistryId added in v1.36.4

SetRegistryId sets the RegistryId field's value.

func (*DescribeRegistryOutput) SetReplicationConfiguration added in v1.36.4

func (s *DescribeRegistryOutput) SetReplicationConfiguration(v *ReplicationConfiguration) *DescribeRegistryOutput

SetReplicationConfiguration sets the ReplicationConfiguration field's value.

func (DescribeRegistryOutput) String added in v1.36.4

func (s DescribeRegistryOutput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

type DescribeRepositoriesInput

type DescribeRepositoriesInput struct {

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

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

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

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

func (DescribeRepositoriesInput) GoString

func (s DescribeRepositoriesInput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeRepositoriesInput) SetMaxResults added in v1.5.0

SetMaxResults sets the MaxResults field's value.

func (*DescribeRepositoriesInput) SetNextToken added in v1.5.0

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesInput) SetRegistryId added in v1.5.0

SetRegistryId sets the RegistryId field's value.

func (*DescribeRepositoriesInput) SetRepositoryNames added in v1.5.0

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

SetRepositoryNames sets the RepositoryNames field's value.

func (DescribeRepositoriesInput) String

func (s DescribeRepositoriesInput) String() string

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeRepositoriesInput) Validate added in v1.1.21

func (s *DescribeRepositoriesInput) Validate() error

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

type DescribeRepositoriesOutput

type DescribeRepositoriesOutput struct {

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

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

func (DescribeRepositoriesOutput) GoString

func (s DescribeRepositoriesOutput) GoString() string

GoString returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

func (*DescribeRepositoriesOutput) SetNextToken added in v1.5.0

SetNextToken sets the NextToken field's value.

func (*DescribeRepositoriesOutput) SetRepositories added in v1.5.0

SetRepositories sets the Repositories field's value.

func (DescribeRepositoriesOutput) String

String returns the string representation.

API parameter values that are decorated as "sensitive" in the API will not be included in the string output. The member name will be present, but the value will be replaced with "sensitive".

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:

mySession := session.Must(session.NewSession())

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

Checks the availability of one or more image layers in a repository.

When an image is pushed to a repository, each image layer is checked to verify if it has been uploaded before. If it has been uploaded, then the image layer is skipped.

This operation is used by the Amazon ECR proxy and is not generally used 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 Types:

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

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

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

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

func (*ECR) BatchCheckLayerAvailabilityRequest

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

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

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

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

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

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

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

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

func (*ECR) BatchCheckLayerAvailabilityWithContext added in v1.8.0

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

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

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

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

func (*ECR) BatchDeleteImage

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

BatchDeleteImage API operation for Amazon EC2 Container Registry.

Deletes a list of specified images within a repository. Images are specified with either an 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 Types:

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

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

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

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

Example (Shared00)

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

package main

import (
	"fmt"

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

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

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

	fmt.Println(result)
}
Output:

func (*ECR) BatchDeleteImageRequest

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

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

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

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

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

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

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

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

func (*ECR) BatchDeleteImageWithContext added in v1.8.0

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

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

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

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

func (*ECR) BatchGetImage

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

BatchGetImage API operation for Amazon EC2 Container Registry.

Gets detailed information for an image. Images are specified with either an imageTag or imageDigest.

When an image is pulled, the BatchGetImage API is called once to retrieve the image manifest.

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 Types:

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

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

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

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

Example (Shared00)

To obtain multiple images in a single request This example obtains information for an image with a specified image digest ID from the repository named ubuntu in the current account.

package main

import (
	"fmt"

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

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

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

	fmt.Println(result)
}
Output:

func (*ECR) BatchGetImageRequest

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

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

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

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

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

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

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

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

func (*ECR) BatchGetImageWithContext added in v1.8.0

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

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

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

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

func (*ECR) BatchGetRepositoryScanningConfiguration added in v1.42.15

func (c *ECR) BatchGetRepositoryScanningConfiguration(input *BatchGetRepositoryScanningConfigurationInput) (*BatchGetRepositoryScanningConfigurationOutput, error)

BatchGetRepositoryScanningConfiguration API operation for Amazon EC2 Container Registry.

Gets the scanning configuration for one or more repositories.

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 BatchGetRepositoryScanningConfiguration for usage and error information.

Returned Error Types:

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

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

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

  • ValidationException There was an exception validating this request.

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

func (*ECR) BatchGetRepositoryScanningConfigurationRequest added in v1.42.15

func (c *ECR) BatchGetRepositoryScanningConfigurationRequest(input *BatchGetRepositoryScanningConfigurationInput) (req *request.Request, output *BatchGetRepositoryScanningConfigurationOutput)

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

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

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

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

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

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

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

func (*ECR) BatchGetRepositoryScanningConfigurationWithContext added in v1.42.15

func (c *ECR) BatchGetRepositoryScanningConfigurationWithContext(ctx aws.Context, input *BatchGetRepositoryScanningConfigurationInput, opts ...request.Option) (*BatchGetRepositoryScanningConfigurationOutput, error)

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

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

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

func (*ECR) CompleteLayerUpload

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

CompleteLayerUpload API operation for Amazon EC2 Container Registry.

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

When an image is pushed, the CompleteLayerUpload API is called once per each new image layer to verify that the upload has completed.

This operation is used by the Amazon ECR proxy and is not generally used 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 Types:

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

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

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

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

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

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

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

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

  • KmsException The operation failed due to a KMS exception.

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

func (*ECR) CompleteLayerUploadRequest

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

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

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

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

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

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

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

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

func (*ECR) CompleteLayerUploadWithContext added in v1.8.0

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

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

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

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

func (*ECR) CreatePullThroughCacheRule added in v1.42.15

func (c *ECR) CreatePullThroughCacheRule(input *CreatePullThroughCacheRuleInput) (*CreatePullThroughCacheRuleOutput, error)

CreatePullThroughCacheRule API operation for Amazon EC2 Container Registry.

Creates a pull through cache rule. A pull through cache rule provides a way to cache images from an external public registry in your Amazon ECR private 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 CreatePullThroughCacheRule for usage and error information.

Returned Error Types:

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

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

  • ValidationException There was an exception validating this request.

  • PullThroughCacheRuleAlreadyExistsException A pull through cache rule with these settings already exists for the private registry.

  • UnsupportedUpstreamRegistryException The specified upstream registry isn't supported.

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

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

func (*ECR) CreatePullThroughCacheRuleRequest added in v1.42.15

func (c *ECR) CreatePullThroughCacheRuleRequest(input *CreatePullThroughCacheRuleInput) (req *request.Request, output *CreatePullThroughCacheRuleOutput)

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

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

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

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

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

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

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

func (*ECR) CreatePullThroughCacheRuleWithContext added in v1.42.15

func (c *ECR) CreatePullThroughCacheRuleWithContext(ctx aws.Context, input *CreatePullThroughCacheRuleInput, opts ...request.Option) (*CreatePullThroughCacheRuleOutput, error)

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

See CreatePullThroughCacheRule 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 a repository. For more information, see Amazon ECR repositories (https://docs.aws.amazon.com/AmazonECR/latest/userguide/Repositories.html) in the Amazon Elastic Container Registry User Guide.

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

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

Returned Error Types:

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

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

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

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

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

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

  • KmsException The operation failed due to a KMS exception.

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

Example (Shared00)

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

package main

import (
	"fmt"

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

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

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

	fmt.Println(result)
}
Output:

func (*ECR) CreateRepositoryRequest

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

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

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

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

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

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

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

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

func (*ECR) CreateRepositoryWithContext added in v1.8.0

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

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

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

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

func (*ECR) DeleteLifecyclePolicy added in v1.12.9

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

DeleteLifecyclePolicy API operation for Amazon EC2 Container Registry.

Deletes the lifecycle policy associated with the 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 DeleteLifecyclePolicy for usage and error information.

Returned Error Types:

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

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

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

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

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

func (*ECR) DeleteLifecyclePolicyRequest added in v1.12.9

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

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

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

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

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

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

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

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

func (*ECR) DeleteLifecyclePolicyWithContext added in v1.12.9

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

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

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

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

func (*ECR) DeletePullThroughCacheRule added in v1.42.15

func (c *ECR) DeletePullThroughCacheRule(input *DeletePullThroughCacheRuleInput) (*DeletePullThroughCacheRuleOutput, error)

DeletePullThroughCacheRule API operation for Amazon EC2 Container Registry.

Deletes a pull through cache rule.

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 DeletePullThroughCacheRule for usage and error information.

Returned Error Types:

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

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

  • ValidationException There was an exception validating this request.

  • PullThroughCacheRuleNotFoundException The pull through cache rule was not found. Specify a valid pull through cache rule and try again.

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

func (*ECR) DeletePullThroughCacheRuleRequest added in v1.42.15

func (c *ECR) DeletePullThroughCacheRuleRequest(input *DeletePullThroughCacheRuleInput) (req *request.Request, output *DeletePullThroughCacheRuleOutput)

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

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

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

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

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

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

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

func (*ECR) DeletePullThroughCacheRuleWithContext added in v1.42.15

func (c *ECR) DeletePullThroughCacheRuleWithContext(ctx aws.Context, input *DeletePullThroughCacheRuleInput, opts ...request.Option) (*DeletePullThroughCacheRuleOutput, error)

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

See DeletePullThroughCacheRule 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) DeleteRegistryPolicy added in v1.36.4

func (c *ECR) DeleteRegistryPolicy(input *DeleteRegistryPolicyInput) (*DeleteRegistryPolicyOutput, error)

DeleteRegistryPolicy API operation for Amazon EC2 Container Registry.

Deletes the registry permissions policy.

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

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

Returned Error Types:

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

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

  • RegistryPolicyNotFoundException The registry doesn't have an associated registry policy.

  • ValidationException There was an exception validating this request.

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

func (*ECR) DeleteRegistryPolicyRequest added in v1.36.4

func (c *ECR) DeleteRegistryPolicyRequest(input *DeleteRegistryPolicyInput) (req *request.Request, output *DeleteRegistryPolicyOutput)

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

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

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

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

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

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

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

func (*ECR) DeleteRegistryPolicyWithContext added in v1.36.4

func (c *ECR) DeleteRegistryPolicyWithContext(ctx aws.Context, input *DeleteRegistryPolicyInput, opts ...request.Option) (*DeleteRegistryPolicyOutput, error)

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

See DeleteRegistryPolicy 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 a repository. If the repository contains images, you must either delete all images in the repository or use the force option to delete the 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 DeleteRepository for usage and error information.

Returned Error Types:

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

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

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

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

  • KmsException The operation failed due to a KMS exception.

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

Example (Shared00)

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

package main

import (
	"fmt"

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

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

	result, err := svc.DeleteRepository(input)
	if err != nil {
		if aerr, ok := err.(awserr.Error); ok {
			switch aerr.Code() {
			case ecr.ErrCodeServerException:
				fmt.Println(ecr.ErrCodeServerException, aerr.Error())
			case ecr.ErrCodeInvalidParameterException:
				fmt.Println(ecr.ErrCodeInvalidParameterException, aerr.Error())
			case ecr.ErrCodeRepositoryNotFoundException:
				fmt.Println(ecr.ErrCodeRepositoryNotFoundException, aerr.Error())
			case ecr.ErrCodeRepositoryNotEmptyException:
				fmt.Println(ecr.ErrCodeRepositoryNotEmptyException, aerr.Error())
			case ecr.ErrCodeKmsException:
				fmt.Println(ecr.ErrCodeKmsException, 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 associated with the 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 Types:

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

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

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

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

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

Example (Shared00)

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

package main

import (
	"fmt"

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

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

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

	fmt.Println(result)
}
Output:

func (*ECR) DeleteRepositoryPolicyRequest

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

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

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

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

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

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

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

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

func (*ECR) DeleteRepositoryPolicyWithContext added in v1.8.0

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

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

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

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

func (*ECR) DeleteRepositoryRequest

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

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

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

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

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

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

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

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

func (*ECR) DeleteRepositoryWithContext added in v1.8.0

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

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

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

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