Application Data - Create Cascade Delete Job

  • Reference
Service:
Azure Data Manager for Agriculture
API Version:
2023-11-01-preview

Create cascade delete job for application data resource.

PUT {endpoint}/application-data/cascade-delete/{jobId}?partyId={partyId}&applicationDataId={applicationDataId}&api-version=2023-11-01-preview

URI Parameters

Name In Required Type Description
endpoint
 path True

string

uri

The host name of the namespace, e.g. admaInstanceName.farmbeats.azure.net
jobId
 path True

string

Job Id supplied by end user.
api-version
 query True

string

The requested API version
applicationDataId
 query True

string

Id of the application data.
partyId
 query True

string

Id of the party.

Request Header

Name Required Type Description
Authorization True

string

Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.

Responses

Name Type Description
202 Accepted

CascadeDeleteJob

Accepted
Other Status Codes

ErrorResponse

Error

Headers

x-ms-error-code: string

Security

Authorization

Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.

Type: apiKey
In: header

Examples

ApplicationData_CreateCascadeDeleteJob

Sample request

PUT {endpoint}/application-data/cascade-delete/JOB123?partyId=PARTY123&applicationDataId=ApplicationData123&api-version=2023-11-01-preview

Sample response

Status code:
202 
{
  "id": "JOB123",
  "status": "Waiting",
  "message": "Created cascade delete job for 'farmoperationapplicationdata' resource with id 'ApplicationData123' and partyId 'PARTY123'.",
  "createdDateTime": "2021-04-19T11:31:20Z",
  "lastActionDateTime": "2021-04-19T11:31:34Z",
  "startTime": "2021-04-19T11:31:19Z",
  "partyId": "PARTY123",
  "resourceId": "ApplicationData123",
  "resourceType": "farmoperationapplicationdata"
}

Definitions

Name Description
CascadeDeleteJob

Schema of cascade delete job.
Error

An error from the Azure AgPlatform service.
ErrorResponse

An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.
InnerError

Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
JobStatus

Status of the job. Possible values: 'Waiting', 'Running', 'Succeeded', 'Failed', 'Cancelled'.

CascadeDeleteJob

Schema of cascade delete job.

Name Type Description
createdDateTime

string

Job created at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
durationInSeconds

number

Duration of the job in seconds.
endTime

string

Job end time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
errorCode

string

Error Code when job failed.
id

string

Unique job id.
lastActionDateTime

string

Job was last acted upon at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
message

string

Status message to capture more details of the job.
partyId

string

Party Id.
resourceId

string

The id of the resource.
resourceType

string

The type of the resource.
startTime

string

Job start time when available. Sample format: yyyy-MM-ddTHH:mm:ssZ.
status

JobStatus

Status of the job. Possible values: 'Waiting', 'Running', 'Succeeded', 'Failed', 'Cancelled'.

Error

An error from the Azure AgPlatform service.

Name Type Description
code

string

Server-defined set of error codes.
details

Error[]

Array of details about specific errors that led to this reported error.
innererror

InnerError

Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
message

string

Human-readable representation of the error.
target

string

Target of the error.

ErrorResponse

An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.

Name Type Description
error

Error

An error from the Azure AgPlatform service.
traceId

string

Unique trace Id.

InnerError

Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.

Name Type Description
code

string

Specific error code than was provided by the containing error.
innererror

InnerError

Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.

JobStatus

Status of the job. Possible values: 'Waiting', 'Running', 'Succeeded', 'Failed', 'Cancelled'.

Name Type Description
Cancelled

string

Failed

string

Running

string

Succeeded

string

Waiting

string