space.highport.manage.enableDelegation
Schema Diff
+7 -7
Compatibility Analysis
Backward Compatible
No changes detected.
1
1
{
2
2
"id": "space.highport.manage.enableDelegation",
3
3
"defs": {
4
4
"main": {
5
5
"type": "procedure",
6
6
"input": {
7
7
"schema": {
8
8
"type": "object",
9
9
"required": [
10
10
"domain"
11
11
],
12
12
"properties": {
13
13
"domain": {
14
14
"type": "string",
15
15
"maxLength": 253,
16
16
"description": "The base: a domain registered to the caller."
17
17
},
18
18
"maxNames": {
19
19
"type": "integer",
20
20
"minimum": 1,
21
-
"description": "The most names the base may hold in reservation. Omitted, the deployment's default applies; a value above the deployment's ceiling is refused."
21
+
"description": "The most names the base can reserve. Defaults to the deployment's setting; a value above the deployment's ceiling is refused."
22
22
}
23
23
}
24
24
},
25
25
"encoding": "application/json"
26
26
},
27
27
"errors": [
28
28
{
29
29
"name": "InvalidDomain",
30
30
"description": "Not a syntactically valid domain."
31
31
},
32
32
{
33
33
"name": "NotBaseOwner",
34
34
"description": "No verified or active registration of that domain belongs to the caller."
35
35
},
36
36
{
37
37
"name": "DelegationUnsupported",
38
-
"description": "The domain is registered to a space, and a space-registered domain cannot delegate names."
38
+
"description": "This domain cannot be a delegation base. It is registered to a space, is a domain this deployment provides or a name under one, was itself handed out under a base, or sits above or below a domain with delegation turned on. Bases do not nest."
39
39
},
40
40
{
41
41
"name": "MaxNamesAboveLimit",
42
-
"description": "maxNames is above the most names this deployment lets one base hold."
42
+
"description": "maxNames is above this deployment's per-base limit."
43
43
},
44
44
{
45
45
"name": "CaaForbidsIssuance",
46
-
"description": "The base's CAA records do not permit this deployment's certificate issuer, account, or challenge method. The message names the record in the way."
46
+
"description": "The base's CAA records do not allow this deployment's certificate issuer, account, or challenge method. The error message names the blocking record."
47
47
}
48
48
],
49
49
"output": {
50
50
"schema": {
51
51
"type": "object",
52
52
"required": [
53
53
"domain",
54
54
"records",
55
55
"status"
56
56
],
57
57
"properties": {
58
58
"domain": {
59
59
"type": "string"
60
60
},
61
61
"status": {
62
62
"ref": "space.highport.defs#delegationState",
63
63
"type": "ref"
64
64
},
65
65
"records": {
66
66
"type": "array",
67
67
"items": {
68
68
"ref": "space.highport.defs#dnsInstruction",
69
69
"type": "ref"
70
70
},
71
-
"description": "The DNS records delegation asks for: the wildcard traffic record."
71
+
"description": "The DNS records to publish: the wildcard traffic record."
72
72
},
73
73
"probeHostname": {
74
74
"type": "string",
75
75
"maxLength": 253,
76
-
"description": "The random name under the base through which the wildcard is proven to route. Absent while the base has no probe."
76
+
"description": "A random name under the base, used to prove the wildcard routes. Absent while the base has no probe."
77
77
}
78
78
}
79
79
},
80
80
"encoding": "application/json"
81
81
},
82
-
"description": "Declare a registered domain a delegation base, so its owner can reserve names directly under it for other identities, and obtain the wildcard traffic record that routes those names. The caller must be the base's registered identity, and the base must be verified or active."
82
+
"description": "Make a registered domain a delegation base, so its owner can reserve names directly under it for other identities. Returns the wildcard record that routes those names. The caller must own the base, and it must be verified or active."
83
83
}
84
84
},
85
85
"$type": "com.atproto.lexicon.schema",
86
86
"lexicon": 1
87
87
}