Jump to

• Request
• Response

Create Image

post

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/goldImages

Creates a new image. This is an asynchronous operation, which submits a deployment procedure to perform this task.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Match One Schema

Show Source

• object DatabaseGoldImageDetails
  Input to create the image

{
    "oneOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageDetails"
        }
    ]
}

Nested Schema : DatabaseGoldImageDetails

Type: object

Input to create the image

Match One Schema

Show Source

• object DatabaseGoldImageReferenceHomeInput
  Input to create image from a reference Oracle home
• object DatabaseGoldImageReferenceHomePatchingInput
  Input to create the image from the reference Oracle home with patching
• object DatabaseGoldImageNewHomePatchingInput
  Input to create the image from new home with patching, which is to be used as the reference Oracle home
• object DatabaseGoldImageImportInput
  Input to create image from import
• object DatabaseGoldImageFPPInput
  Input to create new series resource in FPP server with given series name and creates image from reference Oracle Home and associates series to it
• object DatabaseGoldImageFPPReferenceHomeInput
  Input to create image in FPP server from a reference Oracle home
• object DatabaseGoldImageFPPReferenceHomePatchingInput
  Input to create the image in FPP server from the reference Oracle home with patching
• object DatabaseGoldImageFPPNewHomePatchingInput
  Input to create the image in FPP server from new home with patching, which is to be used as the reference Oracle home

{
    "description":"Input to create the image",
    "type":"object",
    "oneOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomeInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomePatchingInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageNewHomePatchingInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageImportInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomeInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomePatchingInput"
        },
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPNewHomePatchingInput"
        }
    ]
}

Nested Schema : DatabaseGoldImageReferenceHomeInput

Type: object

Input to create image from a reference Oracle home

Show Source

• referenceHostCredential(required): string
  Reference Oracle Home host credential

  Example: TESTSUPERADMIN:ADMIN
• referenceTargetName(required): string
  Reference Oracle Home target

  Example: myoraclehome_4661

{
    "description":"Input to create image from a reference Oracle home",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageInput"
        }
    ],
    "type":"object",
    "properties":{
        "referenceTargetName":{
            "description":"Reference Oracle Home target",
            "type":"string",
            "example":"myoraclehome_4661"
        },
        "referenceHostCredential":{
            "description":"Reference Oracle Home host credential",
            "type":"string",
            "example":"TESTSUPERADMIN:ADMIN"
        }
    }
}

Match All

Show Source

• object allOf DatabaseGoldImageInput
  Common input to create image or version

{
    "description":"Input to create image from a reference Oracle home",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageInput"
        }
    ],
    "type":"object",
    "properties":{
        "referenceTargetName":{
            "description":"Reference Oracle Home target",
            "type":"string",
            "example":"myoraclehome_4661"
        },
        "referenceHostCredential":{
            "description":"Reference Oracle Home host credential",
            "type":"string",
            "example":"TESTSUPERADMIN:ADMIN"
        }
    }
}

Nested Schema : DatabaseGoldImageReferenceHomePatchingInput

Type: object

Input to create the image from the reference Oracle home with patching

Show Source

• isCleanupDestinationHome: boolean
  Flag to indicate cleanup destination home

  Example: false
• patchList(required): string
  Patches to be applied

  Example: 31504723
• referenceHostPrivilegeCredential: string
  Privilege host credential of the reference Oracle Home target

  Example: TESTPRIVADMIN:ADMIN

{
    "description":"Input to create the image from the reference Oracle home with patching",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomeInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName",
        "patchList"
    ],
    "properties":{
        "referenceHostPrivilegeCredential":{
            "description":"Privilege host credential of the reference Oracle Home target",
            "type":"string",
            "example":"TESTPRIVADMIN:ADMIN"
        },
        "isCleanupDestinationHome":{
            "description":"Flag to indicate cleanup destination home",
            "type":"boolean",
            "example":false
        },
        "patchList":{
            "description":"Patches to be applied",
            "type":"string",
            "example":"31504723"
        }
    }
}

Match All

Show Source

• object allOf DatabaseGoldImageReferenceHomeInput
  Input to create image from a reference Oracle home

{
    "description":"Input to create the image from the reference Oracle home with patching",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomeInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName",
        "patchList"
    ],
    "properties":{
        "referenceHostPrivilegeCredential":{
            "description":"Privilege host credential of the reference Oracle Home target",
            "type":"string",
            "example":"TESTPRIVADMIN:ADMIN"
        },
        "isCleanupDestinationHome":{
            "description":"Flag to indicate cleanup destination home",
            "type":"boolean",
            "example":false
        },
        "patchList":{
            "description":"Patches to be applied",
            "type":"string",
            "example":"31504723"
        }
    }
}

Nested Schema : DatabaseGoldImageNewHomePatchingInput

Type: object

Input to create the image from new home with patching, which is to be used as the reference Oracle home

Show Source

• destinationOracleHomeLocation(required): string
  Location of the destination Oracle home

  Example: /u01/oracle/newhome

{
    "description":"Input to create the image from new home with patching, which is to be used as the reference Oracle home",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomePatchingInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName",
        "patchList",
        "referenceHostPrivilegeCredential",
        "destinationOracleHomeLocation"
    ],
    "properties":{
        "destinationOracleHomeLocation":{
            "description":"Location of the destination Oracle home",
            "type":"string",
            "example":"/u01/oracle/newhome"
        }
    }
}

Match All

Show Source

• object allOf DatabaseGoldImageReferenceHomePatchingInput
  Input to create the image from the reference Oracle home with patching

{
    "description":"Input to create the image from new home with patching, which is to be used as the reference Oracle home",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageReferenceHomePatchingInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "imageSoftwareLibraryPath",
        "referenceHostCredential",
        "workingDirectory",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "versionName",
        "patchList",
        "referenceHostPrivilegeCredential",
        "destinationOracleHomeLocation"
    ],
    "properties":{
        "destinationOracleHomeLocation":{
            "description":"Location of the destination Oracle home",
            "type":"string",
            "example":"/u01/oracle/newhome"
        }
    }
}

Nested Schema : DatabaseGoldImageImportInput

Type: object

Input to create image from import

Show Source

• hostCredential(required): string
  Credential of the host

  Example: SRC_HOST_CRED:ADMIN
• hostName(required): string
  Name of the host

  Example: myhost.com
• imageBundleLocation(required): string
  Bundle location of the image

  Example: /scratch/images/exportedimages
• imageBundleName(required):
  Bundle name of image

  Example: exportedImage_18c.zip
• imageDescription: string
  Description of the image

  Example: importing image 18c
• imageName(required): string
  Name of the image

  Example: fm_18c_image1
• imageSoftwareLibraryLocation(required):
  Software library location for the image

  Example: Oracle Home Provisioning Profiles/18.3.0.0.0/linux_x64
• softwareLibraryStorageName(required): string
  Software library storage name

  Example: swlib
• softwareLibraryStorageType(required): string
  Software library storage type

  Example: OmsShared
• versionName(required): string
  Name of the image version

  Example: Version1-18.3
• workingDirectory(required): string
  Default Value: /tmp

  Working directory

  Example: /scratch/workdir

{
    "description":"Input to create image from import",
    "required":[
        "imageName",
        "hostName",
        "hostCredential",
        "imageBundleName",
        "imageBundleLocation",
        "imageSoftwareLibraryLocation",
        "softwareLibraryStorageName",
        "softwareLibraryStorageType",
        "workingDirectory",
        "versionName"
    ],
    "properties":{
        "imageName":{
            "description":"Name of the image",
            "type":"string",
            "example":"fm_18c_image1"
        },
        "hostName":{
            "description":"Name of the host",
            "type":"string",
            "example":"myhost.com"
        },
        "hostCredential":{
            "description":"Credential of the host",
            "type":"string",
            "example":"SRC_HOST_CRED:ADMIN"
        },
        "imageBundleName":{
            "description":"Bundle name of image",
            "example":"exportedImage_18c.zip"
        },
        "imageBundleLocation":{
            "description":"Bundle location of the image",
            "type":"string",
            "example":"/scratch/images/exportedimages"
        },
        "imageDescription":{
            "description":"Description of the image",
            "type":"string",
            "example":"importing image 18c"
        },
        "imageSoftwareLibraryLocation":{
            "description":"Software library location for the image",
            "example":"Oracle Home Provisioning Profiles/18.3.0.0.0/linux_x64"
        },
        "softwareLibraryStorageName":{
            "description":"Software library storage name",
            "type":"string",
            "example":"swlib"
        },
        "softwareLibraryStorageType":{
            "description":"Software library storage type",
            "type":"string",
            "example":"OmsShared"
        },
        "workingDirectory":{
            "description":"Working directory",
            "type":"string",
            "default":"/tmp",
            "example":"/scratch/workdir"
        },
        "versionName":{
            "description":"Name of the image version",
            "type":"string",
            "example":"Version1-18.3"
        }
    }
}

Nested Schema : DatabaseGoldImageFPPInput

Type: object

Input to create new series resource in FPP server with given series name and creates image from reference Oracle Home and associates series to it

Show Source

• fppOptions: string
  Additional options for FPP
• fppRestUser: string
  REST user to be used for an FPP REST call

  Example: rest_cuser
• imageDescription: string
  Description for the image

  Example: Gold image for DB19
• imageName: string
  Name of the FPP series

  Example: FPP_DB_19_Series_04_july_21
• referenceHostCredential(required): string
  Host credential of the reference host

  Example: SRC_HOST_CRED:ADMIN
• referenceTargetName(required): string
  Reference target name

  Example: myoraclehome_3917
• version: string
  Version of the image
• versionName(required): string
  Name of the image

  Example: Tier1_19_ver_Image_04_July_21
• workingDirectory(required): string
  Default Value: /tmp

  Working directory

  Example: /scratch/cuser/agents/image

{
    "description":"Input to create new series resource in FPP server with given series name and creates image from reference Oracle Home and associates series to it",
    "type":"object",
    "required":[
        "versionName",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory"
    ],
    "properties":{
        "imageName":{
            "description":"Name of the FPP series",
            "type":"string",
            "example":"FPP_DB_19_Series_04_july_21"
        },
        "versionName":{
            "description":"Name of the image",
            "type":"string",
            "example":"Tier1_19_ver_Image_04_July_21"
        },
        "imageDescription":{
            "description":"Description for the image",
            "type":"string",
            "example":"Gold image for DB19"
        },
        "referenceTargetName":{
            "description":"Reference target name",
            "type":"string",
            "example":"myoraclehome_3917"
        },
        "referenceHostCredential":{
            "description":"Host credential of the reference host",
            "type":"string",
            "example":"SRC_HOST_CRED:ADMIN"
        },
        "workingDirectory":{
            "description":"Working directory",
            "type":"string",
            "default":"/tmp",
            "example":"/scratch/cuser/agents/image"
        },
        "version":{
            "description":"Version of the image",
            "type":"string"
        },
        "fppOptions":{
            "description":"Additional options for FPP",
            "type":"string"
        },
        "fppRestUser":{
            "description":"REST user to be used for an FPP REST call",
            "type":"string",
            "example":"rest_cuser"
        }
    }
}

Nested Schema : DatabaseGoldImageFPPReferenceHomeInput

Type: object

Input to create image in FPP server from a reference Oracle home

Show Source

• referenceHostCredential(required): string
  Reference Oracle home host credential

  Example: TESTSUPERADMIN:ADMIN
• referenceTargetName(required): string
  Reference Oracle home target

  Example: myoraclehome_4661

{
    "description":"Input to create image in FPP server from a reference Oracle home",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPInput"
        }
    ],
    "type":"object",
    "properties":{
        "referenceTargetName":{
            "description":"Reference Oracle home target",
            "type":"string",
            "example":"myoraclehome_4661"
        },
        "referenceHostCredential":{
            "description":"Reference Oracle home host credential",
            "type":"string",
            "example":"TESTSUPERADMIN:ADMIN"
        }
    }
}

Match All

Show Source

• object DatabaseGoldImageFPPInput
  Input to create new series resource in FPP server with given series name and creates image from reference Oracle Home and associates series to it

{
    "description":"Input to create image in FPP server from a reference Oracle home",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPInput"
        }
    ],
    "type":"object",
    "properties":{
        "referenceTargetName":{
            "description":"Reference Oracle home target",
            "type":"string",
            "example":"myoraclehome_4661"
        },
        "referenceHostCredential":{
            "description":"Reference Oracle home host credential",
            "type":"string",
            "example":"TESTSUPERADMIN:ADMIN"
        }
    }
}

Nested Schema : DatabaseGoldImageFPPReferenceHomePatchingInput

Type: object

Input to create the image in FPP server from the reference Oracle home with patching

Show Source

• isCleanupDestinationHome: boolean
  Flag to indicate cleanup destination home

  Example: false
• patchList(required): string
  Patches to be applied

  Example: 31504723
• referenceHostPrivilegeCredential: string
  Privilege host credential of the reference Oracle home target

  Example: TESTPRIVADMIN:ADMIN

{
    "description":"Input to create the image in FPP server from the reference Oracle home with patching",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomeInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName",
        "patchList"
    ],
    "properties":{
        "referenceHostPrivilegeCredential":{
            "description":"Privilege host credential of the reference Oracle home target",
            "type":"string",
            "example":"TESTPRIVADMIN:ADMIN"
        },
        "isCleanupDestinationHome":{
            "description":"Flag to indicate cleanup destination home",
            "type":"boolean",
            "example":false
        },
        "patchList":{
            "description":"Patches to be applied",
            "type":"string",
            "example":"31504723"
        }
    }
}

Match All

Show Source

• object allOf DatabaseGoldImageFPPReferenceHomeInput
  Input to create image in FPP server from a reference Oracle home

{
    "description":"Input to create the image in FPP server from the reference Oracle home with patching",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomeInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName",
        "patchList"
    ],
    "properties":{
        "referenceHostPrivilegeCredential":{
            "description":"Privilege host credential of the reference Oracle home target",
            "type":"string",
            "example":"TESTPRIVADMIN:ADMIN"
        },
        "isCleanupDestinationHome":{
            "description":"Flag to indicate cleanup destination home",
            "type":"boolean",
            "example":false
        },
        "patchList":{
            "description":"Patches to be applied",
            "type":"string",
            "example":"31504723"
        }
    }
}

Nested Schema : DatabaseGoldImageFPPNewHomePatchingInput

Type: object

Input to create the image in FPP server from new home with patching, which is to be used as the reference Oracle home

Show Source

• destinationOracleHomeLocation(required): string
  Location of the destination Oracle home

  Example: /u01/oracle/newhome

{
    "description":"Input to create the image in FPP server from new home with patching, which is to be used as the reference Oracle home",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomePatchingInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName",
        "patchList",
        "referenceHostPrivilegeCredential",
        "destinationOracleHomeLocation"
    ],
    "properties":{
        "destinationOracleHomeLocation":{
            "description":"Location of the destination Oracle home",
            "type":"string",
            "example":"/u01/oracle/newhome"
        }
    }
}

Match All

Show Source

• object allOf DatabaseGoldImageFPPReferenceHomePatchingInput
  Input to create the image in FPP server from the reference Oracle home with patching

{
    "description":"Input to create the image in FPP server from new home with patching, which is to be used as the reference Oracle home",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageFPPReferenceHomePatchingInput"
        }
    ],
    "type":"object",
    "required":[
        "imageName",
        "imageDescription",
        "referenceTargetName",
        "referenceHostCredential",
        "workingDirectory",
        "versionName",
        "patchList",
        "referenceHostPrivilegeCredential",
        "destinationOracleHomeLocation"
    ],
    "properties":{
        "destinationOracleHomeLocation":{
            "description":"Location of the destination Oracle home",
            "type":"string",
            "example":"/u01/oracle/newhome"
        }
    }
}

Nested Schema : DatabaseGoldImageInput

Type: object

Common input to create image or version

Show Source

• imageName: string
  Name of the image

{
    "description":"Common input to create image or version",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageCommonDetails"
        }
    ],
    "properties":{
        "imageName":{
            "description":"Name of the image",
            "type":"string"
        }
    }
}

Match All

Show Source

• object DatabaseGoldImageCommonDetails
  Common input details to create the image

{
    "description":"Common input to create image or version",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/DatabaseGoldImageCommonDetails"
        }
    ],
    "properties":{
        "imageName":{
            "description":"Name of the image",
            "type":"string"
        }
    }
}

Nested Schema : DatabaseGoldImageCommonDetails

Type: object

Common input details to create the image

Show Source

• excludeFileList: string
  List of files to be excluded
• externalId: string
  External ID for the image

  Example: oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_OracleDB:4BAFA861A7E96603E053057FB10A0588:0.1
• imageDescription: string
  Description of the image
• imageNotes: string
  Notes about the image
• imageSoftwareLibraryPath: string
  Software library path for image

  Example: <path>/18.0/linux64
• isCreateImageLegacyWay: boolean
  Flag to indicate creation of the image in a legacy way

  Example: false
• isIgnoreActiveFileExecutionCheck: boolean
  Flag to ignore active files execution

  Example: false
• nfsLocalMountPoint: string
  Local directory path for NFS share to mount

  Example: /scratch/cuser/Nfs_mount_point
• softwareLibraryStorageName: string
  Software library storage name

  Example: swlib
• softwareLibraryStorageType: string
  Software Library storage type

  Example: OmsShared
• storageDestination: string
  Allowed Values: [ "SOFTWARE_LIBRARY", "FPP_SERVER" ]

  Image storage/creation is either in software library or in FPP server
• versionName: string
  Name for the Database Gold Image Version

  Example: fm_version_1
• versionStatus: string
  Allowed Values: [ "CURRENT" ]

  Enum for image version status
• windowsCredential: string
  Credential for the Windows platform
• workingDirectory: string
  Default Value: /tmp

  Working directory

  Example: /scratch/workdir

{
    "description":"Common input details to create the image",
    "type":"object",
    "properties":{
        "storageDestination":{
            "description":"Image storage/creation is either in software library or in FPP server",
            "type":"string",
            "enum":[
                "SOFTWARE_LIBRARY",
                "FPP_SERVER"
            ]
        },
        "imageDescription":{
            "description":"Description of the image",
            "type":"string"
        },
        "imageSoftwareLibraryPath":{
            "description":"Software library path for image",
            "type":"string",
            "example":"<path>/18.0/linux64"
        },
        "workingDirectory":{
            "description":"Working directory",
            "type":"string",
            "default":"/tmp",
            "example":"/scratch/workdir"
        },
        "softwareLibraryStorageName":{
            "description":"Software library storage name",
            "type":"string",
            "example":"swlib"
        },
        "softwareLibraryStorageType":{
            "description":"Software Library storage type",
            "type":"string",
            "example":"OmsShared"
        },
        "versionName":{
            "description":"Name for the Database Gold Image Version",
            "type":"string",
            "example":"fm_version_1"
        },
        "versionStatus":{
            "$ref":"#/components/schemas/VersionStatusEnum"
        },
        "nfsLocalMountPoint":{
            "description":"Local directory path for NFS share to mount",
            "type":"string",
            "example":"/scratch/cuser/Nfs_mount_point"
        },
        "imageNotes":{
            "description":"Notes about the image",
            "type":"string"
        },
        "externalId":{
            "description":"External ID for the image",
            "type":"string",
            "example":"oracle:defaultService:em:provisioning:1:cmp:COMP_Component:SUB_OracleDB:4BAFA861A7E96603E053057FB10A0588:0.1"
        },
        "excludeFileList":{
            "description":"List of files to be excluded",
            "type":"string"
        },
        "windowsCredential":{
            "description":"Credential for the Windows platform",
            "type":"string"
        },
        "isIgnoreActiveFileExecutionCheck":{
            "description":"Flag to ignore active files execution",
            "type":"boolean",
            "example":false
        },
        "isCreateImageLegacyWay":{
            "description":"Flag to indicate creation of the image in a legacy way",
            "type":"boolean",
            "example":false
        }
    }
}

Examples

Select an example Payload for Create Image in Software library From Reference Oracle Home Payload for Create Image in Software Library From Reference Oracle Home Patching Payload for Create Image in Software Library from Import Payload for Create Image in Software Library from New Reference Oracle Home Patching Payload for Create Image in FPP Server from Reference Oracle Home Payload for Create Image in FPP Server from Reference Oracle Home Patching Payload for Create Image in FPP Server from New Reference Oracle Home Patching

Back to Top

Response

202 Response

It is a long running/async API. It submits a deployment procedure.

Headers

• Location:
  URL link to track the status of the API for the deployment procedure

  Example:

  /deploymentProcedureInstances/{deploymentProcedureInstanceId}

Body ()

Root Schema : schema

Type: object

Show Source

• links: object links
  links
• message: string
  message

  Example: It is a long running/async API. It submits a deployment procedure.

{
    "type":"object",
    "properties":{
        "message":{
            "description":"message",
            "type":"string",
            "example":"It is a long running/async API. It submits a deployment procedure."
        },
        "links":{
            "description":"links",
            "type":"object",
            "properties":{
                "tracking":{
                    "type":"object",
                    "description":"Represents a link to the REST API to track the status of the submitted deployment procedure",
                    "properties":{
                        "href":{
                            "type":"string",
                            "description":"URL for the link",
                            "example":"/deploymentProcedureInstances/{deploymentProcedureInstanceId}"
                        }
                    }
                }
            }
        }
    }
}

Nested Schema : links

Type: object

links

Show Source

• tracking: object tracking
  Represents a link to the REST API to track the status of the submitted deployment procedure

{
    "description":"links",
    "type":"object",
    "properties":{
        "tracking":{
            "type":"object",
            "description":"Represents a link to the REST API to track the status of the submitted deployment procedure",
            "properties":{
                "href":{
                    "type":"string",
                    "description":"URL for the link",
                    "example":"/deploymentProcedureInstances/{deploymentProcedureInstanceId}"
                }
            }
        }
    }
}

Nested Schema : tracking

Type: object

Represents a link to the REST API to track the status of the submitted deployment procedure

Show Source

• href: string
  URL for the link

  Example: /deploymentProcedureInstances/{deploymentProcedureInstanceId}

{
    "type":"object",
    "description":"Represents a link to the REST API to track the status of the submitted deployment procedure",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for the link",
            "example":"/deploymentProcedureInstances/{deploymentProcedureInstanceId}"
        }
    }
}

400 Response

Bad Request. The payload is null or missing some parameters

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

401 Response

Unauthorized. The user does not have permissions to perform the requested operation

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

403 Response

Forbidden. The user is forbidden to perform the requested operation

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

404 Response

Not Found. The requested REST API URL is not found.

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

500 Response

Internal Server Error. Exception in execution of REST API.

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

503 Response

Service Unavailable. The server is unable to process the request.

Body ()

Root Schema : ErrorResponse

Type: object

Error response

Show Source

• code(required): string
  A short error code that defines the error, meant for programmatic parsing
• message(required): string
  A human-readable error string

{
    "description":"Error response",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "description":"A short error code that defines the error, meant for programmatic parsing",
            "type":"string"
        },
        "message":{
            "description":"A human-readable error string",
            "type":"string"
        }
    }
}

Back to Top