Skip to content

Commit fda4fa0

Browse files
author
CBWS
committed
Update generated protobuf docs based on v0.0.13
1 parent 8d1d0df commit fda4fa0

1 file changed

Lines changed: 153 additions & 0 deletions

File tree

‎protobuf/domains.md‎

Lines changed: 153 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,153 @@
1+
# Protocol Documentation
2+
<a name="top"></a>
3+
4+
## Table of Contents
5+
6+
- [cbws/domains/v1alpha1/domain.proto](#cbws/domains/v1alpha1/domain.proto)
7+
- [Domain](#cbws.domains.v1alpha1.Domain)
8+
9+
- [cbws/domains/v1alpha1/domains.proto](#cbws/domains/v1alpha1/domains.proto)
10+
- [GetDomainRequest](#cbws.domains.v1alpha1.GetDomainRequest)
11+
- [ListDomainsRequest](#cbws.domains.v1alpha1.ListDomainsRequest)
12+
- [ListDomainsResponse](#cbws.domains.v1alpha1.ListDomainsResponse)
13+
14+
- [DomainsService](#cbws.domains.v1alpha1.DomainsService)
15+
16+
- [Scalar Value Types](#scalar-value-types)
17+
18+
19+
20+
<a name="cbws/domains/v1alpha1/domain.proto"></a>
21+
<p align="right"><a href="#top">Top</a></p>
22+
23+
## cbws/domains/v1alpha1/domain.proto
24+
25+
26+
27+
<a name="cbws.domains.v1alpha1.Domain"></a>
28+
29+
### Domain
30+
31+
32+
33+
| Field | Type | Label | Description |
34+
| ----- | ---- | ----- | ----------- |
35+
| name | [string](#string) | | The resource name of the domain in the following format: `domains/{domain}`
36+
37+
We have chosen to not include the project prefix as domain names are globally unique. |
38+
| parent | [string](#string) | | |
39+
| unique_id | [string](#string) | | @OutputOnly The unique and stable id of the service account. |
40+
| domain | [string](#string) | | The domain name part of the domain, in case of sidn.nl this would be sidn |
41+
| tld | [string](#string) | | The tld portion of the domain, for example nl, com, co.uk |
42+
| expiry | [google.protobuf.Timestamp](#google.protobuf.Timestamp) | | When the domain will expire |
43+
| auto_renew | [bool](#bool) | | Whether auto renew has been enabled for this domain |
44+
45+
46+
47+
48+
49+
50+
51+
52+
53+
54+
55+
56+
57+
58+
59+
<a name="cbws/domains/v1alpha1/domains.proto"></a>
60+
<p align="right"><a href="#top">Top</a></p>
61+
62+
## cbws/domains/v1alpha1/domains.proto
63+
64+
65+
66+
<a name="cbws.domains.v1alpha1.GetDomainRequest"></a>
67+
68+
### GetDomainRequest
69+
The domain get request.
70+
71+
72+
| Field | Type | Label | Description |
73+
| ----- | ---- | ----- | ----------- |
74+
| name | [string](#string) | | Required. The resource name of the domain in the following format: `domains/{domain}`. |
75+
76+
77+
78+
79+
80+
81+
<a name="cbws.domains.v1alpha1.ListDomainsRequest"></a>
82+
83+
### ListDomainsRequest
84+
The domain list request.
85+
86+
87+
| Field | Type | Label | Description |
88+
| ----- | ---- | ----- | ----------- |
89+
| parent | [string](#string) | | Required. The resource name of the project associated with the service accounts, such as `projects/my-project-123`. |
90+
| page_size | [int32](#int32) | | Optional limit on the number of domains to include in the response. Further accounts can subsequently be obtained by including the [ListDomainsResponse.next_page_token][cbws.domains.v1alpha1.ListDomainsResponse.next_page_token] in a subsequent request. |
91+
| page_token | [string](#string) | | Optional pagination token returned in an earlier [ListDomainsResponse.next_page_token][cbws.domains.v1alpha1.ListDomainsResponse.next_page_token]. |
92+
93+
94+
95+
96+
97+
98+
<a name="cbws.domains.v1alpha1.ListDomainsResponse"></a>
99+
100+
### ListDomainsResponse
101+
The domain list response.
102+
103+
104+
| Field | Type | Label | Description |
105+
| ----- | ---- | ----- | ----------- |
106+
| domains | [Domain](#cbws.domains.v1alpha1.Domain) | repeated | The list of matching domains. |
107+
| next_page_token | [string](#string) | | To retrieve the next page of results, set [ListDomainsRequest.page_token][cbws.domains.v1alpha1.ListDomainsRequest.page_token] to this value. |
108+
109+
110+
111+
112+
113+
114+
115+
116+
117+
118+
119+
120+
<a name="cbws.domains.v1alpha1.DomainsService"></a>
121+
122+
### DomainsService
123+
124+
125+
| Method Name | Request Type | Response Type | Description |
126+
| ----------- | ------------ | ------------- | ------------|
127+
| ListDomains | [ListDomainsRequest](#cbws.domains.v1alpha1.ListDomainsRequest) | [ListDomainsResponse](#cbws.domains.v1alpha1.ListDomainsResponse) | |
128+
| GetDomain | [GetDomainRequest](#cbws.domains.v1alpha1.GetDomainRequest) | [Domain](#cbws.domains.v1alpha1.Domain) | |
129+
130+
131+
132+
133+
134+
## Scalar Value Types
135+
136+
| .proto Type | Notes | C++ | Java | Python | Go | C# | PHP | Ruby |
137+
| ----------- | ----- | --- | ---- | ------ | -- | -- | --- | ---- |
138+
| <a name="double" /> double | | double | double | float | float64 | double | float | Float |
139+
| <a name="float" /> float | | float | float | float | float32 | float | float | Float |
140+
| <a name="int32" /> int32 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint32 instead. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
141+
| <a name="int64" /> int64 | Uses variable-length encoding. Inefficient for encoding negative numbers – if your field is likely to have negative values, use sint64 instead. | int64 | long | int/long | int64 | long | integer/string | Bignum |
142+
| <a name="uint32" /> uint32 | Uses variable-length encoding. | uint32 | int | int/long | uint32 | uint | integer | Bignum or Fixnum (as required) |
143+
| <a name="uint64" /> uint64 | Uses variable-length encoding. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum or Fixnum (as required) |
144+
| <a name="sint32" /> sint32 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int32s. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
145+
| <a name="sint64" /> sint64 | Uses variable-length encoding. Signed int value. These more efficiently encode negative numbers than regular int64s. | int64 | long | int/long | int64 | long | integer/string | Bignum |
146+
| <a name="fixed32" /> fixed32 | Always four bytes. More efficient than uint32 if values are often greater than 2^28. | uint32 | int | int | uint32 | uint | integer | Bignum or Fixnum (as required) |
147+
| <a name="fixed64" /> fixed64 | Always eight bytes. More efficient than uint64 if values are often greater than 2^56. | uint64 | long | int/long | uint64 | ulong | integer/string | Bignum |
148+
| <a name="sfixed32" /> sfixed32 | Always four bytes. | int32 | int | int | int32 | int | integer | Bignum or Fixnum (as required) |
149+
| <a name="sfixed64" /> sfixed64 | Always eight bytes. | int64 | long | int/long | int64 | long | integer/string | Bignum |
150+
| <a name="bool" /> bool | | bool | boolean | boolean | bool | bool | boolean | TrueClass/FalseClass |
151+
| <a name="string" /> string | A string must always contain UTF-8 encoded or 7-bit ASCII text. | string | String | str/unicode | string | string | string | String (UTF-8) |
152+
| <a name="bytes" /> bytes | May contain any arbitrary sequence of bytes. | string | ByteString | str | []byte | ByteString | string | String (ASCII-8BIT) |
153+

0 commit comments

Comments
 (0)