Skip to content

Commit 6b66b60

Browse files
Clarify claiming-existing-composite-resources: CompositeAlreadyBoundError
CompositeAlreadyBoundError should be returned if a composite is already bound to a claim Fixes crossplane#783
1 parent dda19d8 commit 6b66b60

File tree

1 file changed

+8
-2
lines changed

1 file changed

+8
-2
lines changed

content/master/concepts/claims.md

+8-2
Original file line numberDiff line numberDiff line change
@@ -138,7 +138,7 @@ If you don't use namespaces in your Kubernetes deployment Claims aren't necessar
138138
### Claiming existing composite resources
139139

140140
By default, creating a Claim creates a new composite resource. Claims can also
141-
link to existing composite resources.
141+
link to existing composite resources (if not yet referencing a claim).
142142

143143
A use case for claiming existing composite resources may be slow to provision
144144
resources. Composite resources can be pre-provisioned and a Claim can
@@ -164,6 +164,10 @@ If a Claim specifies a
164164
{{<hover label="resourceref" line="6">}}resourceRef{{</hover>}} that doesn't
165165
exist, Crossplane doesn't create a composite resource.
166166
167+
If a new Claim specifies a
168+
{{<hover label="resourceref" line="6">}}resourceRef{{</hover>}} of a composite which is already referenced by another existing claim, then the new Claim will fail with a `CompositeAlreadyBoundError`.
169+
170+
167171
{{<hint "note" >}}
168172
All Claims have a
169173
{{<hover label="resourceref" line="6">}}resourceRef{{</hover>}}. Manually
@@ -174,6 +178,8 @@ isn't required. Crossplane fills in the
174178
with the information from the composite resource created for the Claim.
175179
{{< /hint >}}
176180

181+
182+
177183
## Claim connection secrets
178184

179185
If a Claim expects connection secrets the Claim must define a
@@ -204,4 +210,4 @@ spec:
204210
name: my-claim-secret
205211
```
206212

207-
For more information on connection secrets read the [Connection Secrets knowledge base article]({{<ref "connection-details">}}).
213+
For more information on connection secrets read the [Connection Secrets knowledge base article]({{<ref "connection-details">}}).

0 commit comments

Comments
 (0)