|
1289 | 1289 | }, |
1290 | 1290 | "operationId": "getRoleMapping", |
1291 | 1291 | "summary": "Return a single role mapping", |
1292 | | - "description": "Gets the details of a single role mapping (by principalId).\n\nThis operation can fail for the following reasons:\n\n* No role mapping for the principalId exists (HTTP error `404`)\n* A server error occurred (HTTP error `500`)\n" |
| 1292 | + "description": "Gets the details of a single role mapping (by `principalId`).\n\nThis operation can fail for the following reasons:\n\n* No role mapping for the `principalId` exists (HTTP error `404`)\n* A server error occurred (HTTP error `500`)\n" |
1293 | 1293 | }, |
1294 | 1294 | "put": { |
1295 | 1295 | "requestBody": { |
|
1453 | 1453 | } |
1454 | 1454 | }, |
1455 | 1455 | "operationId": "referencesByContentHash", |
1456 | | - "summary": "Returns a list with all the references for the artifact with the given hash", |
| 1456 | + "summary": "List artifact references by hash", |
1457 | 1457 | "description": "Returns a list containing all the artifact references using the artifact content hash.\n\nThis operation may fail for one of the following reasons:\n\n* A server error occurred (HTTP error `500`)\n" |
1458 | 1458 | }, |
1459 | 1459 | "parameters": [ |
|
1489 | 1489 | } |
1490 | 1490 | }, |
1491 | 1491 | "operationId": "referencesByContentId", |
1492 | | - "summary": "Returns a list with all the references for the artifact with the given content id.", |
1493 | | - "description": "Returns a list containing all the artifact references using the artifact contentId.\n\nThis operation may fail for one of the following reasons:\n\n* A server error occurred (HTTP error `500`)" |
| 1492 | + "summary": "List artifact references by content ID", |
| 1493 | + "description": "Returns a list containing all the artifact references using the artifact content ID.\n\nThis operation may fail for one of the following reasons:\n\n* A server error occurred (HTTP error `500`)" |
1494 | 1494 | }, |
1495 | 1495 | "parameters": [ |
1496 | 1496 | { |
|
1657 | 1657 | } |
1658 | 1658 | }, |
1659 | 1659 | "operationId": "getConfigProperty", |
1660 | | - "summary": "Get the value of a configuration property", |
| 1660 | + "summary": "Get configuration property value", |
1661 | 1661 | "description": "Returns the value of a single configuration property.\n\nThis operation may fail for one of the following reasons:\n\n* Property not found or not configured (HTTP error `404`)\n* A server error occurred (HTTP error `500`)\n" |
1662 | 1662 | }, |
1663 | 1663 | "put": { |
|
2022 | 2022 | "description": "The content of the artifact being created. This is often, but not always, JSON data\nrepresenting one of the supported artifact types:\n\n* Avro (`AVRO`)\n* Protobuf (`PROTOBUF`)\n* JSON Schema (`JSON`)\n* Kafka Connect (`KCONNECT`)\n* OpenAPI (`OPENAPI`)\n* AsyncAPI (`ASYNCAPI`)\n* GraphQL (`GRAPHQL`)\n* Web Services Description Language (`WSDL`)\n* XML Schema (`XSD`)\n", |
2023 | 2023 | "content": { |
2024 | 2024 | "*/*": { |
2025 | | - "schema": {}, |
| 2025 | + "schema": { |
| 2026 | + "format": "binary", |
| 2027 | + "type": "string" |
| 2028 | + }, |
2026 | 2029 | "examples": { |
2027 | 2030 | "OpenAPI Example": { |
2028 | 2031 | "value": { |
|
2163 | 2166 | "$ref": "#/components/schemas/EncodedArtifactName" |
2164 | 2167 | }, |
2165 | 2168 | "in": "header" |
| 2169 | + }, |
| 2170 | + { |
| 2171 | + "name": "X-Registry-Content-Hash", |
| 2172 | + "description": "Specifies the (optional) hash of the artifact to be verified.", |
| 2173 | + "schema": { |
| 2174 | + "type": "string" |
| 2175 | + }, |
| 2176 | + "in": "header" |
| 2177 | + }, |
| 2178 | + { |
| 2179 | + "name": "X-Registry-Hash-Algorithm", |
| 2180 | + "description": "The algorithm to use when checking the content validity. (available: SHA256, MD5; default: SHA256)", |
| 2181 | + "schema": { |
| 2182 | + "enum": [ |
| 2183 | + "SHA256", |
| 2184 | + "MD5" |
| 2185 | + ], |
| 2186 | + "type": "string" |
| 2187 | + }, |
| 2188 | + "in": "header" |
2166 | 2189 | } |
2167 | 2190 | ], |
2168 | 2191 | "responses": { |
|
2203 | 2226 | } |
2204 | 2227 | }, |
2205 | 2228 | "operationId": "deleteArtifactsInGroup", |
2206 | | - "summary": "Deletes all artifacts in a group", |
| 2229 | + "summary": "Delete artifacts in group", |
2207 | 2230 | "description": "Deletes all of the artifacts that exist in a given group." |
2208 | 2231 | }, |
2209 | 2232 | "parameters": [ |
|
2669 | 2692 | "required": true |
2670 | 2693 | } |
2671 | 2694 | ] |
| 2695 | + }, |
| 2696 | + "/groups/{groupId}/artifacts/{artifactId}/owner": { |
| 2697 | + "summary": "Manage the ownership of a single artifact.", |
| 2698 | + "get": { |
| 2699 | + "tags": [ |
| 2700 | + "Metadata" |
| 2701 | + ], |
| 2702 | + "responses": { |
| 2703 | + "200": { |
| 2704 | + "content": { |
| 2705 | + "application/json": { |
| 2706 | + "schema": { |
| 2707 | + "$ref": "#/components/schemas/ArtifactOwner" |
| 2708 | + } |
| 2709 | + } |
| 2710 | + }, |
| 2711 | + "description": "The artifact's owner." |
| 2712 | + }, |
| 2713 | + "404": { |
| 2714 | + "$ref": "#/components/responses/NotFound" |
| 2715 | + }, |
| 2716 | + "500": { |
| 2717 | + "$ref": "#/components/responses/ServerError" |
| 2718 | + } |
| 2719 | + }, |
| 2720 | + "operationId": "getArtifactOwner", |
| 2721 | + "summary": "Get artifact owner", |
| 2722 | + "description": "Gets the owner of an artifact in the registry.\n\nThis operation can fail for the following reasons:\n\n* No artifact with this `artifactId` exists (HTTP error `404`)\n* A server error occurred (HTTP error `500`)" |
| 2723 | + }, |
| 2724 | + "put": { |
| 2725 | + "requestBody": { |
| 2726 | + "content": { |
| 2727 | + "application/json": { |
| 2728 | + "schema": { |
| 2729 | + "$ref": "#/components/schemas/ArtifactOwner" |
| 2730 | + } |
| 2731 | + } |
| 2732 | + }, |
| 2733 | + "required": true |
| 2734 | + }, |
| 2735 | + "tags": [ |
| 2736 | + "Metadata" |
| 2737 | + ], |
| 2738 | + "responses": { |
| 2739 | + "204": { |
| 2740 | + "description": "The owner was successfully changed." |
| 2741 | + }, |
| 2742 | + "404": { |
| 2743 | + "$ref": "#/components/responses/NotFound" |
| 2744 | + }, |
| 2745 | + "500": { |
| 2746 | + "$ref": "#/components/responses/ServerError" |
| 2747 | + } |
| 2748 | + }, |
| 2749 | + "operationId": "updateArtifactOwner", |
| 2750 | + "summary": "Update artifact owner", |
| 2751 | + "description": "Changes the ownership of an artifact.\n\nThis operation can fail for the following reasons:\n\n* No artifact with this `artifactId` exists (HTTP error `404`)\n* A server error occurred (HTTP error `500`)" |
| 2752 | + }, |
| 2753 | + "parameters": [ |
| 2754 | + { |
| 2755 | + "name": "groupId", |
| 2756 | + "description": "The artifact group ID. Must be a string provided by the client, representing the name of the grouping of artifacts.", |
| 2757 | + "schema": { |
| 2758 | + "$ref": "#/components/schemas/GroupId" |
| 2759 | + }, |
| 2760 | + "in": "path", |
| 2761 | + "required": true |
| 2762 | + }, |
| 2763 | + { |
| 2764 | + "name": "artifactId", |
| 2765 | + "description": "The artifact ID. Can be a string (client-provided) or UUID (server-generated), representing the unique artifact identifier.", |
| 2766 | + "schema": { |
| 2767 | + "$ref": "#/components/schemas/ArtifactId" |
| 2768 | + }, |
| 2769 | + "in": "path", |
| 2770 | + "required": true |
| 2771 | + } |
| 2772 | + ] |
2672 | 2773 | } |
2673 | 2774 | }, |
2674 | 2775 | "components": { |
|
3596 | 3697 | "type": "object", |
3597 | 3698 | "properties": { |
3598 | 3699 | "content": { |
3599 | | - "description": "Raw content of the artifact.", |
| 3700 | + "description": "Raw content of the artifact or a valid (and accessible) URL where the content can be found.", |
3600 | 3701 | "type": "string", |
3601 | 3702 | "example": "" |
3602 | 3703 | }, |
|
3732 | 3833 | "maxArtifactDescriptionLengthChars": -1, |
3733 | 3834 | "maxRequestsPerSecondCount": -1 |
3734 | 3835 | } |
| 3836 | + }, |
| 3837 | + "ArtifactOwner": { |
| 3838 | + "title": "Root Type for ArtifactOwner", |
| 3839 | + "description": "Describes the ownership of an artifact.", |
| 3840 | + "type": "object", |
| 3841 | + "properties": { |
| 3842 | + "owner": { |
| 3843 | + "type": "string" |
| 3844 | + } |
| 3845 | + }, |
| 3846 | + "example": { |
| 3847 | + "owner": "bwayne" |
| 3848 | + } |
3735 | 3849 | } |
3736 | 3850 | }, |
3737 | 3851 | "responses": { |
|
0 commit comments