Skip to content

feat(ipa): Tighten standard method guarantees in IPA-101, IPA-106, IPA-107 and IPA-108#78

Open
AgustinBettati wants to merge 1 commit into
mainfrom
CLOUDP-412563-ipa-101-106-107-108-standard-method
Open

feat(ipa): Tighten standard method guarantees in IPA-101, IPA-106, IPA-107 and IPA-108#78
AgustinBettati wants to merge 1 commit into
mainfrom
CLOUDP-412563-ipa-101-106-107-108-standard-method

Conversation

@AgustinBettati

Copy link
Copy Markdown
Member

Tightens standard-method guarantees from should to must and adds two lifecycle rules, so declarative clients can rely on field round-trip parity and predictable delete behavior.

  • IPA-101 — every field accepted in a request body must also appear in the response (sensitive fields excepted); and resources declared by clients must not be silently removed by the server (model lifecycle transitions as a terminal status, e.g. EXPIRED/REVOKED).
  • IPA-106 / IPA-107 — Create/Update response must (was should) be the same resource returned by Get; Update must return the complete resource.
  • IPA-108 — Delete must succeed iff the resource was deleted, must 404 on non-existent, and must not return success while internal state without an independent endpoint remains.

Note: the IPA-101 round-trip bullet links to the Sensitive Fields anchor added in #77 — merging that first resolves the anchor (build only warns until then).

Ticket: CLOUDP-412563

@AgustinBettati AgustinBettati force-pushed the CLOUDP-412563-ipa-101-106-107-108-standard-method branch from 7bb8065 to 43e400d Compare June 17, 2026 20:18
@AgustinBettati AgustinBettati force-pushed the CLOUDP-412563-ipa-101-106-107-108-standard-method branch from 43e400d to 159531f Compare June 17, 2026 20:29
@AgustinBettati AgustinBettati marked this pull request as ready for review June 18, 2026 09:35
@AgustinBettati AgustinBettati requested a review from a team as a code owner June 18, 2026 09:35
Comment thread ipa/general/0108.mdx
was successfully deleted.
- If the resource did not exist, the method **must** respond with a
`404 Not Found` error per [IPA-114](0114.mdx#not-found).
- The Delete method **must not** return a successful response while any internal

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we considering DELETE operations that act as a reset for singleton resources?

Comment thread ipa/general/0108.mdx
`404 Not Found` error per [IPA-114](0114.mdx#not-found).
- The Delete method **must not** return a successful response while any internal
state of the resource — settings, policies, configurations, or any other state
without an independent endpoint — remains.

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could we clarify what without an independent endpoint means in the guidelines?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants