Jump to

• Request
• Response
• Examples

Clone an Integration

post

/ic/api/integration/v1/integrations/{id}/clone

Creates a new copy of an integration with identical connections and data mappings. The request body must contain at least the code, version, and name fields.

Request

Path Parameters

• id(required): string
  Integration composite identifier. The ID consists of the code and the version separated by the | (vertical line) character. Format: code%7Cversion. Example: SC2RN%7C01.00.0000. When using cURL, substitute the %7C code for the vertical line.

Query Parameters

• integrationInstance(required): string
  This is the name of the service instance. You can get this value from the About page where it is specified in the Service instance field.

Supported Media Types

• application/json

Request Body - application/json ()

Root Schema : schema

Type: object

Show Source

• code(required): string
  Integration Code
• description: string
  Integration Description
• keywords: string
  Keywords
• name(required): string
  Integration Name
• packageName: string
  Integration Description
• version(required): string
  Integration Version

{
    "required":[
        "code",
        "name",
        "version"
    ],
    "type":"object",
    "properties":{
        "code":{
            "required":[
                "true"
            ],
            "type":"string",
            "description":"Integration Code"
        },
        "description":{
            "type":"string",
            "description":"Integration Description"
        },
        "keywords":{
            "type":"string",
            "description":"Keywords"
        },
        "name":{
            "required":[
                "true"
            ],
            "type":"string",
            "description":"Integration Name"
        },
        "packageName":{
            "type":"string",
            "description":"Integration Description"
        },
        "version":{
            "required":[
                "true"
            ],
            "type":"string",
            "description":"Integration Version"
        }
    }
}

Back to Top

Response

200 Response

Successful operation

400 Response

Bad request, missing required data

404 Response

Integration not found

500 Response

Server error

Back to Top

Examples

The following example shows how to clone an integration by submitting a POST request on the REST resource using cURL. For more information about cURL, see Use cURL. For more information about endpoint URL structure, see Send Requests.

Example: Clone the Integration with the Specified ID

Request:

The id is in the form: code%7Cversion. The %7C is the encoded | (vertical line).

curl -X POST -H 'Authorization: Bearer access_token' -H "Content-Type:application/json" -d @integration.json https://design.integration.region.ocp.oraclecloud.com/ic/api/integration/v1/integrations/HELLO_WORLD%7C01.02.0000/clone?integrationInstance=service-instance

Request Body:

The following example shows the contents of the request body in JSON format. This is the contents of the integration.json file listed in the cURL command. The file must contain three attributes: name, code, and version. The description attribute is optional.

{"code":"CLONEDINTEGRATION","version":"01.00.0000","name":"ClonedIntegration","description":"The description of the cloned integration"}

Back to Top