/
model_vlan_virtual_circuit_status.go
131 lines (110 loc) · 9.85 KB
/
model_vlan_virtual_circuit_status.go
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
/*
Metal API
# Introduction Equinix Metal provides a RESTful HTTP API which can be reached at <https://api.equinix.com/metal/v1>. This document describes the API and how to use it. The API allows you to programmatically interact with all of your Equinix Metal resources, including devices, networks, addresses, organizations, projects, and your user account. Every feature of the Equinix Metal web interface is accessible through the API. The API docs are generated from the Equinix Metal OpenAPI specification and are officially hosted at <https://metal.equinix.com/developers/api>. # Common Parameters The Equinix Metal API uses a few methods to minimize network traffic and improve throughput. These parameters are not used in all API calls, but are used often enough to warrant their own section. Look for these parameters in the documentation for the API calls that support them. ## Pagination Pagination is used to limit the number of results returned in a single request. The API will return a maximum of 100 results per page. To retrieve additional results, you can use the `page` and `per_page` query parameters. The `page` parameter is used to specify the page number. The first page is `1`. The `per_page` parameter is used to specify the number of results per page. The maximum number of results differs by resource type. ## Sorting Where offered, the API allows you to sort results by a specific field. To sort results use the `sort_by` query parameter with the root level field name as the value. The `sort_direction` parameter is used to specify the sort direction, either either `asc` (ascending) or `desc` (descending). ## Filtering Filtering is used to limit the results returned in a single request. The API supports filtering by certain fields in the response. To filter results, you can use the field as a query parameter. For example, to filter the IP list to only return public IPv4 addresses, you can filter by the `type` field, as in the following request: ```sh curl -H 'X-Auth-Token: my_authentication_token' \\ https://api.equinix.com/metal/v1/projects/id/ips?type=public_ipv4 ``` Only IP addresses with the `type` field set to `public_ipv4` will be returned. ## Searching Searching is used to find matching resources using multiple field comparissons. The API supports searching in resources that define this behavior. Currently the search parameter is only available on devices, ssh_keys, api_keys and memberships endpoints. To search resources you can use the `search` query parameter. ## Include and Exclude For resources that contain references to other resources, sucha as a Device that refers to the Project it resides in, the Equinix Metal API will returns `href` values (API links) to the associated resource. ```json { ... \"project\": { \"href\": \"/metal/v1/projects/f3f131c8-f302-49ef-8c44-9405022dc6dd\" } } ``` If you're going need the project details, you can avoid a second API request. Specify the contained `href` resources and collections that you'd like to have included in the response using the `include` query parameter. For example: ```sh curl -H 'X-Auth-Token: my_authentication_token' \\ https://api.equinix.com/metal/v1/user?include=projects ``` The `include` parameter is generally accepted in `GET`, `POST`, `PUT`, and `PATCH` requests where `href` resources are presented. To have multiple resources include, use a comma-separated list (e.g. `?include=emails,projects,memberships`). ```sh curl -H 'X-Auth-Token: my_authentication_token' \\ https://api.equinix.com/metal/v1/user?include=emails,projects,memberships ``` You may also include nested associations up to three levels deep using dot notation (`?include=memberships.projects`): ```sh curl -H 'X-Auth-Token: my_authentication_token' \\ https://api.equinix.com/metal/v1/user?include=memberships.projects ``` To exclude resources, and optimize response delivery, use the `exclude` query parameter. The `exclude` parameter is generally accepted in `GET`, `POST`, `PUT`, and `PATCH` requests for fields with nested object responses. When excluded, these fields will be replaced with an object that contains only an `href` field.
API version: 1.0.0
Contact: support@equinixmetal.com
*/
// Code generated by OpenAPI Generator (https://openapi-generator.tech); DO NOT EDIT.
package metalv1
import (
"encoding/json"
"fmt"
)
// VlanVirtualCircuitStatus The status of a Virtual Circuit is always 'pending' on creation. The status can turn to 'Waiting on Customer VLAN' if a Metro VLAN was not set yet on the Virtual Circuit and is the last step needed for full activation. For Dedicated interconnections, as long as the Dedicated Port has been associated to the Virtual Circuit and a NNI VNID has been set, it will turn to 'waiting_on_customer_vlan'. For Fabric VCs, it will only change to 'waiting_on_customer_vlan' once the corresponding Fabric connection has been found on the Fabric side. If the Fabric service token associated with the Virtual Circuit hasn't been redeemed on Fabric within the expiry time, it will change to an `expired` status. Once a Metro VLAN is set on the Virtual Circuit (which for Fabric VCs, can be set on creation of a Fabric VC) and the necessary set up is done, it will turn into 'Activating' status as it tries to activate the Virtual Circuit. Once the Virtual Circuit fully activates and is configured on the switch, it will turn to staus 'active'. For Fabric VCs (Metal Billed), we will start billing the moment the status of the Virtual Circuit turns to 'active'. If there are any changes to the VLAN after the Virtual Circuit is in an 'active' status, the status will show 'changing_vlan' if a new VLAN has been provided, or 'deactivating' if we are removing the VLAN. When a deletion request is issued for the Virtual Circuit, it will move to a 'deleting' status, and we will immediately unconfigure the switch for the Virtual Circuit and issue a deletion on any associated Fabric connections. Any associated Metro VLANs on the virtual circuit will also be unassociated after the switch has been successfully unconfigured. If there are any associated Fabric connections, we will only fully delete the Virtual Circuit once we have checked that the Fabric connection was fully deprovisioned on Fabric.
type VlanVirtualCircuitStatus string
// List of VlanVirtualCircuit_status
const (
VLANVIRTUALCIRCUITSTATUS_PENDING VlanVirtualCircuitStatus = "pending"
VLANVIRTUALCIRCUITSTATUS_WAITING_ON_CUSTOMER_VLAN VlanVirtualCircuitStatus = "waiting_on_customer_vlan"
VLANVIRTUALCIRCUITSTATUS_ACTIVATING VlanVirtualCircuitStatus = "activating"
VLANVIRTUALCIRCUITSTATUS_CHANGING_VLAN VlanVirtualCircuitStatus = "changing_vlan"
VLANVIRTUALCIRCUITSTATUS_DEACTIVATING VlanVirtualCircuitStatus = "deactivating"
VLANVIRTUALCIRCUITSTATUS_DELETING VlanVirtualCircuitStatus = "deleting"
VLANVIRTUALCIRCUITSTATUS_ACTIVE VlanVirtualCircuitStatus = "active"
VLANVIRTUALCIRCUITSTATUS_EXPIRED VlanVirtualCircuitStatus = "expired"
VLANVIRTUALCIRCUITSTATUS_ACTIVATION_FAILED VlanVirtualCircuitStatus = "activation_failed"
VLANVIRTUALCIRCUITSTATUS_CHANGING_VLAN_FAILED VlanVirtualCircuitStatus = "changing_vlan_failed"
VLANVIRTUALCIRCUITSTATUS_DEACTIVATION_FAILED VlanVirtualCircuitStatus = "deactivation_failed"
VLANVIRTUALCIRCUITSTATUS_DELETE_FAILED VlanVirtualCircuitStatus = "delete_failed"
)
// All allowed values of VlanVirtualCircuitStatus enum
var AllowedVlanVirtualCircuitStatusEnumValues = []VlanVirtualCircuitStatus{
"pending",
"waiting_on_customer_vlan",
"activating",
"changing_vlan",
"deactivating",
"deleting",
"active",
"expired",
"activation_failed",
"changing_vlan_failed",
"deactivation_failed",
"delete_failed",
}
func (v *VlanVirtualCircuitStatus) UnmarshalJSON(src []byte) error {
var value string
err := json.Unmarshal(src, &value)
if err != nil {
return err
}
enumTypeValue := VlanVirtualCircuitStatus(value)
for _, existing := range AllowedVlanVirtualCircuitStatusEnumValues {
if existing == enumTypeValue {
*v = enumTypeValue
return nil
}
}
return fmt.Errorf("%+v is not a valid VlanVirtualCircuitStatus", value)
}
// NewVlanVirtualCircuitStatusFromValue returns a pointer to a valid VlanVirtualCircuitStatus
// for the value passed as argument, or an error if the value passed is not allowed by the enum
func NewVlanVirtualCircuitStatusFromValue(v string) (*VlanVirtualCircuitStatus, error) {
ev := VlanVirtualCircuitStatus(v)
if ev.IsValid() {
return &ev, nil
} else {
return nil, fmt.Errorf("invalid value '%v' for VlanVirtualCircuitStatus: valid values are %v", v, AllowedVlanVirtualCircuitStatusEnumValues)
}
}
// IsValid return true if the value is valid for the enum, false otherwise
func (v VlanVirtualCircuitStatus) IsValid() bool {
for _, existing := range AllowedVlanVirtualCircuitStatusEnumValues {
if existing == v {
return true
}
}
return false
}
// Ptr returns reference to VlanVirtualCircuit_status value
func (v VlanVirtualCircuitStatus) Ptr() *VlanVirtualCircuitStatus {
return &v
}
type NullableVlanVirtualCircuitStatus struct {
value *VlanVirtualCircuitStatus
isSet bool
}
func (v NullableVlanVirtualCircuitStatus) Get() *VlanVirtualCircuitStatus {
return v.value
}
func (v *NullableVlanVirtualCircuitStatus) Set(val *VlanVirtualCircuitStatus) {
v.value = val
v.isSet = true
}
func (v NullableVlanVirtualCircuitStatus) IsSet() bool {
return v.isSet
}
func (v *NullableVlanVirtualCircuitStatus) Unset() {
v.value = nil
v.isSet = false
}
func NewNullableVlanVirtualCircuitStatus(val *VlanVirtualCircuitStatus) *NullableVlanVirtualCircuitStatus {
return &NullableVlanVirtualCircuitStatus{value: val, isSet: true}
}
func (v NullableVlanVirtualCircuitStatus) MarshalJSON() ([]byte, error) {
return json.Marshal(v.value)
}
func (v *NullableVlanVirtualCircuitStatus) UnmarshalJSON(src []byte) error {
v.isSet = true
return json.Unmarshal(src, &v.value)
}