| <html><body> | |
| <style> | |
| body, h1, h2, h3, div, span, p, pre, a { | |
| margin: 0; | |
| padding: 0; | |
| border: 0; | |
| font-weight: inherit; | |
| font-style: inherit; | |
| font-size: 100%; | |
| font-family: inherit; | |
| vertical-align: baseline; | |
| } | |
| body { | |
| font-size: 13px; | |
| padding: 1em; | |
| } | |
| h1 { | |
| font-size: 26px; | |
| margin-bottom: 1em; | |
| } | |
| h2 { | |
| font-size: 24px; | |
| margin-bottom: 1em; | |
| } | |
| h3 { | |
| font-size: 20px; | |
| margin-bottom: 1em; | |
| margin-top: 1em; | |
| } | |
| pre, code { | |
| line-height: 1.5; | |
| font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; | |
| } | |
| pre { | |
| margin-top: 0.5em; | |
| } | |
| h1, h2, h3, p { | |
| font-family: Arial, sans serif; | |
| } | |
| h1, h2, h3 { | |
| border-bottom: solid #CCC 1px; | |
| } | |
| .toc_element { | |
| margin-top: 0.5em; | |
| } | |
| .firstline { | |
| margin-left: 2 em; | |
| } | |
| .method { | |
| margin-top: 1em; | |
| border: solid 1px #CCC; | |
| padding: 1em; | |
| background: #EEE; | |
| } | |
| .details { | |
| font-weight: bold; | |
| font-size: 14px; | |
| } | |
| </style> | |
| <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.interconnectLocations.html">interconnectLocations</a></h1> | |
| <h2>Instance Methods</h2> | |
| <p class="toc_element"> | |
| <code><a href="#close">close()</a></code></p> | |
| <p class="firstline">Close httplib2 connections.</p> | |
| <p class="toc_element"> | |
| <code><a href="#get">get(project, interconnectLocation, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Returns the details for the specified interconnect location. Gets a list of</p> | |
| <p class="toc_element"> | |
| <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p> | |
| <p class="firstline">Retrieves the list of interconnect locations available to the specified</p> | |
| <p class="toc_element"> | |
| <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> | |
| <p class="firstline">Retrieves the next page of results.</p> | |
| <h3>Method Details</h3> | |
| <div class="method"> | |
| <code class="details" id="close">close()</code> | |
| <pre>Close httplib2 connections.</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="get">get(project, interconnectLocation, x__xgafv=None)</code> | |
| <pre>Returns the details for the specified interconnect location. Gets a list of | |
| available interconnect locations by making a list() request. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| interconnectLocation: string, Name of the interconnect location to return. (required) | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Represents an Interconnect Attachment (VLAN) Location resource. | |
| # | |
| # You can use this resource to find location details about an Interconnect | |
| # attachment (VLAN). For more information about interconnect attachments, read | |
| # Creating VLAN Attachments. | |
| "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in | |
| # the address is separated by a newline character. | |
| "availabilityZone": "A String", # [Output Only] Availability zone for this InterconnectLocation. Within a | |
| # metropolitan area (metro), maintenance will not be simultaneously scheduled | |
| # in more than one availability zone. Example: "zone1" or "zone2". | |
| "availableFeatures": [ # [Output only] List of features available at this InterconnectLocation, | |
| # which can take one of the following values: | |
| # | |
| # - IF_MACSEC | |
| # - IF_CROSS_SITE_NETWORK | |
| "A String", | |
| ], | |
| "availableLinkTypes": [ # [Output only] List of link types available at this InterconnectLocation, | |
| # which can take one of the following values: | |
| # | |
| # - LINK_TYPE_ETHERNET_10G_LR | |
| # - LINK_TYPE_ETHERNET_100G_LR | |
| # - LINK_TYPE_ETHERNET_400G_LR4 | |
| "A String", | |
| ], | |
| "city": "A String", # [Output Only] Metropolitan area designator that indicates which city an | |
| # interconnect is located. | |
| # For example: "Chicago, IL", "Amsterdam, Netherlands". | |
| "continent": "A String", # [Output Only] Continent for this location, which can take one of the | |
| # following values: | |
| # | |
| # - AFRICA | |
| # - ASIA_PAC | |
| # - EUROPE | |
| # - NORTH_AMERICA | |
| # - SOUTH_AMERICA | |
| "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 | |
| # text format. | |
| "crossSiteInterconnectInfos": [ # [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo | |
| # objects, that describe where Cross-Site Interconnect wires may connect to | |
| # from this location and associated connection parameters. Cross-Site | |
| # Interconnect isn't allowed to locations which are not listed. | |
| { # Information about Cross-Site Interconnect wires which may be created | |
| # between the containing location and another remote location. | |
| "city": "A String", # Output only. The remote location for Cross-Site Interconnect wires. This specifies an | |
| # InterconnectLocation city (metropolitan area designator), which itself | |
| # may match multiple InterconnectLocations. | |
| "maxDynamicPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for dynamic paths allowable per | |
| # WireGroup for this metro. | |
| "maxFixedPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for fixed paths allowable per WireGroup | |
| # for this metro. | |
| "maxSingleFlowGbps": 42, # Output only. The maximum gbps for a single flow to this metro. | |
| # This limits the total bandwidth which may be configured per wire. | |
| }, | |
| ], | |
| "description": "A String", # Output only. [Output Only] An optional description of the resource. | |
| "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX). | |
| "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g., | |
| # Ashburn-DC1). | |
| "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is | |
| # defined by the server. | |
| "kind": "compute#interconnectLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. | |
| "name": "A String", # Output only. [Output Only] Name of the resource. | |
| "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding | |
| # with a netfac type in peeringdb). | |
| "regionInfos": [ # Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that | |
| # describe parameters pertaining to the relation between this | |
| # InterconnectLocation and various Google Cloud regions. | |
| { # Information about any potential InterconnectAttachments between an | |
| # Interconnect at a specific InterconnectLocation, and a specific Cloud | |
| # Region. | |
| "expectedRttMs": "A String", # Output only. Expected round-trip time in milliseconds, from this InterconnectLocation | |
| # to a VM in this region. | |
| "l2ForwardingEnabled": True or False, # Output only. Identifies whether L2 Interconnect Attachments can be created in this | |
| # region for interconnects that are in this location. | |
| "locationPresence": "A String", # Output only. Identifies the network presence of this location. | |
| "region": "A String", # Output only. URL for the region of this location. | |
| }, | |
| ], | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "singleRegionProductionCriticalPeerLocations": [ # Output only. [Output Only] URLs of the other locations that can pair up with this | |
| # location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and | |
| # iad-zone2-5467 are Single-Region 99.99% peer locations of each other. | |
| "A String", | |
| ], | |
| "status": "A String", # [Output Only] The status of this InterconnectLocation, which can take one | |
| # of the following values: | |
| # | |
| # - CLOSED: The InterconnectLocation is closed and is unavailable for | |
| # provisioning new Interconnects. | |
| # - AVAILABLE: The InterconnectLocation is available for provisioning new | |
| # Interconnects. | |
| "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use. | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code> | |
| <pre>Retrieves the list of interconnect locations available to the specified | |
| project. | |
| Args: | |
| project: string, Project ID for this request. (required) | |
| filter: string, A filter expression that filters resources listed in the response. Most | |
| Compute resources support two types of filter expressions: | |
| expressions that support regular expressions and expressions that follow | |
| API improvement proposal AIP-160. | |
| These two types of filter expressions cannot be mixed in one request. | |
| If you want to use AIP-160, your expression must specify the field name, an | |
| operator, and the value that you want to use for filtering. The value | |
| must be a string, a number, or a boolean. The operator | |
| must be either `=`, `!=`, `>`, `<`, `<=`, `>=` or `:`. | |
| For example, if you are filtering Compute Engine instances, you can | |
| exclude instances named `example-instance` by specifying | |
| `name != example-instance`. | |
| The `:*` comparison can be used to test whether a key has been defined. | |
| For example, to find all objects with `owner` label use: | |
| ``` | |
| labels.owner:* | |
| ``` | |
| You can also filter nested fields. For example, you could specify | |
| `scheduling.automaticRestart = false` to include instances only | |
| if they are not scheduled for automatic restarts. You can use filtering | |
| on nested fields to filter based onresource labels. | |
| To filter on multiple expressions, provide each separate expression within | |
| parentheses. For example: | |
| ``` | |
| (scheduling.automaticRestart = true) | |
| (cpuPlatform = "Intel Skylake") | |
| ``` | |
| By default, each expression is an `AND` expression. However, you | |
| can include `AND` and `OR` expressions explicitly. | |
| For example: | |
| ``` | |
| (cpuPlatform = "Intel Skylake") OR | |
| (cpuPlatform = "Intel Broadwell") AND | |
| (scheduling.automaticRestart = true) | |
| ``` | |
| If you want to use a regular expression, use the `eq` (equal) or `ne` | |
| (not equal) operator against a single un-parenthesized expression with or | |
| without quotes or against multiple parenthesized expressions. Examples: | |
| `fieldname eq unquoted literal` | |
| `fieldname eq 'single quoted literal'` | |
| `fieldname eq "double quoted literal"` | |
| `(fieldname1 eq literal) (fieldname2 ne "literal")` | |
| The literal value is interpreted as a regular expression using GoogleRE2 library syntax. | |
| The literal value must match the entire field. | |
| For example, to filter for instances that do not end with name "instance", | |
| you would use `name ne .*instance`. | |
| You cannot combine constraints on multiple fields using regular | |
| expressions. | |
| maxResults: integer, The maximum number of results per page that should be returned. | |
| If the number of available results is larger than `maxResults`, | |
| Compute Engine returns a `nextPageToken` that can be used to get | |
| the next page of results in subsequent list requests. Acceptable values are | |
| `0` to `500`, inclusive. (Default: `500`) | |
| orderBy: string, Sorts list results by a certain order. By default, results | |
| are returned in alphanumerical order based on the resource name. | |
| You can also sort results in descending order based on the creation | |
| timestamp using `orderBy="creationTimestamp desc"`. This sorts | |
| results based on the `creationTimestamp` field in | |
| reverse chronological order (newest result first). Use this to sort | |
| resources like operations so that the newest operation is returned first. | |
| Currently, only sorting by `name` or | |
| `creationTimestamp desc` is supported. | |
| pageToken: string, Specifies a page token to use. Set `pageToken` to the | |
| `nextPageToken` returned by a previous list request to get | |
| the next page of results. | |
| returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case | |
| of failure. The default value is false. | |
| For example, when partial success behavior is enabled, aggregatedList for a | |
| single zone scope either returns all resources in the zone or no resources, | |
| with an error code. | |
| x__xgafv: string, V1 error format. | |
| Allowed values | |
| 1 - v1 error format | |
| 2 - v2 error format | |
| Returns: | |
| An object of the form: | |
| { # Response to the list request, and contains a list of interconnect locations. | |
| "id": "A String", # [Output Only] Unique identifier for the resource; defined by the server. | |
| "items": [ # A list of InterconnectLocation resources. | |
| { # Represents an Interconnect Attachment (VLAN) Location resource. | |
| # | |
| # You can use this resource to find location details about an Interconnect | |
| # attachment (VLAN). For more information about interconnect attachments, read | |
| # Creating VLAN Attachments. | |
| "address": "A String", # Output only. [Output Only] The postal address of the Point of Presence, each line in | |
| # the address is separated by a newline character. | |
| "availabilityZone": "A String", # [Output Only] Availability zone for this InterconnectLocation. Within a | |
| # metropolitan area (metro), maintenance will not be simultaneously scheduled | |
| # in more than one availability zone. Example: "zone1" or "zone2". | |
| "availableFeatures": [ # [Output only] List of features available at this InterconnectLocation, | |
| # which can take one of the following values: | |
| # | |
| # - IF_MACSEC | |
| # - IF_CROSS_SITE_NETWORK | |
| "A String", | |
| ], | |
| "availableLinkTypes": [ # [Output only] List of link types available at this InterconnectLocation, | |
| # which can take one of the following values: | |
| # | |
| # - LINK_TYPE_ETHERNET_10G_LR | |
| # - LINK_TYPE_ETHERNET_100G_LR | |
| # - LINK_TYPE_ETHERNET_400G_LR4 | |
| "A String", | |
| ], | |
| "city": "A String", # [Output Only] Metropolitan area designator that indicates which city an | |
| # interconnect is located. | |
| # For example: "Chicago, IL", "Amsterdam, Netherlands". | |
| "continent": "A String", # [Output Only] Continent for this location, which can take one of the | |
| # following values: | |
| # | |
| # - AFRICA | |
| # - ASIA_PAC | |
| # - EUROPE | |
| # - NORTH_AMERICA | |
| # - SOUTH_AMERICA | |
| "creationTimestamp": "A String", # Output only. [Output Only] Creation timestamp inRFC3339 | |
| # text format. | |
| "crossSiteInterconnectInfos": [ # [Output Only] A list of InterconnectLocation.CrossSiteInterconnectInfo | |
| # objects, that describe where Cross-Site Interconnect wires may connect to | |
| # from this location and associated connection parameters. Cross-Site | |
| # Interconnect isn't allowed to locations which are not listed. | |
| { # Information about Cross-Site Interconnect wires which may be created | |
| # between the containing location and another remote location. | |
| "city": "A String", # Output only. The remote location for Cross-Site Interconnect wires. This specifies an | |
| # InterconnectLocation city (metropolitan area designator), which itself | |
| # may match multiple InterconnectLocations. | |
| "maxDynamicPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for dynamic paths allowable per | |
| # WireGroup for this metro. | |
| "maxFixedPathBandwidthGbps": "A String", # Output only. The maximum unmetered bandwidth for fixed paths allowable per WireGroup | |
| # for this metro. | |
| "maxSingleFlowGbps": 42, # Output only. The maximum gbps for a single flow to this metro. | |
| # This limits the total bandwidth which may be configured per wire. | |
| }, | |
| ], | |
| "description": "A String", # Output only. [Output Only] An optional description of the resource. | |
| "facilityProvider": "A String", # Output only. [Output Only] The name of the provider for this facility (e.g., EQUINIX). | |
| "facilityProviderFacilityId": "A String", # Output only. [Output Only] A provider-assigned Identifier for this facility (e.g., | |
| # Ashburn-DC1). | |
| "id": "A String", # Output only. [Output Only] The unique identifier for the resource. This identifier is | |
| # defined by the server. | |
| "kind": "compute#interconnectLocation", # Output only. [Output Only] Type of the resource. Alwayscompute#interconnectLocation for interconnect locations. | |
| "name": "A String", # Output only. [Output Only] Name of the resource. | |
| "peeringdbFacilityId": "A String", # Output only. [Output Only] The peeringdb identifier for this facility (corresponding | |
| # with a netfac type in peeringdb). | |
| "regionInfos": [ # Output only. [Output Only] A list of InterconnectLocation.RegionInfo objects, that | |
| # describe parameters pertaining to the relation between this | |
| # InterconnectLocation and various Google Cloud regions. | |
| { # Information about any potential InterconnectAttachments between an | |
| # Interconnect at a specific InterconnectLocation, and a specific Cloud | |
| # Region. | |
| "expectedRttMs": "A String", # Output only. Expected round-trip time in milliseconds, from this InterconnectLocation | |
| # to a VM in this region. | |
| "l2ForwardingEnabled": True or False, # Output only. Identifies whether L2 Interconnect Attachments can be created in this | |
| # region for interconnects that are in this location. | |
| "locationPresence": "A String", # Output only. Identifies the network presence of this location. | |
| "region": "A String", # Output only. URL for the region of this location. | |
| }, | |
| ], | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined URL for the resource. | |
| "selfLinkWithId": "A String", # Output only. [Output Only] Server-defined URL for this resource with the resource id. | |
| "singleRegionProductionCriticalPeerLocations": [ # Output only. [Output Only] URLs of the other locations that can pair up with this | |
| # location to support Single-Region 99.99% SLA. E.g. iad-zone1-1 and | |
| # iad-zone2-5467 are Single-Region 99.99% peer locations of each other. | |
| "A String", | |
| ], | |
| "status": "A String", # [Output Only] The status of this InterconnectLocation, which can take one | |
| # of the following values: | |
| # | |
| # - CLOSED: The InterconnectLocation is closed and is unavailable for | |
| # provisioning new Interconnects. | |
| # - AVAILABLE: The InterconnectLocation is available for provisioning new | |
| # Interconnects. | |
| "supportsPzs": True or False, # Output only. [Output Only] Reserved for future use. | |
| }, | |
| ], | |
| "kind": "compute#interconnectLocationList", # Output only. [Output Only] Type of resource. Alwayscompute#interconnectLocationList for lists of interconnect | |
| # locations. | |
| "nextPageToken": "A String", # [Output Only] This token allows you to get the next page of results for | |
| # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for | |
| # the query parameter pageToken in the next list request. | |
| # Subsequent list requests will have their own nextPageToken to | |
| # continue paging through the results. | |
| "selfLink": "A String", # Output only. [Output Only] Server-defined URL for this resource. | |
| "warning": { # [Output Only] Informational warning message. | |
| "code": "A String", # [Output Only] A warning code, if applicable. For example, Compute | |
| # Engine returns NO_RESULTS_ON_PAGE if there | |
| # are no results in the response. | |
| "data": [ # [Output Only] Metadata about this warning in key: | |
| # value format. For example: | |
| # | |
| # "data": [ | |
| # { | |
| # "key": "scope", | |
| # "value": "zones/us-east1-d" | |
| # }] | |
| { | |
| "key": "A String", # [Output Only] A key that provides more detail on the warning being | |
| # returned. For example, for warnings where there are no results in a list | |
| # request for a particular zone, this key might be scope and | |
| # the key value might be the zone name. Other examples might be a key | |
| # indicating a deprecated resource and a suggested replacement, or a | |
| # warning about invalid network settings (for example, if an instance | |
| # attempts to perform IP forwarding but is not enabled for IP forwarding). | |
| "value": "A String", # [Output Only] A warning data value corresponding to the key. | |
| }, | |
| ], | |
| "message": "A String", # [Output Only] A human-readable description of the warning code. | |
| }, | |
| }</pre> | |
| </div> | |
| <div class="method"> | |
| <code class="details" id="list_next">list_next(previous_request, previous_response)</code> | |
| <pre>Retrieves the next page of results. | |
| Args: | |
| previous_request: The request for the previous page. (required) | |
| previous_response: The response from the request for the previous page. (required) | |
| Returns: | |
| A request object that you can call 'execute()' on to request the next | |
| page. Returns None if there are no more items in the collection. | |
| </pre> | |
| </div> | |
| </body></html> |