Jump to

• Request
• Response
• Examples

Get availability details of machine images.

get

/appstore/publisher/v1/storageimages/{machineImagePath}

Get the availability status of passed machine image in all data centers associated to the partner.

Request

Path Parameters

• machineImagePath: string
  Machine image path for which details are needed.

Back to Top

Response

Supported Media Types

• application/json;qs=1
• application/xml;qs=.5

200 Response

Successful Operation

Body ()

Root Schema : StorageImageResponse

Type: object

Show Source

• application(optional): string
• fileName(optional): string
• operatingSystem(optional): string
• path(optional): string
• storageDataCenterImageStatuses(optional): array storageDataCenterImageStatuses
• version(optional): string

{
    "type":"object",
    "properties":{
        "fileName":{
            "type":"string"
        },
        "version":{
            "type":"string"
        },
        "operatingSystem":{
            "type":"string"
        },
        "application":{
            "type":"string"
        },
        "path":{
            "type":"string"
        },
        "storageDataCenterImageStatuses":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/StorageDataCenterImageStatus"
            }
        }
    }
}

Nested Schema : storageDataCenterImageStatuses

Type: array

Show Source

• Array of: object StorageDataCenterImageStatus

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/StorageDataCenterImageStatus"
    }
}

Nested Schema : StorageDataCenterImageStatus

Type: object

Show Source

• dataCenterName(optional): string
• isAvailable(optional): boolean
• lastModifiedDate(optional): string
• region(optional): string
• replica(optional): boolean
• size(optional): string

{
    "type":"object",
    "properties":{
        "dataCenterName":{
            "type":"string"
        },
        "size":{
            "type":"string"
        },
        "lastModifiedDate":{
            "type":"string"
        },
        "region":{
            "type":"string"
        },
        "replica":{
            "type":"boolean"
        },
        "isAvailable":{
            "type":"boolean"
        }
    }
}

400 Response

Invalid Parameter Value

401 Response

Not Authorized

404 Response

Entity Not Found

500 Response

System Error

Back to Top

Examples

The following example fetches the availabilty of the machineimage in all the data centers associated to partner, by submitting a GET request on the REST resource using cURL.

cURL Example

curl -X GET -H "X-Oracle-UserId: partner-email" -H "Authorization: Bearer Access-token" "https://ocm-apis.cloud.oracle.com/appstore/publisher/v1/storageimages/mi/sun/sun/sun/ruby-2.4.1.tar.gz"

Request Header

X-Oracle-UserId: [e-mail] 
Authorization: Bearer Access-token 

Request Body

None

HTTP Status Code:

200 OK

JSON Response:

{
    "fileName": "ruby-2.4.1.tar.gz",
    "version": "sun",
    "operatingSystem": "sun",
    "application": "sun",
    "path": "mi/sun/sun/sun/ruby-2.4.1.tar.gz",
    "storageDataCenterImageStatuses": [
        {
            "dataCenterName": "TEAK",
            "size": "14174752",
            "isAvailable": true,
            "lastModifiedDate": "2017-11-30T10:32:38.000Z",
            "region": "TEAK"
        },
        {
            "dataCenterName": "redwood",
            "isAvailable": false,
            "region": "redwood",
            "replica": false
        }
    ]
}

Back to Top