|
2 | 2 | # Documentation for `scw webhosting` |
3 | 3 | Webhosting API. |
4 | 4 |
|
5 | | -- [DNS record management commands](#dns-record-management-commands) |
6 | | - - [Get the DNS records](#get-the-dns-records) |
7 | 5 | - [Hosting management commands](#hosting-management-commands) |
8 | 6 | - [Create a hosting](#create-a-hosting) |
| 7 | + - [Delete a hosting](#delete-a-hosting) |
9 | 8 | - [Get a hosting](#get-a-hosting) |
| 9 | + - [Get the DNS records](#get-the-dns-records) |
10 | 10 | - [List all hostings](#list-all-hostings) |
| 11 | + - [Restore a hosting](#restore-a-hosting) |
11 | 12 | - [Update a hosting](#update-a-hosting) |
12 | 13 | - [Offer management commands](#offer-management-commands) |
13 | 14 | - [List all offers](#list-all-offers) |
14 | 15 |
|
15 | 16 |
|
16 | | -## DNS record management commands |
| 17 | +## Hosting management commands |
17 | 18 |
|
18 | | -The set of DNS record of a specific domain associated to a hosting. |
| 19 | +A Scaleway web hosting associated with a domain name. |
19 | 20 |
|
20 | 21 |
|
21 | 22 |
|
22 | | -### Get the DNS records |
| 23 | +### Create a hosting |
23 | 24 |
|
24 | | -Get the DNS records of a specified domain. |
| 25 | +Create a hosting. |
25 | 26 |
|
26 | 27 | **Usage:** |
27 | 28 |
|
28 | 29 | ``` |
29 | | -scw webhosting dns-record get [arg=value ...] |
| 30 | +scw webhosting hosting create [arg=value ...] |
30 | 31 | ``` |
31 | 32 |
|
32 | 33 |
|
33 | 34 | **Args:** |
34 | 35 |
|
35 | 36 | | Name | | Description | |
36 | 37 | |------|---|-------------| |
37 | | -| domain | Required | Domain associated to the DNS records | |
| 38 | +| offer-id | | ID of the selected offer for the hosting | |
| 39 | +| project-id | | Project ID to use. If none is passed the default project ID will be used | |
| 40 | +| email | | Contact email of the client for the hosting | |
| 41 | +| tags.{index} | | The tags of the hosting | |
| 42 | +| domain | | The domain name of the hosting | |
| 43 | +| option-ids.{index} | | IDs of the selected options for the hosting | |
38 | 44 | | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config | |
39 | 45 |
|
40 | 46 |
|
41 | | -**Examples:** |
42 | 47 |
|
| 48 | +### Delete a hosting |
| 49 | + |
| 50 | +Delete a hosting with the given ID. |
| 51 | + |
| 52 | +**Usage:** |
43 | 53 |
|
44 | | -Get DNS records associated to the given domain |
45 | 54 | ``` |
46 | | -scw webhosting dns-record get domain=foo.com |
| 55 | +scw webhosting hosting delete [arg=value ...] |
47 | 56 | ``` |
48 | 57 |
|
49 | 58 |
|
| 59 | +**Args:** |
| 60 | + |
| 61 | +| Name | | Description | |
| 62 | +|------|---|-------------| |
| 63 | +| hosting-id | Required | Hosting ID | |
| 64 | +| region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config | |
| 65 | + |
50 | 66 |
|
| 67 | +**Examples:** |
51 | 68 |
|
52 | | -## Hosting management commands |
53 | 69 |
|
54 | | -A Scaleway web hosting associated with a domain name. |
| 70 | +Delete a Hosting with the given ID |
| 71 | +``` |
| 72 | +scw webhosting hosting delete hosting-id=a3244331-5d32-4e36-9bf9-b60233e201c7 |
| 73 | +``` |
55 | 74 |
|
56 | 75 |
|
57 | 76 |
|
58 | | -### Create a hosting |
59 | 77 |
|
60 | | -Create a hosting. |
| 78 | +### Get a hosting |
| 79 | + |
| 80 | +Get the details of a Hosting with the given ID. |
61 | 81 |
|
62 | 82 | **Usage:** |
63 | 83 |
|
64 | 84 | ``` |
65 | | -scw webhosting hosting create [arg=value ...] |
| 85 | +scw webhosting hosting get [arg=value ...] |
66 | 86 | ``` |
67 | 87 |
|
68 | 88 |
|
69 | 89 | **Args:** |
70 | 90 |
|
71 | 91 | | Name | | Description | |
72 | 92 | |------|---|-------------| |
73 | | -| offer-id | | ID of the selected offer for the hosting | |
74 | | -| project-id | | Project ID to use. If none is passed the default project ID will be used | |
75 | | -| email | | Contact email of the client for the hosting | |
76 | | -| tags.{index} | | The tags of the hosting | |
77 | | -| domain | | The domain name of the hosting | |
78 | | -| option-ids.{index} | | IDs of the selected options for the hosting | |
| 93 | +| hosting-id | Required | Hosting ID | |
79 | 94 | | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config | |
80 | 95 |
|
81 | 96 |
|
| 97 | +**Examples:** |
82 | 98 |
|
83 | | -### Get a hosting |
84 | 99 |
|
85 | | -Get the details of a Hosting with the given ID. |
| 100 | +Get a Hosting with the given ID |
| 101 | +``` |
| 102 | +scw webhosting hosting get hosting-id=a3244331-5d32-4e36-9bf9-b60233e201c7 |
| 103 | +``` |
| 104 | + |
| 105 | + |
| 106 | + |
| 107 | + |
| 108 | +### Get the DNS records |
| 109 | + |
| 110 | +The set of DNS record of a specific domain associated to a hosting. |
86 | 111 |
|
87 | 112 | **Usage:** |
88 | 113 |
|
89 | 114 | ``` |
90 | | -scw webhosting hosting get [arg=value ...] |
| 115 | +scw webhosting hosting get-dns-records [arg=value ...] |
91 | 116 | ``` |
92 | 117 |
|
93 | 118 |
|
94 | 119 | **Args:** |
95 | 120 |
|
96 | 121 | | Name | | Description | |
97 | 122 | |------|---|-------------| |
98 | | -| hosting-id | Required | Hosting ID | |
| 123 | +| domain | Required | Domain associated to the DNS records | |
99 | 124 | | region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config | |
100 | 125 |
|
101 | 126 |
|
102 | 127 | **Examples:** |
103 | 128 |
|
104 | 129 |
|
105 | | -Get a Hosting with the given ID |
| 130 | +Get DNS records associated to the given domain |
106 | 131 | ``` |
107 | | -scw webhosting hosting get hosting-id=a3244331-5d32-4e36-9bf9-b60233e201c7 |
| 132 | +scw webhosting hosting get-dns-records domain=foo.com |
108 | 133 | ``` |
109 | 134 |
|
110 | 135 |
|
@@ -145,6 +170,36 @@ scw webhosting hosting list project-id=a3244331-5d32-4e36-9bf9-b60233e201c7 orga |
145 | 170 |
|
146 | 171 |
|
147 | 172 |
|
| 173 | +### Restore a hosting |
| 174 | + |
| 175 | +Restore a hosting with the given ID. |
| 176 | + |
| 177 | +**Usage:** |
| 178 | + |
| 179 | +``` |
| 180 | +scw webhosting hosting restore [arg=value ...] |
| 181 | +``` |
| 182 | + |
| 183 | + |
| 184 | +**Args:** |
| 185 | + |
| 186 | +| Name | | Description | |
| 187 | +|------|---|-------------| |
| 188 | +| hosting-id | Required | Hosting ID | |
| 189 | +| region | Default: `fr-par`<br />One of: `fr-par` | Region to target. If none is passed will use default region from the config | |
| 190 | + |
| 191 | + |
| 192 | +**Examples:** |
| 193 | + |
| 194 | + |
| 195 | +Restore a Hosting with the given ID |
| 196 | +``` |
| 197 | +scw webhosting hosting restore hosting-id=a3244331-5d32-4e36-9bf9-b60233e201c7 |
| 198 | +``` |
| 199 | + |
| 200 | + |
| 201 | + |
| 202 | + |
148 | 203 | ### Update a hosting |
149 | 204 |
|
150 | 205 | Update a hosting. |
|
0 commit comments