#445: Relaxed api to not throw 404 when element was not found on PUT#454
Conversation
BirgitBoss
left a comment
There was a problem hiding this comment.
as discussed today in TF please also update explanations/descriptions of the interface operations themselves. Thank you!
…tifiable services
| tags: | ||
| - Asset Administration Shell API | ||
| summary: Creates or updates an existing Asset Administration Shell | ||
| summary: Updates an existing Asset Administration Shell |
There was a problem hiding this comment.
Here 201 return code missing?
There was a problem hiding this comment.
Yes, that is intentionally - for all "Service" interfaces (the one targetting a single identifiable, I removed the update again. These services offer no POST - so I thought it makes no sense to introduce a create via the backdoor.
I understand the services interfaces as interfaces for single objects - they do not offer the option to create new objects (an IOT device offers data via aas interface - but doesn't allow "huckepack" objects). If so, it would offer a repository interface...
Entire-API-Collection/V3.1.yaml
Outdated
| required: true | ||
| responses: | ||
| '201': | ||
| description: Submodel created successfully |
There was a problem hiding this comment.
Here without ?
description: Concept Description created successfully
headers:
Location:
description: URL of the newly created resource
schema:
type: string
content:
application/json:
schema:
$ref: 'https://api.swaggerhub.com/domains/Plattform_i40/Part1-MetaModel-Schemas/V3.1.0#/components/schemas/ConceptDescription'
| tags: | ||
| - Asset Administration Shell Repository API | ||
| summary: Creates or updates the Submodel | ||
| summary: Updates the Submodel |
There was a problem hiding this comment.
why only update and not create or update?
documentation/IDTA-01002-3/modules/ROOT/pages/specification/interfaces.adoc
Outdated
Show resolved
Hide resolved
| |=== | ||
| h|*Operation Name* 4+e|[[PutAssetAdministrationShell]]PutAssetAdministrationShell | ||
| hh|Explanation 4+a|Replaces the Asset Administration Shell | ||
| h|Explanation 4+a|Replaces the Asset Administration Shell or create it if it does not exist |
There was a problem hiding this comment.
| h|Explanation 4+a|Replaces the Asset Administration Shell or create it if it does not exist | |
| h|Explanation 4+a|Replaces the Asset Administration Shell or creates it if it does not exist |
b99a121
into
admin-shell-io:IDTA-01002-3-1_preparation
No description provided.