openapi: 3.2.0 info: description: "Use the Artifacts and Container Images API to manage container images and non-container generic artifacts. \n\n- For container images such as Docker images, use the [ContainerImage](#/en/registry/latest/ContainerImage/) resource. Save the images in a [container repository](#/en/registry/latest/ContainerRepository).\n\n- For non-container generic artifacts or blobs, use the [GenericArtifact](#/en/registry/latest/GenericArtifact/) resource. Save the artifacts in an [artifact repository](#/en/registry/latest/Repository).\n- To upload and download non-container generic artifacts, instead of the Artifacts and Container Images API, use the [Generic Artifacts Content API](#/en/generic/latest/).\nFor more information, see the user guides for [Container Registry](/iaas/Content/Registry/home.htm) and [Artifact Registry](/iaas/Content/artifacts/home.htm).\n" license: name: Oracle Corporation title: Container Images Artifacts API version: '20160918' x-provenance: method: harvested first_party: true publisher: Oracle source: https://docs.oracle.com/en-us/iaas/api/specs/76d31f24bad6516f91d80c0ed4ef939ddb9a642130bbc33a526b173e7983fa11.yaml harvested: '2026-08-04' note: Published by Oracle as the contract for the Artifacts and Container Images API OCI service and stored verbatim; API Evangelist added only this provenance block. x-evidence: - url: https://docs.oracle.com/en-us/iaas/api/specs/index.json what: Oracle's own index of every OCI service specification - url: https://docs.oracle.com/en-us/iaas/api/specs/76d31f24bad6516f91d80c0ed4ef939ddb9a642130bbc33a526b173e7983fa11.yaml what: the harvested document for Artifacts and Container Images API servers: - url: /20160918 tags: - name: artifacts paths: /container/configuration: get: description: Get container configuration. operationId: GetContainerConfiguration parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container configuration. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerConfiguration' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetContainerConfiguration tags: - artifacts x-related-resource: '#/definitions/ContainerConfiguration' put: description: Update container configuration. operationId: UpdateContainerConfiguration parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container configuration. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerConfiguration' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: UpdateContainerConfiguration tags: - artifacts requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateContainerConfigurationDetails' description: Update container configuration details. required: true /container/imageSignatures: get: description: List container image signatures in an image. operationId: ListContainerImageSignatures parameters: - $ref: '#/components/parameters/CompartmentIdInSubtreeQueryParam' - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/FilterByContainerImageIdQueryParam' - $ref: '#/components/parameters/FilterByContainerRepositoryIdQueryParam' - $ref: '#/components/parameters/FilterByContainerRepositoryNameQueryParam' - $ref: '#/components/parameters/FilterByContainerDigestQueryParam' - $ref: '#/components/parameters/FilterByDisplayNameQueryParam' - $ref: '#/components/parameters/FilterByKmsKeyIdQueryParam' - $ref: '#/components/parameters/FilterByKmsKeyVersionIdQueryParam' - $ref: '#/components/parameters/FilterBySigningAlgorithmDigestQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: 200: description: The container image signature collection. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImageSignatureCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ListContainerImageSignatures tags: - artifacts x-related-resource: '#/definitions/ContainerImageSignatureSummary' post: description: Upload a signature to an image. operationId: CreateContainerImageSignature parameters: - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' - $ref: '#/components/parameters/IfMatchHeader' responses: 200: description: The container image signature metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImageSignature' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: CreateContainerImageSignature tags: - artifacts x-related-resource: '#/definitions/ContainerImageSignature' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateContainerImageSignatureDetails' description: Upload container image signature details required: true /container/imageSignatures/{imageSignatureId}: delete: description: Delete a container image signature. operationId: DeleteContainerImageSignature parameters: - $ref: '#/components/parameters/ContainerImageSignatureIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/IfMatchHeader' responses: 204: description: The container image signature has been deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteContainerImageSignature tags: - artifacts x-related-resource: '#/definitions/ContainerImageSignature' get: description: Get container image signature metadata. operationId: GetContainerImageSignature parameters: - $ref: '#/components/parameters/ContainerImageSignatureIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container image signature metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImageSignature' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetContainerImageSignature tags: - artifacts x-related-resource: '#/definitions/ContainerImageSignature' put: description: Modify the properties of a container image signature. Avoid entering confidential information. operationId: UpdateContainerImageSignature parameters: - $ref: '#/components/parameters/ContainerImageSignatureIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/IfMatchHeader' responses: 200: description: The container image signature. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImageSignature' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: Updates properties of container image signatures tags: - artifacts x-related-resource: '#/definitions/ContainerImageSignature' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateContainerImageSignatureDetails' description: Update container image signature details. required: true /container/images: get: description: List container images in a compartment. operationId: ListContainerImages parameters: - $ref: '#/components/parameters/CompartmentIdInSubtreeQueryParam' - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/FilterByDisplayNameQueryParam' - $ref: '#/components/parameters/FilterByContainerImageIdQueryParam' - $ref: '#/components/parameters/FilterByContainerIsVersionedQueryParam' - $ref: '#/components/parameters/FilterByContainerRepositoryIdQueryParam' - $ref: '#/components/parameters/FilterByContainerRepositoryNameQueryParam' - $ref: '#/components/parameters/FilterByContainerVersionQueryParam' - $ref: '#/components/parameters/FilterByLifecycleStateQueryParam' - $ref: '#/components/parameters/FilterByContainerDigestQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: 200: description: The container image collection. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImageCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ListContainerImages tags: - artifacts x-related-resource: '#/definitions/ContainerImageSummary' /container/images/actions/lookupImageByUri: post: description: Get container image metadata by URI. operationId: LookupContainerImageByUri parameters: - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container image metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImage' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: LookupContainerImageByUri tags: - artifacts x-related-resource: '#/definitions/ContainerImage' requestBody: content: application/json: schema: $ref: '#/components/schemas/LookupContainerImageByUriDetails' description: Get container image metadata by URI. required: true /container/images/{imageId}: delete: description: Delete a container image. operationId: DeleteContainerImage parameters: - $ref: '#/components/parameters/ContainerImageIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 204: description: The container image has been deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteContainerImage tags: - artifacts x-related-resource: '#/definitions/ContainerImage' get: description: Get container image metadata. operationId: GetContainerImage parameters: - $ref: '#/components/parameters/ContainerImageIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container image metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImage' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetContainerImage tags: - artifacts x-related-resource: '#/definitions/ContainerImage' put: description: Modify the properties of a container image. Avoid entering confidential information. operationId: UpdateContainerImage parameters: - $ref: '#/components/parameters/ContainerImageIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container image. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImage' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: Updates properties of container images tags: - artifacts x-related-resource: '#/definitions/ContainerImage' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateContainerImageDetails' description: Update container image details. required: true /container/images/{imageId}/actions/removeVersion: post: description: Remove version from container image. operationId: RemoveContainerVersion parameters: - $ref: '#/components/parameters/ContainerImageIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 200: description: The container image metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImage' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: RemoveContainerVersion tags: - artifacts x-related-resource: '#/definitions/ContainerImage' requestBody: content: application/json: schema: $ref: '#/components/schemas/RemoveContainerVersionDetails' description: Remove version details. required: true /container/images/{imageId}/actions/restore: post: description: Restore a container image. operationId: RestoreContainerImage parameters: - $ref: '#/components/parameters/ContainerImageIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 200: description: The container image metadata. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerImage' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: RestoreContainerImage tags: - artifacts x-related-resource: '#/definitions/ContainerImage' requestBody: content: application/json: schema: $ref: '#/components/schemas/RestoreContainerImageDetails' description: Restore container image details. required: true /container/repositories: get: description: List container repositories in a compartment. operationId: ListContainerRepositories parameters: - $ref: '#/components/parameters/CompartmentIdInSubtreeQueryParam' - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/FilterByContainerRepositoryIdQueryParam' - $ref: '#/components/parameters/FilterByDisplayNameQueryParam' - $ref: '#/components/parameters/FilterByIsPublicQueryParam' - $ref: '#/components/parameters/FilterByLifecycleStateQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: 200: description: The container repository collection. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerRepositoryCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ListContainerRepositories tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' post: description: Create a new empty container repository. Avoid entering confidential information. operationId: CreateContainerRepository parameters: - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 200: description: The created container repository. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerRepository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: CreateContainerRepository tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateContainerRepositoryDetails' description: Create container repository details. required: true /container/repositories/{repositoryId}: delete: description: Delete container repository. operationId: DeleteContainerRepository parameters: - $ref: '#/components/parameters/ContainerRepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 204: description: The container repository has been deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteContainerRepository tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' get: description: Get container repository. operationId: GetContainerRepository parameters: - $ref: '#/components/parameters/ContainerRepositoryIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container repository. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerRepository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetContainerRepository tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' put: description: Modify the properties of a container repository. Avoid entering confidential information. operationId: UpdateContainerRepository parameters: - $ref: '#/components/parameters/ContainerRepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The container repository. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/ContainerRepository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: UpdateContainerRepository tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateContainerRepositoryDetails' description: Update container repository details. required: true /container/repositories/{repositoryId}/actions/changeCompartment: post: description: 'Moves a container repository into a different compartment within the same tenancy. For information about moving resources between compartments, see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes). ' operationId: ChangeContainerRepositoryCompartment parameters: - $ref: '#/components/parameters/ContainerRepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 204: description: The container repository has been moved to the compartment. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ChangeContainerRepositoryCompartment tags: - artifacts x-related-resource: '#/definitions/ContainerRepository' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangeContainerRepositoryCompartmentDetails' description: Change container repository compartment details. required: true /generic/artifacts: get: description: Lists artifacts in the specified repository. operationId: ListGenericArtifacts parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/FilterByRepositoryIdQueryParam' - $ref: '#/components/parameters/FilterByIdQueryParam' - $ref: '#/components/parameters/FilterByDisplayNameQueryParam' - $ref: '#/components/parameters/FilterByGenericArtifactPathContainsQueryParam' - $ref: '#/components/parameters/FilterByGenericArtifactVersionContainsQueryParam' - $ref: '#/components/parameters/FilterByGenericArtifactSha256QueryParam' - $ref: '#/components/parameters/FilterByLifecycleStateQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: 200: description: The list of artifacts was retrieved successfully. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/GenericArtifactCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ListGenericArtifacts tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' /generic/artifacts/{artifactId}: delete: description: Deletes an artifact with a specified [OCID](/iaas/Content/General/Concepts/identifiers.htm). operationId: DeleteGenericArtifact parameters: - $ref: '#/components/parameters/GenericArtifactIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 204: description: The specified artifact was deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 403: $ref: '#/components/responses/403' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteGenericArtifact tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' get: description: Gets information about an artifact with a specified [OCID](/iaas/Content/General/Concepts/identifiers.htm). operationId: GetGenericArtifact parameters: - $ref: '#/components/parameters/GenericArtifactIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The artifact information was retrieved successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/GenericArtifact' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 403: $ref: '#/components/responses/403' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetGenericArtifact tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' put: description: Updates the artifact with the specified [OCID](/iaas/Content/General/Concepts/identifiers.htm). You can only update the tags of an artifact. operationId: UpdateGenericArtifact parameters: - $ref: '#/components/parameters/GenericArtifactIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The artifact was updated successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/GenericArtifact' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 403: $ref: '#/components/responses/403' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: UpdateGenericArtifact tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateGenericArtifactDetails' description: Updates the artifact with the specified [OCID](/iaas/Content/General/Concepts/identifiers.htm). You can only update the tags of an artifact. required: true /generic/repositories/{repositoryId}/artifactPaths/{artifactPath}/versions/{version}: delete: description: Deletes an artifact with a specified `artifactPath` and `version`. operationId: DeleteGenericArtifactByPath parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/GenericArtifactPathPathParam' - $ref: '#/components/parameters/GenericArtifactVersionPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 204: description: The specified artifact was deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteGenericArtifactByPath tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' get: description: Gets information about an artifact with a specified `artifactPath` and `version`. operationId: GetGenericArtifactByPath parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/GenericArtifactPathPathParam' - $ref: '#/components/parameters/GenericArtifactVersionPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The information about the artifact with the specified `artifactPath` and `version` was retrieved successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/GenericArtifact' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetGenericArtifactByPath tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' put: description: Updates an artifact with a specified `artifactPath` and `version`. You can only update the tags of an artifact. operationId: UpdateGenericArtifactByPath parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/GenericArtifactPathPathParam' - $ref: '#/components/parameters/GenericArtifactVersionPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The artifact with the specified `artifactPath` and `version` was updated successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/GenericArtifact' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: UpdateGenericArtifactByPath tags: - artifacts x-related-resource: '#/definitions/GenericArtifact' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateGenericArtifactByPathDetails' description: Updates an artifact with a specified `artifactPath` and `version`. You can only update the tags of an artifact. required: true /repositories: get: description: Lists repositories in the specified compartment. operationId: ListRepositories parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/FilterByIdQueryParam' - $ref: '#/components/parameters/FilterByDisplayNameQueryParam' - $ref: '#/components/parameters/FilterByIsImmutableQueryParam' - $ref: '#/components/parameters/FilterByLifecycleStateQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/SortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: 200: description: The list of repositories was retrieved successfully. headers: opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/RepositoryCollection' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 403: $ref: '#/components/responses/403' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ListRepositories tags: - artifacts x-related-resource: '#/definitions/Repository' post: description: Creates a new repository for storing artifacts. operationId: CreateRepository parameters: - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 200: description: The repository was created successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/Repository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 403: $ref: '#/components/responses/403' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: CreateRepository tags: - artifacts x-obmcs-client-retries-enabled: false x-related-resource: '#/definitions/Repository' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateRepositoryDetails' description: Creates a new repository for storing artifacts. required: true /repositories/{repositoryId}: delete: description: Deletes the specified repository. This operation fails unless all associated artifacts are in a DELETED state. You must delete all associated artifacts before deleting a repository. operationId: DeleteRepository parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 204: description: The specified repository was deleted. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: DeleteRepository tags: - artifacts x-related-resource: '#/definitions/Repository' get: description: Gets the specified repository's information. operationId: GetRepository parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The repository information was retrieved successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/Repository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: GetRepository tags: - artifacts x-related-resource: '#/definitions/Repository' put: description: Updates the properties of a repository. You can update the `displayName` and `description` properties. operationId: UpdateRepository parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' responses: 200: description: The repository was updated successfully. headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' schema: type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/Repository' 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: UpdateRepository tags: - artifacts x-related-resource: '#/definitions/Repository' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateRepositoryDetails' description: Updates the properties of a repository. required: true /repositories/{repositoryId}/actions/changeCompartment: post: description: 'Moves a repository into a different compartment within the same tenancy. For information about moving resources between compartments, see [Moving Resources to a Different Compartment](/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes). ' operationId: ChangeRepositoryCompartment parameters: - $ref: '#/components/parameters/RepositoryIdPathParam' - $ref: '#/components/parameters/IfMatchHeader' - $ref: '#/components/parameters/RequestIdHeader' - $ref: '#/components/parameters/RetryTokenHeader' responses: 204: description: The repository was successfully moved to the specified compartment. headers: opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' schema: type: string 400: $ref: '#/components/responses/400' 401: $ref: '#/components/responses/401' 404: $ref: '#/components/responses/404' 409: $ref: '#/components/responses/409' 412: $ref: '#/components/responses/412' 429: $ref: '#/components/responses/429' 500: $ref: '#/components/responses/500' summary: ChangeRepositoryCompartment tags: - artifacts x-related-resource: '#/definitions/Repository' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangeRepositoryCompartmentDetails' description: Moves a repository into a different compartment. required: true components: schemas: ContainerRepositoryReadme: description: Container repository readme. properties: content: description: Readme content. Avoid entering confidential information. maxLength: 8192 minLength: 0 type: string format: description: Readme format. Supported formats are text/plain and text/markdown. enum: - TEXT_MARKDOWN - TEXT_PLAIN type: string required: - content - format ContainerVersion: description: Container version metadata. properties: createdBy: description: The OCID of the user or principal that pushed the version. maxLength: 100 minLength: 1 type: string timeCreated: description: The creation time of the version. format: date-time type: string version: description: The version name. maxLength: 128 minLength: 1 type: string required: - createdBy - timeCreated - version ChangeRepositoryCompartmentDetails: description: Details for changing a repository's compartment. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment into which the repository should be moved. ' maxLength: 100 minLength: 1 type: string required: - compartmentId type: object UpdateContainerRepositoryDetails: description: Update container repository request details. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object isImmutable: description: Whether the repository is immutable. Images cannot be overwritten in an immutable repository. type: boolean isPublic: description: Whether the repository is public. A public repository allows unauthenticated access. type: boolean readme: $ref: '#/components/schemas/ContainerRepositoryReadme' GenericArtifactSummary: description: Summary information for an artifact. properties: artifactPath: description: 'A user-defined path to describe the location of an artifact. Slashes do not create a directory structure, but you can use slashes to organize the repository. An artifact path does not include an artifact version. Example: `project01/my-web-app/artifact-abc` ' maxLength: 256 minLength: 1 type: string compartmentId: description: The OCID of the artifact's compartment. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'The artifact name with the format of `:`. The artifact name is truncated to a maximum length of 255. Example: `project01/my-web-app/artifact-abc:1.0.0` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the artifact. Example: `ocid1.genericartifact.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string lifecycleState: description: The current state of the generic artifact. type: string x-obmcs-enumref: '#/definitions/GenericArtifact/lifecycleState' repositoryId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the repository. maxLength: 255 minLength: 1 type: string sha256: description: The SHA256 digest for the artifact. When you upload an artifact to the repository, a SHA256 digest is calculated and added to the artifact properties. maxLength: 64 minLength: 1 type: string sizeInBytes: description: The size of the artifact in bytes. format: int64 type: integer timeCreated: description: An RFC 3339 timestamp indicating when the artifact was created. format: date-time type: string version: description: 'A user-defined string to describe the artifact version. Example: `1.1.0` or `1.2-beta-2` ' maxLength: 128 minLength: 1 type: string required: - id - displayName - compartmentId - repositoryId - artifactPath - version - sha256 - sizeInBytes - lifecycleState - freeformTags - definedTags - timeCreated UpdateContainerConfigurationDetails: description: Update container configuration request details. properties: isRepositoryCreatedOnFirstPush: description: 'Whether to create a new container repository when a container is pushed to a new repository path. Repositories created in this way belong to the root compartment. ' type: boolean UpdateContainerImageSignatureDetails: description: Details for updating a container image signature. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object ContainerRepositorySummary: description: Container repository summary. properties: billableSizeInGBs: description: Total storage size in GBs that will be charged. format: int64 type: integer compartmentId: description: The OCID of the compartment in which the container repository exists. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: The container repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the container repository. Example: `ocid1.containerrepo.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string imageCount: description: Total number of images. format: int32 type: integer isPublic: description: Whether the repository is public. A public repository allows unauthenticated access. type: boolean layerCount: description: Total number of layers. format: int32 type: integer layersSizeInBytes: description: Total storage in bytes consumed by layers. format: int64 type: integer lifecycleState: description: The current state of the container repository. type: string x-obmcs-enumref: '#/definitions/ContainerRepository/lifecycleState' namespace: description: The tenancy namespace used in the container repository path. maxLength: 64 minLength: 1 type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the repository was created. format: date-time type: string required: - compartmentId - displayName - id - imageCount - isPublic - layerCount - layersSizeInBytes - lifecycleState - timeCreated - billableSizeInGBs - namespace - freeformTags - definedTags - systemTags GenericArtifact: description: The metadata of the artifact. properties: artifactPath: description: 'A user-defined path to describe the location of an artifact. Slashes do not create a directory structure, but you can use slashes to organize the repository. An artifact path does not include an artifact version. Example: `project01/my-web-app/artifact-abc` ' maxLength: 256 minLength: 1 type: string compartmentId: description: The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the repository's compartment. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'The artifact name with the format of `:`. The artifact name is truncated to a maximum length of 255. Example: `project01/my-web-app/artifact-abc:1.0.0` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the artifact. Example: `ocid1.genericartifact.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string lifecycleState: description: The current state of the artifact. enum: - AVAILABLE - DELETING - DELETED type: string repositoryId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the repository. maxLength: 255 minLength: 1 type: string sha256: description: The SHA256 digest for the artifact. When you upload an artifact to the repository, a SHA256 digest is calculated and added to the artifact properties. maxLength: 64 minLength: 1 type: string sizeInBytes: description: The size of the artifact in bytes. format: int64 type: integer timeCreated: description: An RFC 3339 timestamp indicating when the repository was created. format: date-time type: string version: description: 'A user-defined string to describe the artifact version. Example: `1.1.0` or `1.2-beta-2` ' maxLength: 128 minLength: 1 type: string required: - id - displayName - compartmentId - repositoryId - artifactPath - version - sha256 - sizeInBytes - lifecycleState - freeformTags - definedTags - timeCreated UpdateGenericArtifactByPathDetails: description: Details for updating an artifact by providing its `artifactPath` and `version`. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object ContainerConfiguration: description: Container configuration. properties: isRepositoryCreatedOnFirstPush: description: 'Whether to create a new container repository when a container is pushed to a new repository path. Repositories created in this way belong to the root compartment. ' type: boolean namespace: description: The tenancy namespace used in the container repository path. maxLength: 64 minLength: 1 type: string required: - isRepositoryCreatedOnFirstPush - namespace ContainerImageCollection: description: List container image results. properties: items: description: Page of matching container images. items: $ref: '#/components/schemas/ContainerImageSummary' type: array remainingItemsCount: description: Estimated number of remaining results. format: int32 type: integer required: - items - remainingItemsCount GenericArtifactCollection: description: A list of artifacts. properties: items: description: The listed artifacts. items: $ref: '#/components/schemas/GenericArtifactSummary' type: array required: - items ContainerImageSignature: description: Container image signature metadata. properties: compartmentId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment in which the container repository exists. maxLength: 100 minLength: 1 type: string createdBy: description: The id of the user or principal that created the resource. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'The last 10 characters of the kmsKeyId, the last 10 characters of the kmsKeyVersionId, the signingAlgorithm, and the last 10 characters of the signatureId. Example: `wrmz22sixa::qdwyc2ptun::SHA_256_RSA_PKCS_PSS::2vwmobasva` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image signature. Example: `ocid1.containerimagesignature.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string imageId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyId used to sign the container image. Example: `ocid1.key.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyVersionId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyVersionId used to sign the container image. Example: `ocid1.keyversion.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string lifecycleState: description: The current state of the container image signature. enum: - AVAILABLE - DELETING - DELETED type: string message: description: The base64 encoded signature payload that was signed. maxLength: 1024 minLength: 1 type: string signature: description: The signature of the message field using the kmsKeyId, the kmsKeyVersionId, and the signingAlgorithm. maxLength: 684 minLength: 1 type: string signingAlgorithm: description: The algorithm to be used for signing. These are the only supported signing algorithms for container images. enum: - SHA_224_RSA_PKCS_PSS - SHA_256_RSA_PKCS_PSS - SHA_384_RSA_PKCS_PSS - SHA_512_RSA_PKCS_PSS type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the image was created. format: date-time type: string required: - compartmentId - createdBy - displayName - id - imageId - kmsKeyId - kmsKeyVersionId - message - signature - signingAlgorithm - timeCreated - lifecycleState - freeformTags - definedTags - systemTags ContainerImageSignatureCollection: description: List container image signature results. properties: items: description: Page of matching container image signatures. items: $ref: '#/components/schemas/ContainerImageSignatureSummary' type: array remainingItemsCount: description: Estimated number of remaining results. format: int32 type: integer required: - items - remainingItemsCount ContainerImageLayer: description: The container image layer metadata. properties: digest: description: The sha256 digest of the image layer. maxLength: 128 minLength: 1 type: string sizeInBytes: description: The size of the layer in bytes. format: int64 type: integer timeCreated: description: An RFC 3339 timestamp indicating when the layer was created. format: date-time type: string required: - digest - sizeInBytes - timeCreated ChangeContainerRepositoryCompartmentDetails: description: Change container repository compartment details. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment into which to move the resource. ' maxLength: 100 minLength: 1 type: string required: - compartmentId type: object CreateContainerRepositoryDetails: description: Create container repository details. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment in which to create the resource. ' maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: The container repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object isImmutable: description: Whether the repository is immutable. Images cannot be overwritten in an immutable repository. Currently, setting this flag is not supported yet and is set to false by default. type: boolean isPublic: description: Whether the repository is public. A public repository allows unauthenticated access. type: boolean readme: $ref: '#/components/schemas/ContainerRepositoryReadme' required: - compartmentId - displayName RepositoryCollection: description: A list of repositories. properties: items: description: The listed repositories. items: $ref: '#/components/schemas/RepositorySummary' type: array required: - items ContainerImage: description: Container image metadata. properties: compartmentId: description: The compartment OCID to which the container image belongs. Inferred from the container repository. maxLength: 100 minLength: 1 type: string createdBy: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the user or principal that created the resource. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object digest: description: The container image digest. maxLength: 128 minLength: 1 type: string displayName: description: 'The repository name and the most recent version associated with the image. If there are no versions associated with the image, then last known version and digest are used instead. If the last known version is unavailable, then ''unknown'' is used instead of the version. Example: `ubuntu:latest` or `ubuntu:latest@sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string layers: description: Layers of which the image is composed, ordered by the layer digest. items: $ref: '#/components/schemas/ContainerImageLayer' type: array layersSizeInBytes: description: The total size of the container image layers in bytes. format: int64 type: integer lifecycleState: description: The current state of the container image. enum: - AVAILABLE - DELETED - DELETING type: string manifestSizeInBytes: description: The size of the container image manifest in bytes. format: int32 type: integer pullCount: description: Total number of pulls. format: int64 type: integer repositoryId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the container repository. maxLength: 255 minLength: 1 type: string repositoryName: description: The container repository name. maxLength: 255 minLength: 1 type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the image was created. format: date-time type: string timeLastPulled: description: An RFC 3339 timestamp indicating when the image was last pulled. format: date-time type: string version: description: The most recent version associated with this image. maxLength: 128 minLength: 1 type: string versions: description: The versions associated with this image. items: $ref: '#/components/schemas/ContainerVersion' type: array required: - compartmentId - createdBy - digest - displayName - id - layers - layersSizeInBytes - lifecycleState - manifestSizeInBytes - pullCount - repositoryId - repositoryName - timeCreated - versions - freeformTags - definedTags - systemTags RestoreContainerImageDetails: description: Undelete container image request details. properties: version: description: Optional version to associate with image. maxLength: 128 minLength: 1 type: string x-default-description: 'null' LookupContainerImageByUriDetails: description: Details for fetching a container image by its URI. properties: imageUri: description: 'The container image URI starting with the namespace. Example: namespace/reponame:version Example: namespace/reponame@sha256:50d858e0985ecc7f60418aaf0cc5ab587f42c2570a884095a9e8ccacd0f6545c ' maxLength: 512 minLength: 1 type: string x-default-description: 'null' required: - imageUri CreateContainerImageSignatureDetails: description: Upload container image signature request details. properties: compartmentId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment in which the container repository exists. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object imageId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyId used to sign the container image. Example: `ocid1.key.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyVersionId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyVersionId used to sign the container image. Example: `ocid1.keyversion.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string message: description: The base64 encoded signature payload that was signed. maxLength: 1024 minLength: 1 type: string signature: description: The signature of the message field using the kmsKeyId, the kmsKeyVersionId, and the signingAlgorithm. maxLength: 684 minLength: 1 type: string signingAlgorithm: description: The algorithm to be used for signing. These are the only supported signing algorithms for container images. enum: - SHA_224_RSA_PKCS_PSS - SHA_256_RSA_PKCS_PSS - SHA_384_RSA_PKCS_PSS - SHA_512_RSA_PKCS_PSS type: string required: - compartmentId - imageId - kmsKeyId - kmsKeyVersionId - message - signature - signingAlgorithm CreateRepositoryDetails: description: Parameters needed to create an artifact repository. discriminator: propertyName: repositoryType properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the repository''s compartment. ' maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object description: description: A short description of the repository. It can be updated later. maxLength: 400 minLength: 1 type: string displayName: description: A user-friendly display name for the repository. If not present, will be auto-generated. It can be modified later. Avoid entering confidential information. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object isImmutable: description: Whether to make the repository immutable. The artifacts of an immutable repository cannot be overwritten. type: boolean repositoryType: description: The repository's supported artifact type. type: string x-obmcs-enumref: '#/definitions/Repository/repositoryType' required: - compartmentId - repositoryType - isImmutable RepositorySummary: description: Summary information for a repository. discriminator: propertyName: repositoryType properties: compartmentId: description: The OCID of the repository's compartment. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object description: description: The repository description. maxLength: 400 minLength: 1 type: string displayName: description: The repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the repository. Example: `ocid1.artifactrepository.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string isImmutable: description: Whether the repository is immutable. The artifacts of an immutable repository cannot be overwritten. type: boolean lifecycleState: description: The current state of the artifact repository. type: string x-obmcs-enumref: '#/definitions/Repository/lifecycleState' repositoryType: description: The repository's supported artifact type. type: string x-obmcs-enumref: '#/definitions/Repository/repositoryType' timeCreated: description: An RFC 3339 timestamp indicating when the repository was created. format: date-time type: string required: - id - displayName - compartmentId - repositoryType - isImmutable - lifecycleState - freeformTags - definedTags - timeCreated ContainerImageSummary: description: Container image summary. properties: compartmentId: description: The compartment OCID to which the container image belongs. Inferred from the container repository. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object digest: description: The container image digest. maxLength: 128 minLength: 1 type: string displayName: description: 'The repository name and the most recent version associated with the image. If there are no versions associated with the image, then last known version and digest are used instead. If the last known version is unavailable, then ''unknown'' is used instead of the version. Example: `ubuntu:latest` or `ubuntu:latest@sha256:45b23dee08af5e43a7fea6c4cf9c25ccf269ee113168c19722f87876677c5cb2` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string lifecycleState: description: The current state of the container image. type: string x-obmcs-enumref: '#/definitions/ContainerImage/lifecycleState' repositoryId: description: The OCID of the container repository. maxLength: 255 minLength: 1 type: string repositoryName: description: The container repository name. maxLength: 255 minLength: 1 type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the image was created. format: date-time type: string version: description: The most recent version associated with this image. maxLength: 128 minLength: 1 type: string required: - compartmentId - digest - displayName - id - lifecycleState - repositoryId - repositoryName - timeCreated - freeformTags - definedTags - systemTags UpdateRepositoryDetails: description: Details for updating a repository. discriminator: propertyName: repositoryType properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object description: description: The repository description. maxLength: 400 minLength: 1 type: string displayName: description: The repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object repositoryType: description: The repository's supported artifact type. type: string x-obmcs-enumref: '#/definitions/Repository/repositoryType' required: - repositoryType UpdateContainerImageDetails: description: Details for updating a container image. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object RemoveContainerVersionDetails: description: Remove version details. properties: version: description: The version to remove. maxLength: 128 minLength: 1 type: string required: - version Repository: description: The metadata for the artifact repository. discriminator: propertyName: repositoryType properties: compartmentId: description: The OCID of the repository's compartment. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object description: description: The repository description. maxLength: 400 minLength: 1 type: string displayName: description: The repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the repository. Example: `ocid1.artifactrepository.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string isImmutable: description: Whether the repository is immutable. The artifacts of an immutable repository cannot be overwritten. type: boolean lifecycleState: description: The current state of the repository. enum: - AVAILABLE - DELETING - DELETED type: string repositoryType: description: The repository's supported artifact type. enum: - GENERIC type: string timeCreated: description: An RFC 3339 timestamp indicating when the repository was created. format: date-time type: string required: - id - displayName - compartmentId - repositoryType - description - isImmutable - lifecycleState - freeformTags - definedTags - timeCreated UpdateGenericArtifactDetails: description: Details for updating an artifact by providing its [OCID](/iaas/Content/General/Concepts/identifiers.htm). properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object ContainerRepository: description: Container repository metadata. properties: billableSizeInGBs: description: Total storage size in GBs that will be charged. format: int64 type: integer compartmentId: description: The OCID of the compartment in which the container repository exists. maxLength: 100 minLength: 1 type: string createdBy: description: The id of the user or principal that created the resource. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: The container repository name. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the container repository. Example: `ocid1.containerrepo.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string imageCount: description: Total number of images. format: int32 type: integer isImmutable: description: Whether the repository is immutable. Images cannot be overwritten in an immutable repository. type: boolean isPublic: description: Whether the repository is public. A public repository allows unauthenticated access. type: boolean layerCount: description: Total number of layers. format: int32 type: integer layersSizeInBytes: description: Total storage in bytes consumed by layers. format: int64 type: integer lifecycleState: description: The current state of the container repository. enum: - AVAILABLE - DELETING - DELETED type: string namespace: description: The tenancy namespace used in the container repository path. maxLength: 64 minLength: 1 type: string readme: $ref: '#/components/schemas/ContainerRepositoryReadme' systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the repository was created. format: date-time type: string timeLastPushed: description: An RFC 3339 timestamp indicating when an image was last pushed to the repository. format: date-time type: string required: - compartmentId - createdBy - displayName - id - imageCount - isImmutable - isPublic - layerCount - layersSizeInBytes - lifecycleState - timeCreated - billableSizeInGBs - namespace - freeformTags - definedTags - systemTags ContainerRepositoryCollection: description: List of container repository results. properties: imageCount: description: Total number of images. format: int32 type: integer items: description: Collection of container repositories. items: $ref: '#/components/schemas/ContainerRepositorySummary' type: array layerCount: description: Total number of layers. format: int32 type: integer layersSizeInBytes: description: Total storage in bytes consumed by layers. format: int64 type: integer remainingItemsCount: description: Estimated number of remaining results. format: int32 type: integer repositoryCount: description: Total number of repositories. format: int32 type: integer required: - imageCount - items - layerCount - layersSizeInBytes - remainingItemsCount - repositoryCount ContainerImageSignatureSummary: description: Container image signature summary. properties: compartmentId: description: The OCID of the compartment in which the container repository exists. maxLength: 100 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object displayName: description: 'The last 10 characters of the kmsKeyId, the last 10 characters of the kmsKeyVersionId, the signingAlgorithm, and the last 10 characters of the signatureId. Example: `wrmz22sixa::qdwyc2ptun::SHA_256_RSA_PKCS_PSS::2vwmobasva` ' maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image signature. Example: `ocid1.containerimagesignature.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string imageId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyId used to sign the container image. Example: `ocid1.key.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string kmsKeyVersionId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyVersionId used to sign the container image. Example: `ocid1.keyversion.oc1..exampleuniqueID` ' maxLength: 255 minLength: 1 type: string lifecycleState: description: The current state of the container image signature. type: string x-obmcs-enumref: '#/definitions/ContainerImageSignature/lifecycleState' message: description: The base64 encoded signature payload that was signed. maxLength: 1024 minLength: 1 type: string signature: description: The signature of the message field using the kmsKeyId, the kmsKeyVersionId, and the signingAlgorithm. maxLength: 684 minLength: 1 type: string signingAlgorithm: description: The algorithm to be used for signing. These are the only supported signing algorithms for container images. enum: - SHA_224_RSA_PKCS_PSS - SHA_256_RSA_PKCS_PSS - SHA_384_RSA_PKCS_PSS - SHA_512_RSA_PKCS_PSS type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: An RFC 3339 timestamp indicating when the image was created. format: date-time type: string required: - compartmentId - displayName - id - imageId - kmsKeyId - kmsKeyVersionId - message - signature - signingAlgorithm - timeCreated - lifecycleState - freeformTags - definedTags - systemTags parameters: FilterByKmsKeyIdQueryParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyVersionId used to sign the container image. Example: `ocid1.keyversion.oc1..exampleuniqueID` ' in: query name: kmsKeyId required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 FilterByRepositoryIdQueryParam: description: 'A filter to return the artifacts only for the specified repository OCID. ' in: query name: repositoryId required: true x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 FilterByIsImmutableQueryParam: description: 'A filter to return resources that match the isImmutable value. ' in: query name: isImmutable required: false x-default-description: 'null' schema: type: boolean SortByQueryParam: description: 'The field to sort by. You can provide one sort order (`sortOrder`). Default order for TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME sort order is case sensitive. **Note:** In general, some "List" operations (for example, `ListInstances`) let you optionally filter by availability domain if the scope of the resource type is within a single availability domain. If you call one of these "List" operations without specifying an availability domain, the resources are grouped by availability domain, then sorted. ' in: query name: sortBy required: false x-default-description: The default field to sort by varies by API. schema: type: string enum: - TIMECREATED - DISPLAYNAME FilterByContainerImageIdQueryParam: description: 'A filter to return a container image summary only for the specified container image OCID. ' in: query name: imageId required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 PaginationTokenQueryParam: description: 'For list pagination. The value of the `opc-next-page` response header from the previous "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' in: query name: page schema: type: string maxLength: 4096 minLength: 1 ContainerRepositoryIdPathParam: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the container repository. Example: `ocid1.containerrepo.oc1..exampleuniqueID` ' in: path name: repositoryId required: true schema: type: string maxLength: 255 minLength: 1 FilterByContainerRepositoryIdQueryParam: description: 'A filter to return container images only for the specified container repository OCID. ' in: query name: repositoryId required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 FilterByGenericArtifactPathContainsQueryParam: description: 'Filter results by a prefix for the `artifactPath` and and return artifacts that begin with the specified prefix in their path. ' in: query name: artifactPath required: false x-default-description: 'null' schema: type: string maxLength: 256 minLength: 1 FilterByIdQueryParam: description: 'A filter to return the resources for the specified OCID. ' in: query name: id required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 IfMatchHeader: description: 'For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match` parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource''s current etag value. ' in: header name: if-match schema: type: string CompartmentIdQueryParam: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment. in: query name: compartmentId required: true schema: type: string maxLength: 255 minLength: 1 FilterByDisplayNameQueryParam: description: 'A filter to return only resources that match the given display name exactly. ' in: query name: displayName required: false schema: type: string maxLength: 255 minLength: 1 PaginationLimitQueryParam: description: 'For list pagination. The maximum number of results per page, or items to return in a paginated "List" call. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). Example: `50` ' in: query name: limit x-default-description: The default maximum results per page varies by API. schema: type: integer maximum: 1000 minimum: 1 FilterByKmsKeyVersionIdQueryParam: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the kmsKeyVersionId used to sign the container image. Example: `ocid1.keyversion.oc1..exampleuniqueID` ' in: query name: kmsKeyVersionId required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 RepositoryIdPathParam: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the repository. Example: `ocid1.artifactrepository.oc1..exampleuniqueID` ' in: path name: repositoryId required: true schema: type: string maxLength: 255 minLength: 1 ContainerImageSignatureIdPathParam: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the container image signature. Example: `ocid1.containersignature.oc1..exampleuniqueID` ' in: path name: imageSignatureId required: true schema: type: string maxLength: 255 minLength: 1 SortOrderQueryParam: description: 'The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order is case sensitive. ' in: query name: sortOrder required: false x-default-description: The default sort order varies by API. schema: type: string enum: - ASC - DESC FilterByContainerVersionQueryParam: description: 'A filter to return container images that match the version. Example: `foo` or `foo*` ' in: query name: version required: false x-default-description: 'null' schema: type: string maxLength: 128 minLength: 1 FilterBySigningAlgorithmDigestQueryParam: description: The algorithm to be used for signing. These are the only supported signing algorithms for container images. in: query name: signingAlgorithm required: false x-default-description: 'null' schema: type: string enum: - SHA_224_RSA_PKCS_PSS - SHA_256_RSA_PKCS_PSS - SHA_384_RSA_PKCS_PSS - SHA_512_RSA_PKCS_PSS maxLength: 128 minLength: 1 FilterByContainerRepositoryNameQueryParam: description: 'A filter to return container images or container image signatures that match the repository name. Example: `foo` or `foo*` ' in: query name: repositoryName required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 FilterByIsPublicQueryParam: description: 'A filter to return resources that match the isPublic value. ' in: query name: isPublic required: false x-default-description: 'null' schema: type: boolean RetryTokenHeader: description: 'A token that uniquely identifies a request so it can be retried in case of a timeout or server error without risk of executing that same action again. Retry tokens expire after 24 hours, but can be invalidated before then due to conflicting operations (for example, if a resource has been deleted and purged from the system, then a retry of the original creation request may be rejected). ' in: header name: opc-retry-token schema: type: string maxLength: 64 minLength: 1 GenericArtifactVersionPathParam: description: 'A user-defined string to describe the artifact version. Example: `1.1.2` or `1.2-beta-2` ' in: path name: version required: true schema: type: string maxLength: 128 minLength: 1 GenericArtifactIdPathParam: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the artifact. Example: `ocid1.genericartifact.oc1..exampleuniqueID` ' in: path name: artifactId required: true schema: type: string maxLength: 255 minLength: 1 FilterByLifecycleStateQueryParam: description: 'A filter to return only resources that match the given lifecycle state name exactly. ' in: query name: lifecycleState required: false schema: type: string maxLength: 255 minLength: 1 FilterByContainerIsVersionedQueryParam: description: 'A filter to return container images based on whether there are any associated versions. ' in: query name: isVersioned required: false x-default-description: 'null' schema: type: boolean RequestIdHeader: description: 'Unique identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' in: header name: opc-request-id schema: type: string pattern: '[A-Za-z0-9\-_\.]+' ContainerImageIdPathParam: description: 'The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the container image. Example: `ocid1.containerimage.oc1..exampleuniqueID` ' in: path name: imageId required: true schema: type: string maxLength: 255 minLength: 1 FilterByGenericArtifactSha256QueryParam: description: 'Filter results by a specified SHA256 digest for the artifact. ' in: query name: sha256 required: false x-default-description: 'null' schema: type: string maxLength: 64 minLength: 1 GenericArtifactPathPathParam: description: 'A user-defined path to describe the location of an artifact. You can use slashes to organize the repository, but slashes do not create a directory structure. An artifact path does not include an artifact version. Example: `project01/my-web-app/artifact-abc` ' in: path name: artifactPath required: true schema: type: string maxLength: 256 minLength: 1 FilterByContainerDigestQueryParam: description: 'The digest of the container image. Example: `sha256:e7d38b3517548a1c71e41bffe9c8ae6d6d29546ce46bf62159837aad072c90aa` ' in: query name: imageDigest required: false x-default-description: 'null' schema: type: string maxLength: 128 minLength: 1 FilterByGenericArtifactVersionContainsQueryParam: description: 'Filter results by a prefix for `version` and return artifacts that that begin with the specified prefix in their version. ' in: query name: version required: false x-default-description: 'null' schema: type: string maxLength: 128 minLength: 1 CompartmentIdInSubtreeQueryParam: description: 'When set to true, the hierarchy of compartments is traversed and all compartments and subcompartments in the tenancy are inspected depending on the the setting of `accessLevel`. Default is false. Can only be set to true when calling the API on the tenancy (root compartment). ' in: query name: compartmentIdInSubtree x-default-description: false schema: type: boolean x-anchors: x-headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' type: string opc-next-page: description: 'For list pagination. When this header appears in the response, additional pages of results remain. For important details about how pagination works, see [List Pagination](/iaas/Content/API/Concepts/usingapi.htm#nine). ' type: string opc-request-id: description: 'Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. ' type: string x-properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only the String type is supported. ' type: object description: 'Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Operations": {"CostCenter": "42"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. For more information, see [Resource Tags](/iaas/Content/General/Concepts/resourcetags.htm). Example: `{"Department": "Finance"}` ' type: object systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. ' type: object description: 'Key-value pair representing a system tag key and value, scoped to a namespace. Example: `{"free-tier-retained" : "true"}` ' type: object description: 'The system tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object x-obmcs-client-retries-enabled: true x-oracle-package: com.oracle.pic.artifacts