Jump to

• Request
• Response

Patch database home by name with available patch

put

/dbhomes/name/{dbhomeName}

Patches Oracle home that is associated with a database. Note that, to patch an Oracle home by database home name, there must be some associated databases in the Oracle home.

Request

Supported Media Types

• application/json

Path Parameters

• dbhomeName: string
  database home Name

Header Parameters

• opc-idempotency-token: string
  Minimum Length: 1

  Maximum Length: 64

  A user-supplied token that uniquely identifies a request. A single request will be acted upon among many requests that share the same token. Idempotency tokens expire after 30 minutes.

Body ()

patching parameters

Root Schema : DbHomePatchingRequest

Type: object

Show Source

• force(optional): boolean
  force flag to force patching. By default it will be false.
• ignoreMissingPatches(optional): boolean
  force flag to ignore all missing patches and force patching. By default it will be false.
• local(optional): boolean
  local flag to patch only local system. By default it will be false.
• nodeId(optional): string
  Node Id to support remote node patching
• precheck(optional): boolean
  option to not apply the patch but just to analyze the patch
• version(optional): string
  patch version or patch release version

{
    "properties":{
        "force":{
            "description":"force flag to force patching. By default it will be false.",
            "type":"boolean"
        },
        "ignoreMissingPatches":{
            "description":"force flag to ignore all missing patches and force patching. By default it will be false.",
            "type":"boolean"
        },
        "local":{
            "description":"local flag to patch only local system. By default it will be false.",
            "type":"boolean"
        },
        "nodeId":{
            "description":"Node Id to support remote node patching",
            "type":"string"
        },
        "precheck":{
            "description":"option to not apply the patch but just to analyze the patch",
            "type":"boolean"
        },
        "version":{
            "description":"patch version or patch release version",
            "type":"string"
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

200 Response

update Database Home status

Body ()

Root Schema : ServiceJobReport

Type: object

Job Request Status

Show Source

• createTimestamp(optional): string(date-time)
• description(optional): string
• jobId(optional): string
• jobType(optional): string
• message(optional): string
• reports(optional): array reports
• resourceList(optional): array resourceList
• status(optional): string
  Allowed Values: [ "Created", "Scheduled", "Running", "Success", "Failure", "Retrying", "Waiting", "InternalError", "Reverting", "Reverted", "NodeDisconnectedFailure" ]
• updatedTime(optional): string(date-time)

{
    "description":"Job Request Status",
    "properties":{
        "createTimestamp":{
            "format":"date-time",
            "type":"string"
        },
        "description":{
            "type":"string"
        },
        "jobId":{
            "type":"string"
        },
        "jobType":{
            "type":"string"
        },
        "message":{
            "type":"string"
        },
        "reports":{
            "items":{
                "$ref":"#/definitions/TaskReport"
            },
            "type":"array"
        },
        "resourceList":{
            "items":{
                "$ref":"#/definitions/JobResourceInfo"
            },
            "type":"array"
        },
        "status":{
            "enum":[
                "Created",
                "Scheduled",
                "Running",
                "Success",
                "Failure",
                "Retrying",
                "Waiting",
                "InternalError",
                "Reverting",
                "Reverted",
                "NodeDisconnectedFailure"
            ],
            "type":"string"
        },
        "updatedTime":{
            "format":"date-time",
            "type":"string"
        }
    }
}

Nested Schema : reports

Type: array

Show Source

• Array of: object TaskReport

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

Nested Schema : resourceList

Type: array

Show Source

• Array of: object JobResourceInfo
  resource information

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

Nested Schema : TaskReport

Type: object

Show Source

• duration(optional): string
• endTime(optional): string(date-time)
• jobId(optional): string
• nodeName(optional): string
• parentTaskId(optional): string
• reportLevel(optional): string
  Allowed Values: [ "Verbose", "Info", "Error" ]
• startTime(optional): string(date-time)
• status(optional): string
  Allowed Values: [ "Created", "Scheduled", "Running", "Success", "Failure", "Retrying", "Waiting", "InternalError", "Reverting", "Reverted", "NodeDisconnectedFailure", "Skipped" ]
• tags(optional): array tags
• taskDescription(optional): string
• taskId(optional): string
• taskName(optional): string
• taskResult(optional): string
• updatedTime(optional): string(date-time)

{
    "properties":{
        "duration":{
            "type":"string"
        },
        "endTime":{
            "format":"date-time",
            "type":"string"
        },
        "jobId":{
            "type":"string"
        },
        "nodeName":{
            "type":"string"
        },
        "parentTaskId":{
            "type":"string"
        },
        "reportLevel":{
            "enum":[
                "Verbose",
                "Info",
                "Error"
            ],
            "type":"string"
        },
        "startTime":{
            "format":"date-time",
            "type":"string"
        },
        "status":{
            "enum":[
                "Created",
                "Scheduled",
                "Running",
                "Success",
                "Failure",
                "Retrying",
                "Waiting",
                "InternalError",
                "Reverting",
                "Reverted",
                "NodeDisconnectedFailure",
                "Skipped"
            ],
            "type":"string"
        },
        "tags":{
            "items":{
                "type":"string"
            },
            "type":"array"
        },
        "taskDescription":{
            "type":"string"
        },
        "taskId":{
            "type":"string"
        },
        "taskName":{
            "type":"string"
        },
        "taskResult":{
            "type":"string"
        },
        "updatedTime":{
            "format":"date-time",
            "type":"string"
        }
    }
}

Nested Schema : tags

Type: array

Show Source

• Array of: string

{
    "items":{
        "type":"string"
    },
    "type":"array"
}

Nested Schema : JobResourceInfo

Type: object

resource information

Show Source

• jobId(optional): string
• resourceId(optional): string
• resourceNewType(optional): string
• resourceType(optional): string
  Allowed Values: [ "Backup", "BackupConfig", "DB", "DbHome", "Grid", "Pdb", "Recovery", "Report", "Tde", "ObjectStoreSwift" ]
• updatedTime(optional): string(date-time)

{
    "description":"resource information",
    "properties":{
        "jobId":{
            "type":"string"
        },
        "resourceId":{
            "type":"string"
        },
        "resourceNewType":{
            "type":"string"
        },
        "resourceType":{
            "enum":[
                "Backup",
                "BackupConfig",
                "DB",
                "DbHome",
                "Grid",
                "Pdb",
                "Recovery",
                "Report",
                "Tde",
                "ObjectStoreSwift"
            ],
            "type":"string"
        },
        "updatedTime":{
            "format":"date-time",
            "type":"string"
        }
    }
}

Default Response

An unexpected error has occurred

Body ()

Root Schema : Error

Type: object

Show Source

• code: string
• message: string

{
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string"
        },
        "message":{
            "type":"string"
        }
    }
}

Back to Top