openapi: 3.2.0 info: description: 'Use the Service Catalog API to manage solutions in Oracle Cloud Infrastructure Service Catalog. For more information, see [Overview of Service Catalog](/iaas/Content/service-catalog/overview_of_service_catalog.htm). ' title: Service Catalog API version: '20210527' x-provenance: method: harvested first_party: true publisher: Oracle source: https://docs.oracle.com/en-us/iaas/api/specs/7331af53a6aec7acddb0f95d1824085c07535cff7d30f5d256174b4e14523d47.yaml harvested: '2026-08-04' note: Published by Oracle as the contract for the Service Catalog 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/7331af53a6aec7acddb0f95d1824085c07535cff7d30f5d256174b4e14523d47.yaml what: the harvested document for Service Catalog API servers: - url: http://localhost:24000/20210527 - url: https://localhost:24000/20210527 tags: - name: serviceCatalog paths: /applications: get: description: 'Lists all the applications in a service catalog or a tenancy. If no parameter is specified, all catalogs from all compartments in the tenancy will be scanned for any type of content. ' operationId: ListApplications parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/ServiceCatalogIdQueryParam' - $ref: '#/components/parameters/EntityTypeFilterQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/DisplayNameFilterQueryParam' - $ref: '#/components/parameters/EntityIdQueryParam' - $ref: '#/components/parameters/PublisherIdQueryParam' - $ref: '#/components/parameters/PackageTypeFilterQueryParam' - $ref: '#/components/parameters/PricingFilterQueryParam' - $ref: '#/components/parameters/FeaturedFilterQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: '200': description: The operation to list all the applications in a service catalog succeeded. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/ApplicationCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Lists the applications in a catalog or a tenancy. tags: - serviceCatalog x-example: 'GET /20210527/applications?compartmentId=<compartmentId> Host: servicecatalog.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/ApplicationSummary' /privateApplicationPackages: get: description: Lists the packages in the specified private application. operationId: ListPrivateApplicationPackages parameters: - $ref: '#/components/parameters/PrivateApplicationIdRequiredQueryParam' - $ref: '#/components/parameters/PrivateApplicationPackageIdQueryParam' - $ref: '#/components/parameters/PackageTypeQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PrivateApplicationPackageSortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/DisplayNameFilterQueryParam' responses: '200': description: List of all packages of a given private application. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/PrivateApplicationPackageCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Lists the packages in a private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplicationPackage' /privateApplicationPackages/{privateApplicationPackageId}: get: description: Gets the details of a specific package within a given private application. operationId: GetPrivateApplicationPackage parameters: - $ref: '#/components/parameters/PrivateApplicationPackageIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The requested private application package version. 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/PrivateApplicationPackage' '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' default: $ref: '#/components/responses/DefaultError' summary: Gets the details of a specified private application package. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplicationPackage' /privateApplicationPackages/{privateApplicationPackageId}/actions/downloadConfig: get: description: Downloads the configuration that was used to create the private application package. operationId: GetPrivateApplicationPackageActionDownloadConfig parameters: - $ref: '#/components/parameters/PrivateApplicationPackageIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: 'Configuration payload as a binary stream. This can represent a zip file or some other binary format, that was used to create this package. ' 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 content: application/zip: schema: format: binary 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' default: $ref: '#/components/responses/DefaultError' summary: Downloads the configuration of a private application package. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplicationPackage' /privateApplications: get: description: Lists all the private applications in a given compartment. operationId: ListPrivateApplications parameters: - $ref: '#/components/parameters/CompartmentIdRequiredQueryParam' - $ref: '#/components/parameters/PrivateApplicationIdQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/PrivateApplicationSortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/DisplayNameFilterQueryParam' responses: '200': description: List of all private applications. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/PrivateApplicationCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: List all private applications. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' post: description: Creates a private application along with a single package to be hosted. operationId: CreatePrivateApplication parameters: - $ref: '#/components/parameters/OpcRetryTokenHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '202': description: The operation to create a private application succeeded. 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 opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/PrivateApplication' '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' default: $ref: '#/components/responses/DefaultError' summary: Creates a private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreatePrivateApplicationDetails' description: Private application creation details. required: true /privateApplications/{privateApplicationId}: delete: description: Deletes an existing private application. operationId: DeletePrivateApplication parameters: - $ref: '#/components/parameters/PrivateApplicationIdPathParam' - $ref: '#/components/parameters/IfMatchHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '202': description: The request to delete a private application accepted. 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 opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' 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' default: $ref: '#/components/responses/DefaultError' summary: Deletes a private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' get: description: Gets the details of the specified private application. operationId: GetPrivateApplication parameters: - $ref: '#/components/parameters/PrivateApplicationIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The details of the requested private application. 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/PrivateApplication' '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' default: $ref: '#/components/responses/DefaultError' summary: Gets a private application. tags: - serviceCatalog x-example: 'GET /20210527/privateApplications/<privateApplicationId> Host: osc.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/PrivateApplication' put: description: Updates the details of an existing private application. operationId: UpdatePrivateApplication parameters: - $ref: '#/components/parameters/PrivateApplicationIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/IfMatchHeaderParam' responses: '202': description: The request to update a private application accepted. 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 opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' schema: type: string content: application/json: schema: $ref: '#/components/schemas/PrivateApplication' '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' default: $ref: '#/components/responses/DefaultError' summary: Updates an existing private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdatePrivateApplicationDetails' description: The details for updating the private application. required: true /privateApplications/{privateApplicationId}/actions/changeCompartment: post: description: Moves the specified private application from one compartment to another. operationId: ChangePrivateApplicationCompartment parameters: - $ref: '#/components/parameters/PrivateApplicationIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/IfMatchHeaderParam' responses: '202': description: The request to change the compartment of a private application has been accepted. 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 opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' 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' default: $ref: '#/components/responses/DefaultError' summary: Changes the compartment of the private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangePrivateApplicationCompartmentDetails' description: The details of the request to change the compartment of a given private application. required: true /privateApplications/{privateApplicationId}/actions/downloadLogo: get: description: Downloads the binary payload of the logo image of the private application. operationId: GetPrivateApplicationActionDownloadLogo parameters: - $ref: '#/components/parameters/PrivateApplicationIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: 'Image payload as a binary stream. Can be one of the common image types png, jpeg, bmp, gif or tiff. ' 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 content: image/bmp: schema: format: binary type: string image/gif: schema: format: binary type: string image/jpeg: schema: format: binary type: string image/png: schema: format: binary type: string image/tiff: schema: format: binary 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' default: $ref: '#/components/responses/DefaultError' summary: Downloads the logo image of the private application. tags: - serviceCatalog x-related-resource: '#/definitions/PrivateApplication' /serviceCatalogAssociations: get: description: Lists all the resource associations for a specific service catalog. operationId: ListServiceCatalogAssociations parameters: - $ref: '#/components/parameters/ServiceCatalogAssociationIdQueryParam' - $ref: '#/components/parameters/ServiceCatalogIdQueryParam' - $ref: '#/components/parameters/EntityIdQueryParam' - $ref: '#/components/parameters/EntityTypeFilterQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/ServiceCatalogAssociationSortByQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The operation to list all resource associated with specified service catalog succeeded. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/ServiceCatalogAssociationCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Lists resource associations. tags: - serviceCatalog x-example: 'GET /20210527/serviceCatalogs/<serviceCatalogId>/associations Host: servicecatalog.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/ServiceCatalogAssociation' post: description: Creates an association between service catalog and a resource. operationId: CreateServiceCatalogAssociation parameters: - $ref: '#/components/parameters/OpcRetryTokenHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The operation to create an association between resource and service catalog succeeded. 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/ServiceCatalogAssociation' '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' default: $ref: '#/components/responses/DefaultError' summary: Creates a service catalog association. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalogAssociation' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateServiceCatalogAssociationDetails' description: The details for creating the association between resource and service catalog. required: true /serviceCatalogAssociations/{serviceCatalogAssociationId}: delete: description: Removes an association between service catalog and a resource. operationId: DeleteServiceCatalogAssociation parameters: - $ref: '#/components/parameters/ServiceCatalogAssociationIdPathParam' - $ref: '#/components/parameters/IfMatchHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '204': description: The specified service catalog assocition was deleted successfully. 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' default: $ref: '#/components/responses/DefaultError' summary: Removes an association between service catalog and a resource. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalogAssociation' get: description: Gets detailed information about specific service catalog association. operationId: GetServiceCatalogAssociation parameters: - $ref: '#/components/parameters/ServiceCatalogAssociationIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The get operation for service catalog association succeeded. 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/ServiceCatalogAssociation' '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' default: $ref: '#/components/responses/DefaultError' summary: Gets the details of a service catalog association. tags: - serviceCatalog x-example: 'GET /20210527/serviceCatalogs/<serviceCatalogId>/associations/<associationId> Host: servicecatalog.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/ServiceCatalogAssociation' /serviceCatalogs: get: description: Lists all the service catalogs in the given compartment. operationId: ListServiceCatalogs parameters: - $ref: '#/components/parameters/CompartmentIdRequiredQueryParam' - $ref: '#/components/parameters/ServiceCatalogIdQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/ServiceCatalogSortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/DisplayNameFilterQueryParam' responses: '200': description: List of all service catalogs. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/ServiceCatalogCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Retrieves all the service catalogs in the given compartment. tags: - serviceCatalog x-example: 'GET /20210527/serviceCatalogs Host: servicecatalog.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/ServiceCatalog' post: description: Creates a brand new service catalog in a given compartment. operationId: CreateServiceCatalog parameters: - $ref: '#/components/parameters/OpcRetryTokenHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The operation to create a service catalog succeeded. 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/ServiceCatalog' '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' default: $ref: '#/components/responses/DefaultError' summary: Creates a service catalog in the compartment. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalog' requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateServiceCatalogDetails' description: The details for creating a service catalog. required: true /serviceCatalogs/{serviceCatalogId}: delete: description: Deletes the specified service catalog from the compartment. operationId: DeleteServiceCatalog parameters: - $ref: '#/components/parameters/ServiceCatalogIdPathParam' - $ref: '#/components/parameters/IfMatchHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '204': description: The operation to delete the service catalog succeeded. 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' default: $ref: '#/components/responses/DefaultError' summary: Deletes an existing service catalog. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalog' get: description: Gets detailed information about the service catalog including name, compartmentId operationId: GetServiceCatalog parameters: - $ref: '#/components/parameters/ServiceCatalogIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The get operation for service catalog succeeded. 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/ServiceCatalog' '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' default: $ref: '#/components/responses/DefaultError' summary: Get the details of the service catalog. tags: - serviceCatalog x-example: 'GET /20210527/serviceCatalogs/<serviceCatalogId> Host: servicecatalog.us-ashburn-1.oci.oraclecloud.com <authorization and other headers> ' x-related-resource: '#/definitions/ServiceCatalog' put: description: Updates the details of a previously created service catalog. operationId: UpdateServiceCatalog parameters: - $ref: '#/components/parameters/ServiceCatalogIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/IfMatchHeaderParam' responses: '200': description: The update operation for the service catalog succeeded. 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/ServiceCatalog' '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' default: $ref: '#/components/responses/DefaultError' summary: Updates the details of the service catalog. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalog' requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateServiceCatalogDetails' description: Details to update for a service catalog. required: true /serviceCatalogs/{serviceCatalogId}/actions/bulkReplaceAssociations: put: description: Replace all associations of a given service catalog in one bulk transaction. operationId: BulkReplaceServiceCatalogAssociations parameters: - $ref: '#/components/parameters/ServiceCatalogIdPathParam' - $ref: '#/components/parameters/IfMatchHeaderParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: Bulk replace operation succeeded. 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' default: $ref: '#/components/responses/DefaultError' summary: Replace associations in bulk. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalogAssociation' requestBody: content: application/json: schema: $ref: '#/components/schemas/BulkReplaceServiceCatalogAssociationsDetails' description: Details of the service catalog update operation. required: true /serviceCatalogs/{serviceCatalogId}/actions/changeCompartment: post: description: Moves the specified service catalog from one compartment to another. operationId: ChangeServiceCatalogCompartment parameters: - $ref: '#/components/parameters/ServiceCatalogIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/IfMatchHeaderParam' responses: '204': description: Changing the compartment for the specified service catalog succeeded. 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' default: $ref: '#/components/responses/DefaultError' summary: Changes the compartment of the service catalog. tags: - serviceCatalog x-related-resource: '#/definitions/ServiceCatalog' requestBody: content: application/json: schema: $ref: '#/components/schemas/ChangeServiceCatalogCompartmentDetails' description: The details of the request to change the compartment of a given service catalog. required: true /workRequests: get: description: 'Lists the work requests in a compartment. ' operationId: ListWorkRequests parameters: - $ref: '#/components/parameters/CompartmentIdQueryParam' - $ref: '#/components/parameters/WorkRequestIdQueryParam' - $ref: '#/components/parameters/WorkRequestStatusQueryParam' - $ref: '#/components/parameters/ResourceIdentifierQueryParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' - $ref: '#/components/parameters/WorkRequestSortByQueryParam' responses: '200': description: The list is being retrieved. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/WorkRequestSummaryCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: List Work Requests tags: - serviceCatalog x-related-resource: '#/definitions/WorkRequest' /workRequests/{workRequestId}: get: description: Gets the status of the work request with the given ID. operationId: GetWorkRequest parameters: - $ref: '#/components/parameters/WorkRequestIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' responses: '200': description: The detail of the work request. 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 retry-after: description: A decimal number representing the number of seconds the client should wait before polling this endpoint again. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/WorkRequest' '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' default: $ref: '#/components/responses/DefaultError' summary: GET Work Request Status tags: - serviceCatalog x-related-resource: '#/definitions/WorkRequest' /workRequests/{workRequestId}/errors: get: description: 'Return a (paginated) list of errors for a given work request. ' operationId: ListWorkRequestErrors parameters: - $ref: '#/components/parameters/WorkRequestIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/WorkRequestSortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: '200': description: List of work request errors. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/WorkRequestErrorCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Lists work request errors tags: - serviceCatalog x-related-resource: '#/definitions/WorkRequestError' /workRequests/{workRequestId}/logs: get: description: 'Return a (paginated) list of logs for a given work request. ' operationId: ListWorkRequestLogs parameters: - $ref: '#/components/parameters/WorkRequestIdPathParam' - $ref: '#/components/parameters/OpcRequestIdHeaderParam' - $ref: '#/components/parameters/PaginationTokenQueryParam' - $ref: '#/components/parameters/PaginationLimitQueryParam' - $ref: '#/components/parameters/WorkRequestSortByQueryParam' - $ref: '#/components/parameters/SortOrderQueryParam' responses: '200': description: List of work request logs. headers: opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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/WorkRequestLogEntryCollection' '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' default: $ref: '#/components/responses/DefaultError' summary: Lists work request logs tags: - serviceCatalog x-related-resource: '#/definitions/WorkRequestLogEntry' components: parameters: PricingFilterQueryParam: description: 'Name of the pricing type. If multiple pricing types are provided, then any resource with one or more matching pricing models will be returned. ' in: query name: pricing required: false x-default-description: [] style: form explode: true schema: type: array items: enum: - FREE - BYOL - PAYGO type: string x-obmcs-top-level-enum: '#/definitions/PricingTypeEnum' ServiceCatalogAssociationIdQueryParam: description: The unique identifier for the service catalog association. in: query name: serviceCatalogAssociationId required: false schema: type: string maxLength: 255 minLength: 1 ServiceCatalogIdPathParam: description: The unique identifier for the service catalog. in: path name: serviceCatalogId required: true schema: type: string maxLength: 255 minLength: 1 PaginationTokenQueryParam: description: The value of the `opc-next-page` response header from the previous "List" call. in: query name: page required: false schema: type: string maxLength: 511 minLength: 1 ServiceCatalogSortByQueryParam: description: Default is `TIMECREATED` in: query name: sortBy required: false schema: type: string enum: - TIMECREATED default: TIMECREATED ResourceIdentifierQueryParam: description: The ID of the resource affected by the work request in: query name: resourceId x-default-description: 'null' schema: type: string ServiceCatalogAssociationIdPathParam: description: The unique identifier of the service catalog association. in: path name: serviceCatalogAssociationId required: true schema: type: string maxLength: 255 minLength: 1 PrivateApplicationPackageIdQueryParam: description: The unique identifier for the private application package. in: query name: privateApplicationPackageId required: false schema: type: string CompartmentIdQueryParam: description: The unique identifier for the compartment. in: query name: compartmentId required: false schema: type: string maxLength: 255 minLength: 1 WorkRequestStatusQueryParam: description: A filter to return only resources their lifecycleState matches the given OperationStatus. in: query name: status required: false x-default-description: 'null' x-obmcs-top-level-enum: '#/definitions/OperationStatus' schema: type: string enum: - ACCEPTED - FAILED - SUCCEEDED PrivateApplicationIdPathParam: description: The unique identifier for the private application. in: path name: privateApplicationId required: true schema: type: string OpcRetryTokenHeaderParam: 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 might be rejected). ' in: header name: opc-retry-token required: false schema: type: string PaginationLimitQueryParam: description: 'How many records to return. Specify a value greater than zero and less than or equal to 1000. The default is 30. ' in: query name: limit required: false schema: type: integer default: 30 maximum: 1023 minimum: 1 IfMatchHeaderParam: 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 required: false schema: type: string PrivateApplicationIdRequiredQueryParam: description: The unique identifier for the private application. in: query name: privateApplicationId required: true schema: type: string PublisherIdQueryParam: description: Limit results to just this publisher. in: query name: publisherId required: false x-default-description: [] style: form explode: true schema: type: array items: type: string CompartmentIdRequiredQueryParam: description: The unique identifier for the compartment. in: query name: compartmentId required: true schema: type: string maxLength: 255 minLength: 1 WorkRequestIdPathParam: description: The ID of the asynchronous request. in: path name: workRequestId required: true schema: type: string PrivateApplicationPackageIdPathParam: description: The unique identifier for the private application package. in: path name: privateApplicationPackageId required: true schema: type: string WorkRequestIdQueryParam: description: The ID of the asynchronous work request. in: query name: workRequestId x-default-description: 'null' schema: type: string SortOrderQueryParam: description: The sort order to apply, either `ASC` or `DESC`. Default is `ASC`. in: query name: sortOrder required: false schema: type: string enum: - ASC - DESC default: ASC ServiceCatalogAssociationSortByQueryParam: description: Default is `TIMECREATED` in: query name: sortBy required: false schema: type: string enum: - TIMECREATED default: TIMECREATED FeaturedFilterQueryParam: description: 'Indicates whether to show only featured resources. If this is set to `false` or is omitted, then all resources will be returned. ' in: query name: isFeatured required: false schema: type: boolean default: false EntityIdQueryParam: description: The unique identifier of the entity associated with service catalog. in: query name: entityId required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 OpcRequestIdHeaderParam: description: 'Unique Oracle-assigned 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 required: false schema: type: string PackageTypeQueryParam: description: 'Name of the package type. If multiple package types are provided, then any resource with one or more matching package types will be returned. ' in: query name: packageType required: false x-default-description: [] style: form explode: true schema: type: array items: enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' PrivateApplicationSortByQueryParam: description: 'The field to use to sort listed results. You can only specify one field to sort by. Default is `TIMECREATED`. ' in: query name: sortBy required: false schema: type: string enum: - TIMECREATED - LIFECYCLESTATE default: TIMECREATED PackageTypeFilterQueryParam: description: 'Name of the package type. If multiple package types are provided, then any resource with one or more matching package types will be returned. ' in: query name: packageType required: false x-default-description: [] style: form explode: true schema: type: array items: enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' PrivateApplicationPackageSortByQueryParam: description: 'The field to use to sort listed results. You can only specify one field to sort by. `TIMECREATED` displays results in descending order by default. You can change your preference by specifying a different sort order. ' in: query name: sortBy required: false schema: type: string enum: - TIMECREATED - VERSION default: TIMECREATED WorkRequestSortByQueryParam: description: 'The field to sort by. Only one sort order may be provided. Default order for timeAccepted is descending. ' in: query name: sortBy schema: type: string enum: - timeAccepted default: timeAccepted DisplayNameFilterQueryParam: description: Exact match name filter. in: query name: displayName required: false schema: type: string PrivateApplicationIdQueryParam: description: The unique identifier for the private application. in: query name: privateApplicationId required: false schema: type: string ServiceCatalogIdQueryParam: description: The unique identifier for the service catalog. in: query name: serviceCatalogId required: false schema: type: string maxLength: 255 minLength: 1 EntityTypeFilterQueryParam: description: The type of the application in the service catalog. in: query name: entityType required: false x-default-description: 'null' schema: type: string maxLength: 255 minLength: 1 schemas: PublisherSummary: description: Summary details about the publisher of the resource. properties: displayName: description: The name of the publisher. maxLength: 255 minLength: 1 type: string id: description: The unique identifier for the publisher. maxLength: 255 minLength: 1 type: string required: - id - displayName type: object x-example: "{\n \"id\": \"53312546\",\n \"displayName\": \"Riverbed Technology\"\n}\n" BulkReplaceServiceCatalogAssociationsDetails: description: The model to replace service catalog associations in bulk. properties: items: description: Collection of CreateServiceCatalogAssociationDetails for bulk operation. items: $ref: '#/components/schemas/CreateServiceCatalogAssociationDetails' type: array required: - items type: object UpdateServiceCatalogDetails: description: The model for the parameters needed to update a service catalog. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: A display name of the service catalog. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object required: - displayName type: object ServiceCatalogAssociationCollection: description: Collection of service catalog associations. properties: items: description: Collection of service catalog and the resources associated with it. items: $ref: '#/components/schemas/ServiceCatalogAssociationSummary' type: array required: - items type: object WorkRequestSummaryCollection: description: Results of a workRequest search. Contains both WorkRequest items and other information, such as metadata. properties: items: description: List of workRequestSummary objects. items: $ref: '#/components/schemas/WorkRequestSummary' type: array required: - items type: object ApplicationSummary: description: The model for summary of an application in service catalog. properties: displayName: description: The name that service catalog should use to display this application. maxLength: 255 minLength: 1 type: string entityId: description: Identifier of the application from a service catalog. maxLength: 255 minLength: 1 type: string entityType: description: The type of an application in the service catalog. maxLength: 255 minLength: 1 type: string isFeatured: description: Indicates whether the application is featured. type: boolean logo: $ref: '#/components/schemas/UploadData' packageType: description: The type of the packages withing the application. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' pricingType: description: Summary of the pricing types available across all packages in the application. enum: - FREE - BYOL - PAYGO type: string x-obmcs-top-level-enum: '#/definitions/PricingTypeEnum' publisher: $ref: '#/components/schemas/PublisherSummary' shortDescription: description: A short description of the application. maxLength: 511 minLength: 0 type: string required: - entityId - displayName - entityType type: object x-example: "{\n \"entityId\": \"ocid1.privateapplication.oc1.iad.123..\",\n \"entityType\": \"privateapplication\",\n \"displayName\": \"My Private Application\",\n \"shortDescription\": \"This is my private application\",\n \"pricingType\": FREE,\n \"packageType\": IMAGE\n}\n" PrivateApplicationSummary: description: 'Brief data about an application or a solution, which lives inside the tenancy and may be included into service catalogs. ' properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where the private application resides. ' maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the private application. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object id: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the private application. maxLength: 255 minLength: 1 type: string lifecycleState: description: The lifecycle state of the private application. type: string x-obmcs-enumref: '#/definitions/PrivateApplication/lifecycleState' logo: $ref: '#/components/schemas/UploadData' packageType: description: Type of the packages, which are hosted by the private application. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' shortDescription: description: A short description of the private application. maxLength: 511 minLength: 0 type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: 'The date and time the private application was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-05-27T21:10:29.600Z` ' format: date-time type: string required: - id - displayName - packageType - compartmentId - lifecycleState - timeCreated type: object x-example: "{\n \"id\": \"ocid1.privateapplication.oc1.iad.123..\",\n \"displayName\": \"Software Load Balancer\",\n \"packageType\": \"STACK\",\n \"shortDescription\": \"Free Software Load Balancer by ACME\",\n \"lifecycleState\": \"ACTIVE\",\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"timeCreated\": \"2021-05-27T01:43:23.789Z\"\n}\n" ChangePrivateApplicationCompartmentDetails: description: All the parameters required to make the move. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where you want to move the private application. ' maxLength: 255 minLength: 1 type: string ApplicationCollection: description: Collection of applications in a given service catalog or a tenancy. properties: items: description: Collection of service catalog applications. items: $ref: '#/components/schemas/ApplicationSummary' type: array required: - items type: object PrivateApplicationPackageSummary: description: The model for a summary of a private application package. properties: displayName: description: The display name of the specified package. type: string id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the private application package. ' type: string packageType: description: The type of the package. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' privateApplicationId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the private application where the package is hosted. ' type: string timeCreated: description: 'The date and time the private application package was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-05-27T21:10:29.600Z` ' format: date-time type: string version: description: The version of the specified package. type: string required: - id - privateApplicationId - version - packageType - timeCreated type: object x-example: "{\n \"id\": \"ocid1.iad.privateapplicationpackage.00123..\",\n \"privateApplicationId\": \"ocid1.iad.privateapplication.00456..\",\n \"version\": \"1.4.231\",\n \"packageType\": \"STACK\",\n \"timeCreated\": \"2020-05-27T01:23:45.678Z\"\n}\n" PrivateApplicationPackageCollection: description: Collection of Private Application Package summary objects. properties: items: description: Collection of items. items: $ref: '#/components/schemas/PrivateApplicationPackageSummary' type: array required: - items type: object WorkRequestResource: description: A resource created or operated on by a work request. properties: actionType: description: 'The way in which this resource is affected by the work tracked in the work request. A resource being created, updated, or deleted will remain in the IN_PROGRESS state until work is complete for that resource at which point it will transition to CREATED, UPDATED, or DELETED, respectively. ' enum: - CREATED - UPDATED - DELETED - FAILED type: string x-obmcs-top-level-enum: '#/definitions/ActionType' entityId: description: The identifier of the resource the work request affects. type: string entityType: description: The resource type the work request affects. type: string entityUri: description: The URI path that the user can do a GET on to access the resource metadata type: string required: - actionType - entityType - entityId ServiceCatalogAssociation: description: The detailed model for service catalog association. properties: entityId: description: Identifier of the entity being associated with service catalog. maxLength: 255 minLength: 1 type: string entityType: description: The type of the entity that is associated with the service catalog. maxLength: 255 minLength: 1 type: string id: description: Identifier of the association. maxLength: 255 minLength: 1 type: string serviceCatalogId: description: Identifier of the service catalog. maxLength: 255 minLength: 1 type: string timeCreated: description: Timestamp of when the resource was associated with service catalog. format: date-time type: string required: - id - serviceCatalogId - entityId - timeCreated type: object x-example: "{\n \"id\": \"ocid1.catalogassociation.oc1.iad.123..\",\n \"serviceCatalogId\": \"ocid1.servicecatalog.oc1.iad.456..\",\n \"entityId\": \"ocid1.privateapplication.oc1.iad.789..\",\n \"entityType\": \"privateapplication\",\n \"timeCreated\": \"2021-05-27T17:39:19.186Z\"\n}\n" CreateServiceCatalogAssociationDetails: description: The model to create a single association between a service catalog and a resource. properties: entityId: description: Identifier of the entity being associated with service catalog. maxLength: 255 minLength: 1 type: string entityType: description: The type of the entity that is associated with the service catalog. maxLength: 255 minLength: 1 type: string serviceCatalogId: description: Identifier of the service catalog. maxLength: 255 minLength: 1 type: string required: - serviceCatalogId - entityId type: object x-example: "{\n \"serviceCatalogId\": \"ocid1.servicecatalog.oc1.iad.456..\",\n \"entityId\": \"ocid1.privateapplication.oc1.iad.789..\",\n \"entityType\": \"privateapplication\"\n}\n" PrivateApplicationCollection: description: Collection of private applications. properties: items: description: Collection of items. items: $ref: '#/components/schemas/PrivateApplicationSummary' type: array required: - items type: object ServiceCatalogSummary: description: The model for a summary of an Oracle Cloud Infrastructure service catalog. properties: compartmentId: description: The Compartment id where the service catalog exists. maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the service catalog. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object id: description: The unique identifier for the Service catalog. maxLength: 255 minLength: 1 type: string lifecycleState: description: The lifecycle state of the service catalog. type: string x-obmcs-enumref: '#/definitions/ServiceCatalog/lifecycleState' systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: 'The date and time this service catalog was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-08-25T21:10:29.600Z` ' format: date-time type: string required: - id - displayName - compartmentId - lifecycleState - timeCreated type: object x-example: "{\n \"id\": \"ocid1.servicecatalog.oc1.iad.123..\",\n \"displayName\": \"Service Catalog 1\",\n \"lifecycleState\": \"ACTIVE\",\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"timeCreated\": \"2021-05-27T17:39:19.186Z\"\n}\n" ServiceCatalogAssociationSummary: description: The model for a summary of a service catalog association. properties: entityId: description: The unique identifier of the resource being associated to service catalog. maxLength: 255 minLength: 1 type: string entityType: description: The type of the entity that is associated with the service catalog. maxLength: 255 minLength: 1 type: string id: description: The unique identifier of the service catalog association. maxLength: 255 minLength: 1 type: string serviceCatalogId: description: The unique identifier of the service catalog. maxLength: 255 minLength: 1 type: string timeCreated: description: Timestamp of when the resource was associated with service catalog. format: date-time type: string required: - id - serviceCatalogId - entityId - timeCreated type: object x-example: "{\n \"id\": \"ocid1.catalogassociation.oc1.iad.123..\",\n \"serviceCatalogId\": \"ocid1.servicecatalog.oc1.iad.456..\",\n \"entityId\": \"ocid1.privateapplication.oc1.iad.789..\",\n \"entityType\": \"privateapplication\",\n \"timeCreated\": \"2021-05-27T17:39:19.186Z\"\n}\n" PrivateApplicationPackage: description: A base object for all types of private application packages. discriminator: propertyName: packageType properties: displayName: description: The display name of the package. type: string id: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the private application package. ' type: string packageType: description: The specified package's type. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' privateApplicationId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the private application where the package is hosted. ' type: string timeCreated: description: 'The date and time the private application package was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-05-27T21:10:29.600Z` ' format: date-time type: string version: description: The package version. type: string required: - id - privateApplicationId - version - packageType - timeCreated x-example: "{\n \"id\": \"ocid1.iad.privateapplicationpackage.00123..\",\n \"privateApplicationId\": \"ocid1.iad.privateapplication.00456..\",\n \"version\": \"1.4.231\",\n \"packageType\": \"STACK\",\n \"timeCreated\": \"2020-05-27T01:23:45.678Z\"\n}\n" WorkRequest: description: A description of workrequest status properties: compartmentId: description: 'The ocid of the compartment that contains the work request. Work requests should be scoped to the same compartment as the resource the work request affects. If the work request affects multiple resources, and those resources are not in the same compartment, it is up to the service team to pick the primary resource whose compartment should be used ' type: string id: description: The id of the work request. type: string operationType: description: Type of the work request enum: - CREATE_PRIVATE_APPLICATION - UPDATE_PRIVATE_APPLICATION - DELETE_PRIVATE_APPLICATION - MOVE_PRIVATE_APPLICATION type: string x-obmcs-top-level-enum: '#/definitions/OperationType' percentComplete: description: Percentage of the request completed. format: float type: number resources: description: The resources affected by this work request. items: $ref: '#/components/schemas/WorkRequestResource' type: array status: description: Status of current work request. enum: - ACCEPTED - FAILED - SUCCEEDED type: string x-obmcs-top-level-enum: '#/definitions/OperationStatus' timeAccepted: description: 'The date and time the request was created, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29. ' format: date-time type: string timeFinished: description: 'The date and time the object was finished, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339). ' format: date-time type: string timeStarted: description: 'The date and time the request was started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29. ' format: date-time type: string required: - operationType - status - id - compartmentId - resources - percentComplete - timeAccepted CreatePrivateApplicationDetails: description: The model for the parameters needed to create a private application. properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where you want to create the private application. ' maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the private application. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object logoFileBase64Encoded: description: 'Base64-encoded logo to use as the private application icon. Template icon file requirements: PNG format, 50 KB maximum, 130 x 130 pixels. ' type: string longDescription: description: A long description of the private application. maxLength: 4095 minLength: 0 type: string packageDetails: $ref: '#/components/schemas/CreatePrivateApplicationPackage' shortDescription: description: A short description of the private application. maxLength: 511 minLength: 1 type: string required: - compartmentId - displayName - shortDescription - packageDetails type: object x-example: "{\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"displayName\": \"Software Load Balancer\",\n \"shortDescription\": \"Free Software Load Balancer by ACME\",\n \"longDescription\": \"Software load balancer by ACME will provide you with a reliable round-robin ...\",\n \"packageDetails\": {\n \"version\": \"1.0.0\",\n \"type\": \"STACK\"\n }\n}\n" WorkRequestErrorCollection: description: Results of a workRequestError search. Contains both WorkRequestError items and other information, such as metadata. properties: items: description: List of workRequestError objects. items: $ref: '#/components/schemas/WorkRequestError' type: array required: - items type: object CreateServiceCatalogDetails: description: The model for parameter needed to create service catalog. properties: compartmentId: description: The unique identifier for the compartment where the service catalog will be created. maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The display name of the service catalog. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object required: - displayName - compartmentId type: object x-example: "{\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"displayName\": \"Service Catalog 2\"\n}\n" UploadData: description: The model for uploaded binary data, like logos and images. properties: contentUrl: description: The content URL of the uploaded data. maxLength: 2047 minLength: 1 type: string displayName: description: The name used to refer to the uploaded data. maxLength: 255 minLength: 1 type: string mimeType: description: The MIME type of the uploaded data. maxLength: 255 minLength: 1 type: string type: object x-example: "{\n \"displayName\": \"ACME Logo\",\n \"contentUrl\": \"https://service-catalog.marketplace.us-ashburn-1.oci.oraclecloud.com/ |\n privateApplications/ocid1.privateapplication.oc1.iad.123../actions/downloadLogo\",\n \"mimeType\": \"image/jpeg\"\n}\n" ErrorEntity: description: The model for the error entity. properties: code: description: A short error code that defines the error. maxLength: 255 minLength: 0 type: string message: description: A human-readable error string. maxLength: 1023 minLength: 0 type: string required: - code - message type: object ChangeServiceCatalogCompartmentDetails: description: The model for the parameters needed move a service catalog from one compartment to another. properties: compartmentId: description: The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where you want to move the service catalog. maxLength: 255 minLength: 1 type: string WorkRequestSummary: description: A summary of the status of a work request. properties: compartmentId: description: 'The ocid of the compartment that contains the work request. Work requests should be scoped to the same compartment as the resource the work request affects. If the work request affects multiple resources, and those resources are not in the same compartment, it is up to the service team to pick the primary resource whose compartment should be used ' type: string id: description: The id of the work request. type: string operationType: description: Type of the work request enum: - CREATE_PRIVATE_APPLICATION - UPDATE_PRIVATE_APPLICATION - DELETE_PRIVATE_APPLICATION - MOVE_PRIVATE_APPLICATION type: string x-obmcs-top-level-enum: '#/definitions/OperationType' percentComplete: description: Percentage of the request completed. format: float type: number resources: description: The resources affected by this work request. items: $ref: '#/components/schemas/WorkRequestResource' type: array status: description: Status of current work request. enum: - ACCEPTED - FAILED - SUCCEEDED type: string x-obmcs-top-level-enum: '#/definitions/OperationStatus' timeAccepted: description: 'The date and time the request was created, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29. ' format: date-time type: string timeFinished: description: 'The date and time the object was finished, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339). ' format: date-time type: string timeStarted: description: 'The date and time the request was started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29. ' format: date-time type: string required: - operationType - status - id - compartmentId - resources - percentComplete - timeAccepted WorkRequestError: description: An error encountered while executing a work request. properties: code: description: 'A machine-usable code for the error that occured. Error codes are listed on (https://docs.cloud.oracle.com/Content/API/References/apierrors.htm) ' type: string message: description: A human readable description of the issue encountered. type: string timestamp: description: The time the error occured. An RFC3339 formatted datetime string. format: date-time type: string required: - code - message - timestamp ServiceCatalog: description: The model for an Oracle Cloud Infrastructure Service Catalog. properties: compartmentId: description: The Compartment id where the service catalog exists maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the service catalog. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object id: description: The unique identifier for the Service catalog. maxLength: 255 minLength: 1 type: string lifecycleState: description: The lifecycle state of the service catalog. enum: - ACTIVE - DELETED type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: 'The date and time the service catalog was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-05-26T21:10:29.600Z` ' format: date-time type: string timeUpdated: description: 'The date and time the service catalog was last modified, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-12-10T05:10:29.721Z` ' format: date-time type: string required: - id - displayName - compartmentId - lifecycleState - timeCreated type: object x-example: "{\n \"id\": \"ocid1.servicecatalog.oc1.iad.123..\",\n \"displayName\": \"Service Catalog 1\",\n \"lifecycleState\": \"ACTIVE\",\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"timeCreated\": \"2021-05-27T17:39:19.186Z\"\n}\n" UpdatePrivateApplicationDetails: description: The model for the parameters needed to update a private application. properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the private application. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object logoFileBase64Encoded: description: 'Base64-encoded logo to use as the private application icon. Template icon file requirements: PNG format, 50 KB maximum, 130 x 130 pixels. ' type: string longDescription: description: A long description of the private application. maxLength: 4095 minLength: 0 type: string shortDescription: description: A short description of the private application. maxLength: 511 minLength: 1 type: string type: object x-example: "{\n \"displayName\": \"Software Load Balancer (800 Mbps)\",\n \"shortDescription\": \"Software Load Balancer (800 Mbps) by ACME\",\n \"longDescription\": \"Software load balancer by ACME will provide you with a reliable traffic partition ...\"\n}\n" WorkRequestLogEntry: description: A log message from the execution of a work request. properties: message: description: Human-readable log message. type: string timestamp: description: The time the log message was written. An RFC3339 formatted datetime string format: date-time type: string required: - message - timestamp CreatePrivateApplicationPackage: description: A base object for creating a private application package. discriminator: propertyName: packageType properties: packageType: description: The package's type. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' version: description: The package version. maxLength: 255 minLength: 1 type: string required: - packageType - version type: object ServiceCatalogCollection: description: Collection of Service Catalog Summaries. properties: items: description: Collection of catalog summaries. items: $ref: '#/components/schemas/ServiceCatalogSummary' type: array required: - items type: object WorkRequestLogEntryCollection: description: Results of a workRequestLog search. Contains both workRequestLog items and other information, such as metadata. properties: items: description: List of workRequestLogEntries. items: $ref: '#/components/schemas/WorkRequestLogEntry' type: array required: - items type: object PrivateApplication: description: 'Full details of an application or a solution, which lives inside the tenancy and may be included into service catalogs. ' properties: compartmentId: description: 'The [OCID](/Content/General/Concepts/identifiers.htm) of the compartment where the private application resides. ' maxLength: 255 minLength: 1 type: string definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object displayName: description: The name of the private application. maxLength: 255 minLength: 1 type: string freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object id: description: The unique identifier for the private application in Marketplace. maxLength: 255 minLength: 1 type: string lifecycleState: description: The lifecycle state of the private application. enum: - CREATING - UPDATING - ACTIVE - DELETING - DELETED type: string logo: $ref: '#/components/schemas/UploadData' longDescription: description: A long description of the private application. maxLength: 4095 minLength: 0 type: string packageType: description: Type of packages within this private application. enum: - STACK - IMAGE type: string x-obmcs-top-level-enum: '#/definitions/PackageTypeEnum' shortDescription: description: A short description of the private application. maxLength: 511 minLength: 0 type: string systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object timeCreated: description: 'The date and time the private application was created, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-05-26T21:10:29.600Z` ' format: date-time type: string timeUpdated: description: 'The date and time the private application was last modified, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. Example: `2021-12-10T05:10:29.721Z` ' format: date-time type: string required: - id - displayName - packageType - compartmentId - lifecycleState - timeCreated type: object x-example: "{\n \"compartmentId\": \"ocid1.compartment.oc1.aaabcd..\",\n \"id\": \"ocid1.privateapplication.oc1.iad.123..\",\n \"displayName\": \"Software Load Balancer\",\n \"longDescription\": \"Software load balancer by ACME will provide you with a reliable round-robin ...\",\n \"packageType\": \"STACK\",\n \"shortDescription\": \"Free Software Load Balancer by ACME\",\n \"lifecycleState\": \"ACTIVE\",\n \"timeCreated\": \"2021-05-26T21:10:29.600Z\",\n \"timeUpdated\": \"2021-12-10T05:10:29.721Z\"\n}\n" responses: '400': description: Bad Request 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' DefaultError: description: An error has occurred. 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '404': description: Not Found 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '412': description: Precondition Failed 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '429': description: Too Many Requests 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '401': description: Not Authenticated 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '409': description: Conflict 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' '500': description: Internal Server Error 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 content: application/json: schema: $ref: '#/components/schemas/ErrorEntity' x-anchors: x-headers: etag: description: 'For optimistic concurrency control. See `if-match`. ' type: string opc-next-page: description: 'For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items. ' 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 opc-work-request-id: description: 'Unique Oracle-assigned identifier for the asynchronous request. You can use this to query status of the asynchronous operation. ' type: string retry-after: description: A decimal number representing the number of seconds the client should wait before polling this endpoint again. type: integer x-properties: definedTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing predefined tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: `{"foo-namespace": {"bar-key": "value"}}` ' type: object freeformTags: additionalProperties: type: string description: 'Simple key-value pair that is applied without any predefined name, type or scope. Exists for cross-compatibility only. Example: `{"bar-key": "value"}` ' type: object systemTags: additionalProperties: additionalProperties: description: 'The value of the tag. Only string, integer and boolean types are supported. ' type: object description: 'Key-value pair representing system tags'' keys and values scoped to a namespace. Example: `{"bar-key": "value"}` ' type: object description: 'Usage of system tag keys. These predefined keys are scoped to namespaces. Example: `{"orcl-cloud": {"free-tier-retained": "true"}}` ' type: object x-obmcs-client-retries-enabled: true