Plant Tissue Analyses - Create Cascade Delete Job

Service:: Azure Data Manager for Agriculture

API Version:: 2023-11-01-preview

Create a cascade delete job for specified plant tissue analysis.

PUT {endpoint}/plant-tissue-analyses/cascade-delete/{jobId}?partyId={partyId}&plantTissueAnalysisId={plantTissueAnalysisId}&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
partyId	query	True	string	ID of the associated party.
plantTissueAnalysisId	query	True	string	ID of the plant tissue analysis to be deleted.

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

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

PlantTissueAnalyses_CreateCascadeDeleteJob

Sample request

HTTP

PUT {endpoint}/plant-tissue-analyses/cascade-delete/JOB123?partyId=PARTY123&plantTissueAnalysisId=PlantTissueAnalysis123&api-version=2023-11-01-preview

Sample response

Status code:: 202

{
  "id": "JOB123",
  "status": "Waiting",
  "message": "Created cascade delete job for 'planttissueanalysis' resource with id 'PlantTissueAnalysis123' and partyId 'PARTY123'.",
  "createdDateTime": "2021-07-19T11:31:20Z",
  "lastActionDateTime": "2021-07-19T11:31:34Z",
  "startTime": "2021-07-19T11:31:19Z",
  "partyId": "PARTY123",
  "resourceId": "PlantTissueAnalysis123",
  "resourceType": "planttissueanalysis"
}

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

Object

Schema of cascade delete job.

Name	Type	Description
createdDateTime	string (date-time)	Job created at dateTime. Sample format: yyyy-MM-ddTHH:mm:ssZ.
durationInSeconds	number (double)	Duration of the job in seconds.
endTime	string (date-time)	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 (date-time)	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 minLength: 1	Party Id.
resourceId	string minLength: 1	The id of the resource.
resourceType	string minLength: 1	The type of the resource.
startTime	string (date-time)	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

Object

An error from the Azure AgPlatform service.

Name	Type	Description
code	string minLength: 1	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 minLength: 1	Human-readable representation of the error.
target	string	Target of the error.

ErrorResponse

Object

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

Object

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

Enumeration

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

Value	Description
Waiting
Running
Succeeded
Failed
Cancelled