Uploaded image for project: 'OASIS Cloud Application Management for Platforms (CAMP) TC'
  1. OASIS Cloud Application Management for Platforms (CAMP) TC
  2. CAMP-180

PUT and PATCH don't make sense for all resources

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Minor
    • Resolution: Fixed
    • Affects Version/s: 1.2
    • Fix Version/s: 1.2
    • Component/s: Spec
    • Labels:
      None
    • Proposal:
      Hide

      Rewrite 5.5 to remove the text that says PUT and PATCH must be supported by every resource. Add a section to every resource description that lists the HTTP methods that must be supported.


      v1 of the proposal to resolve this issue is at https://www.oasis-open.org/committees/document.php?document_id=57140&wg_abbrev=camp
      The proposal is based on the v3 proposal for issue 201

      Show
      Rewrite 5.5 to remove the text that says PUT and PATCH must be supported by every resource. Add a section to every resource description that lists the HTTP methods that must be supported. v1 of the proposal to resolve this issue is at https://www.oasis-open.org/committees/document.php?document_id=57140&wg_abbrev=camp The proposal is based on the v3 proposal for issue 201
    • Resolution:
      Show
      Resolved in WD 07: https://www.oasis-open.org/apps/org/workgroup/camp/download.php/57679/camp-spec-v1.2-wd07.doc

      Description

      Section 5.5, "HTTP Method Support", of CAMP 1.1 states the following:

      "As described in Section 6.1, “Transfer Protocol”, Consumers use HTTP [RFC2616] to interact with CAMP defined resources. To foster interoperability it is necessary to define the HTTP methods supported by
      each resource. Note that a requirement on the Provider to support a particular HTTP method on a resource does not ensure that all requests to that resource using that method will succeed; it simply guarantees that the Provider will not fail such requests with a 405 (Method Not Allowed) error.
      Providers SHALL support the HTTP GET, PUT, and PATCH methods on all of the resources defined in this section. [RE-53]"

      However, there are a number of CAMP-defined resources for which this simply does not make sense; there are resources which are essentially "read-only" in nature. For example, one of the "type_definition" resources. Even if you accept the general notion that a client may want to tag various resources for any number of reasons, it is difficult to imagine why someone would attempt to add a tag to a type_definition resource. These resources exist solely to allow the provider to advertise the resource types supported by the platform.

      If we accept the idea that some CAMP resources are "read-only", what should a provider do if a client attempts a PUT or a PATCH method on these resources? 405 is the most honest response to such a request.

        Attachments

          Activity

            People

            • Assignee:
              gilbert.pilz Gilbert Pilz
              Reporter:
              gilbert.pilz Gilbert Pilz
            • Watchers:
              3 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: