docs: docs update (#911)
Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code! That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)
Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/composer_v1beta1.projects.locations.environments.html b/docs/dyn/composer_v1beta1.projects.locations.environments.html
index c64c95f..c533ced 100644
--- a/docs/dyn/composer_v1beta1.projects.locations.environments.html
+++ b/docs/dyn/composer_v1beta1.projects.locations.environments.html
@@ -84,7 +84,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Get an existing environment.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</a></code></p>
+ <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
<p class="firstline">List environments.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -99,18 +99,13 @@
Args:
parent: string, The parent must be of the form
-"projects/{projectId}/locations/{locationId}". (required)
+"projects/{projectId}/locations/{locationId}". (required)
body: object, The request body.
The object takes the form of:
{ # An environment for running orchestration tasks.
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
- "name": "A String", # The resource name of the environment, in the form:
- # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
- #
- # EnvironmentId must start with a lowercase letter followed by up to 63
- # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- "labels": { # Optional. User-defined labels for this environment.
+ "createTime": "A String", # Output only. The time at which this environment was created.
+ "labels": { # Optional. User-defined labels for this environment.
# The labels map can contain no more than 64 entries. Entries of the labels
# map are UTF8 strings that comply with the following restrictions:
#
@@ -118,51 +113,77 @@
# * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
# * Both keys and values are additionally constrained to be <= 128 bytes in
# size.
- "a_key": "A String",
+ "a_key": "A String",
},
- "state": "A String", # The current state of the environment.
- "config": { # Configuration information for an environment. # Configuration parameters for this environment.
- "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "config": { # Configuration information for an environment. # Configuration parameters for this environment.
+ "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
+ # used to run this environment.
+ "databaseConfig": { # The configuration of Cloud SQL instance that is used by the Apache Airflow # Optional. The configuration settings for Cloud SQL instance used internally by Apache
+ # Airflow software.
+ # software.
+ "machineType": "A String", # Optional. Cloud SQL tier used by Airflow database.
+ # If not specified, db-n1-standard-2 will be used.
+ },
+ "webServerConfig": { # The configuration settings for the Airflow web server App Engine instance. # Optional. The configuration settings for the Airflow web server App Engine instance.
+ "machineType": "A String", # Optional. Machine type on which Airflow web server is running.
+ # For example: composer-n1-webserver-2, composer-n1-webserver-4,
+ # composer-n1-webserver-8.
+ # If not specified, composer-n1-webserver-2 will be used.
+ # Value custom is returned only in response, if Airflow web server parameters
+ # were manually changed to a non-standard values.
+ },
+ "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
+ # unspecified, no network-level access restrictions will be applied.
+ "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
+ { # Allowed IP range with user-provided description.
+ "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
+ # rule applies to.
+ # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
+ # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
+ #
+ #
+ # <p>IP range prefixes should be properly truncated. For example,
+ # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
+ # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
+ "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
+ },
+ ],
+ },
+ "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
# Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
+ # can be simulated using "/"-delimited object name prefixes. DAG objects for
# this environment reside in a simulated directory with the given prefix.
- "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
- "imageVersion": "A String", # The version of the software running in the environment.
- # This encapsulates both the version of Cloud Composer functionality and the
- # version of Apache Airflow. It must match the regular expression
- # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
- # When used as input, the server also checks if the provided version is
- # supported and denies the request for an unsupported version.
- #
- # The Cloud Composer portion of the version is a
- # [semantic version](https://semver.org) or `latest`. When the patch version
- # is omitted, the current Cloud Composer patch version is selected.
- # When `latest` is provided instead of an explicit version number,
- # the server replaces `latest` with the current Cloud Composer version
- # and stores that version number in the same field.
- #
- # The portion of the image version that follows <em>airflow-</em> is an
- # official Apache Airflow repository
- # [release name](https://github.com/apache/incubator-airflow/releases).
- #
- # See also [Version
- # List](/composer/docs/concepts/versioning/composer-versions).
- "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
- # the environment.
- #
- # Keys refer to the lowercase package name such as "numpy"
- # and values are the lowercase extras and version specifier such as
- # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
- # package without pinning it to a version specifier, use the empty string as
- # the value.
- "a_key": "A String",
+ "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
+ # environment.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is true, `use_ip_aliases` must be true.
+ "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
+ # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
+ "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
+ # Cloud Composer environment.
+ # environment.
+ "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
+ # left blank, the default value of '172.16.0.0/23' is used.
+ "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
+ # denied.
+ "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
+ # range is used for assigning internal IP addresses to the cluster
+ # master or set of masters and to the internal load balancer virtual IP.
+ # This range must not overlap with any other ranges in use
+ # within the cluster's network.
},
- "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
- # scheduler, worker, and webserver processes.
- #
- # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
- # updated.
- "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
+ "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
+ "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
+ # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
+ # cloud_sql_ipv4_cidr_block.
+ },
+ "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
+ "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
+ # [Airflow web
+ # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
+ "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
+ "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
# scheduler, worker, and webserver processes.
#
# Environment variable names must match the regular expression
@@ -184,16 +205,51 @@
# * `SQL_PROJECT`
# * `SQL_REGION`
# * `SQL_USER`
- "a_key": "A String",
+ "a_key": "A String",
},
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
+ # scheduler, worker, and webserver processes.
+ #
+ # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
+ # updated.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
+ #
+ # Keys refer to the lowercase package name such as "numpy"
+ # and values are the lowercase extras and version specifier such as
+ # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
+ # package without pinning it to a version specifier, use the empty string as
+ # the value.
+ "a_key": "A String",
+ },
+ "imageVersion": "A String", # The version of the software running in the environment.
+ # This encapsulates both the version of Cloud Composer functionality and the
+ # version of Apache Airflow. It must match the regular expression
+ # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
+ # When used as input, the server also checks if the provided version is
+ # supported and denies the request for an unsupported version.
+ #
+ # The Cloud Composer portion of the version is a
+ # [semantic version](https://semver.org) or `latest`. When the patch version
+ # is omitted, the current Cloud Composer patch version is selected.
+ # When `latest` is provided instead of an explicit version number,
+ # the server replaces `latest` with the current Cloud Composer version
+ # and stores that version number in the same field.
+ #
+ # The portion of the image version that follows <em>airflow-</em> is an
+ # official Apache Airflow repository
+ # [release name](https://github.com/apache/incubator-airflow/releases).
+ #
+ # See also [Version
+ # List](/composer/docs/concepts/versioning/composer-versions).
+ "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
#
# Property keys contain the section and property names, separated by a
- # hyphen, for example "core-dags_are_paused_at_creation". Section names must
- # not contain hyphens ("-"), opening square brackets ("["), or closing
- # square brackets ("]"). The property name must not be empty and must not
- # contain an equals sign ("=") or semicolon (";"). Section and property names
- # must not contain a period ("."). Apache Airflow configuration property
+ # hyphen, for example "core-dags_are_paused_at_creation". Section names must
+ # not contain hyphens ("-"), opening square brackets ("["), or closing
+ # square brackets ("]"). The property name must not be empty and must not
+ # contain an equals sign ("=") or semicolon (";"). Section and property names
+ # must not contain a period ("."). Apache Airflow configuration property
# names must be written in
# [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can
# contain any character, and can be written in any lower/upper case format.
@@ -201,83 +257,35 @@
# Certain Apache Airflow configuration property values are
# [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
# and cannot be overridden.
- "a_key": "A String",
+ "a_key": "A String",
},
},
- "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
- # [Airflow web
- # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
- "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
- # unspecified, no network-level access restrictions will be applied.
- "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
- { # Allowed IP range with user-provided description.
- "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
- "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
- # rule applies to.
- # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
- # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
- #
- #
- # <p>IP range prefixes should be properly truncated. For example,
- # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
- # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
- },
- ],
- },
- "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
- "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
# the Apache Airflow software.
- "machineType": "A String", # Optional. The Compute Engine
- # [machine type](/compute/docs/machine-types) used for cluster instances,
- # specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
- #
- # The `machineType` must belong to the enclosing environment's project and
- # location. If both this field and `nodeConfig.location` are specified,
- # this `machineType` must belong to the `nodeConfig.location`; if both are
- # unspecified, the service will pick a zone in the Compute Engine region
- # corresponding to the Cloud Composer location, and propagate that choice to
- # both fields. If exactly one of this field and `nodeConfig.location` is
- # specified, the location information from the specified field will be
- # propagated to the unspecified field.
- #
- # The `machineTypeId` must not be a [shared-core machine
- # type](/compute/docs/machine-types#sharedcore).
- #
- # If this field is unspecified, the `machineTypeId` defaults
- # to "n1-standard-1".
- "network": "A String", # Optional. The Compute Engine network to be used for machine
+ "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
+ # node VMs. If `oauth_scopes` is empty, defaults to
+ # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
+ "A String",
+ ],
+ "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
# communications, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/global/networks/{networkId}".
+ # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
#
- # If unspecified, the default network in the environment's project is used.
- # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
- # is provided, `nodeConfig.subnetwork` must also be provided. For
- # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
- # `nodeConfig.subnetwork`.
- "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
- # to identify valid sources or targets for network firewalls. Each tag within
- # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
- # Cannot be updated.
- "A String",
- ],
- "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
- # VMs. If a service account is not specified, the "default" Compute Engine
- # service account is used. Cannot be updated.
- "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
- # node VMs. If `oauth_scopes` is empty, defaults to
- # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
- "A String",
- ],
- "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
- # If unspecified, defaults to 100GB. Cannot be updated.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
+ # If a subnetwork is provided, `nodeConfig.network` must also be provided,
+ # and the subnetwork must belong to the enclosing environment's project and
+ # location.
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
# GKE cluster.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the cluster. Specify either `services_secondary_range_name`
+ # or `services_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
+ # If `true`, a VPC-native cluster is created.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
# the cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -294,7 +302,12 @@
# to use.
# Specify `cluster_secondary_range_name` or `cluster_ipv4_cidr_block`
# but not both.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
+ # IP addresses to pods. Specify either `cluster_secondary_range_name`
+ # or `cluster_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
# cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -311,35 +324,25 @@
# to use.
# Specify `services_secondary_range_name` or `services_ipv4_cidr_block`
# but not both.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the cluster. Specify either `services_secondary_range_name`
- # or `services_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
- # IP addresses to pods. Specify either `cluster_secondary_range_name`
- # or `cluster_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
},
- "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
- # communications, specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
- #
- # If a subnetwork is provided, `nodeConfig.network` must also be provided,
- # and the subnetwork must belong to the enclosing environment's project and
- # location.
- "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
+ "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
+ # If unspecified, defaults to 100GB. Cannot be updated.
+ "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
+ # to identify valid sources or targets for network firewalls. Each tag within
+ # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
+ # Cannot be updated.
+ "A String",
+ ],
+ "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
+ # VMs. If a service account is not specified, the "default" Compute Engine
+ # service account is used. Cannot be updated.
+ "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
# to deploy the VMs used to run the Apache Airflow software, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}".
+ # "projects/{projectId}/zones/{zoneId}".
#
- # This `location` must belong to the enclosing environment's project and
+ # This `location` must belong to the enclosing environment's project and
# location. If both this field and `nodeConfig.machineType` are specified,
# `nodeConfig.machineType` must belong to this `location`; if both are
# unspecified, the service will pick a zone in the Compute Engine region
@@ -347,36 +350,47 @@
# both fields. If only one field (`location` or `nodeConfig.machineType`) is
# specified, the location information from the specified field will be
# propagated to the unspecified field.
- },
- "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
- # used to run this environment.
- "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
- # environment.
- "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
- # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
- "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
- # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
- # cloud_sql_ipv4_cidr_block.
- "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is true, `use_ip_aliases` must be true.
- "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
- # Cloud Composer environment.
- # environment.
- "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
- # denied.
- "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
- # range is used for assigning internal IP addresses to the cluster
- # master or set of masters and to the internal load balancer virtual IP.
- # This range must not overlap with any other ranges in use
- # within the cluster's network.
- "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
- # left blank, the default value of '172.16.0.0/23' is used.
- },
+ "machineType": "A String", # Optional. The Compute Engine
+ # [machine type](/compute/docs/machine-types) used for cluster instances,
+ # specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
+ #
+ # The `machineType` must belong to the enclosing environment's project and
+ # location. If both this field and `nodeConfig.location` are specified,
+ # this `machineType` must belong to the `nodeConfig.location`; if both are
+ # unspecified, the service will pick a zone in the Compute Engine region
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # both fields. If exactly one of this field and `nodeConfig.location` is
+ # specified, the location information from the specified field will be
+ # propagated to the unspecified field.
+ #
+ # The `machineTypeId` must not be a [shared-core machine
+ # type](/compute/docs/machine-types#sharedcore).
+ #
+ # If this field is unspecified, the `machineTypeId` defaults
+ # to "n1-standard-1".
+ "network": "A String", # Optional. The Compute Engine network to be used for machine
+ # communications, specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/global/networks/{networkId}".
+ #
+ # If unspecified, the default network in the environment's project is used.
+ # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
+ # is provided, `nodeConfig.subnetwork` must also be provided. For
+ # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
+ # `nodeConfig.subnetwork`.
},
},
- "createTime": "A String", # Output only. The time at which this environment was created.
- "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
+ "state": "A String", # The current state of the environment.
+ "name": "A String", # The resource name of the environment, in the form:
+ # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
+ #
+ # EnvironmentId must start with a lowercase letter followed by up to 63
+ # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
+ "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
# This value is generated when the environment is created.
}
@@ -390,28 +404,16 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
- # 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).
- "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.
- "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.
- },
- ],
+ "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.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ "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.
- "response": { # The normal response of the operation in case of success. If the original
+ "response": { # The normal response of the operation in case of success. 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
@@ -419,16 +421,28 @@
# 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.
+ "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
+ "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}`.
- "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.
+ "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+ # 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).
+ "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.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
},
}</pre>
</div>
@@ -439,7 +453,7 @@
Args:
name: string, The environment to delete, in the form:
-"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
+"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -450,28 +464,16 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
- # 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).
- "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.
- "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.
- },
- ],
+ "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.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ "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.
- "response": { # The normal response of the operation in case of success. If the original
+ "response": { # The normal response of the operation in case of success. 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
@@ -479,16 +481,28 @@
# 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.
+ "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
+ "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}`.
- "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.
+ "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+ # 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).
+ "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.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
},
}</pre>
</div>
@@ -499,7 +513,7 @@
Args:
name: string, The resource name of the environment to get, in the form:
-"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
+"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -509,13 +523,8 @@
An object of the form:
{ # An environment for running orchestration tasks.
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
- "name": "A String", # The resource name of the environment, in the form:
- # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
- #
- # EnvironmentId must start with a lowercase letter followed by up to 63
- # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- "labels": { # Optional. User-defined labels for this environment.
+ "createTime": "A String", # Output only. The time at which this environment was created.
+ "labels": { # Optional. User-defined labels for this environment.
# The labels map can contain no more than 64 entries. Entries of the labels
# map are UTF8 strings that comply with the following restrictions:
#
@@ -523,51 +532,77 @@
# * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
# * Both keys and values are additionally constrained to be <= 128 bytes in
# size.
- "a_key": "A String",
+ "a_key": "A String",
},
- "state": "A String", # The current state of the environment.
- "config": { # Configuration information for an environment. # Configuration parameters for this environment.
- "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "config": { # Configuration information for an environment. # Configuration parameters for this environment.
+ "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
+ # used to run this environment.
+ "databaseConfig": { # The configuration of Cloud SQL instance that is used by the Apache Airflow # Optional. The configuration settings for Cloud SQL instance used internally by Apache
+ # Airflow software.
+ # software.
+ "machineType": "A String", # Optional. Cloud SQL tier used by Airflow database.
+ # If not specified, db-n1-standard-2 will be used.
+ },
+ "webServerConfig": { # The configuration settings for the Airflow web server App Engine instance. # Optional. The configuration settings for the Airflow web server App Engine instance.
+ "machineType": "A String", # Optional. Machine type on which Airflow web server is running.
+ # For example: composer-n1-webserver-2, composer-n1-webserver-4,
+ # composer-n1-webserver-8.
+ # If not specified, composer-n1-webserver-2 will be used.
+ # Value custom is returned only in response, if Airflow web server parameters
+ # were manually changed to a non-standard values.
+ },
+ "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
+ # unspecified, no network-level access restrictions will be applied.
+ "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
+ { # Allowed IP range with user-provided description.
+ "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
+ # rule applies to.
+ # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
+ # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
+ #
+ #
+ # <p>IP range prefixes should be properly truncated. For example,
+ # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
+ # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
+ "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
+ },
+ ],
+ },
+ "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
# Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
+ # can be simulated using "/"-delimited object name prefixes. DAG objects for
# this environment reside in a simulated directory with the given prefix.
- "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
- "imageVersion": "A String", # The version of the software running in the environment.
- # This encapsulates both the version of Cloud Composer functionality and the
- # version of Apache Airflow. It must match the regular expression
- # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
- # When used as input, the server also checks if the provided version is
- # supported and denies the request for an unsupported version.
- #
- # The Cloud Composer portion of the version is a
- # [semantic version](https://semver.org) or `latest`. When the patch version
- # is omitted, the current Cloud Composer patch version is selected.
- # When `latest` is provided instead of an explicit version number,
- # the server replaces `latest` with the current Cloud Composer version
- # and stores that version number in the same field.
- #
- # The portion of the image version that follows <em>airflow-</em> is an
- # official Apache Airflow repository
- # [release name](https://github.com/apache/incubator-airflow/releases).
- #
- # See also [Version
- # List](/composer/docs/concepts/versioning/composer-versions).
- "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
- # the environment.
- #
- # Keys refer to the lowercase package name such as "numpy"
- # and values are the lowercase extras and version specifier such as
- # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
- # package without pinning it to a version specifier, use the empty string as
- # the value.
- "a_key": "A String",
+ "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
+ # environment.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is true, `use_ip_aliases` must be true.
+ "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
+ # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
+ "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
+ # Cloud Composer environment.
+ # environment.
+ "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
+ # left blank, the default value of '172.16.0.0/23' is used.
+ "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
+ # denied.
+ "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
+ # range is used for assigning internal IP addresses to the cluster
+ # master or set of masters and to the internal load balancer virtual IP.
+ # This range must not overlap with any other ranges in use
+ # within the cluster's network.
},
- "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
- # scheduler, worker, and webserver processes.
- #
- # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
- # updated.
- "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
+ "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
+ "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
+ # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
+ # cloud_sql_ipv4_cidr_block.
+ },
+ "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
+ "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
+ # [Airflow web
+ # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
+ "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
+ "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
# scheduler, worker, and webserver processes.
#
# Environment variable names must match the regular expression
@@ -589,16 +624,51 @@
# * `SQL_PROJECT`
# * `SQL_REGION`
# * `SQL_USER`
- "a_key": "A String",
+ "a_key": "A String",
},
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
+ # scheduler, worker, and webserver processes.
+ #
+ # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
+ # updated.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
+ #
+ # Keys refer to the lowercase package name such as "numpy"
+ # and values are the lowercase extras and version specifier such as
+ # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
+ # package without pinning it to a version specifier, use the empty string as
+ # the value.
+ "a_key": "A String",
+ },
+ "imageVersion": "A String", # The version of the software running in the environment.
+ # This encapsulates both the version of Cloud Composer functionality and the
+ # version of Apache Airflow. It must match the regular expression
+ # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
+ # When used as input, the server also checks if the provided version is
+ # supported and denies the request for an unsupported version.
+ #
+ # The Cloud Composer portion of the version is a
+ # [semantic version](https://semver.org) or `latest`. When the patch version
+ # is omitted, the current Cloud Composer patch version is selected.
+ # When `latest` is provided instead of an explicit version number,
+ # the server replaces `latest` with the current Cloud Composer version
+ # and stores that version number in the same field.
+ #
+ # The portion of the image version that follows <em>airflow-</em> is an
+ # official Apache Airflow repository
+ # [release name](https://github.com/apache/incubator-airflow/releases).
+ #
+ # See also [Version
+ # List](/composer/docs/concepts/versioning/composer-versions).
+ "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
#
# Property keys contain the section and property names, separated by a
- # hyphen, for example "core-dags_are_paused_at_creation". Section names must
- # not contain hyphens ("-"), opening square brackets ("["), or closing
- # square brackets ("]"). The property name must not be empty and must not
- # contain an equals sign ("=") or semicolon (";"). Section and property names
- # must not contain a period ("."). Apache Airflow configuration property
+ # hyphen, for example "core-dags_are_paused_at_creation". Section names must
+ # not contain hyphens ("-"), opening square brackets ("["), or closing
+ # square brackets ("]"). The property name must not be empty and must not
+ # contain an equals sign ("=") or semicolon (";"). Section and property names
+ # must not contain a period ("."). Apache Airflow configuration property
# names must be written in
# [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can
# contain any character, and can be written in any lower/upper case format.
@@ -606,83 +676,35 @@
# Certain Apache Airflow configuration property values are
# [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
# and cannot be overridden.
- "a_key": "A String",
+ "a_key": "A String",
},
},
- "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
- # [Airflow web
- # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
- "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
- # unspecified, no network-level access restrictions will be applied.
- "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
- { # Allowed IP range with user-provided description.
- "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
- "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
- # rule applies to.
- # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
- # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
- #
- #
- # <p>IP range prefixes should be properly truncated. For example,
- # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
- # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
- },
- ],
- },
- "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
- "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
# the Apache Airflow software.
- "machineType": "A String", # Optional. The Compute Engine
- # [machine type](/compute/docs/machine-types) used for cluster instances,
- # specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
- #
- # The `machineType` must belong to the enclosing environment's project and
- # location. If both this field and `nodeConfig.location` are specified,
- # this `machineType` must belong to the `nodeConfig.location`; if both are
- # unspecified, the service will pick a zone in the Compute Engine region
- # corresponding to the Cloud Composer location, and propagate that choice to
- # both fields. If exactly one of this field and `nodeConfig.location` is
- # specified, the location information from the specified field will be
- # propagated to the unspecified field.
- #
- # The `machineTypeId` must not be a [shared-core machine
- # type](/compute/docs/machine-types#sharedcore).
- #
- # If this field is unspecified, the `machineTypeId` defaults
- # to "n1-standard-1".
- "network": "A String", # Optional. The Compute Engine network to be used for machine
+ "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
+ # node VMs. If `oauth_scopes` is empty, defaults to
+ # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
+ "A String",
+ ],
+ "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
# communications, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/global/networks/{networkId}".
+ # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
#
- # If unspecified, the default network in the environment's project is used.
- # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
- # is provided, `nodeConfig.subnetwork` must also be provided. For
- # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
- # `nodeConfig.subnetwork`.
- "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
- # to identify valid sources or targets for network firewalls. Each tag within
- # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
- # Cannot be updated.
- "A String",
- ],
- "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
- # VMs. If a service account is not specified, the "default" Compute Engine
- # service account is used. Cannot be updated.
- "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
- # node VMs. If `oauth_scopes` is empty, defaults to
- # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
- "A String",
- ],
- "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
- # If unspecified, defaults to 100GB. Cannot be updated.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
+ # If a subnetwork is provided, `nodeConfig.network` must also be provided,
+ # and the subnetwork must belong to the enclosing environment's project and
+ # location.
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
# GKE cluster.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the cluster. Specify either `services_secondary_range_name`
+ # or `services_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
+ # If `true`, a VPC-native cluster is created.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
# the cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -699,7 +721,12 @@
# to use.
# Specify `cluster_secondary_range_name` or `cluster_ipv4_cidr_block`
# but not both.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
+ # IP addresses to pods. Specify either `cluster_secondary_range_name`
+ # or `cluster_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
# cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -716,35 +743,25 @@
# to use.
# Specify `services_secondary_range_name` or `services_ipv4_cidr_block`
# but not both.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the cluster. Specify either `services_secondary_range_name`
- # or `services_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
- # IP addresses to pods. Specify either `cluster_secondary_range_name`
- # or `cluster_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
},
- "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
- # communications, specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
- #
- # If a subnetwork is provided, `nodeConfig.network` must also be provided,
- # and the subnetwork must belong to the enclosing environment's project and
- # location.
- "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
+ "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
+ # If unspecified, defaults to 100GB. Cannot be updated.
+ "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
+ # to identify valid sources or targets for network firewalls. Each tag within
+ # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
+ # Cannot be updated.
+ "A String",
+ ],
+ "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
+ # VMs. If a service account is not specified, the "default" Compute Engine
+ # service account is used. Cannot be updated.
+ "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
# to deploy the VMs used to run the Apache Airflow software, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}".
+ # "projects/{projectId}/zones/{zoneId}".
#
- # This `location` must belong to the enclosing environment's project and
+ # This `location` must belong to the enclosing environment's project and
# location. If both this field and `nodeConfig.machineType` are specified,
# `nodeConfig.machineType` must belong to this `location`; if both are
# unspecified, the service will pick a zone in the Compute Engine region
@@ -752,68 +769,74 @@
# both fields. If only one field (`location` or `nodeConfig.machineType`) is
# specified, the location information from the specified field will be
# propagated to the unspecified field.
- },
- "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
- # used to run this environment.
- "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
- # environment.
- "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
- # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
- "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
- # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
- # cloud_sql_ipv4_cidr_block.
- "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is true, `use_ip_aliases` must be true.
- "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
- # Cloud Composer environment.
- # environment.
- "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
- # denied.
- "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
- # range is used for assigning internal IP addresses to the cluster
- # master or set of masters and to the internal load balancer virtual IP.
- # This range must not overlap with any other ranges in use
- # within the cluster's network.
- "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
- # left blank, the default value of '172.16.0.0/23' is used.
- },
+ "machineType": "A String", # Optional. The Compute Engine
+ # [machine type](/compute/docs/machine-types) used for cluster instances,
+ # specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
+ #
+ # The `machineType` must belong to the enclosing environment's project and
+ # location. If both this field and `nodeConfig.location` are specified,
+ # this `machineType` must belong to the `nodeConfig.location`; if both are
+ # unspecified, the service will pick a zone in the Compute Engine region
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # both fields. If exactly one of this field and `nodeConfig.location` is
+ # specified, the location information from the specified field will be
+ # propagated to the unspecified field.
+ #
+ # The `machineTypeId` must not be a [shared-core machine
+ # type](/compute/docs/machine-types#sharedcore).
+ #
+ # If this field is unspecified, the `machineTypeId` defaults
+ # to "n1-standard-1".
+ "network": "A String", # Optional. The Compute Engine network to be used for machine
+ # communications, specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/global/networks/{networkId}".
+ #
+ # If unspecified, the default network in the environment's project is used.
+ # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
+ # is provided, `nodeConfig.subnetwork` must also be provided. For
+ # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
+ # `nodeConfig.subnetwork`.
},
},
- "createTime": "A String", # Output only. The time at which this environment was created.
- "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
+ "state": "A String", # The current state of the environment.
+ "name": "A String", # The resource name of the environment, in the form:
+ # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
+ #
+ # EnvironmentId must start with a lowercase letter followed by up to 63
+ # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
+ "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
# This value is generated when the environment is created.
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, x__xgafv=None, pageSize=None)</code>
+ <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
<pre>List environments.
Args:
parent: string, List environments in the given project and location, in the form:
-"projects/{projectId}/locations/{locationId}" (required)
+"projects/{projectId}/locations/{locationId}" (required)
pageToken: string, The next_page_token value returned from a previous List request, if any.
+ pageSize: integer, The maximum number of environments to return.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
- pageSize: integer, The maximum number of environments to return.
Returns:
An object of the form:
{ # The environments in a project and location.
- "nextPageToken": "A String", # The page token used to query for the next page if one exists.
- "environments": [ # The list of environments returned by a ListEnvironmentsRequest.
+ "nextPageToken": "A String", # The page token used to query for the next page if one exists.
+ "environments": [ # The list of environments returned by a ListEnvironmentsRequest.
{ # An environment for running orchestration tasks.
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
- "name": "A String", # The resource name of the environment, in the form:
- # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
- #
- # EnvironmentId must start with a lowercase letter followed by up to 63
- # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- "labels": { # Optional. User-defined labels for this environment.
+ "createTime": "A String", # Output only. The time at which this environment was created.
+ "labels": { # Optional. User-defined labels for this environment.
# The labels map can contain no more than 64 entries. Entries of the labels
# map are UTF8 strings that comply with the following restrictions:
#
@@ -821,51 +844,77 @@
# * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
# * Both keys and values are additionally constrained to be <= 128 bytes in
# size.
- "a_key": "A String",
+ "a_key": "A String",
},
- "state": "A String", # The current state of the environment.
- "config": { # Configuration information for an environment. # Configuration parameters for this environment.
- "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "config": { # Configuration information for an environment. # Configuration parameters for this environment.
+ "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
+ # used to run this environment.
+ "databaseConfig": { # The configuration of Cloud SQL instance that is used by the Apache Airflow # Optional. The configuration settings for Cloud SQL instance used internally by Apache
+ # Airflow software.
+ # software.
+ "machineType": "A String", # Optional. Cloud SQL tier used by Airflow database.
+ # If not specified, db-n1-standard-2 will be used.
+ },
+ "webServerConfig": { # The configuration settings for the Airflow web server App Engine instance. # Optional. The configuration settings for the Airflow web server App Engine instance.
+ "machineType": "A String", # Optional. Machine type on which Airflow web server is running.
+ # For example: composer-n1-webserver-2, composer-n1-webserver-4,
+ # composer-n1-webserver-8.
+ # If not specified, composer-n1-webserver-2 will be used.
+ # Value custom is returned only in response, if Airflow web server parameters
+ # were manually changed to a non-standard values.
+ },
+ "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
+ # unspecified, no network-level access restrictions will be applied.
+ "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
+ { # Allowed IP range with user-provided description.
+ "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
+ # rule applies to.
+ # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
+ # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
+ #
+ #
+ # <p>IP range prefixes should be properly truncated. For example,
+ # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
+ # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
+ "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
+ },
+ ],
+ },
+ "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
# Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
+ # can be simulated using "/"-delimited object name prefixes. DAG objects for
# this environment reside in a simulated directory with the given prefix.
- "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
- "imageVersion": "A String", # The version of the software running in the environment.
- # This encapsulates both the version of Cloud Composer functionality and the
- # version of Apache Airflow. It must match the regular expression
- # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
- # When used as input, the server also checks if the provided version is
- # supported and denies the request for an unsupported version.
- #
- # The Cloud Composer portion of the version is a
- # [semantic version](https://semver.org) or `latest`. When the patch version
- # is omitted, the current Cloud Composer patch version is selected.
- # When `latest` is provided instead of an explicit version number,
- # the server replaces `latest` with the current Cloud Composer version
- # and stores that version number in the same field.
- #
- # The portion of the image version that follows <em>airflow-</em> is an
- # official Apache Airflow repository
- # [release name](https://github.com/apache/incubator-airflow/releases).
- #
- # See also [Version
- # List](/composer/docs/concepts/versioning/composer-versions).
- "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
- # the environment.
- #
- # Keys refer to the lowercase package name such as "numpy"
- # and values are the lowercase extras and version specifier such as
- # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
- # package without pinning it to a version specifier, use the empty string as
- # the value.
- "a_key": "A String",
+ "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
+ # environment.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is true, `use_ip_aliases` must be true.
+ "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
+ # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
+ "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
+ # Cloud Composer environment.
+ # environment.
+ "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
+ # left blank, the default value of '172.16.0.0/23' is used.
+ "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
+ # denied.
+ "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
+ # range is used for assigning internal IP addresses to the cluster
+ # master or set of masters and to the internal load balancer virtual IP.
+ # This range must not overlap with any other ranges in use
+ # within the cluster's network.
},
- "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
- # scheduler, worker, and webserver processes.
- #
- # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
- # updated.
- "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
+ "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
+ "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
+ # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
+ # cloud_sql_ipv4_cidr_block.
+ },
+ "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
+ "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
+ # [Airflow web
+ # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
+ "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
+ "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
# scheduler, worker, and webserver processes.
#
# Environment variable names must match the regular expression
@@ -887,16 +936,51 @@
# * `SQL_PROJECT`
# * `SQL_REGION`
# * `SQL_USER`
- "a_key": "A String",
+ "a_key": "A String",
},
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
+ # scheduler, worker, and webserver processes.
+ #
+ # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
+ # updated.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
+ #
+ # Keys refer to the lowercase package name such as "numpy"
+ # and values are the lowercase extras and version specifier such as
+ # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
+ # package without pinning it to a version specifier, use the empty string as
+ # the value.
+ "a_key": "A String",
+ },
+ "imageVersion": "A String", # The version of the software running in the environment.
+ # This encapsulates both the version of Cloud Composer functionality and the
+ # version of Apache Airflow. It must match the regular expression
+ # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
+ # When used as input, the server also checks if the provided version is
+ # supported and denies the request for an unsupported version.
+ #
+ # The Cloud Composer portion of the version is a
+ # [semantic version](https://semver.org) or `latest`. When the patch version
+ # is omitted, the current Cloud Composer patch version is selected.
+ # When `latest` is provided instead of an explicit version number,
+ # the server replaces `latest` with the current Cloud Composer version
+ # and stores that version number in the same field.
+ #
+ # The portion of the image version that follows <em>airflow-</em> is an
+ # official Apache Airflow repository
+ # [release name](https://github.com/apache/incubator-airflow/releases).
+ #
+ # See also [Version
+ # List](/composer/docs/concepts/versioning/composer-versions).
+ "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
#
# Property keys contain the section and property names, separated by a
- # hyphen, for example "core-dags_are_paused_at_creation". Section names must
- # not contain hyphens ("-"), opening square brackets ("["), or closing
- # square brackets ("]"). The property name must not be empty and must not
- # contain an equals sign ("=") or semicolon (";"). Section and property names
- # must not contain a period ("."). Apache Airflow configuration property
+ # hyphen, for example "core-dags_are_paused_at_creation". Section names must
+ # not contain hyphens ("-"), opening square brackets ("["), or closing
+ # square brackets ("]"). The property name must not be empty and must not
+ # contain an equals sign ("=") or semicolon (";"). Section and property names
+ # must not contain a period ("."). Apache Airflow configuration property
# names must be written in
# [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can
# contain any character, and can be written in any lower/upper case format.
@@ -904,83 +988,35 @@
# Certain Apache Airflow configuration property values are
# [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
# and cannot be overridden.
- "a_key": "A String",
+ "a_key": "A String",
},
},
- "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
- # [Airflow web
- # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
- "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
- # unspecified, no network-level access restrictions will be applied.
- "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
- { # Allowed IP range with user-provided description.
- "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
- "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
- # rule applies to.
- # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
- # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
- #
- #
- # <p>IP range prefixes should be properly truncated. For example,
- # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
- # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
- },
- ],
- },
- "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
- "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
# the Apache Airflow software.
- "machineType": "A String", # Optional. The Compute Engine
- # [machine type](/compute/docs/machine-types) used for cluster instances,
- # specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
- #
- # The `machineType` must belong to the enclosing environment's project and
- # location. If both this field and `nodeConfig.location` are specified,
- # this `machineType` must belong to the `nodeConfig.location`; if both are
- # unspecified, the service will pick a zone in the Compute Engine region
- # corresponding to the Cloud Composer location, and propagate that choice to
- # both fields. If exactly one of this field and `nodeConfig.location` is
- # specified, the location information from the specified field will be
- # propagated to the unspecified field.
- #
- # The `machineTypeId` must not be a [shared-core machine
- # type](/compute/docs/machine-types#sharedcore).
- #
- # If this field is unspecified, the `machineTypeId` defaults
- # to "n1-standard-1".
- "network": "A String", # Optional. The Compute Engine network to be used for machine
+ "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
+ # node VMs. If `oauth_scopes` is empty, defaults to
+ # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
+ "A String",
+ ],
+ "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
# communications, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/global/networks/{networkId}".
+ # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
#
- # If unspecified, the default network in the environment's project is used.
- # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
- # is provided, `nodeConfig.subnetwork` must also be provided. For
- # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
- # `nodeConfig.subnetwork`.
- "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
- # to identify valid sources or targets for network firewalls. Each tag within
- # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
- # Cannot be updated.
- "A String",
- ],
- "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
- # VMs. If a service account is not specified, the "default" Compute Engine
- # service account is used. Cannot be updated.
- "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
- # node VMs. If `oauth_scopes` is empty, defaults to
- # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
- "A String",
- ],
- "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
- # If unspecified, defaults to 100GB. Cannot be updated.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
+ # If a subnetwork is provided, `nodeConfig.network` must also be provided,
+ # and the subnetwork must belong to the enclosing environment's project and
+ # location.
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
# GKE cluster.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the cluster. Specify either `services_secondary_range_name`
+ # or `services_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
+ # If `true`, a VPC-native cluster is created.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
# the cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -997,7 +1033,12 @@
# to use.
# Specify `cluster_secondary_range_name` or `cluster_ipv4_cidr_block`
# but not both.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
+ # IP addresses to pods. Specify either `cluster_secondary_range_name`
+ # or `cluster_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
# cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -1014,35 +1055,25 @@
# to use.
# Specify `services_secondary_range_name` or `services_ipv4_cidr_block`
# but not both.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the cluster. Specify either `services_secondary_range_name`
- # or `services_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
- # IP addresses to pods. Specify either `cluster_secondary_range_name`
- # or `cluster_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
},
- "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
- # communications, specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
- #
- # If a subnetwork is provided, `nodeConfig.network` must also be provided,
- # and the subnetwork must belong to the enclosing environment's project and
- # location.
- "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
+ "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
+ # If unspecified, defaults to 100GB. Cannot be updated.
+ "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
+ # to identify valid sources or targets for network firewalls. Each tag within
+ # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
+ # Cannot be updated.
+ "A String",
+ ],
+ "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
+ # VMs. If a service account is not specified, the "default" Compute Engine
+ # service account is used. Cannot be updated.
+ "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
# to deploy the VMs used to run the Apache Airflow software, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}".
+ # "projects/{projectId}/zones/{zoneId}".
#
- # This `location` must belong to the enclosing environment's project and
+ # This `location` must belong to the enclosing environment's project and
# location. If both this field and `nodeConfig.machineType` are specified,
# `nodeConfig.machineType` must belong to this `location`; if both are
# unspecified, the service will pick a zone in the Compute Engine region
@@ -1050,36 +1081,47 @@
# both fields. If only one field (`location` or `nodeConfig.machineType`) is
# specified, the location information from the specified field will be
# propagated to the unspecified field.
- },
- "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
- # used to run this environment.
- "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
- # environment.
- "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
- # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
- "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
- # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
- # cloud_sql_ipv4_cidr_block.
- "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is true, `use_ip_aliases` must be true.
- "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
- # Cloud Composer environment.
- # environment.
- "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
- # denied.
- "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
- # range is used for assigning internal IP addresses to the cluster
- # master or set of masters and to the internal load balancer virtual IP.
- # This range must not overlap with any other ranges in use
- # within the cluster's network.
- "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
- # left blank, the default value of '172.16.0.0/23' is used.
- },
+ "machineType": "A String", # Optional. The Compute Engine
+ # [machine type](/compute/docs/machine-types) used for cluster instances,
+ # specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
+ #
+ # The `machineType` must belong to the enclosing environment's project and
+ # location. If both this field and `nodeConfig.location` are specified,
+ # this `machineType` must belong to the `nodeConfig.location`; if both are
+ # unspecified, the service will pick a zone in the Compute Engine region
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # both fields. If exactly one of this field and `nodeConfig.location` is
+ # specified, the location information from the specified field will be
+ # propagated to the unspecified field.
+ #
+ # The `machineTypeId` must not be a [shared-core machine
+ # type](/compute/docs/machine-types#sharedcore).
+ #
+ # If this field is unspecified, the `machineTypeId` defaults
+ # to "n1-standard-1".
+ "network": "A String", # Optional. The Compute Engine network to be used for machine
+ # communications, specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/global/networks/{networkId}".
+ #
+ # If unspecified, the default network in the environment's project is used.
+ # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
+ # is provided, `nodeConfig.subnetwork` must also be provided. For
+ # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
+ # `nodeConfig.subnetwork`.
},
},
- "createTime": "A String", # Output only. The time at which this environment was created.
- "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
+ "state": "A String", # The current state of the environment.
+ "name": "A String", # The resource name of the environment, in the form:
+ # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
+ #
+ # EnvironmentId must start with a lowercase letter followed by up to 63
+ # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
+ "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
# This value is generated when the environment is created.
},
],
@@ -1095,7 +1137,7 @@
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
+ 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>
@@ -1106,18 +1148,13 @@
Args:
name: string, The relative resource name of the environment to update, in the form:
-"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
+"projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
body: object, The request body.
The object takes the form of:
{ # An environment for running orchestration tasks.
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
- "name": "A String", # The resource name of the environment, in the form:
- # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
- #
- # EnvironmentId must start with a lowercase letter followed by up to 63
- # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
- "labels": { # Optional. User-defined labels for this environment.
+ "createTime": "A String", # Output only. The time at which this environment was created.
+ "labels": { # Optional. User-defined labels for this environment.
# The labels map can contain no more than 64 entries. Entries of the labels
# map are UTF8 strings that comply with the following restrictions:
#
@@ -1125,51 +1162,77 @@
# * Values must conform to regexp: [\p{Ll}\p{Lo}\p{N}_-]{0,63}
# * Both keys and values are additionally constrained to be <= 128 bytes in
# size.
- "a_key": "A String",
+ "a_key": "A String",
},
- "state": "A String", # The current state of the environment.
- "config": { # Configuration information for an environment. # Configuration parameters for this environment.
- "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "config": { # Configuration information for an environment. # Configuration parameters for this environment.
+ "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
+ # used to run this environment.
+ "databaseConfig": { # The configuration of Cloud SQL instance that is used by the Apache Airflow # Optional. The configuration settings for Cloud SQL instance used internally by Apache
+ # Airflow software.
+ # software.
+ "machineType": "A String", # Optional. Cloud SQL tier used by Airflow database.
+ # If not specified, db-n1-standard-2 will be used.
+ },
+ "webServerConfig": { # The configuration settings for the Airflow web server App Engine instance. # Optional. The configuration settings for the Airflow web server App Engine instance.
+ "machineType": "A String", # Optional. Machine type on which Airflow web server is running.
+ # For example: composer-n1-webserver-2, composer-n1-webserver-4,
+ # composer-n1-webserver-8.
+ # If not specified, composer-n1-webserver-2 will be used.
+ # Value custom is returned only in response, if Airflow web server parameters
+ # were manually changed to a non-standard values.
+ },
+ "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
+ # unspecified, no network-level access restrictions will be applied.
+ "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
+ { # Allowed IP range with user-provided description.
+ "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
+ # rule applies to.
+ # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
+ # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
+ #
+ #
+ # <p>IP range prefixes should be properly truncated. For example,
+ # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
+ # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
+ "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
+ },
+ ],
+ },
+ "dagGcsPrefix": "A String", # Output only. The Cloud Storage prefix of the DAGs for this environment. Although Cloud
# Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
+ # can be simulated using "/"-delimited object name prefixes. DAG objects for
# this environment reside in a simulated directory with the given prefix.
- "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
- "imageVersion": "A String", # The version of the software running in the environment.
- # This encapsulates both the version of Cloud Composer functionality and the
- # version of Apache Airflow. It must match the regular expression
- # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
- # When used as input, the server also checks if the provided version is
- # supported and denies the request for an unsupported version.
- #
- # The Cloud Composer portion of the version is a
- # [semantic version](https://semver.org) or `latest`. When the patch version
- # is omitted, the current Cloud Composer patch version is selected.
- # When `latest` is provided instead of an explicit version number,
- # the server replaces `latest` with the current Cloud Composer version
- # and stores that version number in the same field.
- #
- # The portion of the image version that follows <em>airflow-</em> is an
- # official Apache Airflow repository
- # [release name](https://github.com/apache/incubator-airflow/releases).
- #
- # See also [Version
- # List](/composer/docs/concepts/versioning/composer-versions).
- "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
- # the environment.
- #
- # Keys refer to the lowercase package name such as "numpy"
- # and values are the lowercase extras and version specifier such as
- # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
- # package without pinning it to a version specifier, use the empty string as
- # the value.
- "a_key": "A String",
+ "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
+ # environment.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is true, `use_ip_aliases` must be true.
+ "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
+ # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
+ "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
+ # Cloud Composer environment.
+ # environment.
+ "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
+ # left blank, the default value of '172.16.0.0/23' is used.
+ "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
+ # denied.
+ "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
+ # range is used for assigning internal IP addresses to the cluster
+ # master or set of masters and to the internal load balancer virtual IP.
+ # This range must not overlap with any other ranges in use
+ # within the cluster's network.
},
- "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
- # scheduler, worker, and webserver processes.
- #
- # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
- # updated.
- "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
+ "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
+ "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
+ # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
+ # cloud_sql_ipv4_cidr_block.
+ },
+ "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
+ "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
+ # [Airflow web
+ # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
+ "softwareConfig": { # Specifies the selection and configuration of software inside the environment. # The configuration settings for software inside the environment.
+ "envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
# scheduler, worker, and webserver processes.
#
# Environment variable names must match the regular expression
@@ -1191,16 +1254,51 @@
# * `SQL_PROJECT`
# * `SQL_REGION`
# * `SQL_USER`
- "a_key": "A String",
+ "a_key": "A String",
},
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pythonVersion": "A String", # Optional. The major version of Python used to run the Apache Airflow
+ # scheduler, worker, and webserver processes.
+ #
+ # Can be set to '2' or '3'. If not specified, the default is '2'. Cannot be
+ # updated.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
+ #
+ # Keys refer to the lowercase package name such as "numpy"
+ # and values are the lowercase extras and version specifier such as
+ # "==1.12.0", "[devel,gcp_api]", or "[devel]>=1.8.2, <1.9.2". To specify a
+ # package without pinning it to a version specifier, use the empty string as
+ # the value.
+ "a_key": "A String",
+ },
+ "imageVersion": "A String", # The version of the software running in the environment.
+ # This encapsulates both the version of Cloud Composer functionality and the
+ # version of Apache Airflow. It must match the regular expression
+ # `composer-([0-9]+\.[0-9]+\.[0-9]+|latest)-airflow-[0-9]+\.[0-9]+(\.[0-9]+.*)?`.
+ # When used as input, the server also checks if the provided version is
+ # supported and denies the request for an unsupported version.
+ #
+ # The Cloud Composer portion of the version is a
+ # [semantic version](https://semver.org) or `latest`. When the patch version
+ # is omitted, the current Cloud Composer patch version is selected.
+ # When `latest` is provided instead of an explicit version number,
+ # the server replaces `latest` with the current Cloud Composer version
+ # and stores that version number in the same field.
+ #
+ # The portion of the image version that follows <em>airflow-</em> is an
+ # official Apache Airflow repository
+ # [release name](https://github.com/apache/incubator-airflow/releases).
+ #
+ # See also [Version
+ # List](/composer/docs/concepts/versioning/composer-versions).
+ "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
#
# Property keys contain the section and property names, separated by a
- # hyphen, for example "core-dags_are_paused_at_creation". Section names must
- # not contain hyphens ("-"), opening square brackets ("["), or closing
- # square brackets ("]"). The property name must not be empty and must not
- # contain an equals sign ("=") or semicolon (";"). Section and property names
- # must not contain a period ("."). Apache Airflow configuration property
+ # hyphen, for example "core-dags_are_paused_at_creation". Section names must
+ # not contain hyphens ("-"), opening square brackets ("["), or closing
+ # square brackets ("]"). The property name must not be empty and must not
+ # contain an equals sign ("=") or semicolon (";"). Section and property names
+ # must not contain a period ("."). Apache Airflow configuration property
# names must be written in
# [snake_case](https://en.wikipedia.org/wiki/Snake_case). Property values can
# contain any character, and can be written in any lower/upper case format.
@@ -1208,83 +1306,35 @@
# Certain Apache Airflow configuration property values are
# [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
# and cannot be overridden.
- "a_key": "A String",
+ "a_key": "A String",
},
},
- "airflowUri": "A String", # Output only. The URI of the Apache Airflow Web UI hosted within this environment (see
- # [Airflow web
- # interface](/composer/docs/how-to/accessing/airflow-web-interface)).
- "webServerNetworkAccessControl": { # Network-level access control policy for the Airflow web server. # Optional. The network-level access control policy for the Airflow web server. If
- # unspecified, no network-level access restrictions will be applied.
- "allowedIpRanges": [ # A collection of allowed IP ranges with descriptions.
- { # Allowed IP range with user-provided description.
- "description": "A String", # Optional. User-provided description. It must contain at most 300 characters.
- "value": "A String", # IP address or range, defined using CIDR notation, of requests that this
- # rule applies to.
- # Examples: `192.168.1.1` or `192.168.0.0/16` or `2001:db8::/32`
- # or `2001:0db8:0000:0042:0000:8a2e:0370:7334`.
- #
- #
- # <p>IP range prefixes should be properly truncated. For example,
- # `1.2.3.4/24` should be truncated to `1.2.3.0/24`. Similarly, for IPv6,
- # `2001:db8::1/32` should be truncated to `2001:db8::/32`.
- },
- ],
- },
- "gkeCluster": "A String", # Output only. The Kubernetes Engine cluster used to run this environment.
- "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
# the Apache Airflow software.
- "machineType": "A String", # Optional. The Compute Engine
- # [machine type](/compute/docs/machine-types) used for cluster instances,
- # specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
- #
- # The `machineType` must belong to the enclosing environment's project and
- # location. If both this field and `nodeConfig.location` are specified,
- # this `machineType` must belong to the `nodeConfig.location`; if both are
- # unspecified, the service will pick a zone in the Compute Engine region
- # corresponding to the Cloud Composer location, and propagate that choice to
- # both fields. If exactly one of this field and `nodeConfig.location` is
- # specified, the location information from the specified field will be
- # propagated to the unspecified field.
- #
- # The `machineTypeId` must not be a [shared-core machine
- # type](/compute/docs/machine-types#sharedcore).
- #
- # If this field is unspecified, the `machineTypeId` defaults
- # to "n1-standard-1".
- "network": "A String", # Optional. The Compute Engine network to be used for machine
+ "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
+ # node VMs. If `oauth_scopes` is empty, defaults to
+ # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
+ "A String",
+ ],
+ "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
# communications, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/global/networks/{networkId}".
+ # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
#
- # If unspecified, the default network in the environment's project is used.
- # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
- # is provided, `nodeConfig.subnetwork` must also be provided. For
- # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
- # `nodeConfig.subnetwork`.
- "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
- # to identify valid sources or targets for network firewalls. Each tag within
- # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
- # Cannot be updated.
- "A String",
- ],
- "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
- # VMs. If a service account is not specified, the "default" Compute Engine
- # service account is used. Cannot be updated.
- "oauthScopes": [ # Optional. The set of Google API scopes to be made available on all
- # node VMs. If `oauth_scopes` is empty, defaults to
- # ["https://www.googleapis.com/auth/cloud-platform"]. Cannot be updated.
- "A String",
- ],
- "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
- # If unspecified, defaults to 100GB. Cannot be updated.
- "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
+ # If a subnetwork is provided, `nodeConfig.network` must also be provided,
+ # and the subnetwork must belong to the enclosing environment's project and
+ # location.
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The IPAllocationPolicy fields for the GKE cluster.
# GKE cluster.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the cluster. Specify either `services_secondary_range_name`
+ # or `services_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
+ # If `true`, a VPC-native cluster is created.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
# the cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -1301,7 +1351,12 @@
# to use.
# Specify `cluster_secondary_range_name` or `cluster_ipv4_cidr_block`
# but not both.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
+ # IP addresses to pods. Specify either `cluster_secondary_range_name`
+ # or `cluster_ipv4_cidr_block` but not both.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
# cluster.
#
# This field is applicable only when `use_ip_aliases` is true.
@@ -1318,35 +1373,25 @@
# to use.
# Specify `services_secondary_range_name` or `services_ipv4_cidr_block`
# but not both.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the cluster. Specify either `services_secondary_range_name`
- # or `services_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the cluster's secondary range used to allocate
- # IP addresses to pods. Specify either `cluster_secondary_range_name`
- # or `cluster_ipv4_cidr_block` but not both.
- #
- # This field is applicable only when `use_ip_aliases` is true.
},
- "subnetwork": "A String", # Optional. The Compute Engine subnetwork to be used for machine
- # communications, specified as a
- # [relative resource
- # name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/regions/{regionId}/subnetworks/{subnetworkId}"
- #
- # If a subnetwork is provided, `nodeConfig.network` must also be provided,
- # and the subnetwork must belong to the enclosing environment's project and
- # location.
- "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
+ "diskSizeGb": 42, # Optional. The disk size in GB used for node VMs. Minimum size is 20GB.
+ # If unspecified, defaults to 100GB. Cannot be updated.
+ "tags": [ # Optional. The list of instance tags applied to all node VMs. Tags are used
+ # to identify valid sources or targets for network firewalls. Each tag within
+ # the list must comply with [RFC1035](https://www.ietf.org/rfc/rfc1035.txt).
+ # Cannot be updated.
+ "A String",
+ ],
+ "serviceAccount": "A String", # Optional. The Google Cloud Platform Service Account to be used by the node
+ # VMs. If a service account is not specified, the "default" Compute Engine
+ # service account is used. Cannot be updated.
+ "location": "A String", # Optional. The Compute Engine [zone](/compute/docs/regions-zones) in which
# to deploy the VMs used to run the Apache Airflow software, specified as a
# [relative resource
# name](/apis/design/resource_names#relative_resource_name). For example:
- # "projects/{projectId}/zones/{zoneId}".
+ # "projects/{projectId}/zones/{zoneId}".
#
- # This `location` must belong to the enclosing environment's project and
+ # This `location` must belong to the enclosing environment's project and
# location. If both this field and `nodeConfig.machineType` are specified,
# `nodeConfig.machineType` must belong to this `location`; if both are
# unspecified, the service will pick a zone in the Compute Engine region
@@ -1354,36 +1399,47 @@
# both fields. If only one field (`location` or `nodeConfig.machineType`) is
# specified, the location information from the specified field will be
# propagated to the unspecified field.
- },
- "nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
- # used to run this environment.
- "privateEnvironmentConfig": { # The configuration information for configuring a Private IP Cloud Composer # The configuration used for the Private IP Cloud Composer environment.
- # environment.
- "cloudSqlIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range in tenant project will be reserved for
- # Cloud SQL. Needs to be disjoint from web_server_ipv4_cidr_block
- "webServerIpv4CidrBlock": "A String", # Optional. The CIDR block from which IP range for web server will be reserved. Needs
- # to be disjoint from private_cluster_config.master_ipv4_cidr_block and
- # cloud_sql_ipv4_cidr_block.
- "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is true, `use_ip_aliases` must be true.
- "privateClusterConfig": { # Configuration options for the private GKE cluster in a Cloud Composer # Optional. Configuration for the private GKE cluster for a Private IP
- # Cloud Composer environment.
- # environment.
- "enablePrivateEndpoint": True or False, # Optional. If `true`, access to the public endpoint of the GKE cluster is
- # denied.
- "masterIpv4ReservedRange": "A String", # Output only. The IP range in CIDR notation to use for the hosted master network. This
- # range is used for assigning internal IP addresses to the cluster
- # master or set of masters and to the internal load balancer virtual IP.
- # This range must not overlap with any other ranges in use
- # within the cluster's network.
- "masterIpv4CidrBlock": "A String", # Optional. The CIDR block from which IPv4 range for GKE master will be reserved. If
- # left blank, the default value of '172.16.0.0/23' is used.
- },
+ "machineType": "A String", # Optional. The Compute Engine
+ # [machine type](/compute/docs/machine-types) used for cluster instances,
+ # specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/zones/{zoneId}/machineTypes/{machineTypeId}".
+ #
+ # The `machineType` must belong to the enclosing environment's project and
+ # location. If both this field and `nodeConfig.location` are specified,
+ # this `machineType` must belong to the `nodeConfig.location`; if both are
+ # unspecified, the service will pick a zone in the Compute Engine region
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # both fields. If exactly one of this field and `nodeConfig.location` is
+ # specified, the location information from the specified field will be
+ # propagated to the unspecified field.
+ #
+ # The `machineTypeId` must not be a [shared-core machine
+ # type](/compute/docs/machine-types#sharedcore).
+ #
+ # If this field is unspecified, the `machineTypeId` defaults
+ # to "n1-standard-1".
+ "network": "A String", # Optional. The Compute Engine network to be used for machine
+ # communications, specified as a
+ # [relative resource
+ # name](/apis/design/resource_names#relative_resource_name). For example:
+ # "projects/{projectId}/global/networks/{networkId}".
+ #
+ # If unspecified, the default network in the environment's project is used.
+ # If a [Custom Subnet Network](/vpc/docs/vpc#vpc_networks_and_subnets)
+ # is provided, `nodeConfig.subnetwork` must also be provided. For
+ # [Shared VPC](/vpc/docs/shared-vpc) subnetwork requirements, see
+ # `nodeConfig.subnetwork`.
},
},
- "createTime": "A String", # Output only. The time at which this environment was created.
- "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
+ "state": "A String", # The current state of the environment.
+ "name": "A String", # The resource name of the environment, in the form:
+ # "projects/{projectId}/locations/{locationId}/environments/{environmentId}"
+ #
+ # EnvironmentId must start with a lowercase letter followed by up to 63
+ # lowercase letters, numbers, or hyphens, and cannot end with a hyphen.
+ "uuid": "A String", # Output only. The UUID (Universally Unique IDentifier) associated with this environment.
# This value is generated when the environment is created.
}
@@ -1392,15 +1448,15 @@
For example, to set the version of scikit-learn to install in the
environment to 0.19.0 and to remove an existing installation of
argparse, the `updateMask` parameter would include the following two
-`paths` values: "config.softwareConfig.pypiPackages.scikit-learn" and
-"config.softwareConfig.pypiPackages.argparse". The included patch
+`paths` values: "config.softwareConfig.pypiPackages.scikit-learn" and
+"config.softwareConfig.pypiPackages.argparse". The included patch
environment would specify the scikit-learn version as follows:
{
- "config":{
- "softwareConfig":{
- "pypiPackages":{
- "scikit-learn":"==0.19.0"
+ "config":{
+ "softwareConfig":{
+ "pypiPackages":{
+ "scikit-learn":"==0.19.0"
}
}
}
@@ -1409,19 +1465,19 @@
Note that in the above example, any existing PyPI packages
other than scikit-learn and argparse will be unaffected.
-Only one update type may be included in a single request's `updateMask`.
+Only one update type may be included in a single request's `updateMask`.
For example, one cannot update both the PyPI packages and
labels in the same request. However, it is possible to update multiple
members of a map field simultaneously in the same request. For example,
-to set the labels "label1" and "label2" while clearing "label3" (assuming
+to set the labels "label1" and "label2" while clearing "label3" (assuming
it already exists), one can
-provide the paths "labels.label1", "labels.label2", and "labels.label3"
+provide the paths "labels.label1", "labels.label2", and "labels.label3"
and populate the patch environment as follows:
{
- "labels":{
- "label1":"new-label1-value"
- "label2":"new-label2-value"
+ "labels":{
+ "label1":"new-label1-value"
+ "label2":"new-label2-value"
}
}
@@ -1429,18 +1485,18 @@
included in the `updateMask` will be unaffected.
It is also possible to replace an entire map field by providing the
-map field's path in the `updateMask`. The new value of the field will
+map field's path in the `updateMask`. The new value of the field will
be that which is provided in the patch environment. For example, to
delete all pre-existing user-specified PyPI packages and
install botocore at version 1.7.14, the `updateMask` would contain
-the path "config.softwareConfig.pypiPackages", and
+the path "config.softwareConfig.pypiPackages", and
the patch environment would be the following:
{
- "config":{
- "softwareConfig":{
- "pypiPackages":{
- "botocore":"==1.7.14"
+ "config":{
+ "softwareConfig":{
+ "pypiPackages":{
+ "botocore":"==1.7.14"
}
}
}
@@ -1469,7 +1525,7 @@
`updateMask`, and omit the mapping for it in
`environment.config.softwareConfig.pypiPackages`. It is an error
to provide both a mask of this form and the
- "config.softwareConfig.pypiPackages" mask.</td>
+ "config.softwareConfig.pypiPackages" mask.</td>
</tr>
<tr>
<td>labels</td>
@@ -1483,7 +1539,7 @@
<td>Set the label named <var>labelName</var>, while preserving other
labels. To delete the label, include it in `updateMask` and omit its
mapping in `environment.labels`. It is an error to provide both a
- mask of this form and the "labels" mask.</td>
+ mask of this form and the "labels" mask.</td>
</tr>
<tr>
<td>config.nodeCount</td>
@@ -1493,6 +1549,11 @@
</td>
</tr>
<tr>
+ <td>config.webServerNetworkAccessControl</td>
+ <td>Replace the environment's current WebServerNetworkAccessControl.
+ </td>
+ </tr>
+ <tr>
<td>config.softwareConfig.airflowConfigOverrides</td>
<td>Replace all Apache Airflow config overrides. If a replacement config
overrides map is not included in `environment`, all config overrides
@@ -1508,7 +1569,7 @@
the property override, include it in `updateMask` and omit its mapping
in `environment.config.softwareConfig.airflowConfigOverrides`.
It is an error to provide both a mask of this form and the
- "config.softwareConfig.airflowConfigOverrides" mask.</td>
+ "config.softwareConfig.airflowConfigOverrides" mask.</td>
</tr>
<tr>
<td>config.softwareConfig.envVariables</td>
@@ -1523,9 +1584,9 @@
<td>Upgrade the version of the environment in-place. Refer to
`SoftwareConfig.image_version` for information on how to format the new
image version. Additionally, the new image version cannot effect a version
- downgrade and must match the current image version's Composer major
+ downgrade and must match the current image version's Composer major
version and Airflow major and minor versions. Consult the
- <a href="/composer/docs/concepts/versioning/composer-versions">Cloud
+ <a href="/composer/docs/concepts/versioning/composer-versions">Cloud
Composer Version List</a> for valid values.</td>
</tr>
</tbody>
@@ -1540,28 +1601,16 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
- # 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).
- "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.
- "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.
- },
- ],
+ "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.
},
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
+ "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.
- "response": { # The normal response of the operation in case of success. If the original
+ "response": { # The normal response of the operation in case of success. 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
@@ -1569,16 +1618,28 @@
# 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.
+ "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
+ "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}`.
- "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.
+ "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+ # 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).
+ "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.
+ },
+ ],
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "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.
},
}</pre>
</div>