Jump to

• Request
• Response

Register a target database group for Data Safe onboarding

post

https://EM_HOST:8080/em/api/databases/dataSafeOnboardings/actions/registerTargetDatabaseGroup

Submits the Data Safe registration procedure for the provided EM group and OCI settings.

Request

There are no request parameters for this operation.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Request payload for Data Safe registration inputs.

Show Source

• dataSafeConnectorId(required): string
  OCID of the Data Safe on-prem connector.
• dbSysNamedCredentialName: string
  Optional named credential for SYSDBA access.
• dbTargetGroupName(required): string
  EM database group name to onboard.
• ociCompartmentId(required): string
  OCI compartment OCID for Data Safe resources.
• ociCredentialName(required): string
  EM credential name for OCI authentication.
• region(required): string
  OCI region identifier.

{
    "description":"Request payload for Data Safe registration inputs.",
    "type":"object",
    "required":[
        "dbTargetGroupName",
        "dataSafeConnectorId",
        "ociCredentialName",
        "ociCompartmentId",
        "region"
    ],
    "properties":{
        "dbTargetGroupName":{
            "type":"string",
            "description":"EM database group name to onboard."
        },
        "dataSafeConnectorId":{
            "type":"string",
            "description":"OCID of the Data Safe on-prem connector."
        },
        "ociCredentialName":{
            "type":"string",
            "description":"EM credential name for OCI authentication."
        },
        "ociCompartmentId":{
            "type":"string",
            "description":"OCI compartment OCID for Data Safe resources."
        },
        "region":{
            "type":"string",
            "description":"OCI region identifier."
        },
        "dbSysNamedCredentialName":{
            "type":"string",
            "description":"Optional named credential for SYSDBA access."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

202 Response

Registration procedure submitted successfully.

Headers

• Location:
  URL to poll for the submitted Data Safe onboarding status.

Body ()

Root Schema : DataSafeOnboardingSubmission

Type: object

Response returned after the Data Safe registration procedure is submitted.

Show Source

• message(required): string
  Human-readable submission result.
• procedureName(required): string
  Submitted procedure name.
• submissionId(required): string
  Procedure submission identifier returned by Enterprise Manager.
• timeSubmitted(required): string (date-time)
  Submission timestamp.

{
    "description":"Response returned after the Data Safe registration procedure is submitted.",
    "type":"object",
    "required":[
        "message",
        "procedureName",
        "submissionId",
        "timeSubmitted"
    ],
    "properties":{
        "message":{
            "type":"string",
            "description":"Human-readable submission result."
        },
        "procedureName":{
            "type":"string",
            "description":"Submitted procedure name."
        },
        "submissionId":{
            "type":"string",
            "description":"Procedure submission identifier returned by Enterprise Manager."
        },
        "timeSubmitted":{
            "type":"string",
            "format":"date-time",
            "description":"Submission timestamp."
        }
    }
}

400 Response

Bad Request.

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

401 Response

Unauthorized.

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

403 Response

Forbidden.

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

409 Response

Conflict.

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

500 Response

Internal Server Error.

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

503 Response

Service Unavailable

Headers

• ORCL-EM-RETRY-LINK:
  Link of the request that failed.

Body ()

Root Schema : ErrorResponse

Type: object

Response sent in the case of an error.

Show Source

• code(required): string
  Error code.

  Example: InvalidParameter
• message(required): string
  Error description.

  Example: Parameter cannot be empty

{
    "description":"Response sent in the case of an error.",
    "type":"object",
    "required":[
        "code",
        "message"
    ],
    "properties":{
        "code":{
            "type":"string",
            "description":"Error code.",
            "example":"InvalidParameter"
        },
        "message":{
            "type":"string",
            "description":"Error description.",
            "example":"Parameter cannot be empty"
        }
    }
}

Back to Top