Gets the details of a listing.
GET {{baseUrl}}/listings/:listingId?compartmentId={{compartment_ocid}}
Gets detailed information about a listing, including the listing's name, version, description, and resources.
If you plan to launch an instance from an image listing, you must first subscribe to the listing. When you launch the instance, you also need to provide the image ID of the listing resource version that you want.
Subscribing to the listing requires you to first get a signature from the terms of use agreement for the listing resource version. To get the signature, issue a GetAppCatalogListingAgreements API call. The AppCatalogListingResourceVersionAgreements object, including its signature, is returned in the response. With the signature for the terms of use agreement for the desired listing resource version, create a subscription by issuing a CreateAppCatalogSubscription API call.
To get the image ID to launch an instance, issue a GetAppCatalogListingResourceVersion API call. Lastly, to launch the instance, use the image ID of the listing resource version to issue a LaunchInstance API call.
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
compartmentId | string | The unique identifier for the compartment. |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
opc-request-id | string | Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, | |
please provide the request ID. | |||
Accept | string |
RESPONSES
status: OK
{"banner":{"contentUrl":"Duis dolore aute","fileExtension":"qui anim","mimeType":"in nostrud","name":"pariatur dolor conse"},"categories":["in ea tempor","anim adipisicing enim tempor dolore"],"compatibleArchitectures":["ARM","ARM"],"defaultPackageVersion":"sed","documentationLinks":[{"documentCategory":"incididunt mollit aliqua et","name":"in irure sint","url":"nulla"},{"documentCategory":"ut","name":"ex cillum quis","url":"laborum"}],"icon":{"contentUrl":"Excepteur sint adipisicing laboris","fileExtension":"cillum quis","mimeType":"elit","name":"Excepteur"},"id":"reprehenderit fugiat id nulla","isFeatured":false,"keywords":"minim occaecat ad","languages":[{"code":"in sed ipsum velit sunt","name":"elit anim voluptate adipisicing"},{"code":"laboris sit minim ","name":"nulla tempor"}],"licenseModelDescription":"laborum aute voluptate","links":[{"href":"aliqua adipisicing Ut","rel":"TEMPLATE"},{"href":"nisi deserunt nulla","rel":"PREV"}],"listingType":"PRIVATE","longDescription":"in ut Duis","name":"Lorem ut Ut","packageType":"IMAGE","publisher":{"contactEmail":"exercitation commodo consequat cupidatat","contactPhone":"minim exercitation aliquip in cupidatat","description":"commodo exercitation ad","hqAddress":"eiusmod nisi officia in","id":"eu non ut laborum","links":[{"href":"ut laborum eiusmod proident","rel":"PREV"},{"href":"minim officia incididunt","rel":"CANONICAL"}],"logo":{"contentUrl":"esse est","fileExtension":"id in exercitation Duis","mimeType":"enim officia voluptate magna do","name":"Ut Excepteur ad ut"},"name":"mollit aliquip in cupidatat","websiteUrl":"commodo nisi","yearFounded":-27705022},"regions":[{"code":"magna voluptate dolor deserunt","countries":[{"code":"elit laborum ad et","name":"eu"},{"code":"do non aliqua","name":"eiusmod magna sit"}],"name":"a"},{"code":"ut enim do dolor","countries":[{"code":"sin","name":"sint nisi aliquip"},{"code":"dolor dolor qui aliquip","name":"ullamco dolor consectetur officia"}],"name":"amet ullamco"}],"releaseNotes":"ad eiusmod","screenshots":[{"contentUrl":"veniam enim qui","description":"in cupidatat minim","fileExtension":"occaecat dolore","mimeType":"laboris","name":"velit dolor"},{"contentUrl":"ea nostrud","description":"dolor","fileExtension":"consectetur esse aliqua pariatur","mimeType":"amet commodo","name":"dolore pariatur"}],"shortDescription":"et deserunt pariatur","supportContacts":[{"email":"qui labore sed","name":"anim enim dolor","phone":"cupidatat elit","subject":"ea laborum"},{"email":"Excepteur in a","name":"pariatur","phone":"dolore adipisicing in","subject":"sit dolore occaecat"}],"supportLinks":[{"name":"enim dolore aliquip","url":"sit proident sint quis"},{"name":"aliquip Lorem exercitation","url":"exercitation laboris et"}],"supportedOperatingSystems":[{"name":"voluptate consectetur enim esse"},{"name":"Duis eiusmod incididunt"}],"systemRequirements":"Ut veniam cillum","tagline":"consectetur ut mollit ipsum","timeReleased":"1989-10-22T02:40:29.642Z","usageInformation":"veniam magna dolore occaecat","version":"in commodo cillum voluptate labore","videos":[{"name":"est minim proident officia veniam","url":"occaecat minim culpa cillum incididunt"},{"name":"exercitation labore enim cupidatat","url":"nostrud cupidatat"}]}