Documentation ¶
Overview ¶
Package ecr provides a client for Amazon EC2 Container Registry.
Index ¶
- Constants
- type AuthorizationData
- type BatchCheckLayerAvailabilityInput
- type BatchCheckLayerAvailabilityOutput
- type BatchDeleteImageInput
- type BatchDeleteImageOutput
- type BatchGetImageInput
- type BatchGetImageOutput
- type CompleteLayerUploadInput
- type CompleteLayerUploadOutput
- type CreateRepositoryInput
- type CreateRepositoryOutput
- type DeleteRepositoryInput
- type DeleteRepositoryOutput
- type DeleteRepositoryPolicyInput
- type DeleteRepositoryPolicyOutput
- type DescribeRepositoriesInput
- type DescribeRepositoriesOutput
- type ECR
- func (c *ECR) BatchCheckLayerAvailability(input *BatchCheckLayerAvailabilityInput) (*BatchCheckLayerAvailabilityOutput, error)
- func (c *ECR) BatchCheckLayerAvailabilityRequest(input *BatchCheckLayerAvailabilityInput) (req *request.Request, output *BatchCheckLayerAvailabilityOutput)
- func (c *ECR) BatchDeleteImage(input *BatchDeleteImageInput) (*BatchDeleteImageOutput, error)
- func (c *ECR) BatchDeleteImageRequest(input *BatchDeleteImageInput) (req *request.Request, output *BatchDeleteImageOutput)
- func (c *ECR) BatchGetImage(input *BatchGetImageInput) (*BatchGetImageOutput, error)
- func (c *ECR) BatchGetImageRequest(input *BatchGetImageInput) (req *request.Request, output *BatchGetImageOutput)
- func (c *ECR) CompleteLayerUpload(input *CompleteLayerUploadInput) (*CompleteLayerUploadOutput, error)
- func (c *ECR) CompleteLayerUploadRequest(input *CompleteLayerUploadInput) (req *request.Request, output *CompleteLayerUploadOutput)
- func (c *ECR) CreateRepository(input *CreateRepositoryInput) (*CreateRepositoryOutput, error)
- func (c *ECR) CreateRepositoryRequest(input *CreateRepositoryInput) (req *request.Request, output *CreateRepositoryOutput)
- func (c *ECR) DeleteRepository(input *DeleteRepositoryInput) (*DeleteRepositoryOutput, error)
- func (c *ECR) DeleteRepositoryPolicy(input *DeleteRepositoryPolicyInput) (*DeleteRepositoryPolicyOutput, error)
- func (c *ECR) DeleteRepositoryPolicyRequest(input *DeleteRepositoryPolicyInput) (req *request.Request, output *DeleteRepositoryPolicyOutput)
- func (c *ECR) DeleteRepositoryRequest(input *DeleteRepositoryInput) (req *request.Request, output *DeleteRepositoryOutput)
- func (c *ECR) DescribeRepositories(input *DescribeRepositoriesInput) (*DescribeRepositoriesOutput, error)
- func (c *ECR) DescribeRepositoriesRequest(input *DescribeRepositoriesInput) (req *request.Request, output *DescribeRepositoriesOutput)
- func (c *ECR) GetAuthorizationToken(input *GetAuthorizationTokenInput) (*GetAuthorizationTokenOutput, error)
- func (c *ECR) GetAuthorizationTokenRequest(input *GetAuthorizationTokenInput) (req *request.Request, output *GetAuthorizationTokenOutput)
- func (c *ECR) GetDownloadUrlForLayer(input *GetDownloadUrlForLayerInput) (*GetDownloadUrlForLayerOutput, error)
- func (c *ECR) GetDownloadUrlForLayerRequest(input *GetDownloadUrlForLayerInput) (req *request.Request, output *GetDownloadUrlForLayerOutput)
- func (c *ECR) GetRepositoryPolicy(input *GetRepositoryPolicyInput) (*GetRepositoryPolicyOutput, error)
- func (c *ECR) GetRepositoryPolicyRequest(input *GetRepositoryPolicyInput) (req *request.Request, output *GetRepositoryPolicyOutput)
- func (c *ECR) InitiateLayerUpload(input *InitiateLayerUploadInput) (*InitiateLayerUploadOutput, error)
- func (c *ECR) InitiateLayerUploadRequest(input *InitiateLayerUploadInput) (req *request.Request, output *InitiateLayerUploadOutput)
- func (c *ECR) ListImages(input *ListImagesInput) (*ListImagesOutput, error)
- func (c *ECR) ListImagesRequest(input *ListImagesInput) (req *request.Request, output *ListImagesOutput)
- func (c *ECR) PutImage(input *PutImageInput) (*PutImageOutput, error)
- func (c *ECR) PutImageRequest(input *PutImageInput) (req *request.Request, output *PutImageOutput)
- func (c *ECR) SetRepositoryPolicy(input *SetRepositoryPolicyInput) (*SetRepositoryPolicyOutput, error)
- func (c *ECR) SetRepositoryPolicyRequest(input *SetRepositoryPolicyInput) (req *request.Request, output *SetRepositoryPolicyOutput)
- func (c *ECR) UploadLayerPart(input *UploadLayerPartInput) (*UploadLayerPartOutput, error)
- func (c *ECR) UploadLayerPartRequest(input *UploadLayerPartInput) (req *request.Request, output *UploadLayerPartOutput)
- type GetAuthorizationTokenInput
- type GetAuthorizationTokenOutput
- type GetDownloadUrlForLayerInput
- type GetDownloadUrlForLayerOutput
- type GetRepositoryPolicyInput
- type GetRepositoryPolicyOutput
- type Image
- type ImageFailure
- type ImageIdentifier
- type InitiateLayerUploadInput
- type InitiateLayerUploadOutput
- type Layer
- type LayerFailure
- type ListImagesFilter
- type ListImagesInput
- type ListImagesOutput
- type PutImageInput
- type PutImageOutput
- type Repository
- type SetRepositoryPolicyInput
- type SetRepositoryPolicyOutput
- type UploadLayerPartInput
- type UploadLayerPartOutput
Examples ¶
- ECR.BatchCheckLayerAvailability
- ECR.BatchDeleteImage
- ECR.BatchGetImage
- ECR.CompleteLayerUpload
- ECR.CreateRepository
- ECR.DeleteRepository
- ECR.DeleteRepositoryPolicy
- ECR.DescribeRepositories
- ECR.GetAuthorizationToken
- ECR.GetDownloadUrlForLayer
- ECR.GetRepositoryPolicy
- ECR.InitiateLayerUpload
- ECR.ListImages
- ECR.PutImage
- ECR.SetRepositoryPolicy
- ECR.UploadLayerPart
Constants ¶
const ( // @enum ImageFailureCode ImageFailureCodeInvalidImageDigest = "InvalidImageDigest" // @enum ImageFailureCode ImageFailureCodeInvalidImageTag = "InvalidImageTag" // @enum ImageFailureCode ImageFailureCodeImageTagDoesNotMatchDigest = "ImageTagDoesNotMatchDigest" // @enum ImageFailureCode ImageFailureCodeImageNotFound = "ImageNotFound" // @enum ImageFailureCode ImageFailureCodeMissingDigestAndTag = "MissingDigestAndTag" )
const ( // @enum LayerAvailability LayerAvailabilityAvailable = "AVAILABLE" LayerAvailabilityUnavailable = "UNAVAILABLE" )
const ( // @enum LayerFailureCode LayerFailureCodeInvalidLayerDigest = "InvalidLayerDigest" // @enum LayerFailureCode LayerFailureCodeMissingLayerDigest = "MissingLayerDigest" )
const ( // @enum TagStatus TagStatusTagged = "TAGGED" // @enum TagStatus TagStatusUntagged = "UNTAGGED" )
const ServiceName = "ecr"
A ServiceName is the name of the service the client will make API calls to.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AuthorizationData ¶
type AuthorizationData struct { // A base64-encoded string that contains authorization data for the specified // Amazon ECR registry. When the string is decoded, it is presented in the format // user:password for private registry authentication using docker login. AuthorizationToken *string `locationName:"authorizationToken" type:"string"` // The Unix time in seconds and milliseconds when the authorization token expires. // Authorization tokens are valid for 12 hours. ExpiresAt *time.Time `locationName:"expiresAt" type:"timestamp" timestampFormat:"unix"` // The registry URL to use for this authorization token in a docker login command. // The Amazon ECR registry URL format is https://aws_account_id.dkr.ecr.region.amazonaws.com. // For example, https://012345678910.dkr.ecr.us-east-1.amazonaws.com.. ProxyEndpoint *string `locationName:"proxyEndpoint" type:"string"` // contains filtered or unexported fields }
An object representing authorization data for an Amazon ECR registry.
func (AuthorizationData) GoString ¶
func (s AuthorizationData) GoString() string
GoString returns the string representation
func (AuthorizationData) String ¶
func (s AuthorizationData) String() string
String returns the string representation
type BatchCheckLayerAvailabilityInput ¶
type BatchCheckLayerAvailabilityInput struct { // The digests of the image layers to check. LayerDigests []*string `locationName:"layerDigests" min:"1" type:"list" required:"true"` // The AWS account ID associated with the registry that contains the image layers // to check. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository that is associated with the image layers to check. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (BatchCheckLayerAvailabilityInput) GoString ¶
func (s BatchCheckLayerAvailabilityInput) GoString() string
GoString returns the string representation
func (BatchCheckLayerAvailabilityInput) String ¶
func (s BatchCheckLayerAvailabilityInput) String() string
String returns the string representation
func (*BatchCheckLayerAvailabilityInput) Validate ¶ added in v1.1.21
func (s *BatchCheckLayerAvailabilityInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type BatchCheckLayerAvailabilityOutput ¶
type BatchCheckLayerAvailabilityOutput struct { // Any failures associated with the call. Failures []*LayerFailure `locationName:"failures" type:"list"` // A list of image layer objects corresponding to the image layer references // in the request. Layers []*Layer `locationName:"layers" type:"list"` // contains filtered or unexported fields }
func (BatchCheckLayerAvailabilityOutput) GoString ¶
func (s BatchCheckLayerAvailabilityOutput) GoString() string
GoString returns the string representation
func (BatchCheckLayerAvailabilityOutput) String ¶
func (s BatchCheckLayerAvailabilityOutput) String() string
String returns the string representation
type BatchDeleteImageInput ¶
type BatchDeleteImageInput struct { // A list of image ID references that correspond to images to delete. The format // of the imageIds reference is imageTag=tag or imageDigest=digest. ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list" required:"true"` // The AWS account ID associated with the registry that contains the image to // delete. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The repository that contains the image to delete. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
Deletes specified images within a specified repository. Images are specified with either the imageTag or imageDigest.
func (BatchDeleteImageInput) GoString ¶
func (s BatchDeleteImageInput) GoString() string
GoString returns the string representation
func (BatchDeleteImageInput) String ¶
func (s BatchDeleteImageInput) String() string
String returns the string representation
func (*BatchDeleteImageInput) Validate ¶ added in v1.1.21
func (s *BatchDeleteImageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type BatchDeleteImageOutput ¶
type BatchDeleteImageOutput struct { // Any failures associated with the call. Failures []*ImageFailure `locationName:"failures" type:"list"` // The image IDs of the deleted images. ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"` // contains filtered or unexported fields }
func (BatchDeleteImageOutput) GoString ¶
func (s BatchDeleteImageOutput) GoString() string
GoString returns the string representation
func (BatchDeleteImageOutput) String ¶
func (s BatchDeleteImageOutput) String() string
String returns the string representation
type BatchGetImageInput ¶
type BatchGetImageInput struct { // 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 []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list" required:"true"` // The AWS account ID associated with the registry that contains the images // to describe. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The repository that contains the images to describe. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (BatchGetImageInput) GoString ¶
func (s BatchGetImageInput) GoString() string
GoString returns the string representation
func (BatchGetImageInput) String ¶
func (s BatchGetImageInput) String() string
String returns the string representation
func (*BatchGetImageInput) Validate ¶ added in v1.1.21
func (s *BatchGetImageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type BatchGetImageOutput ¶
type BatchGetImageOutput struct { // Any failures associated with the call. Failures []*ImageFailure `locationName:"failures" type:"list"` // A list of image objects corresponding to the image references in the request. Images []*Image `locationName:"images" type:"list"` // contains filtered or unexported fields }
func (BatchGetImageOutput) GoString ¶
func (s BatchGetImageOutput) GoString() string
GoString returns the string representation
func (BatchGetImageOutput) String ¶
func (s BatchGetImageOutput) String() string
String returns the string representation
type CompleteLayerUploadInput ¶
type CompleteLayerUploadInput struct { // The sha256 digest of the image layer. LayerDigests []*string `locationName:"layerDigests" min:"1" type:"list" required:"true"` // The AWS account ID associated with the registry to which to upload layers. // If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository to associate with the image layer. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // The upload ID from a previous InitiateLayerUpload operation to associate // with the image layer. UploadId *string `locationName:"uploadId" type:"string" required:"true"` // contains filtered or unexported fields }
func (CompleteLayerUploadInput) GoString ¶
func (s CompleteLayerUploadInput) GoString() string
GoString returns the string representation
func (CompleteLayerUploadInput) String ¶
func (s CompleteLayerUploadInput) String() string
String returns the string representation
func (*CompleteLayerUploadInput) Validate ¶ added in v1.1.21
func (s *CompleteLayerUploadInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CompleteLayerUploadOutput ¶
type CompleteLayerUploadOutput struct { // The sha256 digest of the image layer. LayerDigest *string `locationName:"layerDigest" type:"string"` // The registry ID associated with the request. RegistryId *string `locationName:"registryId" type:"string"` // The repository name associated with the request. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // The upload ID associated with the layer. UploadId *string `locationName:"uploadId" type:"string"` // contains filtered or unexported fields }
func (CompleteLayerUploadOutput) GoString ¶
func (s CompleteLayerUploadOutput) GoString() string
GoString returns the string representation
func (CompleteLayerUploadOutput) String ¶
func (s CompleteLayerUploadOutput) String() string
String returns the string representation
type CreateRepositoryInput ¶
type CreateRepositoryInput struct { // The name to use for the repository. The repository name may be specified // on its own (such as nginx-web-app) or it can be prepended with a namespace // to group the repository into a category (such as project-a/nginx-web-app). RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (CreateRepositoryInput) GoString ¶
func (s CreateRepositoryInput) GoString() string
GoString returns the string representation
func (CreateRepositoryInput) String ¶
func (s CreateRepositoryInput) String() string
String returns the string representation
func (*CreateRepositoryInput) Validate ¶ added in v1.1.21
func (s *CreateRepositoryInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type CreateRepositoryOutput ¶
type CreateRepositoryOutput struct { // An object representing a repository. Repository *Repository `locationName:"repository" type:"structure"` // contains filtered or unexported fields }
func (CreateRepositoryOutput) GoString ¶
func (s CreateRepositoryOutput) GoString() string
GoString returns the string representation
func (CreateRepositoryOutput) String ¶
func (s CreateRepositoryOutput) String() string
String returns the string representation
type DeleteRepositoryInput ¶
type DeleteRepositoryInput struct { // Force the deletion of the repository if it contains images. Force *bool `locationName:"force" type:"boolean"` // The AWS account ID associated with the registry that contains the repository // to delete. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository to delete. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (DeleteRepositoryInput) GoString ¶
func (s DeleteRepositoryInput) GoString() string
GoString returns the string representation
func (DeleteRepositoryInput) String ¶
func (s DeleteRepositoryInput) String() string
String returns the string representation
func (*DeleteRepositoryInput) Validate ¶ added in v1.1.21
func (s *DeleteRepositoryInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteRepositoryOutput ¶
type DeleteRepositoryOutput struct { // An object representing a repository. Repository *Repository `locationName:"repository" type:"structure"` // contains filtered or unexported fields }
func (DeleteRepositoryOutput) GoString ¶
func (s DeleteRepositoryOutput) GoString() string
GoString returns the string representation
func (DeleteRepositoryOutput) String ¶
func (s DeleteRepositoryOutput) String() string
String returns the string representation
type DeleteRepositoryPolicyInput ¶
type DeleteRepositoryPolicyInput struct { // The AWS account ID associated with the registry that contains the repository // policy to delete. If you do not specify a registry, the default registry // is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository that is associated with the repository policy // to delete. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (DeleteRepositoryPolicyInput) GoString ¶
func (s DeleteRepositoryPolicyInput) GoString() string
GoString returns the string representation
func (DeleteRepositoryPolicyInput) String ¶
func (s DeleteRepositoryPolicyInput) String() string
String returns the string representation
func (*DeleteRepositoryPolicyInput) Validate ¶ added in v1.1.21
func (s *DeleteRepositoryPolicyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DeleteRepositoryPolicyOutput ¶
type DeleteRepositoryPolicyOutput struct { // The JSON repository policy that was deleted from the repository. PolicyText *string `locationName:"policyText" type:"string"` // The registry ID associated with the request. RegistryId *string `locationName:"registryId" type:"string"` // The repository name associated with the request. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // contains filtered or unexported fields }
func (DeleteRepositoryPolicyOutput) GoString ¶
func (s DeleteRepositoryPolicyOutput) GoString() string
GoString returns the string representation
func (DeleteRepositoryPolicyOutput) String ¶
func (s DeleteRepositoryPolicyOutput) String() string
String returns the string representation
type DescribeRepositoriesInput ¶
type DescribeRepositoriesInput struct { // The maximum number of repository results returned by DescribeRepositories // in paginated output. When this parameter is used, DescribeRepositories only // returns maxResults results in a single page along with a nextToken response // element. The remaining results of the initial request can be seen by sending // another DescribeRepositories request with the returned nextToken value. This // value can be between 1 and 100. If this parameter is not used, then DescribeRepositories // returns up to 100 results and a nextToken value, if applicable. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` // The nextToken value returned from a previous paginated DescribeRepositories // request where maxResults was used and the results exceeded the value of that // parameter. Pagination continues from the end of the previous results that // returned the nextToken value. This value is null when there are no more results // to return. // // This token should be treated as an opaque identifier that is only used // to retrieve the next items in a list and not for other programmatic purposes. NextToken *string `locationName:"nextToken" type:"string"` // The AWS account ID associated with the registry that contains the repositories // to be described. If you do not specify a registry, the default registry is // assumed. RegistryId *string `locationName:"registryId" type:"string"` // A list of repositories to describe. If this parameter is omitted, then all // repositories in a registry are described. RepositoryNames []*string `locationName:"repositoryNames" min:"1" type:"list"` // contains filtered or unexported fields }
func (DescribeRepositoriesInput) GoString ¶
func (s DescribeRepositoriesInput) GoString() string
GoString returns the string representation
func (DescribeRepositoriesInput) String ¶
func (s DescribeRepositoriesInput) String() string
String returns the string representation
func (*DescribeRepositoriesInput) Validate ¶ added in v1.1.21
func (s *DescribeRepositoriesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type DescribeRepositoriesOutput ¶
type DescribeRepositoriesOutput struct { // The nextToken value to include in a future DescribeRepositories request. // When the results of a DescribeRepositories request exceed maxResults, this // value can be used to retrieve the next page of results. This value is null // when there are no more results to return. NextToken *string `locationName:"nextToken" type:"string"` // A list of repository objects corresponding to valid repositories. Repositories []*Repository `locationName:"repositories" type:"list"` // contains filtered or unexported fields }
func (DescribeRepositoriesOutput) GoString ¶
func (s DescribeRepositoriesOutput) GoString() string
GoString returns the string representation
func (DescribeRepositoriesOutput) String ¶
func (s DescribeRepositoriesOutput) String() string
String returns the string representation
type ECR ¶
Amazon EC2 Container Registry (Amazon ECR) is a managed AWS Docker registry service. Customers can use the familiar Docker CLI to push, pull, and manage images. Amazon ECR provides a secure, scalable, and reliable registry. Amazon ECR supports private Docker repositories with resource-based permissions using AWS IAM so that specific users or Amazon EC2 instances can access repositories and images. Developers can use the Docker CLI to author and manage images. The service client's operations are safe to be used concurrently. It is not safe to mutate any of the client's properties though.
func New ¶
func New(p client.ConfigProvider, cfgs ...*aws.Config) *ECR
New creates a new instance of the ECR client with a session. If additional configuration is needed for the client instance use the optional aws.Config parameter to add your extra config.
Example:
// Create a ECR client from just a session. svc := ecr.New(mySession) // Create a ECR client with additional configuration svc := ecr.New(mySession, aws.NewConfig().WithRegion("us-west-2"))
func (*ECR) BatchCheckLayerAvailability ¶
func (c *ECR) BatchCheckLayerAvailability(input *BatchCheckLayerAvailabilityInput) (*BatchCheckLayerAvailabilityOutput, error)
Check the availability of multiple image layers in a specified registry and repository.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.BatchCheckLayerAvailabilityInput{ LayerDigests: []*string{ // Required aws.String("BatchedOperationLayerDigest"), // Required // More values... }, RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.BatchCheckLayerAvailability(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) BatchCheckLayerAvailabilityRequest ¶
func (c *ECR) BatchCheckLayerAvailabilityRequest(input *BatchCheckLayerAvailabilityInput) (req *request.Request, output *BatchCheckLayerAvailabilityOutput)
BatchCheckLayerAvailabilityRequest generates a "aws/request.Request" representing the client's request for the BatchCheckLayerAvailability operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchCheckLayerAvailability method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the BatchCheckLayerAvailabilityRequest method. req, resp := client.BatchCheckLayerAvailabilityRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) BatchDeleteImage ¶
func (c *ECR) BatchDeleteImage(input *BatchDeleteImageInput) (*BatchDeleteImageOutput, error)
Deletes a list of specified images within a specified repository. Images are specified with either imageTag or imageDigest.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.BatchDeleteImageInput{ ImageIds: []*ecr.ImageIdentifier{ // Required { // Required ImageDigest: aws.String("ImageDigest"), ImageTag: aws.String("ImageTag"), }, // More values... }, RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.BatchDeleteImage(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) BatchDeleteImageRequest ¶
func (c *ECR) BatchDeleteImageRequest(input *BatchDeleteImageInput) (req *request.Request, output *BatchDeleteImageOutput)
BatchDeleteImageRequest generates a "aws/request.Request" representing the client's request for the BatchDeleteImage operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchDeleteImage method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the BatchDeleteImageRequest method. req, resp := client.BatchDeleteImageRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) BatchGetImage ¶
func (c *ECR) BatchGetImage(input *BatchGetImageInput) (*BatchGetImageOutput, error)
Gets detailed information for specified images within a specified repository. Images are specified with either imageTag or imageDigest.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.BatchGetImageInput{ ImageIds: []*ecr.ImageIdentifier{ // Required { // Required ImageDigest: aws.String("ImageDigest"), ImageTag: aws.String("ImageTag"), }, // More values... }, RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.BatchGetImage(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) BatchGetImageRequest ¶
func (c *ECR) BatchGetImageRequest(input *BatchGetImageInput) (req *request.Request, output *BatchGetImageOutput)
BatchGetImageRequest generates a "aws/request.Request" representing the client's request for the BatchGetImage operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the BatchGetImage method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the BatchGetImageRequest method. req, resp := client.BatchGetImageRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) CompleteLayerUpload ¶
func (c *ECR) CompleteLayerUpload(input *CompleteLayerUploadInput) (*CompleteLayerUploadOutput, error)
Inform Amazon ECR that the image layer upload for a specified registry, repository name, and upload ID, has completed. You can optionally provide a sha256 digest of the image layer for data validation purposes.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.CompleteLayerUploadInput{ LayerDigests: []*string{ // Required aws.String("LayerDigest"), // Required // More values... }, RepositoryName: aws.String("RepositoryName"), // Required UploadId: aws.String("UploadId"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.CompleteLayerUpload(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) CompleteLayerUploadRequest ¶
func (c *ECR) CompleteLayerUploadRequest(input *CompleteLayerUploadInput) (req *request.Request, output *CompleteLayerUploadOutput)
CompleteLayerUploadRequest generates a "aws/request.Request" representing the client's request for the CompleteLayerUpload operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CompleteLayerUpload method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CompleteLayerUploadRequest method. req, resp := client.CompleteLayerUploadRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) CreateRepository ¶
func (c *ECR) CreateRepository(input *CreateRepositoryInput) (*CreateRepositoryOutput, error)
Creates an image repository.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.CreateRepositoryInput{ RepositoryName: aws.String("RepositoryName"), // Required } resp, err := svc.CreateRepository(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) CreateRepositoryRequest ¶
func (c *ECR) CreateRepositoryRequest(input *CreateRepositoryInput) (req *request.Request, output *CreateRepositoryOutput)
CreateRepositoryRequest generates a "aws/request.Request" representing the client's request for the CreateRepository operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the CreateRepository method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the CreateRepositoryRequest method. req, resp := client.CreateRepositoryRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) DeleteRepository ¶
func (c *ECR) DeleteRepository(input *DeleteRepositoryInput) (*DeleteRepositoryOutput, error)
Deletes an existing image repository. If a repository contains images, you must use the force option to delete it.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.DeleteRepositoryInput{ RepositoryName: aws.String("RepositoryName"), // Required Force: aws.Bool(true), RegistryId: aws.String("RegistryId"), } resp, err := svc.DeleteRepository(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) DeleteRepositoryPolicy ¶
func (c *ECR) DeleteRepositoryPolicy(input *DeleteRepositoryPolicyInput) (*DeleteRepositoryPolicyOutput, error)
Deletes the repository policy from a specified repository.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.DeleteRepositoryPolicyInput{ RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.DeleteRepositoryPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) DeleteRepositoryPolicyRequest ¶
func (c *ECR) DeleteRepositoryPolicyRequest(input *DeleteRepositoryPolicyInput) (req *request.Request, output *DeleteRepositoryPolicyOutput)
DeleteRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the DeleteRepositoryPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteRepositoryPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DeleteRepositoryPolicyRequest method. req, resp := client.DeleteRepositoryPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) DeleteRepositoryRequest ¶
func (c *ECR) DeleteRepositoryRequest(input *DeleteRepositoryInput) (req *request.Request, output *DeleteRepositoryOutput)
DeleteRepositoryRequest generates a "aws/request.Request" representing the client's request for the DeleteRepository operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DeleteRepository method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DeleteRepositoryRequest method. req, resp := client.DeleteRepositoryRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) DescribeRepositories ¶
func (c *ECR) DescribeRepositories(input *DescribeRepositoriesInput) (*DescribeRepositoriesOutput, error)
Describes image repositories in a registry.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.DescribeRepositoriesInput{ MaxResults: aws.Int64(1), NextToken: aws.String("NextToken"), RegistryId: aws.String("RegistryId"), RepositoryNames: []*string{ aws.String("RepositoryName"), // Required // More values... }, } resp, err := svc.DescribeRepositories(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) DescribeRepositoriesRequest ¶
func (c *ECR) DescribeRepositoriesRequest(input *DescribeRepositoriesInput) (req *request.Request, output *DescribeRepositoriesOutput)
DescribeRepositoriesRequest generates a "aws/request.Request" representing the client's request for the DescribeRepositories operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the DescribeRepositories method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the DescribeRepositoriesRequest method. req, resp := client.DescribeRepositoriesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) GetAuthorizationToken ¶
func (c *ECR) GetAuthorizationToken(input *GetAuthorizationTokenInput) (*GetAuthorizationTokenOutput, error)
Retrieves a token that is valid for a specified registry for 12 hours. This command allows you to use the docker CLI to push and pull images with Amazon ECR. If you do not specify a registry, the default registry is assumed.
The authorizationToken returned for each registry specified is a base64 encoded string that can be decoded and used in a docker login command to authenticate to a registry. The AWS CLI offers an aws ecr get-login command that simplifies the login process.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.GetAuthorizationTokenInput{ RegistryIds: []*string{ aws.String("RegistryId"), // Required // More values... }, } resp, err := svc.GetAuthorizationToken(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) GetAuthorizationTokenRequest ¶
func (c *ECR) GetAuthorizationTokenRequest(input *GetAuthorizationTokenInput) (req *request.Request, output *GetAuthorizationTokenOutput)
GetAuthorizationTokenRequest generates a "aws/request.Request" representing the client's request for the GetAuthorizationToken operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetAuthorizationToken method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetAuthorizationTokenRequest method. req, resp := client.GetAuthorizationTokenRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) GetDownloadUrlForLayer ¶
func (c *ECR) GetDownloadUrlForLayer(input *GetDownloadUrlForLayerInput) (*GetDownloadUrlForLayerOutput, error)
Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image layers that are referenced in an image.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.GetDownloadUrlForLayerInput{ LayerDigest: aws.String("LayerDigest"), // Required RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.GetDownloadUrlForLayer(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) GetDownloadUrlForLayerRequest ¶
func (c *ECR) GetDownloadUrlForLayerRequest(input *GetDownloadUrlForLayerInput) (req *request.Request, output *GetDownloadUrlForLayerOutput)
GetDownloadUrlForLayerRequest generates a "aws/request.Request" representing the client's request for the GetDownloadUrlForLayer operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetDownloadUrlForLayer method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetDownloadUrlForLayerRequest method. req, resp := client.GetDownloadUrlForLayerRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) GetRepositoryPolicy ¶
func (c *ECR) GetRepositoryPolicy(input *GetRepositoryPolicyInput) (*GetRepositoryPolicyOutput, error)
Retrieves the repository policy for a specified repository.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.GetRepositoryPolicyInput{ RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.GetRepositoryPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) GetRepositoryPolicyRequest ¶
func (c *ECR) GetRepositoryPolicyRequest(input *GetRepositoryPolicyInput) (req *request.Request, output *GetRepositoryPolicyOutput)
GetRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the GetRepositoryPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the GetRepositoryPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the GetRepositoryPolicyRequest method. req, resp := client.GetRepositoryPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) InitiateLayerUpload ¶
func (c *ECR) InitiateLayerUpload(input *InitiateLayerUploadInput) (*InitiateLayerUploadOutput, error)
Notify Amazon ECR that you intend to upload an image layer.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.InitiateLayerUploadInput{ RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.InitiateLayerUpload(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) InitiateLayerUploadRequest ¶
func (c *ECR) InitiateLayerUploadRequest(input *InitiateLayerUploadInput) (req *request.Request, output *InitiateLayerUploadOutput)
InitiateLayerUploadRequest generates a "aws/request.Request" representing the client's request for the InitiateLayerUpload operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the InitiateLayerUpload method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the InitiateLayerUploadRequest method. req, resp := client.InitiateLayerUploadRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) ListImages ¶
func (c *ECR) ListImages(input *ListImagesInput) (*ListImagesOutput, error)
Lists all the image IDs for a given repository.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.ListImagesInput{ RepositoryName: aws.String("RepositoryName"), // Required Filter: &ecr.ListImagesFilter{ TagStatus: aws.String("TagStatus"), }, MaxResults: aws.Int64(1), NextToken: aws.String("NextToken"), RegistryId: aws.String("RegistryId"), } resp, err := svc.ListImages(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) ListImagesRequest ¶
func (c *ECR) ListImagesRequest(input *ListImagesInput) (req *request.Request, output *ListImagesOutput)
ListImagesRequest generates a "aws/request.Request" representing the client's request for the ListImages operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the ListImages method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the ListImagesRequest method. req, resp := client.ListImagesRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) PutImage ¶
func (c *ECR) PutImage(input *PutImageInput) (*PutImageOutput, error)
Creates or updates the image manifest associated with an image.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.PutImageInput{ ImageManifest: aws.String("ImageManifest"), // Required RepositoryName: aws.String("RepositoryName"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.PutImage(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) PutImageRequest ¶
func (c *ECR) PutImageRequest(input *PutImageInput) (req *request.Request, output *PutImageOutput)
PutImageRequest generates a "aws/request.Request" representing the client's request for the PutImage operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the PutImage method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the PutImageRequest method. req, resp := client.PutImageRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) SetRepositoryPolicy ¶
func (c *ECR) SetRepositoryPolicy(input *SetRepositoryPolicyInput) (*SetRepositoryPolicyOutput, error)
Applies a repository policy on a specified repository to control access permissions.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.SetRepositoryPolicyInput{ PolicyText: aws.String("RepositoryPolicyText"), // Required RepositoryName: aws.String("RepositoryName"), // Required Force: aws.Bool(true), RegistryId: aws.String("RegistryId"), } resp, err := svc.SetRepositoryPolicy(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) SetRepositoryPolicyRequest ¶
func (c *ECR) SetRepositoryPolicyRequest(input *SetRepositoryPolicyInput) (req *request.Request, output *SetRepositoryPolicyOutput)
SetRepositoryPolicyRequest generates a "aws/request.Request" representing the client's request for the SetRepositoryPolicy operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the SetRepositoryPolicy method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the SetRepositoryPolicyRequest method. req, resp := client.SetRepositoryPolicyRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
func (*ECR) UploadLayerPart ¶
func (c *ECR) UploadLayerPart(input *UploadLayerPartInput) (*UploadLayerPartOutput, error)
Uploads an image layer part to Amazon ECR.
This operation is used by the Amazon ECR proxy, and it is not intended
for general use by customers. Use the docker CLI to pull, tag, and push images.
Example ¶
package main import ( "fmt" "github.com/aws/aws-sdk-go/aws" "github.com/aws/aws-sdk-go/aws/session" "github.com/aws/aws-sdk-go/service/ecr" ) func main() { sess, err := session.NewSession() if err != nil { fmt.Println("failed to create session,", err) return } svc := ecr.New(sess) params := &ecr.UploadLayerPartInput{ LayerPartBlob: []byte("PAYLOAD"), // Required PartFirstByte: aws.Int64(1), // Required PartLastByte: aws.Int64(1), // Required RepositoryName: aws.String("RepositoryName"), // Required UploadId: aws.String("UploadId"), // Required RegistryId: aws.String("RegistryId"), } resp, err := svc.UploadLayerPart(params) if err != nil { // Print the error, cast err to awserr.Error to get the Code and // Message from an error. fmt.Println(err.Error()) return } // Pretty-print the response data. fmt.Println(resp) }
Output:
func (*ECR) UploadLayerPartRequest ¶
func (c *ECR) UploadLayerPartRequest(input *UploadLayerPartInput) (req *request.Request, output *UploadLayerPartOutput)
UploadLayerPartRequest generates a "aws/request.Request" representing the client's request for the UploadLayerPart operation. The "output" return value can be used to capture response data after the request's "Send" method is called.
Creating a request object using this method should be used when you want to inject custom logic into the request's lifecycle using a custom handler, or if you want to access properties on the request object before or after sending the request. If you just want the service response, call the UploadLayerPart method directly instead.
Note: You must call the "Send" method on the returned request object in order to execute the request.
// Example sending a request using the UploadLayerPartRequest method. req, resp := client.UploadLayerPartRequest(params) err := req.Send() if err == nil { // resp is now filled fmt.Println(resp) }
type GetAuthorizationTokenInput ¶
type GetAuthorizationTokenInput struct { // A list of AWS account IDs that are associated with the registries for which // to get authorization tokens. If you do not specify a registry, the default // registry is assumed. RegistryIds []*string `locationName:"registryIds" min:"1" type:"list"` // contains filtered or unexported fields }
func (GetAuthorizationTokenInput) GoString ¶
func (s GetAuthorizationTokenInput) GoString() string
GoString returns the string representation
func (GetAuthorizationTokenInput) String ¶
func (s GetAuthorizationTokenInput) String() string
String returns the string representation
func (*GetAuthorizationTokenInput) Validate ¶ added in v1.1.21
func (s *GetAuthorizationTokenInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetAuthorizationTokenOutput ¶
type GetAuthorizationTokenOutput struct { // A list of authorization token data objects that correspond to the registryIds // values in the request. AuthorizationData []*AuthorizationData `locationName:"authorizationData" type:"list"` // contains filtered or unexported fields }
func (GetAuthorizationTokenOutput) GoString ¶
func (s GetAuthorizationTokenOutput) GoString() string
GoString returns the string representation
func (GetAuthorizationTokenOutput) String ¶
func (s GetAuthorizationTokenOutput) String() string
String returns the string representation
type GetDownloadUrlForLayerInput ¶
type GetDownloadUrlForLayerInput struct { // The digest of the image layer to download. LayerDigest *string `locationName:"layerDigest" type:"string" required:"true"` // The AWS account ID associated with the registry that contains the image layer // to download. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository that is associated with the image layer to download. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (GetDownloadUrlForLayerInput) GoString ¶
func (s GetDownloadUrlForLayerInput) GoString() string
GoString returns the string representation
func (GetDownloadUrlForLayerInput) String ¶
func (s GetDownloadUrlForLayerInput) String() string
String returns the string representation
func (*GetDownloadUrlForLayerInput) Validate ¶ added in v1.1.21
func (s *GetDownloadUrlForLayerInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetDownloadUrlForLayerOutput ¶
type GetDownloadUrlForLayerOutput struct { // The pre-signed Amazon S3 download URL for the requested layer. DownloadUrl *string `locationName:"downloadUrl" type:"string"` // The digest of the image layer to download. LayerDigest *string `locationName:"layerDigest" type:"string"` // contains filtered or unexported fields }
func (GetDownloadUrlForLayerOutput) GoString ¶
func (s GetDownloadUrlForLayerOutput) GoString() string
GoString returns the string representation
func (GetDownloadUrlForLayerOutput) String ¶
func (s GetDownloadUrlForLayerOutput) String() string
String returns the string representation
type GetRepositoryPolicyInput ¶
type GetRepositoryPolicyInput struct { // The AWS account ID associated with the registry that contains the repository. // If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository whose policy you want to retrieve. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (GetRepositoryPolicyInput) GoString ¶
func (s GetRepositoryPolicyInput) GoString() string
GoString returns the string representation
func (GetRepositoryPolicyInput) String ¶
func (s GetRepositoryPolicyInput) String() string
String returns the string representation
func (*GetRepositoryPolicyInput) Validate ¶ added in v1.1.21
func (s *GetRepositoryPolicyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type GetRepositoryPolicyOutput ¶
type GetRepositoryPolicyOutput struct { // The JSON repository policy text associated with the repository. PolicyText *string `locationName:"policyText" type:"string"` // The registry ID associated with the request. RegistryId *string `locationName:"registryId" type:"string"` // The repository name associated with the request. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // contains filtered or unexported fields }
func (GetRepositoryPolicyOutput) GoString ¶
func (s GetRepositoryPolicyOutput) GoString() string
GoString returns the string representation
func (GetRepositoryPolicyOutput) String ¶
func (s GetRepositoryPolicyOutput) String() string
String returns the string representation
type Image ¶
type Image struct { // An object containing the image tag and image digest associated with an image. ImageId *ImageIdentifier `locationName:"imageId" type:"structure"` // The image manifest associated with the image. ImageManifest *string `locationName:"imageManifest" type:"string"` // The AWS account ID associated with the registry containing the image. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository associated with the image. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // contains filtered or unexported fields }
An object representing an Amazon ECR image.
type ImageFailure ¶
type ImageFailure struct { // The code associated with the failure. FailureCode *string `locationName:"failureCode" type:"string" enum:"ImageFailureCode"` // The reason for the failure. FailureReason *string `locationName:"failureReason" type:"string"` // The image ID associated with the failure. ImageId *ImageIdentifier `locationName:"imageId" type:"structure"` // contains filtered or unexported fields }
An object representing an Amazon ECR image failure.
func (ImageFailure) GoString ¶
func (s ImageFailure) GoString() string
GoString returns the string representation
func (ImageFailure) String ¶
func (s ImageFailure) String() string
String returns the string representation
type ImageIdentifier ¶
type ImageIdentifier struct { // The sha256 digest of the image manifest. ImageDigest *string `locationName:"imageDigest" type:"string"` // The tag used for the image. ImageTag *string `locationName:"imageTag" type:"string"` // contains filtered or unexported fields }
An object with identifying information for an Amazon ECR image.
func (ImageIdentifier) GoString ¶
func (s ImageIdentifier) GoString() string
GoString returns the string representation
func (ImageIdentifier) String ¶
func (s ImageIdentifier) String() string
String returns the string representation
type InitiateLayerUploadInput ¶
type InitiateLayerUploadInput struct { // The AWS account ID associated with the registry that you intend to upload // layers to. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository that you intend to upload layers to. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (InitiateLayerUploadInput) GoString ¶
func (s InitiateLayerUploadInput) GoString() string
GoString returns the string representation
func (InitiateLayerUploadInput) String ¶
func (s InitiateLayerUploadInput) String() string
String returns the string representation
func (*InitiateLayerUploadInput) Validate ¶ added in v1.1.21
func (s *InitiateLayerUploadInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type InitiateLayerUploadOutput ¶
type InitiateLayerUploadOutput struct { // The size, in bytes, that Amazon ECR expects future layer part uploads to // be. PartSize *int64 `locationName:"partSize" type:"long"` // The upload ID for the layer upload. This parameter is passed to further UploadLayerPart // and CompleteLayerUpload operations. UploadId *string `locationName:"uploadId" type:"string"` // contains filtered or unexported fields }
func (InitiateLayerUploadOutput) GoString ¶
func (s InitiateLayerUploadOutput) GoString() string
GoString returns the string representation
func (InitiateLayerUploadOutput) String ¶
func (s InitiateLayerUploadOutput) String() string
String returns the string representation
type Layer ¶
type Layer struct { // The availability status of the image layer. Valid values are AVAILABLE and // UNAVAILABLE. LayerAvailability *string `locationName:"layerAvailability" type:"string" enum:"LayerAvailability"` // The sha256 digest of the image layer. LayerDigest *string `locationName:"layerDigest" type:"string"` // The size, in bytes, of the image layer. LayerSize *int64 `locationName:"layerSize" type:"long"` // contains filtered or unexported fields }
An object representing an Amazon ECR image layer.
type LayerFailure ¶
type LayerFailure struct { // The failure code associated with the failure. FailureCode *string `locationName:"failureCode" type:"string" enum:"LayerFailureCode"` // The reason for the failure. FailureReason *string `locationName:"failureReason" type:"string"` // The layer digest associated with the failure. LayerDigest *string `locationName:"layerDigest" type:"string"` // contains filtered or unexported fields }
An object representing an Amazon ECR image layer failure.
func (LayerFailure) GoString ¶
func (s LayerFailure) GoString() string
GoString returns the string representation
func (LayerFailure) String ¶
func (s LayerFailure) String() string
String returns the string representation
type ListImagesFilter ¶ added in v1.4.0
type ListImagesFilter struct { TagStatus *string `locationName:"tagStatus" type:"string" enum:"TagStatus"` // contains filtered or unexported fields }
func (ListImagesFilter) GoString ¶ added in v1.4.0
func (s ListImagesFilter) GoString() string
GoString returns the string representation
func (ListImagesFilter) String ¶ added in v1.4.0
func (s ListImagesFilter) String() string
String returns the string representation
type ListImagesInput ¶
type ListImagesInput struct { Filter *ListImagesFilter `locationName:"filter" type:"structure"` // The maximum number of image results returned by ListImages in paginated output. // When this parameter is used, ListImages only returns maxResults results in // a single page along with a nextToken response element. The remaining results // of the initial request can be seen by sending another ListImages request // with the returned nextToken value. This value can be between 1 and 100. If // this parameter is not used, then ListImages returns up to 100 results and // a nextToken value, if applicable. MaxResults *int64 `locationName:"maxResults" min:"1" type:"integer"` // The nextToken value returned from a previous paginated ListImages request // where maxResults was used and the results exceeded the value of that parameter. // Pagination continues from the end of the previous results that returned the // nextToken value. This value is null when there are no more results to return. // // This token should be treated as an opaque identifier that is only used // to retrieve the next items in a list and not for other programmatic purposes. NextToken *string `locationName:"nextToken" type:"string"` // The AWS account ID associated with the registry that contains the repository // to list images in. If you do not specify a registry, the default registry // is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The repository whose image IDs are to be listed. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (ListImagesInput) GoString ¶
func (s ListImagesInput) GoString() string
GoString returns the string representation
func (ListImagesInput) String ¶
func (s ListImagesInput) String() string
String returns the string representation
func (*ListImagesInput) Validate ¶ added in v1.1.21
func (s *ListImagesInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type ListImagesOutput ¶
type ListImagesOutput struct { // The list of image IDs for the requested repository. ImageIds []*ImageIdentifier `locationName:"imageIds" min:"1" type:"list"` // The nextToken value to include in a future ListImages request. When the results // of a ListImages request exceed maxResults, this value can be used to retrieve // the next page of results. This value is null when there are no more results // to return. NextToken *string `locationName:"nextToken" type:"string"` // contains filtered or unexported fields }
func (ListImagesOutput) GoString ¶
func (s ListImagesOutput) GoString() string
GoString returns the string representation
func (ListImagesOutput) String ¶
func (s ListImagesOutput) String() string
String returns the string representation
type PutImageInput ¶
type PutImageInput struct { // The image manifest corresponding to the image to be uploaded. ImageManifest *string `locationName:"imageManifest" type:"string" required:"true"` // The AWS account ID associated with the registry that contains the repository // in which to put the image. If you do not specify a registry, the default // registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository in which to put the image. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (PutImageInput) GoString ¶
func (s PutImageInput) GoString() string
GoString returns the string representation
func (PutImageInput) String ¶
func (s PutImageInput) String() string
String returns the string representation
func (*PutImageInput) Validate ¶ added in v1.1.21
func (s *PutImageInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type PutImageOutput ¶
type PutImageOutput struct { // Details of the image uploaded. Image *Image `locationName:"image" type:"structure"` // contains filtered or unexported fields }
func (PutImageOutput) GoString ¶
func (s PutImageOutput) GoString() string
GoString returns the string representation
func (PutImageOutput) String ¶
func (s PutImageOutput) String() string
String returns the string representation
type Repository ¶
type Repository struct { // The AWS account ID associated with the registry that contains the repository. RegistryId *string `locationName:"registryId" type:"string"` // The Amazon Resource Name (ARN) that identifies the repository. The ARN contains // the arn:aws:ecr namespace, followed by the region of the repository, the // AWS account ID of the repository owner, the repository namespace, and then // the repository name. For example, arn:aws:ecr:region:012345678910:repository/test. RepositoryArn *string `locationName:"repositoryArn" type:"string"` // The name of the repository. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // The URI for the repository. You can use this URI for Docker push and pull // operations. RepositoryUri *string `locationName:"repositoryUri" type:"string"` // contains filtered or unexported fields }
An object representing a repository.
func (Repository) GoString ¶
func (s Repository) GoString() string
GoString returns the string representation
func (Repository) String ¶
func (s Repository) String() string
String returns the string representation
type SetRepositoryPolicyInput ¶
type SetRepositoryPolicyInput struct { // If the policy you are attempting to set on a repository policy would prevent // you from setting another policy in the future, you must force the SetRepositoryPolicy // operation. This is intended to prevent accidental repository lock outs. Force *bool `locationName:"force" type:"boolean"` // The JSON repository policy text to apply to the repository. PolicyText *string `locationName:"policyText" type:"string" required:"true"` // The AWS account ID associated with the registry that contains the repository. // If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository to receive the policy. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // contains filtered or unexported fields }
func (SetRepositoryPolicyInput) GoString ¶
func (s SetRepositoryPolicyInput) GoString() string
GoString returns the string representation
func (SetRepositoryPolicyInput) String ¶
func (s SetRepositoryPolicyInput) String() string
String returns the string representation
func (*SetRepositoryPolicyInput) Validate ¶ added in v1.1.21
func (s *SetRepositoryPolicyInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type SetRepositoryPolicyOutput ¶
type SetRepositoryPolicyOutput struct { // The JSON repository policy text applied to the repository. PolicyText *string `locationName:"policyText" type:"string"` // The registry ID associated with the request. RegistryId *string `locationName:"registryId" type:"string"` // The repository name associated with the request. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // contains filtered or unexported fields }
func (SetRepositoryPolicyOutput) GoString ¶
func (s SetRepositoryPolicyOutput) GoString() string
GoString returns the string representation
func (SetRepositoryPolicyOutput) String ¶
func (s SetRepositoryPolicyOutput) String() string
String returns the string representation
type UploadLayerPartInput ¶
type UploadLayerPartInput struct { // The base64-encoded layer part payload. // // LayerPartBlob is automatically base64 encoded/decoded by the SDK. LayerPartBlob []byte `locationName:"layerPartBlob" type:"blob" required:"true"` // The integer value of the first byte of the layer part. PartFirstByte *int64 `locationName:"partFirstByte" type:"long" required:"true"` // The integer value of the last byte of the layer part. PartLastByte *int64 `locationName:"partLastByte" type:"long" required:"true"` // The AWS account ID associated with the registry that you are uploading layer // parts to. If you do not specify a registry, the default registry is assumed. RegistryId *string `locationName:"registryId" type:"string"` // The name of the repository that you are uploading layer parts to. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string" required:"true"` // The upload ID from a previous InitiateLayerUpload operation to associate // with the layer part upload. UploadId *string `locationName:"uploadId" type:"string" required:"true"` // contains filtered or unexported fields }
func (UploadLayerPartInput) GoString ¶
func (s UploadLayerPartInput) GoString() string
GoString returns the string representation
func (UploadLayerPartInput) String ¶
func (s UploadLayerPartInput) String() string
String returns the string representation
func (*UploadLayerPartInput) Validate ¶ added in v1.1.21
func (s *UploadLayerPartInput) Validate() error
Validate inspects the fields of the type to determine if they are valid.
type UploadLayerPartOutput ¶
type UploadLayerPartOutput struct { // The integer value of the last byte received in the request. LastByteReceived *int64 `locationName:"lastByteReceived" type:"long"` // The registry ID associated with the request. RegistryId *string `locationName:"registryId" type:"string"` // The repository name associated with the request. RepositoryName *string `locationName:"repositoryName" min:"2" type:"string"` // The upload ID associated with the request. UploadId *string `locationName:"uploadId" type:"string"` // contains filtered or unexported fields }
func (UploadLayerPartOutput) GoString ¶
func (s UploadLayerPartOutput) GoString() string
GoString returns the string representation
func (UploadLayerPartOutput) String ¶
func (s UploadLayerPartOutput) String() string
String returns the string representation