Get details about a deployment procedure
get
https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/deploymentProcedures/{deploymentProcedureId}
Get details about a deployment procedure. In emcli, it is equivalent to 'describe_procedure_input'
Request
Path Parameters
-
deploymentProcedureId(required): string
Id of a Procedure.
Query Parameters
-
include: string
if include=procedureInput or include=XmlFormat, information about procedure input/procedure xml is included in the response
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
200 Response
Deployment Procedure returned successfully
Root Schema : DeploymentProcedure
Type:
object
It represents a Procedure
Match All
It represents a Procedure
Show Source
-
object
DeploymentProcedureDetails
This is the representation of a Procedure.
Nested Schema : DeploymentProcedureDetails
Type:
object
This is the representation of a Procedure.
Show Source
-
displayName: string
Display Name of a ProcedureExample:
Copy of TEST_DP
-
id: string
Unique identifier for a ProcedureExample:
B0FBBE587FD201E2E0537013790A7D53
-
links: object
links
Procedure related links
-
name: string
Name of a ProcedureExample:
DP_CC67765EF65F51A5E053E00F4B64D991
-
owner: string
Owner of a ProcedureExample:
SYSMAN
-
parentName: string
Parent procedure of a ProcedureExample:
TEST_DP
-
procedureInput: object
procedureInput
input which given during submit procedure
-
type: string
Type of a ProcedureExample:
UserDefined
-
version: string
Version Number of a ProcedureExample:
Succeeded
-
xmlFormat: string
returns DP xml which can be reused to register.
Nested Schema : links
Type:
object
Procedure related links
Show Source
-
self: object
Link
A link referencing a REST API.
Nested Schema : procedureInput
Type:
object
input which given during submit procedure
Match All
input which given during submit procedure
Show Source
-
object
DescribeProcedureInput
This is the representation of an input given while submitting deployment procedure.
Nested Schema : DescribeProcedureInput
Type:
object
This is the representation of an input given while submitting deployment procedure.
Show Source
-
links: object
links
Self link
-
schedule: object
Schedule
This represents a schedule object to schedule blackouts.
-
targets: array
DeploymentProcedureTargetList
Defining list of procedure targets
-
variables: object
DeploymentProcedureVariableCollection
Collections of Procedure Variable
Nested Schema : links
Type:
object
Self link
Show Source
-
self: object
Link
A link referencing a REST API.
Nested Schema : Schedule
Type:
object
This represents a schedule object to schedule blackouts.
Show Source
-
repeat: object
Repeat
Describes repetition of a blackout.
-
timeToStart: string
Start time of the blackout with timezone. Timestamps are with minute accuracy. Timezones can be given as offset (+01:00) or as zone (Europe/Berlin).Example:
2023-08-24T14:54-02:00
Match One Schema
Show Source
Nested Schema : DeploymentProcedureTargetList
Type:
array
Defining list of procedure targets
Show Source
Nested Schema : DeploymentProcedureVariableCollection
Type:
object
Collections of Procedure Variable
Show Source
-
items: array
items
The list of procedure variables
Nested Schema : Repeat
Type:
object
Describes repetition of a blackout.
Show Source
-
timeToEndRepeat: string
End time of the repetition with timezone. Timestamps are with minute accuracy.Example:
2023-08-24T14:54-02:00
Match One Schema
Show Source
-
object
DaysOfYear
List of days of year.
-
object
DaysOfMonth
List of days of month in range 1-31 or -1 for last day of the month.
-
object
DaysOfWeek
List of days of week.
-
object
EveryNWeeks
Repeat every n weeks.
-
object
EveryNDays
Repeat every n days.
-
object
EveryNHours
Repeat every n hours.
-
object
EveryNMinutes
Repeat every n minutes, minimal value is 2.
Nested Schema : TimeToEnd
Type:
object
An object specifying an end time with timezone. Timestamps are with minute accuracy. Timezones can be given as offset (+01:00) or as zone (Europe/Berlin).
Show Source
-
timeToEnd(required): string
An end timeExample:
2023-08-23T14:54+01:00
Nested Schema : Duration
Type:
object
A duration given in hours and minutes. At least one of durationHours and durationMinutes is required.
Show Source
-
durationHours: integer
Duration of the blackout in hours.Example:
2
-
durationMinutes: integer
Duration of the blackout in minutes.Example:
25
Nested Schema : DaysOfYear
Type:
object
List of days of year.
Show Source
-
daysOfYear: array
daysOfYear
List of days of the year.
Nested Schema : DaysOfMonth
Type:
object
List of days of month in range 1-31 or -1 for last day of the month.
Show Source
-
daysOfMonth: array
daysOfMonth
List of days of the month (1 based).
Nested Schema : DaysOfWeek
Type:
object
List of days of week.
Show Source
-
daysOfWeek: array
daysOfWeek
List of days of week (localized short names).
Nested Schema : EveryNWeeks
Type:
object
Repeat every n weeks.
Show Source
-
everyNWeeks: integer
Repeat interval in weeks.Example:
2
Nested Schema : EveryNDays
Type:
object
Repeat every n days.
Show Source
-
everyNDays: integer
Repeat interval in days, minimal value is 1.Example:
5
Nested Schema : EveryNHours
Type:
object
Repeat every n hours.
Show Source
-
everyNHours: integer
Repeat interval in hours.Example:
2
Nested Schema : EveryNMinutes
Type:
object
Repeat every n minutes, minimal value is 2.
Show Source
-
everyNMinutes: integer
Repeat interval in minutes.Example:
45
Nested Schema : items
Type:
Show Source
object
-
day: integer
Day in range 1-31 or -1 for last day of the month.
-
month: integer
Month in range of 1-12.
Nested Schema : daysOfMonth
Type:
array
List of days of the month (1 based).
Show Source
Example:
[
"1",
"15"
]
Nested Schema : daysOfWeek
Type:
array
List of days of week (localized short names).
Show Source
-
Array of:
string
Allowed Values:
[ "MO", "TU", "WE", "TH", "FR", "SA", "SU" ]
Example:
[
"MO",
"TH"
]
Nested Schema : items
Type:
Show Source
object
-
name: string
name of target typeExample:
host
-
targets: object
DeploymentProcedureTargetCollection
Collections of Procedure Target
Nested Schema : DeploymentProcedureTargetCollection
Type:
object
Collections of Procedure Target
Show Source
-
items: array
items
The list of targets
Nested Schema : items
Type:
array
The list of targets
Show Source
-
Array of:
object DeploymentProcedureTargetSummary
This is the representation of Procedure Target
Nested Schema : DeploymentProcedureTargetSummary
Type:
object
This is the representation of Procedure Target
Match All
This is the representation of Procedure Target
Show Source
-
object
DeploymentProcedureTargetDetails
Defining Target for Deployment Procedure
Nested Schema : DeploymentProcedureTargetDetails
Type:
object
Defining Target for Deployment Procedure
Show Source
-
credentialReferences: array
CredentialReference
This is the representation of credential references.
-
targetName: string
Target NameExample:
host1.oracle.com
-
targetType: string
Target TypeExample:
host
Nested Schema : CredentialReference
Type:
array
This is the representation of credential references.
Show Source
Nested Schema : items
Type:
Show Source
object
-
credentialName: string
Represents credential nameExample:
EMGA
-
credentialType: string
Represents type of the credentialExample:
NAMED
-
owner: string
Represents owner of the credentialExample:
SYSMAN
-
usage: string
Represents credential usageExample:
defaultHostCred
Nested Schema : items
Type:
array
The list of procedure variables
Show Source
-
Array of:
object DeploymentProcedureVariableSummary
This is the representation of Procedure Variable
Nested Schema : DeploymentProcedureVariableSummary
Type:
object
This is the representation of Procedure Variable
Match All
This is the representation of Procedure Variable
Show Source
-
object
DeploymentProcedureVariableDetails
Defining Variable for Deployment Procedure
Nested Schema : DeploymentProcedureVariableDetails
Type:
object
Defining Variable for Deployment Procedure
Show Source
-
variableName: string
Displays Deployment Procedure varibale nameExample:
userId
-
variableValue: string
Displays Deployment Procedure varibale valueExample:
10001
400 Response
Bad Request. The payload is null or missing some parameters
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
401 Response
Unauthorized. The user does not have permissions to perform the requested operation
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
403 Response
Forbidden. The user is forbidden to perform the requested operation
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
404 Response
Not Found. The requested REST API URL is not found.
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
500 Response
Internal Server Error. Exception in execution of REST API.
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported
503 Response
Service Unavailable. The server is unable to process the request.
Root Schema : ErrorResponse
Type:
object
Response sent back in the case of an error.
Show Source
-
code: string
Status code of the error.Example:
IllegalArgument
-
message: string
A descriptive error message.Example:
argument given is not supported