antimatter_api 2.0.13

Interact with the Antimatter Cloud API
Documentation
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
# \GeneralApi

All URIs are relative to *https://api.antimatter.io/v2*

Method | HTTP request | Description
------------- | ------------- | -------------
[**domain_add_new**](GeneralApi.md#domain_add_new) | **POST** /domains | Add a new domain
[**domain_add_peer_domain**](GeneralApi.md#domain_add_peer_domain) | **POST** /domains/{domainID}/peer-domain | Add a peer domain
[**domain_delete_peer**](GeneralApi.md#domain_delete_peer) | **DELETE** /domains/{domainID}/control/peers/{peerDomainID} | Delete a peer domain
[**domain_get_disaster_recovery_settings**](GeneralApi.md#domain_get_disaster_recovery_settings) | **GET** /domains/{domainID}/control/keys/disaster-recovery | Get a domain's disaster recovery settings.
[**domain_get_peer**](GeneralApi.md#domain_get_peer) | **GET** /domains/{domainID}/peer-domain | Get a peer domain by nickname or alias
[**domain_get_peer_config**](GeneralApi.md#domain_get_peer_config) | **GET** /domains/{domainID}/control/peers/{peerDomainID} | Get peer configuration
[**domain_get_private_info**](GeneralApi.md#domain_get_private_info) | **GET** /domains/{domainID}/info | Get the summary info for a Domain
[**domain_get_public_info**](GeneralApi.md#domain_get_public_info) | **GET** /domains/{domainID}/public-info | Get the public info for a Domain
[**domain_get_settings**](GeneralApi.md#domain_get_settings) | **GET** /domains/{domainID}/control/settings | Get the domain settings
[**domain_get_status**](GeneralApi.md#domain_get_status) | **GET** /domains/{domainID}/control/status | Get the domain status
[**domain_get_vendor_settings**](GeneralApi.md#domain_get_vendor_settings) | **GET** /domains/{domainID}/control/vendor/settings | Get vendor settings for the domain
[**domain_list_peers**](GeneralApi.md#domain_list_peers) | **GET** /domains/{domainID}/control/peers | List domain peers
[**domain_put_disaster_recovery_settings**](GeneralApi.md#domain_put_disaster_recovery_settings) | **PUT** /domains/{domainID}/control/keys/disaster-recovery | Create or update a domain's disaster recovery settings.
[**domain_put_settings**](GeneralApi.md#domain_put_settings) | **PUT** /domains/{domainID}/control/settings | Update the domain settings
[**domain_query_control_log**](GeneralApi.md#domain_query_control_log) | **GET** /domains/{domainID}/control/log | Get the domain control-plane audit log
[**domain_update_peer**](GeneralApi.md#domain_update_peer) | **PUT** /domains/{domainID}/control/peers/{peerDomainID} | Update peer configuration



## domain_add_new

> models::NewDomainResponse domain_add_new(new_domain)
Add a new domain

Add a new domain with no default peer relationships. You will need to confirm the email address before the domain is able to be interacted with. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**new_domain** | [**NewDomain**](NewDomain.md) |  | [required] |

### Return type

[**models::NewDomainResponse**](NewDomainResponse.md)

### Authorization

No authorization required

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_add_peer_domain

> models::NewDomainResponse domain_add_peer_domain(domain_id, create_peer_domain)
Add a peer domain

Add a domain with a default \"subordinate\" peering relationship with the current domain. Namely, the current \"parent\" domain will be configured to allow the new \"child\" domain to use the parent's billing and admin contact settings, and the child domain will be configured to import those settings. Optionally, similar linking can be performed for identity providers, read/write contexts and facts by setting the appropriate linkX parameter to true. In most cases, what you want is to set `linkAll=true`. Note, that a \"subdomain\" is just shorthand for a domain with the above-described peering config. This peering can be changed at any time, and there is no permanent difference between a domain created in this way, and a domain created with POST /domains. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**create_peer_domain** | [**CreatePeerDomain**](CreatePeerDomain.md) |  | [required] |

### Return type

[**models::NewDomainResponse**](NewDomainResponse.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_delete_peer

> domain_delete_peer(domain_id, peer_domain_id)
Delete a peer domain

Removes the peering relationship with the given domain

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**peer_domain_id** | **String** |  | [required] |

### Return type

 (empty response body)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_disaster_recovery_settings

> models::DisasterRecoverySettings domain_get_disaster_recovery_settings(domain_id)
Get a domain's disaster recovery settings.

Return the current domain's disaster recovery settings. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DisasterRecoverySettings**](DisasterRecoverySettings.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_peer

> models::Domain domain_get_peer(domain_id, nickname, alias)
Get a peer domain by nickname or alias

Retrieve the details of a domain that is configured as a peer of this domain, by using its alias or one of its nicknames 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**nickname** | Option<**String**> |  |  |
**alias** | Option<**String**> |  |  |

### Return type

[**models::Domain**](Domain.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_peer_config

> models::DomainPeerConfig domain_get_peer_config(domain_id, peer_domain_id)
Get peer configuration

Get the configuration for this peer. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**peer_domain_id** | **String** |  | [required] |

### Return type

[**models::DomainPeerConfig**](DomainPeerConfig.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_private_info

> models::DomainPrivateInfo domain_get_private_info(domain_id)
Get the summary info for a Domain

Returns a Domain's summary information. This may include more information than the `public-info` endpoint but requires authentication. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DomainPrivateInfo**](DomainPrivateInfo.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_public_info

> models::DomainPublicInfo domain_get_public_info(domain_id)
Get the public info for a Domain

Returns a Domain's summary information. This endpoint does not require authorization. This endpoint can be used to determine which identity providers the `/authenticate` endpoint supports. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DomainPublicInfo**](DomainPublicInfo.md)

### Authorization

No authorization required

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_settings

> models::DomainSettings domain_get_settings(domain_id)
Get the domain settings

Get the domain settings. This contains configuration for the contact email addresses as well as the display name for the domain. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DomainSettings**](DomainSettings.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_status

> models::DomainStatus domain_get_status(domain_id)
Get the domain status

The domain status object contains important notifications for administrators of the domain 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DomainStatus**](DomainStatus.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_get_vendor_settings

> models::VendorSettings domain_get_vendor_settings(domain_id)
Get vendor settings for the domain

Return the current vendor settings for a given domain. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::VendorSettings**](VendorSettings.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_list_peers

> models::DomainPeerList domain_list_peers(domain_id)
List domain peers

Returns a list of this domains peers

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |

### Return type

[**models::DomainPeerList**](DomainPeerList.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_put_disaster_recovery_settings

> domain_put_disaster_recovery_settings(domain_id, disaster_recovery_settings)
Create or update a domain's disaster recovery settings.

Create or update the current domain's disaster recovery settings. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**disaster_recovery_settings** | [**DisasterRecoverySettings**](DisasterRecoverySettings.md) |  | [required] |

### Return type

 (empty response body)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_put_settings

> models::DomainSettings domain_put_settings(domain_id, new_domain_settings)
Update the domain settings

Replace the current settings with the new settings supplied. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**new_domain_settings** | [**NewDomainSettings**](NewDomainSettings.md) |  | [required] |

### Return type

[**models::DomainSettings**](DomainSettings.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_query_control_log

> models::DomainControlLogResults domain_query_control_log(domain_id, start_date, end_date, num_results, start_from_id, session, url, description)
Get the domain control-plane audit log

Query the domain control-plane audit log. Results are returned in reverse chronological order 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**start_date** | Option<**String**> | the earlier date of the date range. As results are returned in reverse chronological order, this date corresponds with the end of the result set.  |  |[default to 1970-01-01T01:01:01Z]
**end_date** | Option<**String**> | the later date of the date range. As results are returned in reverse chronological order, this date corresponds with the beginning of the result set. If not specified, defaults to the current time.  |  |
**num_results** | Option<**i32**> | the number of results you would like returned. You may get more or less than this number, and it does not indicate anything about the availability of more records. Consult the returned \"has_more\" field to determine if there are more records available matching the filters and time range.  |  |[default to 100]
**start_from_id** | Option<**String**> | which id to start from. This must be an ID of a record previously returned. The first result will have an ID less than this ID (because results are in reverse chronological order, and it is non-inclusive). You should omit this field if you are not continuing a paginated query.  |  |
**session** | Option<**String**> | the session you would like to filter on. This will return results for only the provided session. If not specified, this field is ignored.  |  |
**url** | Option<**String**> | the URL you would like to filter on. This is a prefix matched filter and will return results starting with the provided string. If not specified, this field is ignored.  |  |
**description** | Option<**String**> | the description you would like to filter on. This is an in matched filter and will return results that  contain the provided string. If not specified, this field is ignored.  |  |

### Return type

[**models::DomainControlLogResults**](DomainControlLogResults.md)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: Not defined
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)


## domain_update_peer

> domain_update_peer(domain_id, peer_domain_id, domain_peer_config)
Update peer configuration

Create or update the configuration for this peer. Please note, if the configuration already exists, it is updated to reflect the values in the request. This will include setting the fields to their default value if not supplied. 

### Parameters


Name | Type | Description  | Required | Notes
------------- | ------------- | ------------- | ------------- | -------------
**domain_id** | **String** |  | [required] |
**peer_domain_id** | **String** |  | [required] |
**domain_peer_config** | [**DomainPeerConfig**](DomainPeerConfig.md) |  | [required] |

### Return type

 (empty response body)

### Authorization

[domain_identity](../README.md#domain_identity)

### HTTP request headers

- **Content-Type**: application/json
- **Accept**: application/json

[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)