Service Networking API . services . projects . global_ . networks

Instance Methods

dnsZones()

Returns the dnsZones Resource.

peeredDnsDomains()

Returns the peeredDnsDomains Resource.

close()

Close httplib2 connections.

get(name, includeUsedIpRanges=None, x__xgafv=None)

Service producers use this method to get the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.

getVpcServiceControls(name, x__xgafv=None)

Consumers use this method to find out the state of VPC Service Controls. The controls could be enabled or disabled for a connection.

updateConsumerConfig(parent, body=None, x__xgafv=None)

Service producers use this method to update the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.

Method Details

close()
Close httplib2 connections.
get(name, includeUsedIpRanges=None, x__xgafv=None)
Service producers use this method to get the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.

Args:
  name: string, Required. Name of the consumer config to retrieve in the format: `services/{service}/projects/{project}/global/networks/{network}`. {service} is the peering service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is `servicenetworking.googleapis.com`. {project} is a project number e.g. `12345` that contains the service consumer's VPC network. {network} is the name of the service consumer's VPC network. (required)
  includeUsedIpRanges: boolean, Optional. When true, include the used IP ranges as part of the GetConsumerConfig output. This includes routes created inside the service networking network, consumer network, peers of the consumer network, and reserved ranges inside the service networking network. By default, this is false
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Configuration information for a private service access connection.
  "cloudsqlConfigs": [ # Represents one or multiple Cloud SQL configurations.
    { # Cloud SQL configuration.
      "service": "A String", # Peering service used for peering with the Cloud SQL project.
      "umbrellaNetwork": "A String", # The name of the umbrella network in the Cloud SQL umbrella project.
      "umbrellaProject": "A String", # The project number of the Cloud SQL umbrella project.
    },
  ],
  "consumerExportCustomRoutes": True or False, # Export custom routes flag value for peering from consumer to producer.
  "consumerExportSubnetRoutesWithPublicIp": True or False, # Export subnet routes with public ip flag value for peering from consumer to producer.
  "consumerImportCustomRoutes": True or False, # Import custom routes flag value for peering from consumer to producer.
  "consumerImportSubnetRoutesWithPublicIp": True or False, # Import subnet routes with public ip flag value for peering from consumer to producer.
  "producerExportCustomRoutes": True or False, # Export custom routes flag value for peering from producer to consumer.
  "producerExportSubnetRoutesWithPublicIp": True or False, # Export subnet routes with public ip flag value for peering from producer to consumer.
  "producerImportCustomRoutes": True or False, # Import custom routes flag value for peering from producer to consumer.
  "producerImportSubnetRoutesWithPublicIp": True or False, # Import subnet routes with public ip flag value for peering from producer to consumer.
  "producerNetwork": "A String", # Output only. The VPC host network that is used to host managed service instances. In the format, projects/{project}/global/networks/{network} where {project} is the project number e.g. '12345' and {network} is the network name.
  "reservedRanges": [ # Output only. The reserved ranges associated with this private service access connection.
    { # Allocated IP address ranges for this private service access connection.
      "address": "A String", # The starting address of the reserved range. The address must be a valid IPv4 address in the x.x.x.x format. This value combined with the IP prefix length is the CIDR range for the reserved range.
      "ipPrefixLength": 42, # The prefix length of the reserved range.
      "name": "A String", # The name of the reserved range.
    },
  ],
  "usedIpRanges": [ # Output only. The IP ranges already in use by consumer or producer
    "A String",
  ],
  "vpcScReferenceArchitectureEnabled": True or False, # Output only. Indicates whether the VPC Service Controls reference architecture is configured for the producer VPC host network.
}
getVpcServiceControls(name, x__xgafv=None)
Consumers use this method to find out the state of VPC Service Controls. The controls could be enabled or disabled for a connection.

Args:
  name: string, Required. Name of the VPC Service Controls config to retrieve in the format: `services/{service}/projects/{project}/global/networks/{network}`. {service} is the peering service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is `servicenetworking.googleapis.com`. {project} is a project number e.g. `12345` that contains the service consumer's VPC network. {network} is the name of the service consumer's VPC network. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for the get VPC Service Controls request.
  "enabled": True or False, # Output only. Indicates whether the VPC Service Controls are enabled or disabled for the connection. If the consumer called the EnableVpcServiceControls method, then this is true. If the consumer called DisableVpcServiceControls, then this is false. The default is false.
}
updateConsumerConfig(parent, body=None, x__xgafv=None)
Service producers use this method to update the configuration of their connection including the import/export of custom routes and subnetwork routes with public IP.

Args:
  parent: string, Required. Parent resource identifying the connection for which the consumer config is being updated in the format: `services/{service}/projects/{project}/global/networks/{network}` {service} is the peering service that is managing connectivity for the service producer's organization. For Google services that support this functionality, this value is `servicenetworking.googleapis.com`. {project} is the number of the project that contains the service consumer's VPC network e.g. `12345`. {network} is the name of the service consumer's VPC network. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request to update the configuration of a service networking connection including the import/export of custom routes and subnetwork routes with public IP.
  "consumerConfig": { # Configuration information for a private service access connection. # Required. The updated peering config.
    "cloudsqlConfigs": [ # Represents one or multiple Cloud SQL configurations.
      { # Cloud SQL configuration.
        "service": "A String", # Peering service used for peering with the Cloud SQL project.
        "umbrellaNetwork": "A String", # The name of the umbrella network in the Cloud SQL umbrella project.
        "umbrellaProject": "A String", # The project number of the Cloud SQL umbrella project.
      },
    ],
    "consumerExportCustomRoutes": True or False, # Export custom routes flag value for peering from consumer to producer.
    "consumerExportSubnetRoutesWithPublicIp": True or False, # Export subnet routes with public ip flag value for peering from consumer to producer.
    "consumerImportCustomRoutes": True or False, # Import custom routes flag value for peering from consumer to producer.
    "consumerImportSubnetRoutesWithPublicIp": True or False, # Import subnet routes with public ip flag value for peering from consumer to producer.
    "producerExportCustomRoutes": True or False, # Export custom routes flag value for peering from producer to consumer.
    "producerExportSubnetRoutesWithPublicIp": True or False, # Export subnet routes with public ip flag value for peering from producer to consumer.
    "producerImportCustomRoutes": True or False, # Import custom routes flag value for peering from producer to consumer.
    "producerImportSubnetRoutesWithPublicIp": True or False, # Import subnet routes with public ip flag value for peering from producer to consumer.
    "producerNetwork": "A String", # Output only. The VPC host network that is used to host managed service instances. In the format, projects/{project}/global/networks/{network} where {project} is the project number e.g. '12345' and {network} is the network name.
    "reservedRanges": [ # Output only. The reserved ranges associated with this private service access connection.
      { # Allocated IP address ranges for this private service access connection.
        "address": "A String", # The starting address of the reserved range. The address must be a valid IPv4 address in the x.x.x.x format. This value combined with the IP prefix length is the CIDR range for the reserved range.
        "ipPrefixLength": 42, # The prefix length of the reserved range.
        "name": "A String", # The name of the reserved range.
      },
    ],
    "usedIpRanges": [ # Output only. The IP ranges already in use by consumer or producer
      "A String",
    ],
    "vpcScReferenceArchitectureEnabled": True or False, # Output only. Indicates whether the VPC Service Controls reference architecture is configured for the producer VPC host network.
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # This resource represents a long-running operation that is the result of a network API call.
  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
      {
        "a_key": "", # Properties of the object. Contains field @type with type URL.
      },
    ],
    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
  },
  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
  "response": { # The normal, successful response of the operation. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
    "a_key": "", # Properties of the object. Contains field @type with type URL.
  },
}