Jump to

• Request
• Response

Subscribe Targets to an Image

post

https://EM_HOST:EM_CONSOLE_HTTPS_PORT/em/api/goldImages/{goldImageId}/actions/subscribeTargets

Subscribes targets to an image. Targets can be of the same release (for patching purposes) or can be of a lower release from which a direct upgrade path is available.

Request

Path Parameters

• goldImageId(required): string
  ID of the image

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Match All

Show Source

• object allOf SubscribeTargetsDetails
  Details of subscription of targets

{
    "type":"object",
    "required":[
        "targetList",
        "targetType"
    ],
    "allOf":[
        {
            "$ref":"#/components/schemas/SubscribeTargetsDetails"
        }
    ]
}

Nested Schema : SubscribeTargetsDetails

Type: object

Details of subscription of targets

Match All

Show Source

• object TargetList
  List of targets
• object SubscribeTargetCommonDetails
  Common details for subscription of a target to the image

{
    "description":"Details of subscription of targets",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/TargetList"
        },
        {
            "$ref":"#/components/schemas/SubscribeTargetCommonDetails"
        }
    ]
}

Nested Schema : TargetList

Type: object

List of targets

Show Source

• targetList: array targetList
  Array of target names
• targetType: string
  Target type

  Example: oracle_database

{
    "description":"List of targets",
    "type":"object",
    "properties":{
        "targetList":{
            "description":"Array of target names",
            "type":"array",
            "items":{
                "type":"string",
                "example":"db1, db2"
            }
        },
        "targetType":{
            "description":"Target type",
            "type":"string",
            "example":"oracle_database"
        }
    }
}

Nested Schema : SubscribeTargetCommonDetails

Type: object

Common details for subscription of a target to the image

Show Source

• isGimr: boolean
  GIMR Flag
• isNoCascade: boolean
  Default Value: false

  Flag to indicate the subscription of PDBs in a CDB
• isStandbyAutoSubscribe: boolean
  Default Value: true

  Flag to indicate the auto subscription of a standby database

{
    "description":"Common details for subscription of a target to the image",
    "type":"object",
    "properties":{
        "isStandbyAutoSubscribe":{
            "description":"Flag to indicate the auto subscription of a standby database",
            "type":"boolean",
            "default":true
        },
        "isNoCascade":{
            "description":"Flag to indicate the subscription of PDBs in a CDB",
            "type":"boolean",
            "default":false
        },
        "isGimr":{
            "description":"GIMR Flag",
            "type":"boolean"
        }
    }
}

Nested Schema : targetList

Type: array

Array of target names

Show Source

• Array of: string
  Example: db1, db2

{
    "description":"Array of target names",
    "type":"array",
    "items":{
        "type":"string",
        "example":"db1, db2"
    }
}

Examples

Select an example Payload

Back to Top

Response

Supported Media Types

• application/json

200 Response

Ok. Targets subscribed.

Body ()

Root Schema : schema

Type: object

Match All

Show Source

• object allOf GoldImageSubscribeTargets
  Targets subscription response

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/GoldImageSubscribeTargets"
        }
    ]
}

Nested Schema : GoldImageSubscribeTargets

Type: object

Targets subscription response

Match All

Show Source

• object GoldImageTargetsSubscriptionSummary
  Targets subscription details

{
    "description":"Targets subscription response",
    "type":"object",
    "allOf":[
        {
            "$ref":"#/components/schemas/GoldImageTargetsSubscriptionSummary"
        }
    ]
}

Nested Schema : GoldImageTargetsSubscriptionSummary

Type: object

Targets subscription details

Show Source

• failed: integer
  Count of Failed targets
• items: array items
  List of subscription summary
• successful: integer
  Count of Successful targets
• total: integer
  Count of Total targets

{
    "description":"Targets subscription details",
    "type":"object",
    "properties":{
        "failed":{
            "description":"Count of Failed targets",
            "type":"integer"
        },
        "successful":{
            "description":"Count of Successful targets",
            "type":"integer"
        },
        "total":{
            "description":"Count of Total targets",
            "type":"integer"
        },
        "items":{
            "description":"List of subscription summary",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/SubscriptionSummary"
            }
        }
    }
}

Nested Schema : items

Type: array

List of subscription summary

Show Source

• Array of: object SubscriptionSummary
  Target subscription summary

{
    "description":"List of subscription summary",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/SubscriptionSummary"
    }
}

Nested Schema : SubscriptionSummary

Type: object

Target subscription summary

Show Source

• code: integer
  HTTP status code
• message: string
  Message of subscription
• targetId: string
  ID of the target

  Example: 01DB50F6963F0E39C72F8651DCC93A6A
• targetName: string
  Name of the target

  Example: sales_db1
• targetType: string
  Target type

  Example: oracle_database

{
    "description":"Target subscription summary",
    "type":"object",
    "properties":{
        "code":{
            "description":"HTTP status code",
            "type":"integer"
        },
        "targetId":{
            "description":"ID of the target",
            "type":"string",
            "example":"01DB50F6963F0E39C72F8651DCC93A6A"
        },
        "targetName":{
            "description":"Name of the target",
            "type":"string",
            "example":"sales_db1"
        },
        "targetType":{
            "description":"Target type",
            "type":"string",
            "example":"oracle_database"
        },
        "message":{
            "description":"Message of subscription",
            "type":"string"
        }
    }
}

Examples

Select an example Payload

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