Create a bulk extract

post

/services/rest/connect/v1.4/bulkExtracts

Request

Body ()
The parameters of the bulk extract job.
Root Schema : bulkExtracts
Type: object
The parameters of the bulk extract job.
Show Source
  • Maximum Length: 256
    Pattern: ^Incident$
    The object type to be extracted.
  • bulkExtracts-columns
    The list item that describes an object property to extract.
  • The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
  • The date and time when the bulk extract job was created. This attribute is read-only.
  • bulkExtracts-filters
    The list item that describes a criterion for filtering the extract results.
  • Minimum Value: 1
    Maximum Value: 9223372036854776000
    The unique identifier of the bulk extract job.
  • Maximum Length: 255
    The name used to look up the bulk extract job.
  • Maximum Length: 80
    Pattern: ^[^ ]*$
    The name used to describe the bulk extract job.
  • namedIDs-bulkExtracts-state
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • namedIDs-bulkExtracts-type
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
  • The date and time when the bulk extract job was last updated. This attribute is read-only.
  • Maximum Length: 80
    The version of the object data being extracted. It is represented in the string format as v1.x, where x is greater than or equal to 4. For example, v1.4.
Nested Schema : bulkExtracts-columns
Type: object
The list item that describes an object property to extract.
Show Source
  • Minimum Value: 1
    Maximum Value: 2147483647
    The order in which specified columns should appear in the SQL select clause.
  • Maximum Length: 349525
    The property name of the list item.
Nested Schema : bulkExtracts-filters
Type: object
The list item that describes a criterion for filtering the extract results.
Show Source
Nested Schema : namedIDs-bulkExtracts-state
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-bulkExtracts-type
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-bulkExtracts-filters-filterOperator
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Back to Top

Response

Default Response

Body ()
Root Schema : bulkExtracts
Type: object
The parameters of the bulk extract job.
Show Source
  • Maximum Length: 256
    Pattern: ^Incident$
    The object type to be extracted.
  • bulkExtracts-columns
    The list item that describes an object property to extract.
  • The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
  • The date and time when the bulk extract job was created. This attribute is read-only.
  • bulkExtracts-filters
    The list item that describes a criterion for filtering the extract results.
  • Minimum Value: 1
    Maximum Value: 9223372036854776000
    The unique identifier of the bulk extract job.
  • Maximum Length: 255
    The name used to look up the bulk extract job.
  • Maximum Length: 80
    Pattern: ^[^ ]*$
    The name used to describe the bulk extract job.
  • namedIDs-bulkExtracts-state
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • namedIDs-bulkExtracts-type
    An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
  • The account represents a staff member in Oracle B2C Service. Examples of staff members are customer sales representatives, sales agents, site administrators, and so on. It is the reference to a resource in 'accounts' collection. Only ID or lookupName can be provided to specify the resource.
  • The date and time when the bulk extract job was last updated. This attribute is read-only.
  • Maximum Length: 80
    The version of the object data being extracted. It is represented in the string format as v1.x, where x is greater than or equal to 4. For example, v1.4.
Nested Schema : bulkExtracts-columns
Type: object
The list item that describes an object property to extract.
Show Source
  • Minimum Value: 1
    Maximum Value: 2147483647
    The order in which specified columns should appear in the SQL select clause.
  • Maximum Length: 349525
    The property name of the list item.
Nested Schema : bulkExtracts-filters
Type: object
The list item that describes a criterion for filtering the extract results.
Show Source
Nested Schema : namedIDs-bulkExtracts-state
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-bulkExtracts-type
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Nested Schema : namedIDs-bulkExtracts-filters-filterOperator
Type: object
An ID which has an associated name string. These IDs can be set by either value or name. If the name cannot uniquely determine the value, an error is generated.
Show Source
Back to Top

Examples

Use POST with the following syntax to create a new bulkExtract object:

https://your_site_interface/services/rest/connect/version/bulkExtracts

Request URI example:

https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts

Request body example

{
 "class": "Incident",
 "name": "ExtractExample",
 "state": {
   "lookupName":"Run"
   },
 "version": "v1.4",
 "filters": [
  {
      "leftOperand": "CreatedTime",
      "filterOperator": {
          "lookupName": ">"
        },
      "rightOperand": "'2018-05-01T00:00:00.000Z'"
  }
    ]
}

Response body example

{
    "id": 1,
    "lookupName": "ExtractExample",
    "createdTime": "2019-01-14T17:27:31.000Z",
    "updatedTime": "2019-01-14T17:27:31.000Z",
    "class": "Incident",
    "columns": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1/columns"
            },
            {
                "rel": "full",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1/columns/{column_id}",
                "templated": true
            }
        ]
    },
    "createdByAccount": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/2"
            },
            {
                "rel": "canonical",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/2"
            },
            {
                "rel": "describedby",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/accounts",
                "mediaType": "application/schema+json"
            }
        ]
    },
    "filters": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1/filters"
            },
            {
                "rel": "full",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1/filters/{filter_id}",
                "templated": true
            }
        ]
    },
    "name": "ExtractExample",
    "state": {
        "id": 1,
        "lookupName": "Run"
    },
    "type": {
        "id": 1,
        "lookupName": "Single"
    },
    "updatedByAccount": {
        "links": [
            {
                "rel": "self",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/2"
            },
            {
                "rel": "canonical",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/accounts/2"
            },
            {
                "rel": "describedby",
                "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/accounts",
                "mediaType": "application/schema+json"
            }
        ]
    },
    "version": "v1.4",
    "links": [
        {
            "rel": "self",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1"
        },
        {
            "rel": "canonical",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/bulkExtracts/1"
        },
        {
            "rel": "describedby",
            "href": "https://mysite.example.com/services/rest/connect/v1.4/metadata-catalog/bulkExtracts",
            "mediaType": "application/schema+json"
        }
    ]
}
Back to Top