Jump to

• Request
• Response

Schedules an register image operation

post

/rhp-restapi/rhp/images/repository

Register a new image from the specified path

Request

Supported Media Types

• application/json

Header Parameters

• Authorization(required): string
  Base64 encoding of the user name and password of the user making the request. For more information, see Authentication for Fleet Patching and Provisioning.

Body ()

Root Schema : RegisterImageBody

Type: object

Show Source

• auth: string
  Use an authentication plugin to access the remote node.
• authArgs: object authArgs
  Additional Properties Allowed: additionalProperties

  Additional properties for the selected authentication plugin.
• client: string
  Client cluster name
• cred: string
  Credential name to associate the user/password credentials to access a remote node
• imageName: string
  Name of the image
• imageType: string
  The software type. ("ORACLEDBSOFTWARE" (default) for Oracle database software, "EXAPATCHSOFTWARE" for Oracle Exadata software, "ORACLEGISOFTWARE" for Oracle Grid Infrastructure software, "ORACLEGGSOFTWARE" for Oracle GoldenGate software, "LINUXOS" for linux Opearting System ISO, and "SOFTWARE" for all other software. For a custom image type, use the image type name.)
• location: string
  Location of the compressed image file on the target
• ossurl: string
  URL where the OSS mapping file is located
• path: string
  Absolute path location of the software home to be imported (For database images, this will be the ORACLE_HOME)
• pathOwner: string
  User with read access to files under the specified path
• root: boolean
  Default Value: false

  Use root credentials to access the remote node
• schedule: string
  Preferred time to execute the operation, in ISO-8601 format. For example: 2016-12-21T19:13:17+05
• state: string
  Allowed Values: [ "TESTABLE", "RESTRICTED", "PUBLISHED" ]

  State name
• sudoPath: string
  location of sudo binary
• sudoUser: string
  perform super user operations as sudo user name
• targetNode: string
  Node on which operation needs to be executed
• temploc: string
  Get the absolute path to be used as temporary location to download the image that will be registered.
• userActionData: string
  Value to be passed to useractiondata parameter of useraction script
• version: string
  Oracle database version for GIAAS, ODA patchbundle version for ODAPATCHSOFTWARE, Exadata image version for EXAPATCHSOFTWARE
• zip: string
  Absolute path of the compressed software home to be imported (a ZIP or TAR file)

{
    "type":"object",
    "properties":{
        "imageName":{
            "type":"string",
            "description":"Name of the image"
        },
        "path":{
            "type":"string",
            "description":"Absolute path location of the software home to be imported (For database images, this will be the ORACLE_HOME)"
        },
        "zip":{
            "type":"string",
            "description":"Absolute path of the compressed software home to be imported (a ZIP or TAR file)"
        },
        "imageType":{
            "type":"string",
            "description":"The software type. (\"ORACLEDBSOFTWARE\" (default) for Oracle database software, \"EXAPATCHSOFTWARE\" for Oracle Exadata software, \"ORACLEGISOFTWARE\" for Oracle Grid Infrastructure software, \"ORACLEGGSOFTWARE\" for Oracle GoldenGate software, \"LINUXOS\" for linux Opearting System ISO, and \"SOFTWARE\" for all other software. For a custom image type, use the image type name.)"
        },
        "pathOwner":{
            "type":"string",
            "description":"User with read access to files under the specified path"
        },
        "state":{
            "type":"string",
            "description":"State name",
            "enum":[
                "TESTABLE",
                "RESTRICTED",
                "PUBLISHED"
            ]
        },
        "client":{
            "type":"string",
            "description":"Client cluster name"
        },
        "targetNode":{
            "type":"string",
            "description":"Node on which operation needs to be executed"
        },
        "sudoPath":{
            "type":"string",
            "description":"location of sudo binary"
        },
        "sudoUser":{
            "type":"string",
            "description":"perform super user operations as sudo user name"
        },
        "root":{
            "type":"boolean",
            "default":false,
            "description":"Use root credentials to access the remote node"
        },
        "schedule":{
            "type":"string",
            "description":"Preferred time to execute the operation, in ISO-8601 format. For example: 2016-12-21T19:13:17+05"
        },
        "userActionData":{
            "type":"string",
            "description":"Value to be passed to useractiondata parameter of useraction script"
        },
        "cred":{
            "type":"string",
            "description":"Credential name to associate the user/password credentials to access a remote node"
        },
        "ossurl":{
            "type":"string",
            "description":"URL where the OSS mapping file is located"
        },
        "version":{
            "type":"string",
            "description":"Oracle database version for GIAAS, ODA patchbundle version for ODAPATCHSOFTWARE, Exadata image version for EXAPATCHSOFTWARE"
        },
        "location":{
            "type":"string",
            "description":"Location of the compressed image file on the target"
        },
        "authArgs":{
            "type":"object",
            "description":"Additional properties for the selected authentication plugin.",
            "additionalProperties":{
                "type":"string"
            }
        },
        "auth":{
            "type":"string",
            "description":"Use an authentication plugin to access the remote node."
        },
        "temploc":{
            "type":"string",
            "description":"Get the absolute path to be used as temporary location to download the image that will be registered."
        }
    }
}

Nested Schema : authArgs

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "description":"Additional properties for the selected authentication plugin.",
    "additionalProperties":{
        "type":"string"
    }
}

Additional properties for the selected authentication plugin.

Security

• basicAuthentication: basic
  Type: basic

Back to Top

Response

Supported Media Types

• application/json
• text/html

202 Response

Accepted. A JSON object containing job resource details of the accepted operation to obtain status and output of the progress.

Headers

• Location: string
  URL to the job that will execute the operation

Body ()

Root Schema : jobResource

Type: object

Show Source

• jobId: string
• links: array links
• operation: string
• output: object jobOutputResource
• status: string
  Allowed Values: [ "SCHEDULED", "UNKNOWN", "EXECUTING", "PAUSED", "ABORTED", "TERMINATED", "FAILED", "SUCCEEDED" ]

{
    "type":"object",
    "properties":{
        "jobId":{
            "type":"string"
        },
        "status":{
            "type":"string",
            "enum":[
                "SCHEDULED",
                "UNKNOWN",
                "EXECUTING",
                "PAUSED",
                "ABORTED",
                "TERMINATED",
                "FAILED",
                "SUCCEEDED"
            ]
        },
        "operation":{
            "type":"string"
        },
        "output":{
            "$ref":"#/definitions/jobOutputResource"
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/singleResourceLinks"
            }
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object singleResourceLinks

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

Nested Schema : jobOutputResource

Type: object

Show Source

• hasMore: boolean
  Default Value: false
• limit: integer
• links: array links
• offset: integer
• output: string

{
    "type":"object",
    "properties":{
        "output":{
            "type":"string"
        },
        "limit":{
            "type":"integer"
        },
        "offset":{
            "type":"integer"
        },
        "hasMore":{
            "type":"boolean",
            "default":false
        },
        "links":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/collectionResourceLinks"
            }
        }
    }
}

Nested Schema : singleResourceLinks

Type: object

Show Source

• href: string
  The referenced hyperlink element provided in an absolute format.
• rel: string
  Allowed Values: [ "self", "collection", "up", "describedBy" ]

  Specify the type of relationship the link has with the described resource.

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Specify the type of relationship the link has with the described resource.",
            "enum":[
                "self",
                "collection",
                "up",
                "describedBy"
            ]
        },
        "href":{
            "type":"string",
            "description":"The referenced hyperlink element provided in an absolute format."
        }
    }
}

Nested Schema : links

Type: array

Show Source

• Array of: object collectionResourceLinks

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

Nested Schema : collectionResourceLinks

Type: object

Show Source

• href: string
  The referenced hyperlink element provided in an absolute format with the correct URL parameters.
• rel: string
  Allowed Values: [ "next", "prev", "first", "last" ]

  Specify the type of relationship the link has with the described resource.

{
    "type":"object",
    "properties":{
        "rel":{
            "type":"string",
            "description":"Specify the type of relationship the link has with the described resource.",
            "enum":[
                "next",
                "prev",
                "first",
                "last"
            ]
        },
        "href":{
            "type":"string",
            "description":"The referenced hyperlink element provided in an absolute format with the correct URL parameters."
        }
    }
}

400 Response

Bad Request. A JSON object containing error details of the issue found while parsing a parameter value or name.

Body ()

Root Schema : errorResource

Type: object

Show Source

• errorCode: string
  Application specific error code, related to the error message shown at tittle.
• errorDetails: array errorDetails
  If multiple errors are reported they can be organized in a hierarchical structure in this array.
• errorPath: string
  XPath or JSON path to indicate where the error occurs.
• instance: string
  URI to the link that provides more detail about the error.
• status: integer
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Link to HTTP error code page.

{
    "type":"object",
    "properties":{
        "status":{
            "type":"integer",
            "description":"HTTP status code."
        },
        "type":{
            "type":"string",
            "description":"Link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorDetails":{
            "type":"array",
            "description":"If multiple errors are reported they can be organized in a hierarchical structure in this array.",
            "items":{
                "$ref":"#/definitions/errorResource"
            }
        },
        "errorPath":{
            "type":"string",
            "description":"XPath or JSON path to indicate where the error occurs."
        },
        "errorCode":{
            "type":"string",
            "description":"Application specific error code, related to the error message shown at tittle."
        }
    }
}

Nested Schema : errorDetails

Type: array

If multiple errors are reported they can be organized in a hierarchical structure in this array.

Show Source

• Array of: object errorResource

{
    "type":"array",
    "description":"If multiple errors are reported they can be organized in a hierarchical structure in this array.",
    "items":{
        "$ref":"#/definitions/errorResource"
    }
}

Default Response

Unexpected error. A JSON object containing error details of the issue while executing the operation.

Body ()

Root Schema : errorResource

Type: object

Show Source

• errorCode: string
  Application specific error code, related to the error message shown at tittle.
• errorDetails: array errorDetails
  If multiple errors are reported they can be organized in a hierarchical structure in this array.
• errorPath: string
  XPath or JSON path to indicate where the error occurs.
• instance: string
  URI to the link that provides more detail about the error.
• status: integer
  HTTP status code.
• title: string
  Summary error message.
• type: string
  Link to HTTP error code page.

{
    "type":"object",
    "properties":{
        "status":{
            "type":"integer",
            "description":"HTTP status code."
        },
        "type":{
            "type":"string",
            "description":"Link to HTTP error code page."
        },
        "title":{
            "type":"string",
            "description":"Summary error message."
        },
        "instance":{
            "type":"string",
            "description":"URI to the link that provides more detail about the error."
        },
        "errorDetails":{
            "type":"array",
            "description":"If multiple errors are reported they can be organized in a hierarchical structure in this array.",
            "items":{
                "$ref":"#/definitions/errorResource"
            }
        },
        "errorPath":{
            "type":"string",
            "description":"XPath or JSON path to indicate where the error occurs."
        },
        "errorCode":{
            "type":"string",
            "description":"Application specific error code, related to the error message shown at tittle."
        }
    }
}

Nested Schema : errorDetails

Type: array

If multiple errors are reported they can be organized in a hierarchical structure in this array.

Show Source

• Array of: object errorResource

{
    "type":"array",
    "description":"If multiple errors are reported they can be organized in a hierarchical structure in this array.",
    "items":{
        "$ref":"#/definitions/errorResource"
    }
}

Back to Top