Get versions of Attribute shared with peer
This use case allows you to retrieve a list of LocalAttribute versions shared with a given peer. Since only the LocalAttribute subtypes OwnIdentityAttribute, OwnRelationshipAttribute, and PeerRelationshipAttribute represent forwardable Attributes, a list of shared versions can only be retrieved for such LocalAttributes.
Parameters
- The
attributeIdbelonging to a LocalAttribute you would like to know the versions shared with a specific peer of. - The returned LocalAttribute versions are limited to those shared with a specific
peer. onlyLatestVersionsomits succeeded versions such that only the most recent version you shared with the peer is returned. In detail, this means that if theattributeIdgiven as input belongs to a LocalAttribute that already has successors you also shared with the peer, only the most recently shared successor will be returned. By default this is set to betrue.
On Success
- A list of versions of the LocalAttribute belonging to the given
attributeIdshared with the specifiedpeeris returned. - If
onlyLatestVersionsis disabled, all versions shared with the peer will be returned, even if they already have successors.
On Failure
- No LocalAttributes can be returned if the
attributeIdcorrelates to an unknown LocalAttribute. - No LocalAttributes can be returned if the
attributeIddoesn’t belong to an OwnIdentityAttribute, an OwnRelationshipAttribute, or a PeerRelationshipAttribute. - No LocalAttributes can be returned if the parameters are malformed.