public sealed class DockerImage : IMessage<DockerImage>, IEquatable<DockerImage>, IDeepCloneable<DockerImage>, IBufferMessage, IMessage
Reference documentation and code samples for the Artifact Registry v1 API class DockerImage.
DockerImage represents a docker artifact.
The following fields are returned as untyped metadata in the Version
resource, using camelcase keys (i.e. metadata.imageSizeBytes):
The time this image was built.
This field is returned as the 'metadata.buildTime' field in the
Version resource.
The build time is returned to the client as an RFC 3339 string, which can
be easily used with the JavaScript Date constructor.
Media type of this image, e.g.
"application/vnd.docker.distribution.manifest.v2+json".
This field is returned as the 'metadata.mediaType' field in the
Version resource.
Required. registry_location, project_id, repository_name and image id forms
a unique image
name:projects/<project_id>/locations/<location>/repository/<repository_name>/dockerImages/<docker_image>.
For example,
"projects/test-project/locations/us-west4/repositories/test-repo/dockerImages/
nginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf",
where "us-west4" is the registry_location, "test-project" is the
project_id, "test-repo" is the repository_name and
"nginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf"
is the image's digest.
Required. URL to access the image.
Example:
us-west4-docker.pkg.dev/test-project/test-repo/nginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eDockerImage\u003c/code\u003e class within the Google Cloud Artifact Registry v1 API represents a Docker artifact, and its latest version is 2.9.0, with prior versions available back to 1.0.0.\u003c/p\u003e\n"],["\u003cp\u003eThe class includes properties such as \u003ccode\u003eImageSizeBytes\u003c/code\u003e, \u003ccode\u003eMediaType\u003c/code\u003e, and \u003ccode\u003eBuildTime\u003c/code\u003e, which are returned as untyped metadata in the Version resource, providing key information about the Docker image.\u003c/p\u003e\n"],["\u003cp\u003eIt is identifiable by a unique name that includes the registry location, project ID, repository name, and image ID, structured like: \u003ccode\u003eprojects/<project_id>/locations/<location>/repository/<repository_name>/dockerImages/<docker_image>\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eDockerImage\u003c/code\u003e also tracks update time, upload time, and build time through \u003ccode\u003eTimestamp\u003c/code\u003e objects, and provides a \u003ccode\u003eUri\u003c/code\u003e property for direct access to the image.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eDockerImage\u003c/code\u003e class allows the attachment of multiple \u003ccode\u003eTags\u003c/code\u003e, is constructable, and implements multiple interfaces, including \u003ccode\u003eIMessage\u003c/code\u003e, \u003ccode\u003eIEquatable\u003c/code\u003e, \u003ccode\u003eIDeepCloneable\u003c/code\u003e, and \u003ccode\u003eIBufferMessage\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Artifact Registry v1 API - Class DockerImage (2.10.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.10.0 (latest)](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.9.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.9.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.8.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.8.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.7.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.7.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.6.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.6.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.5.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.5.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.4.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.4.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.3.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.3.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.2.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.2.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.1.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.1.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [2.0.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/2.0.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [1.1.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/1.1.0/Google.Cloud.ArtifactRegistry.V1.DockerImage)\n- [1.0.0](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/1.0.0/Google.Cloud.ArtifactRegistry.V1.DockerImage) \n\n public sealed class DockerImage : IMessage\u003cDockerImage\u003e, IEquatable\u003cDockerImage\u003e, IDeepCloneable\u003cDockerImage\u003e, IBufferMessage, IMessage\n\nReference documentation and code samples for the Artifact Registry v1 API class DockerImage.\n\nDockerImage represents a docker artifact.\nThe following fields are returned as untyped metadata in the Version\nresource, using camelcase keys (i.e. metadata.imageSizeBytes):\n\n- imageSizeBytes\n- mediaType\n- buildTime \n\nInheritance\n-----------\n\n[object](https://learn.microsoft.com/dotnet/api/system.object) \\\u003e DockerImage \n\nImplements\n----------\n\n[IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage-1.html)[DockerImage](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImage), [IEquatable](https://learn.microsoft.com/dotnet/api/system.iequatable-1)[DockerImage](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImage), [IDeepCloneable](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IDeepCloneable-1.html)[DockerImage](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImage), [IBufferMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IBufferMessage.html), [IMessage](https://cloud.google.com/dotnet/docs/reference/Google.Protobuf/latest/Google.Protobuf.IMessage.html) \n\nInherited Members\n-----------------\n\n[object.GetHashCode()](https://learn.microsoft.com/dotnet/api/system.object.gethashcode) \n[object.GetType()](https://learn.microsoft.com/dotnet/api/system.object.gettype) \n[object.ToString()](https://learn.microsoft.com/dotnet/api/system.object.tostring)\n\nNamespace\n---------\n\n[Google.Cloud.ArtifactRegistry.V1](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1)\n\nAssembly\n--------\n\nGoogle.Cloud.ArtifactRegistry.V1.dll\n\nConstructors\n------------\n\n### DockerImage()\n\n public DockerImage()\n\n### DockerImage(DockerImage)\n\n public DockerImage(DockerImage other)\n\nProperties\n----------\n\n### BuildTime\n\n public Timestamp BuildTime { get; set; }\n\nThe time this image was built.\nThis field is returned as the 'metadata.buildTime' field in the\nVersion resource.\nThe build time is returned to the client as an RFC 3339 string, which can\nbe easily used with the JavaScript Date constructor.\n\n### DockerImageName\n\n public DockerImageName DockerImageName { get; set; }\n\n[DockerImageName](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImageName)-typed view over the [Name](/dotnet/docs/reference/Google.Cloud.ArtifactRegistry.V1/latest/Google.Cloud.ArtifactRegistry.V1.DockerImage#Google_Cloud_ArtifactRegistry_V1_DockerImage_Name) resource name property.\n\n### ImageSizeBytes\n\n public long ImageSizeBytes { get; set; }\n\nCalculated size of the image.\nThis field is returned as the 'metadata.imageSizeBytes' field in the\nVersion resource.\n\n### MediaType\n\n public string MediaType { get; set; }\n\nMedia type of this image, e.g.\n\"application/vnd.docker.distribution.manifest.v2+json\".\nThis field is returned as the 'metadata.mediaType' field in the\nVersion resource.\n\n### Name\n\n public string Name { get; set; }\n\nRequired. registry_location, project_id, repository_name and image id forms\na unique image\nname:`projects/\u003cproject_id\u003e/locations/\u003clocation\u003e/repository/\u003crepository_name\u003e/dockerImages/\u003cdocker_image\u003e`.\nFor example,\n\"projects/test-project/locations/us-west4/repositories/test-repo/dockerImages/\nnginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf\",\nwhere \"us-west4\" is the registry_location, \"test-project\" is the\nproject_id, \"test-repo\" is the repository_name and\n\"nginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf\"\nis the image's digest.\n\n### Tags\n\n public RepeatedField\u003cstring\u003e Tags { get; }\n\nTags attached to this image.\n\n### UpdateTime\n\n public Timestamp UpdateTime { get; set; }\n\nOutput only. The time when the docker image was last updated.\n\n### UploadTime\n\n public Timestamp UploadTime { get; set; }\n\nTime the image was uploaded.\n\n### Uri\n\n public string Uri { get; set; }\n\nRequired. URL to access the image.\nExample:\nus-west4-docker.pkg.dev/test-project/test-repo/nginx@sha256:e9954c1fc875017be1c3e36eca16be2d9e9bccc4bf072163515467d6a823c7cf"]]
