Jump to

• Request
• Response

Get Connection Shapes

get

/rpa/v1/connectionShapes

Returns a list of all Connection Shapes for a service instance.

Request

Query Parameters

• displayName: string
  Minimum Length: 1

  Maximum Length: 50

  A filter to return only resources that match the entire display name given.
• lifecycleState: string
  A filter that returns all resources that match the specified lifecycle state.
• limit: integer
  Minimum Value: 1

  Maximum Value: 100

  The maximum number of items to return.

  Default Value: 100
• page: string
  Minimum Length: 1

  A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
• projectId(required): string
  Project identifier
• q: string
  A filter to search resources by name, identifier, or description. The search query can be a simple string or a JSON object with operators and criteria. Example JSON format: { "operator": "AND", "criteria": [ {"name": "example"}, {"version": "1.0"} ] }
• sortBy: string
  The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is default.

  Default Value: TIME_CREATED

  Allowed Values: [ "TIME_CREATED", "DISPLAY_NAME" ]
• sortOrder: string
  The sort order to use, either 'ASC' or 'DESC'.

  Allowed Values: [ "ASC", "DESC" ]

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

A page of Connection Shape Summary objects.

Headers

• opc-next-page:
  For pagination of a list of items. When paging through a list, if this header appears in the response, then a partial list might have been returned. Include this value as the `page` parameter for the subsequent GET request to get the next batch of items.
• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : ConnectionShapeCollection

Type: object

Results of a connection list operation. Contains ConnectionShapeSummary items.

Show Source

• items(required): array items
  List of ConnectionShape Summary objects.

{
    "type":"object",
    "description":"Results of a connection list operation. Contains ConnectionShapeSummary items.",
    "required":[
        "items"
    ],
    "properties":{
        "items":{
            "description":"List of ConnectionShape Summary objects.",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/ConnectionShapeSummary"
            }
        }
    }
}

Nested Schema : items

Type: array

List of ConnectionShape Summary objects.

Show Source

• Array of: object ConnectionShapeSummary
  Summary of the ConnectionShape.

{
    "description":"List of ConnectionShape Summary objects.",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/ConnectionShapeSummary"
    }
}

Nested Schema : ConnectionShapeSummary

Type: object

Summary of the ConnectionShape.

Show Source

• createdBy: string
  Created By
• description: string
  ConnectionShape description
• displayName(required): string
  ConnectionShape name
• identifier(required): string
  ConnectionShape identifier
• keywords: string
  ConnectionShape keywords
• lifecycleState(required): string
  The current state of the ConnectionShape.
• schema(required): string
  The Schema refers to the JSON to which the Connection's content will adhere.
• timeCreated: string (date-time)
  The time the ConnectionShape was created. An RFC3339 formatted datetime string.
• timeUpdated: string (date-time)
  The time the ConnectionShape was last updated. An RFC3339 formatted datetime string
• updatedBy: string
  Updated By.

{
    "description":"Summary of the ConnectionShape.",
    "type":"object",
    "required":[
        "displayName",
        "identifier",
        "schema",
        "lifecycleState"
    ],
    "properties":{
        "displayName":{
            "description":"ConnectionShape name",
            "type":"string"
        },
        "identifier":{
            "description":"ConnectionShape identifier",
            "type":"string"
        },
        "keywords":{
            "description":"ConnectionShape keywords",
            "type":"string"
        },
        "description":{
            "description":"ConnectionShape description",
            "type":"string"
        },
        "schema":{
            "description":"The Schema refers to the JSON to which the Connection's content will adhere.",
            "type":"string"
        },
        "timeCreated":{
            "description":"The time the ConnectionShape was created. An RFC3339 formatted datetime string.",
            "type":"string",
            "format":"date-time"
        },
        "timeUpdated":{
            "description":"The time the ConnectionShape was last updated. An RFC3339 formatted datetime string",
            "type":"string",
            "format":"date-time"
        },
        "updatedBy":{
            "description":"Updated By.",
            "type":"string"
        },
        "createdBy":{
            "description":"Created By",
            "type":"string"
        },
        "lifecycleState":{
            "description":"The current state of the ConnectionShape.",
            "type":"string",
            "x-obmcs-enumref":"#/definitions/ConnectionShape/lifecycleState"
        }
    }
}

400 Response

Bad Request

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

401 Response

Unauthorized

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

404 Response

Not Found

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

429 Response

Too Many Requests

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

500 Response

Internal Server Error

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

Default Response

Unknown Error

Headers

• opc-request-id:
  Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.

Body ()

Root Schema : Error

Type: object

Show Source

• category: string
• code: string
• location: string
• summary: string

{
    "type":"object",
    "properties":{
        "code":{
            "type":"string"
        },
        "category":{
            "type":"string"
        },
        "summary":{
            "type":"string"
        },
        "location":{
            "type":"string"
        }
    }
}

Back to Top