|
| 1 | +/* |
| 2 | + * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except |
| 3 | + * in compliance with the License. You may obtain a copy of the License at |
| 4 | + * |
| 5 | + * http://www.apache.org/licenses/LICENSE-2.0 |
| 6 | + * |
| 7 | + * Unless required by applicable law or agreed to in writing, software distributed under the License |
| 8 | + * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express |
| 9 | + * or implied. See the License for the specific language governing permissions and limitations under |
| 10 | + * the License. |
| 11 | + */ |
| 12 | +/* |
| 13 | + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ |
| 14 | + * Modify at your own risk. |
| 15 | + */ |
| 16 | + |
| 17 | +package com.google.api.services.compute.model; |
| 18 | + |
| 19 | +/** |
| 20 | + * Model definition for BackendServiceHAPolicy. |
| 21 | + * |
| 22 | + * <p> This is the Java data model class that specifies how to parse/serialize into the JSON that is |
| 23 | + * transmitted over HTTP when working with the Compute Engine API. For a detailed explanation see: |
| 24 | + * <a href="https://developers.google.com/api-client-library/java/google-http-java-client/json">https://developers.google.com/api-client-library/java/google-http-java-client/json</a> |
| 25 | + * </p> |
| 26 | + * |
| 27 | + * @author Google, Inc. |
| 28 | + */ |
| 29 | +@SuppressWarnings("javadoc") |
| 30 | +public final class BackendServiceHAPolicy extends com.google.api.client.json.GenericJson { |
| 31 | + |
| 32 | + /** |
| 33 | + * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported |
| 34 | + * values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to |
| 35 | + * update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint |
| 36 | + * as the leader. This method is faster than updating the leader using the haPolicy.leader API. |
| 37 | + * Fast IP move works as follows: The VM hosting the network endpoint that should become the new |
| 38 | + * leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) |
| 39 | + * packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP |
| 40 | + * address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note |
| 41 | + * the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing |
| 42 | + * stays active for approximately 20 minutes. After triggering fast failover, you must also |
| 43 | + * appropriately set the haPolicy.leader. - The new leader instance should continue to send |
| 44 | + * GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the |
| 45 | + * haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast |
| 46 | + * failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet |
| 47 | + * from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from |
| 48 | + * different VM instances at the same time. If multiple instances continue to send GARP/RA |
| 49 | + * packets, traffic might be routed to different destinations in an alternating order. This |
| 50 | + * condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always |
| 51 | + * takes priority over the leader API. Using the haPolicy.leader API to change the leader to a |
| 52 | + * different instance will have no effect until the GARP/RA request becomes inactive. - The |
| 53 | + * GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding |
| 54 | + * rules refer to a regional backend service, you need only send a GARP or RA packet for a single |
| 55 | + * forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend |
| 56 | + * service will also be moved to the sender of the GARP or RA packet. The following are the Fast |
| 57 | + * IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules |
| 58 | + * cannot use the same IP address if one of them refers to a regional backend service with |
| 59 | + * fastIPMove. - The regional backend service must set the network field, and all NEGs must belong |
| 60 | + * to that network. However, individual NEGs can belong to different subnetworks of that network. |
| 61 | + * - The maximum number of network endpoints across all backends of a backend service with |
| 62 | + * fastIPMove is 64. - The maximum number of backend services with fastIPMove that can have the |
| 63 | + * same network endpoint attached to one of its backends is 64. - The maximum number of backend |
| 64 | + * services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached |
| 65 | + * to a backend of a backend service with fastIPMove cannot resolve to C3 machines. - Traffic |
| 66 | + * directed to the leader by a static route next hop will not be redirected to a new leader by |
| 67 | + * fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken |
| 68 | + * effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by |
| 69 | + * fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, |
| 70 | + * it cannot be updated. By default, fastIpMove is set to DISABLED. |
| 71 | + * The value may be {@code null}. |
| 72 | + */ |
| 73 | + @com.google.api.client.util.Key |
| 74 | + private java.lang.String fastIPMove; |
| 75 | + |
| 76 | + /** |
| 77 | + * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported |
| 78 | + * values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to |
| 79 | + * update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint |
| 80 | + * as the leader. This method is faster than updating the leader using the haPolicy.leader API. |
| 81 | + * Fast IP move works as follows: The VM hosting the network endpoint that should become the new |
| 82 | + * leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) |
| 83 | + * packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP |
| 84 | + * address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note |
| 85 | + * the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing |
| 86 | + * stays active for approximately 20 minutes. After triggering fast failover, you must also |
| 87 | + * appropriately set the haPolicy.leader. - The new leader instance should continue to send |
| 88 | + * GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the |
| 89 | + * haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast |
| 90 | + * failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet |
| 91 | + * from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from |
| 92 | + * different VM instances at the same time. If multiple instances continue to send GARP/RA |
| 93 | + * packets, traffic might be routed to different destinations in an alternating order. This |
| 94 | + * condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always |
| 95 | + * takes priority over the leader API. Using the haPolicy.leader API to change the leader to a |
| 96 | + * different instance will have no effect until the GARP/RA request becomes inactive. - The |
| 97 | + * GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding |
| 98 | + * rules refer to a regional backend service, you need only send a GARP or RA packet for a single |
| 99 | + * forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend |
| 100 | + * service will also be moved to the sender of the GARP or RA packet. The following are the Fast |
| 101 | + * IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules |
| 102 | + * cannot use the same IP address if one of them refers to a regional backend service with |
| 103 | + * fastIPMove. - The regional backend service must set the network field, and all NEGs must belong |
| 104 | + * to that network. However, individual NEGs can belong to different subnetworks of that network. |
| 105 | + * - The maximum number of network endpoints across all backends of a backend service with |
| 106 | + * fastIPMove is 64. - The maximum number of backend services with fastIPMove that can have the |
| 107 | + * same network endpoint attached to one of its backends is 64. - The maximum number of backend |
| 108 | + * services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached |
| 109 | + * to a backend of a backend service with fastIPMove cannot resolve to C3 machines. - Traffic |
| 110 | + * directed to the leader by a static route next hop will not be redirected to a new leader by |
| 111 | + * fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken |
| 112 | + * effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by |
| 113 | + * fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, |
| 114 | + * it cannot be updated. By default, fastIpMove is set to DISABLED. |
| 115 | + * @return value or {@code null} for none |
| 116 | + */ |
| 117 | + public java.lang.String getFastIPMove() { |
| 118 | + return fastIPMove; |
| 119 | + } |
| 120 | + |
| 121 | + /** |
| 122 | + * Specifies whether fast IP move is enabled, and if so, the mechanism to achieve it. Supported |
| 123 | + * values are: - DISABLED: Fast IP Move is disabled. You can only use the haPolicy.leader API to |
| 124 | + * update the leader. - >GARP_RA: Provides a method to very quickly define a new network endpoint |
| 125 | + * as the leader. This method is faster than updating the leader using the haPolicy.leader API. |
| 126 | + * Fast IP move works as follows: The VM hosting the network endpoint that should become the new |
| 127 | + * leader sends either a Gratuitous ARP (GARP) packet (IPv4) or an ICMPv6 Router Advertisement(RA) |
| 128 | + * packet (IPv6). Google Cloud immediately but temporarily associates the forwarding rule IP |
| 129 | + * address with that VM, and both new and in-flight packets are quickly delivered to that VM. Note |
| 130 | + * the important properties of the Fast IP Move functionality: - The GARP/RA-initiated re-routing |
| 131 | + * stays active for approximately 20 minutes. After triggering fast failover, you must also |
| 132 | + * appropriately set the haPolicy.leader. - The new leader instance should continue to send |
| 133 | + * GARP/RA packets periodically every 10 seconds until at least 10 minutes after updating the |
| 134 | + * haPolicy.leader (but stop immediately if it is no longer the leader). - After triggering a fast |
| 135 | + * failover, we recommend that you wait at least 3 seconds before sending another GARP/RA packet |
| 136 | + * from a different VM instance to avoid race conditions. - Don't send GARP/RA packets from |
| 137 | + * different VM instances at the same time. If multiple instances continue to send GARP/RA |
| 138 | + * packets, traffic might be routed to different destinations in an alternating order. This |
| 139 | + * condition ceases when a single instance issues a GARP/RA packet. - The GARP/RA request always |
| 140 | + * takes priority over the leader API. Using the haPolicy.leader API to change the leader to a |
| 141 | + * different instance will have no effect until the GARP/RA request becomes inactive. - The |
| 142 | + * GARP/RA packets should follow the GARP/RA Packet Specifications.. - When multiple forwarding |
| 143 | + * rules refer to a regional backend service, you need only send a GARP or RA packet for a single |
| 144 | + * forwarding rule virtual IP. The virtual IPs for all forwarding rules targeting the same backend |
| 145 | + * service will also be moved to the sender of the GARP or RA packet. The following are the Fast |
| 146 | + * IP Move limitations (that is, when fastIPMove is not DISABLED): - Multiple forwarding rules |
| 147 | + * cannot use the same IP address if one of them refers to a regional backend service with |
| 148 | + * fastIPMove. - The regional backend service must set the network field, and all NEGs must belong |
| 149 | + * to that network. However, individual NEGs can belong to different subnetworks of that network. |
| 150 | + * - The maximum number of network endpoints across all backends of a backend service with |
| 151 | + * fastIPMove is 64. - The maximum number of backend services with fastIPMove that can have the |
| 152 | + * same network endpoint attached to one of its backends is 64. - The maximum number of backend |
| 153 | + * services with fastIPMove in a VPC in a region is 64. - The network endpoints that are attached |
| 154 | + * to a backend of a backend service with fastIPMove cannot resolve to C3 machines. - Traffic |
| 155 | + * directed to the leader by a static route next hop will not be redirected to a new leader by |
| 156 | + * fast failover. Such traffic will only be redirected once an haPolicy.leader update has taken |
| 157 | + * effect. Only traffic to the forwarding rule's virtual IP will be redirected to a new leader by |
| 158 | + * fast failover. haPolicy.fastIPMove can be set only at backend service creation time. Once set, |
| 159 | + * it cannot be updated. By default, fastIpMove is set to DISABLED. |
| 160 | + * @param fastIPMove fastIPMove or {@code null} for none |
| 161 | + */ |
| 162 | + public BackendServiceHAPolicy setFastIPMove(java.lang.String fastIPMove) { |
| 163 | + this.fastIPMove = fastIPMove; |
| 164 | + return this; |
| 165 | + } |
| 166 | + |
| 167 | + @Override |
| 168 | + public BackendServiceHAPolicy set(String fieldName, Object value) { |
| 169 | + return (BackendServiceHAPolicy) super.set(fieldName, value); |
| 170 | + } |
| 171 | + |
| 172 | + @Override |
| 173 | + public BackendServiceHAPolicy clone() { |
| 174 | + return (BackendServiceHAPolicy) super.clone(); |
| 175 | + } |
| 176 | + |
| 177 | +} |
0 commit comments