- URL:
- https://<featureservicefeature-url>/updateAttachment
- Methods:
POST
- Required Capability:
- Update
- Version Introduced:
- 10.0
Description
This operation updates an attachment associated with a feature. Updating an attachment is a feature update, it requires the Update capability. The update
operation is performed on a feature service feature resource.
Since this request uploads a file, it must be a multipart request pursuant to IETF RFC1867. See the Add Item topic for more information.
This operation is available only if the layer has advertised that it has attachments. A layer has attachments if its has
property is true
.
See the Limiting upload file size and file types section of Uploads to learn more about default file size and file type limitations imposed for attachments.
The result of this operation is an array of edit result objects. Each edit result indicates whether or not the edit was successful. If successful, the object
of the result is the ID of the updated attachment. If unsuccessful, it also includes an error code and an error description.
You can provide arguments to the Update Attachment operation as defined in the following parameters table:
Request parameters
Parameter | Details |
---|---|
| The ID of the attachment to be updated. Example
|
| The file to be uploaded as the updated feature attachment. The content type, size, and name of the attachment will be derived from the uploaded file. |
|
The geodatabase version to apply the edits. This parameter applies only if the If the Syntax: Example: |
| This option was added at 10.5 and works with ArcGIS Server services only. Optional parameter specifying whether the response will report the time attachments were updated. If Values: |
| This option was added to the July 2014 of ArcGIS Online and ArcGIS 10.4 Server. The ID of the attachment that has been uploaded to the server. This parameter only applies if the |
|
The response format. The default response format is Values: |
Example usage
Update an attachment using the Update Attachment operation on a feature service feature resource. In this sample URL, the Update Attachment operation is performed on feature ID 818654 belonging to layer 0 of the 311Incidents FeatureService:
https://services.myserver.com/lidGgNLxw9LL0SbI/ArcGIS/rest/services/SanFrancisco/311Incidents/FeatureServer/0/818654/updateAttachment
The input parameters to this operation (attachment
and attachment
) are the ID of the attachment to be updated and a file.
JSON Response syntax
{
"updateAttachmentResult": {
"objectId": <attachmentId>,
"globalId": <globalId>,
"success": <true | false>,
"error": { //only if success is false
"code": <code1>,
"description": "<description>",
}
}
}
JSON Response example
{
"updateAttachmentResult": {
"objectId": 58,
"globalId": null,
"success": true
}
}