Jump to

• Request
• Response
• Examples

Start a Recovery Operation

post

/paas/service/dbcs/api/v1.1/instances/{identityDomainId}/{serviceId}/backups/recovery

Starts a recovery operation on an Exadata Cloud Service database deployment using the latest backup or to a point in time specified by a backup tag, timestamp, or SCN (System Change Number).

Request

Supported Media Types

• application/json

Path Parameters

• identityDomainId: string

  The value depends on the type of Exadata Cloud Service account that is used to make the request:

  • For a Traditional Cloud Account, specify the Identity Domain Name that is associated with the service.

  • For a Cloud Account with Identity Cloud Service, specify the Identity Service Id that is associated with the service, which has the format idcs-letters-and-numbers.

• serviceId: string
  Name of the Exadata Cloud Service database deployment.

Header Parameters

• Authorization: string
  Base64 encoding of the user name and password of the user making the request. For more information, see Security, Authentication and Authorization.
• X-ID-TENANT-NAME: string

  The value depends on the type of Exadata Cloud Service account that is used to make the request:

  • For a Traditional Cloud Account, specify the Identity Domain Name that is associated with the service.

  • For a Cloud Account with Identity Cloud Service, specify the Identity Service Id that is associated with the service, which has the format idcs-letters-and-numbers.

  For more information, see Security, Authentication and Authorization.

Body ()

Root Schema : Request Body

Type: object

Title: Request Body

Show Source

• latest(optional): string
  Recover using the latest available backup.
• scn(optional): string
  Recover using a System Change Number.
• tag(optional): string
  Recover using a database tag.
• timestamp(optional): string
  Recover using a timestamp. The timestamp must be of the format dd-MMM-yyyy HH:mm:ss.

{
    "title":"Request Body",
    "type":"object",
    "description":"",
    "properties":{
        "latest":{
            "type":"string",
            "description":"Recover using the latest available backup."
        },
        "scn":{
            "type":"string",
            "description":"Recover using a System Change Number."
        },
        "tag":{
            "type":"string",
            "description":"Recover using a database tag."
        },
        "timestamp":{
            "type":"string",
            "description":"Recover using a timestamp. The timestamp must be of the format <code>dd-MMM-yyyy HH:mm:ss</code>."
        }
    }
}

Back to Top

Response

202 Response

Accepted. See Status Codes for information about other possible HTTP status codes.

Headers

• Location: string
  A REST URI you can use to check the progress and completion of the recovery operation, as described in View the Job Status of an Operation.

Back to Top

Examples

The following example shows how to start a recovery operation by submitting a POST request on the REST endpoint using cURL.

In this example, the identity domain is usexample and the Oracle Cloud user name and password are serviceadmin and Pa55_word. The name of the Exadata Cloud Service database deployment being acted on is db12c, and recovery is performed using the latest available backup.

cURL Command

In the following cURL command, the request body is provided directly in the -d option.

curl -i -X POST --cacert ~/cacert.pem -u serviceadmin:Pa55_word -H "X-ID-TENANT-NAME:usexample" -H "Content-Type:application/json" -d '{ "latest" : "yes" }' https://dbaas.oraclecloud.com/paas/service/dbcs/api/v1.1/instances/usexample/db12c/backups/recovery

HTTP Status Code and Response Headers

HTTP/2.0 202
server: Oracle-Application-Server-11g
strict-transport-security: max-age=31536000;includeSubDomains
location: https://dbaas.oraclecloud.com/paas/service/dbcs/api/v1.1/instances/usexample/status/recovery/job/12223487
content-language: en
access-control-allow-origin: *
access-control-allow-headers: Content-Type, api_key, Authorization, X-ID-TENANT-NAME, X-USER-IDENTITY-DOMAIN-NAME
retry-after: 60
access-control-allow-methods: GET, POST, DELETE, PUT, OPTIONS, HEAD
x-oracle-dms-ecid: 005KB8LknV76uHFpR0H7id00067c0002l9
x-oracle-dms-ecid: 005KB8LknV76uHFpR0H7id00067c0002l9
service-uri: https://dbaas.oraclecloud.com:443/paas/service/dbcs/api/v1.1/instances/usexample/db12c
x-frame-options: DENY
content-type: application/json
vary: user-agent
date: Mon, 29 May 2017 23:31:23 GMT

Back to Top