Ownership Transfer Model
Table of Contents
OWNERSHIP TRANSFER ATTRIBUTES
- Users can claim ownership of Unowned records. When a user requests ownership with their group ID, the user’s group will be automatically assigned to the record.
- Users can request ownership transfer for records that are already assigned to a group. When a user initiates an ownership transfer, a request is sent to the members of the record’s current owner group. These members must review and approve the request in VinylDNS. Approvers will also receive an email notification about the pending transfer.
| field | type | required? | description |
|---|---|---|---|
| ownershipTransferStatus | OwnershipTransferStatus | yes | Ownership transfer status for this RecordSet change. Must be one of: AutoApproved, Cancelled, ManuallyApproved, ManuallyRejected, Requested, or PendingReview. Values are case-sensitive. See descriptions below. |
| requestedOwnerGroupId | string | yes | UUID of the group to which ownership is being transferred; required when initiating or processing an ownership transfer. |
OwnershipTransferStatus Values
| Value | Description |
|---|---|
| AutoApproved | Ownership transfer was automatically approved. |
| Cancelled | Ownership transfer request was cancelled. |
| ManuallyApproved | Ownership transfer was manually approved by a group member. |
| ManuallyRejected | Ownership transfer was manually rejected by a group member. |
| Requested | Ownership transfer has been requested and is awaiting approval. |
| PendingReview | Ownership transfer is pending review by the current owner group. |
OWNERSHIP TRANSFER EXAMPLE
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "Requested",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}
EXAMPLE HTTP REQUEST AND RESPONSE
Requested ownershipTransferStatus in RecordSets:
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "Requested",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}
Cancelled ownershipTransferStatus in RecordSets:
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "Cancelled",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}
Approved ownershipTransferStatus in RecordSets:
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "ManuallyApproved",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "AutoApproved",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}
Rejected ownershipTransferStatus in RecordSets:
{
"recordSetGroupChange" : {
"ownershipTransferStatus": "ManuallyRejected",
"requestedOwnerGroupId": "f42385e4-5675-38c0-b42f-64105e743bfe"
}
}