Jump to

• Request
• Response

Get the blackout with the given id

get

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/blackouts/{blackoutId}

This API returns the blackout with the given id.

Request

Path Parameters

• blackoutId(required): string
  blackout id

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Successful Response

Body ()

Root Schema : Blackout

Type: object

This is a blackout description.

Show Source

• agent: string
  Name of the agent starting the blackout.

  Example: hostName:1838
• creationTimeToEnd: string
  The timeToEnd given at blackout creation time.
• creationTimeToStart: string
  The timeToStart given at blackout creation time.
• description: string
  Blackout related comments.

  Example: A regular maintenance scheduled blackouts for oemrep database
• excludeTargets: array excludeTargets
  List of indirect blackout members which should be excluded from blackout.
• excludeTypes: array excludeTypes
  List of indirect blackout member type names which should be excluded from blackout.
• id(required): string
  Blackout ID

  Example: D91786E288D35455C3ADA1B329B49BB5
• isAllowJobs: boolean
  Default Value: false

  Indicates if job executions on targets are allowed during blackout.
• isFullBlackoutOnHost: boolean
  Default Value: false

  Indicates if all targets on hosts in the blackout are blacked out too.
• links(required): object links
  Blackout related links.
• name(required): string
  Blackout Name

  Example: my_blackout
• owner(required): string
  Owner of the blackout

  Example: scott
• reason: string
  Blackout reason

  Example: Host patching
• status(required): string
  Allowed Values: [ "SCHEDULED", "START_PROCESSING", "START_PARTIAL", "START_FAILED", "STARTED", "STOP_PENDING", "STOP_FAILED", "STOP_PARTIAL", "EDIT_FAILED", "EDIT_PARTIAL", "EDIT_PENDING", "STOPPED", "ENDED", "END_PARTIAL" ]

  Blackout status.
• type(required): string
  Default Value: PATCHING

  Allowed Values: [ "PATCHING", "NOTIFICATION", "NOTIFICATION_MAINTENANCE" ]

  Type of the blackout.

{
    "x-em-sdk-level":"emSDK",
    "description":"This is a blackout description.",
    "type":"object",
    "required":[
        "id",
        "name",
        "type",
        "status",
        "owner",
        "links"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Blackout ID",
            "example":"D91786E288D35455C3ADA1B329B49BB5"
        },
        "name":{
            "type":"string",
            "description":"Blackout Name",
            "example":"my_blackout"
        },
        "type":{
            "$ref":"#/components/schemas/BlackoutType"
        },
        "owner":{
            "type":"string",
            "description":"Owner of the blackout",
            "example":"scott"
        },
        "reason":{
            "type":"string",
            "description":"Blackout reason",
            "example":"Host patching"
        },
        "description":{
            "type":"string",
            "description":"Blackout related comments.",
            "example":"A regular maintenance scheduled blackouts for oemrep database"
        },
        "agent":{
            "type":"string",
            "description":"Name of the agent starting the blackout.",
            "example":"hostName:1838"
        },
        "status":{
            "$ref":"#/components/schemas/BlackoutStatus"
        },
        "isAllowJobs":{
            "type":"boolean",
            "description":"Indicates if job executions on targets are allowed during blackout.",
            "default":false
        },
        "isFullBlackoutOnHost":{
            "type":"boolean",
            "description":"Indicates if all targets on hosts in the blackout are blacked out too.",
            "default":false
        },
        "excludeTypes":{
            "type":"array",
            "description":"List of indirect blackout member type names which should be excluded from blackout.",
            "items":{
                "type":"string"
            }
        },
        "excludeTargets":{
            "type":"array",
            "description":"List of indirect blackout members which should be excluded from blackout.",
            "items":{
                "$ref":"#/components/schemas/TargetIdentifier"
            }
        },
        "creationTimeToStart":{
            "type":"string",
            "description":"The timeToStart given at blackout creation time."
        },
        "creationTimeToEnd":{
            "type":"string",
            "description":"The timeToEnd given at blackout creation time."
        },
        "links":{
            "type":"object",
            "description":"Blackout related links.",
            "properties":{
                "self":{
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        },
                        {
                            "description":"Link to the blackout."
                        },
                        {
                            "example":{
                                "href":"/em/api/blackouts/D91786E288D35455C3ADA1B329B49BB5"
                            }
                        }
                    ]
                },
                "targets":{
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        },
                        {
                            "description":"Link to the targets under blackout."
                        },
                        {
                            "example":{
                                "href":"/em/api/blackouts/D91786E288DFSE2323ADA1B329B49BB5/targets"
                            }
                        }
                    ]
                }
            }
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/Schedule"
        }
    ]
}

Match All

Show Source

• object Schedule
  Schedule details

{
    "x-em-sdk-level":"emSDK",
    "description":"This is a blackout description.",
    "type":"object",
    "required":[
        "id",
        "name",
        "type",
        "status",
        "owner",
        "links"
    ],
    "properties":{
        "id":{
            "type":"string",
            "description":"Blackout ID",
            "example":"D91786E288D35455C3ADA1B329B49BB5"
        },
        "name":{
            "type":"string",
            "description":"Blackout Name",
            "example":"my_blackout"
        },
        "type":{
            "$ref":"#/components/schemas/BlackoutType"
        },
        "owner":{
            "type":"string",
            "description":"Owner of the blackout",
            "example":"scott"
        },
        "reason":{
            "type":"string",
            "description":"Blackout reason",
            "example":"Host patching"
        },
        "description":{
            "type":"string",
            "description":"Blackout related comments.",
            "example":"A regular maintenance scheduled blackouts for oemrep database"
        },
        "agent":{
            "type":"string",
            "description":"Name of the agent starting the blackout.",
            "example":"hostName:1838"
        },
        "status":{
            "$ref":"#/components/schemas/BlackoutStatus"
        },
        "isAllowJobs":{
            "type":"boolean",
            "description":"Indicates if job executions on targets are allowed during blackout.",
            "default":false
        },
        "isFullBlackoutOnHost":{
            "type":"boolean",
            "description":"Indicates if all targets on hosts in the blackout are blacked out too.",
            "default":false
        },
        "excludeTypes":{
            "type":"array",
            "description":"List of indirect blackout member type names which should be excluded from blackout.",
            "items":{
                "type":"string"
            }
        },
        "excludeTargets":{
            "type":"array",
            "description":"List of indirect blackout members which should be excluded from blackout.",
            "items":{
                "$ref":"#/components/schemas/TargetIdentifier"
            }
        },
        "creationTimeToStart":{
            "type":"string",
            "description":"The timeToStart given at blackout creation time."
        },
        "creationTimeToEnd":{
            "type":"string",
            "description":"The timeToEnd given at blackout creation time."
        },
        "links":{
            "type":"object",
            "description":"Blackout related links.",
            "properties":{
                "self":{
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        },
                        {
                            "description":"Link to the blackout."
                        },
                        {
                            "example":{
                                "href":"/em/api/blackouts/D91786E288D35455C3ADA1B329B49BB5"
                            }
                        }
                    ]
                },
                "targets":{
                    "allOf":[
                        {
                            "$ref":"#/components/schemas/Link"
                        },
                        {
                            "description":"Link to the targets under blackout."
                        },
                        {
                            "example":{
                                "href":"/em/api/blackouts/D91786E288DFSE2323ADA1B329B49BB5/targets"
                            }
                        }
                    ]
                }
            }
        }
    },
    "allOf":[
        {
            "$ref":"#/components/schemas/Schedule"
        }
    ]
}

Nested Schema : excludeTargets

Type: array

List of indirect blackout members which should be excluded from blackout.

Show Source

• Array of: object TargetIdentifier
  Identifies a target either by name and typeName or by id.

{
    "type":"array",
    "description":"List of indirect blackout members which should be excluded from blackout.",
    "items":{
        "$ref":"#/components/schemas/TargetIdentifier"
    }
}

Nested Schema : excludeTypes

Type: array

List of indirect blackout member type names which should be excluded from blackout.

Show Source

• Array of: string

{
    "type":"array",
    "description":"List of indirect blackout member type names which should be excluded from blackout.",
    "items":{
        "type":"string"
    }
}

Nested Schema : links

Type: object

Blackout related links.

Show Source

• self: self
• targets: targets

{
    "type":"object",
    "description":"Blackout related links.",
    "properties":{
        "self":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Link"
                },
                {
                    "description":"Link to the blackout."
                },
                {
                    "example":{
                        "href":"/em/api/blackouts/D91786E288D35455C3ADA1B329B49BB5"
                    }
                }
            ]
        },
        "targets":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Link"
                },
                {
                    "description":"Link to the targets under blackout."
                },
                {
                    "example":{
                        "href":"/em/api/blackouts/D91786E288DFSE2323ADA1B329B49BB5/targets"
                    }
                }
            ]
        }
    }
}

Nested Schema : Schedule

Type: object

Schedule details

Show Source

• isTargetZone: boolean
  To indicate if the time should be interpreted in the target timezone or not. If timezone is specified in time and isTargetZone is true, it will be reported as an ERROR condition
• recurring: string
  Frequency at which the operation must be executed repeatedly

  Example: frequency:weekly;days:2,
• scheduleType: string
  Currently we support ICAL specification default is ICAL, in the future it can be extended to other types e.g CRON.
• startGracePeriodInMinutes: integer
  Time in minutes after which the job will be marked as skipped if not started. Null or Negative value means no grace period.

  Example: 60
• timeToEnd: string (date-time)
  End time
• timeToStart: string (date-time)
  Start time

{
    "description":"Schedule details",
    "type":"object",
    "properties":{
        "timeToStart":{
            "type":"string",
            "description":"Start time",
            "format":"date-time"
        },
        "timeToEnd":{
            "type":"string",
            "description":"End time",
            "format":"date-time"
        },
        "isTargetZone":{
            "type":"boolean",
            "description":"To indicate if the time should be interpreted in the target timezone or not. If timezone is specified in time and isTargetZone is true, it will be reported as an ERROR condition"
        },
        "scheduleType":{
            "type":"string",
            "description":"Currently we support ICAL specification default is ICAL, in the future it can be extended to other types e.g CRON."
        },
        "recurring":{
            "type":"string",
            "description":"Frequency at which the operation must be executed repeatedly",
            "example":"frequency:weekly;days:2,"
        },
        "startGracePeriodInMinutes":{
            "type":"integer",
            "description":"Time in minutes after which the job will be marked as skipped if not started. Null or Negative value means no grace period.",
            "example":"60"
        }
    }
}

Nested Schema : TargetIdentifier

Type: object

Identifies a target either by name and typeName or by id.

Show Source

• id: string
  Target ID
• name: string
  Target Name
• typeName: string
  Target Type Name

{
    "type":"object",
    "description":"Identifies a target either by name and typeName or by id.",
    "properties":{
        "id":{
            "type":"string",
            "description":"Target ID"
        },
        "name":{
            "type":"string",
            "description":"Target Name"
        },
        "typeName":{
            "type":"string",
            "description":"Target Type Name"
        }
    }
}

Nested Schema : self

Match All

Show Source

• object Link
  Represents a link(could be self, previous or next)
• Link to the blackout.
• Example: { "href":"/em/api/blackouts/D91786E288D35455C3ADA1B329B49BB5" }

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Link"
        },
        {
            "description":"Link to the blackout."
        },
        {
            "example":{
                "href":"/em/api/blackouts/D91786E288D35455C3ADA1B329B49BB5"
            }
        }
    ]
}

Nested Schema : targets

Match All

Show Source

• object Link
  Represents a link(could be self, previous or next)
• Link to the targets under blackout.
• Example: { "href":"/em/api/blackouts/D91786E288DFSE2323ADA1B329B49BB5/targets" }

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Link"
        },
        {
            "description":"Link to the targets under blackout."
        },
        {
            "example":{
                "href":"/em/api/blackouts/D91786E288DFSE2323ADA1B329B49BB5/targets"
            }
        }
    ]
}

Nested Schema : Link

Type: object

Represents a link(could be self, previous or next)

Show Source

• href: string
  URL for Link

  Example: /em/api/<resources>?page=b2Zmc2V0OjA&limit=0

{
    "type":"object",
    "description":"Represents a link(could be self, previous or next)",
    "properties":{
        "href":{
            "type":"string",
            "description":"URL for Link",
            "example":"/em/api/<resources>?page=b2Zmc2V0OjA&limit=0"
        }
    }
}

Examples

Select an example Example blackout response

400 Response

Error while processing the request. See the response message for the reason.

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

client is not authenticated

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

target not found or not authorized

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 error serving 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"
        }
    }
}

503 Response

indicates that a required service is not available.

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