docs: update generated docs (#981)
diff --git a/docs/dyn/composer_v1.projects.locations.environments.html b/docs/dyn/composer_v1.projects.locations.environments.html
index 03dc4e5..034a192 100644
--- a/docs/dyn/composer_v1.projects.locations.environments.html
+++ b/docs/dyn/composer_v1.projects.locations.environments.html
@@ -104,7 +104,8 @@
The object takes the form of:
{ # An environment for running orchestration tasks.
- "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.
+ # This value is generated when the environment is 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:
@@ -115,159 +116,60 @@
# size.
"a_key": "A String",
},
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "createTime": "A String", # Output only. The time at which this environment was created.
"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
- # Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
- # this environment reside in a simulated directory with the given prefix.
+ "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)).
"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`.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
+ # set to 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.
- "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.
"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 GKE 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.
},
"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`.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
- # set to 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`.
},
- "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.
- # the Apache Airflow software.
- "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.
- "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 configuration for controlling how IPs are allocated in the GKE cluster.
- # GKE cluster running the Apache Airflow software.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
- # GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
- # IP addresses to pods.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
- # the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- },
- "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}".
- #
- # 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
- # corresponding to the Cloud Composer location, and propagate that choice to
- # 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.
- "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}".
- #
- # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
- # network must belong to the environment's project. If unspecified, the
- # "default" network ID 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.
- "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",
- ],
- },
- "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.
+ "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
+ # 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.
+ #
+ # 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",
+ },
+ "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.
"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
@@ -288,21 +190,14 @@
#
# See also [Version
# List](/composer/docs/concepts/versioning/composer-versions).
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
#
- # 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
- # 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.
- #
- # Certain Apache Airflow configuration property values are
- # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
- # and cannot be overridden.
+ # 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",
},
"envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
@@ -329,33 +224,138 @@
# * `SQL_USER`
"a_key": "A String",
},
- "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",
- },
},
"nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
# used to run this environment.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ # the Apache Airflow software.
+ "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",
+ ],
+ "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".
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The configuration for controlling how IPs are allocated in the GKE cluster.
+ # GKE cluster running the Apache Airflow software.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ # the GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ # GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
+ # IP addresses to pods.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the GKE cluster.
+ #
+ # 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.
+ },
+ "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}".
+ #
+ # 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
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # 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.
+ "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.
+ "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",
+ ],
+ "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}".
+ #
+ # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
+ # network must belong to the environment's project. If unspecified, the
+ # "default" network ID 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.
+ },
+ "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
+ # this environment reside in a simulated directory with the given prefix.
},
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
"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.
}
x__xgafv: string, V1 error format.
@@ -368,9 +368,9 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
"response": { # The normal 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
@@ -381,9 +381,15 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
+ "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.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
"error": { # The `Status` type defines a logical error model that is suitable for # 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
@@ -397,16 +403,10 @@
"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.
- },
- "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.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
}</pre>
</div>
@@ -428,9 +428,9 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
"response": { # The normal 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
@@ -441,9 +441,15 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
+ "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.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
"error": { # The `Status` type defines a logical error model that is suitable for # 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
@@ -457,16 +463,10 @@
"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.
- },
- "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.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
}</pre>
</div>
@@ -487,7 +487,8 @@
An object of the form:
{ # An environment for running orchestration tasks.
- "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.
+ # This value is generated when the environment is 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:
@@ -498,159 +499,60 @@
# size.
"a_key": "A String",
},
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "createTime": "A String", # Output only. The time at which this environment was created.
"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
- # Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
- # this environment reside in a simulated directory with the given prefix.
+ "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)).
"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`.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
+ # set to 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.
- "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.
"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 GKE 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.
},
"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`.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
- # set to 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`.
},
- "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.
- # the Apache Airflow software.
- "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.
- "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 configuration for controlling how IPs are allocated in the GKE cluster.
- # GKE cluster running the Apache Airflow software.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
- # GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
- # IP addresses to pods.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
- # the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- },
- "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}".
- #
- # 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
- # corresponding to the Cloud Composer location, and propagate that choice to
- # 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.
- "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}".
- #
- # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
- # network must belong to the environment's project. If unspecified, the
- # "default" network ID 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.
- "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",
- ],
- },
- "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.
+ "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
+ # 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.
+ #
+ # 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",
+ },
+ "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.
"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
@@ -671,21 +573,14 @@
#
# See also [Version
# List](/composer/docs/concepts/versioning/composer-versions).
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
#
- # 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
- # 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.
- #
- # Certain Apache Airflow configuration property values are
- # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
- # and cannot be overridden.
+ # 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",
},
"envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
@@ -712,33 +607,138 @@
# * `SQL_USER`
"a_key": "A String",
},
- "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",
- },
},
"nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
# used to run this environment.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ # the Apache Airflow software.
+ "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",
+ ],
+ "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".
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The configuration for controlling how IPs are allocated in the GKE cluster.
+ # GKE cluster running the Apache Airflow software.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ # the GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ # GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
+ # IP addresses to pods.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the GKE cluster.
+ #
+ # 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.
+ },
+ "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}".
+ #
+ # 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
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # 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.
+ "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.
+ "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",
+ ],
+ "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}".
+ #
+ # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
+ # network must belong to the environment's project. If unspecified, the
+ # "default" network ID 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.
+ },
+ "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
+ # this environment reside in a simulated directory with the given prefix.
},
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
"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>
@@ -760,9 +760,11 @@
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.
{ # An environment for running orchestration tasks.
- "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.
+ # This value is generated when the environment is 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:
@@ -773,159 +775,60 @@
# size.
"a_key": "A String",
},
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "createTime": "A String", # Output only. The time at which this environment was created.
"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
- # Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
- # this environment reside in a simulated directory with the given prefix.
+ "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)).
"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`.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
+ # set to 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.
- "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.
"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 GKE 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.
},
"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`.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
- # set to 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`.
},
- "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.
- # the Apache Airflow software.
- "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.
- "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 configuration for controlling how IPs are allocated in the GKE cluster.
- # GKE cluster running the Apache Airflow software.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
- # GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
- # IP addresses to pods.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
- # the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- },
- "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}".
- #
- # 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
- # corresponding to the Cloud Composer location, and propagate that choice to
- # 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.
- "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}".
- #
- # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
- # network must belong to the environment's project. If unspecified, the
- # "default" network ID 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.
- "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",
- ],
- },
- "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.
+ "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
+ # 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.
+ #
+ # 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",
+ },
+ "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.
"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
@@ -946,21 +849,14 @@
#
# See also [Version
# List](/composer/docs/concepts/versioning/composer-versions).
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
#
- # 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
- # 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.
- #
- # Certain Apache Airflow configuration property values are
- # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
- # and cannot be overridden.
+ # 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",
},
"envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
@@ -987,36 +883,140 @@
# * `SQL_USER`
"a_key": "A String",
},
- "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",
- },
},
"nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
# used to run this environment.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ # the Apache Airflow software.
+ "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",
+ ],
+ "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".
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The configuration for controlling how IPs are allocated in the GKE cluster.
+ # GKE cluster running the Apache Airflow software.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ # the GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ # GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
+ # IP addresses to pods.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the GKE cluster.
+ #
+ # 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.
+ },
+ "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}".
+ #
+ # 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
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # 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.
+ "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.
+ "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",
+ ],
+ "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}".
+ #
+ # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
+ # network must belong to the environment's project. If unspecified, the
+ # "default" network ID 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.
+ },
+ "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
+ # this environment reside in a simulated directory with the given prefix.
},
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
"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.
},
],
- "nextPageToken": "A String", # The page token used to query for the next page if one exists.
}</pre>
</div>
@@ -1045,7 +1045,8 @@
The object takes the form of:
{ # An environment for running orchestration tasks.
- "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.
+ # This value is generated when the environment is 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:
@@ -1056,159 +1057,60 @@
# size.
"a_key": "A String",
},
- "updateTime": "A String", # Output only. The time at which this environment was last modified.
+ "createTime": "A String", # Output only. The time at which this environment was created.
"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
- # Storage objects reside in a flat namespace, a hierarchical file tree
- # can be simulated using "/"-delimited object name prefixes. DAG objects for
- # this environment reside in a simulated directory with the given prefix.
+ "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)).
"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`.
+ "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
+ # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
+ # set to 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.
- "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.
"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 GKE 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.
},
"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`.
- "enablePrivateEnvironment": True or False, # Optional. If `true`, a Private IP Cloud Composer environment is created.
- # If this field is set to true, `IPAllocationPolicy.use_ip_aliases` must be
- # set to 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`.
},
- "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.
- # the Apache Airflow software.
- "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.
- "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 configuration for controlling how IPs are allocated in the GKE cluster.
- # GKE cluster running the Apache Airflow software.
- "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
- # GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- "useIpAliases": True or False, # Optional. Whether or not to enable Alias IPs in the GKE cluster.
- # If `true`, a VPC-native cluster is created.
- "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
- # IP addresses to the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
- # IP addresses to pods.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
- # the GKE cluster.
- #
- # This field is applicable only when `use_ip_aliases` is true.
- #
- # Set to blank to have GKE choose a range with the default size.
- #
- # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
- # netmask.
- #
- # Set to a
- # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
- # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
- # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
- # to use.
- },
- "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}".
- #
- # 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
- # corresponding to the Cloud Composer location, and propagate that choice to
- # 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.
- "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}".
- #
- # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
- # network must belong to the environment's project. If unspecified, the
- # "default" network ID 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.
- "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",
- ],
- },
- "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.
+ "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
+ # 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.
+ #
+ # 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",
+ },
+ "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.
"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
@@ -1229,21 +1131,14 @@
#
# See also [Version
# List](/composer/docs/concepts/versioning/composer-versions).
- "airflowConfigOverrides": { # Optional. Apache Airflow configuration properties to override.
+ "pypiPackages": { # Optional. Custom Python Package Index (PyPI) packages to be installed in
+ # the environment.
#
- # 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
- # 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.
- #
- # Certain Apache Airflow configuration property values are
- # [blacklisted](/composer/docs/how-to/managing/setting-airflow-configurations#airflow_configuration_blacklists),
- # and cannot be overridden.
+ # 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",
},
"envVariables": { # Optional. Additional environment variables to provide to the Apache Airflow
@@ -1270,33 +1165,138 @@
# * `SQL_USER`
"a_key": "A String",
},
- "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",
- },
},
"nodeCount": 42, # The number of nodes in the Kubernetes Engine cluster that will be
# used to run this environment.
+ "nodeConfig": { # The configuration information for the Kubernetes Engine nodes running # The configuration used for the Kubernetes Engine cluster.
+ # the Apache Airflow software.
+ "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",
+ ],
+ "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".
+ "ipAllocationPolicy": { # Configuration for controlling how IPs are allocated in the # Optional. The configuration for controlling how IPs are allocated in the GKE cluster.
+ # GKE cluster running the Apache Airflow software.
+ "clusterIpv4CidrBlock": "A String", # Optional. The IP address range used to allocate IP addresses to pods in
+ # the GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "servicesIpv4CidrBlock": "A String", # Optional. The IP address range of the services IP addresses in this
+ # GKE cluster.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ #
+ # Set to blank to have GKE choose a range with the default size.
+ #
+ # Set to /netmask (e.g. `/14`) to have GKE choose a range with a specific
+ # netmask.
+ #
+ # Set to a
+ # [CIDR](http://en.wikipedia.org/wiki/Classless_Inter-Domain_Routing)
+ # notation (e.g. `10.96.0.0/14`) from the RFC-1918 private networks (e.g.
+ # `10.0.0.0/8`, `172.16.0.0/12`, `192.168.0.0/16`) to pick a specific range
+ # to use.
+ "clusterSecondaryRangeName": "A String", # Optional. The name of the GKE cluster's secondary range used to allocate
+ # IP addresses to pods.
+ #
+ # This field is applicable only when `use_ip_aliases` is true.
+ "servicesSecondaryRangeName": "A String", # Optional. The name of the services' secondary range used to allocate
+ # IP addresses to the GKE cluster.
+ #
+ # 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.
+ },
+ "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}".
+ #
+ # 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
+ # corresponding to the Cloud Composer location, and propagate that choice to
+ # 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.
+ "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.
+ "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",
+ ],
+ "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}".
+ #
+ # [Shared VPC](/vpc/docs/shared-vpc) is not currently supported. The
+ # network must belong to the environment's project. If unspecified, the
+ # "default" network ID 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.
+ },
+ "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
+ # this environment reside in a simulated directory with the given prefix.
},
+ "updateTime": "A String", # Output only. The time at which this environment was last modified.
"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.
}
updateMask: string, Required. A comma-separated list of paths, relative to `Environment`, of
@@ -1442,9 +1442,9 @@
{ # This resource represents a long-running operation that is the result of a
# network API call.
- "done": True or False, # If the value is `false`, it means the operation is still in progress.
- # If `true`, the operation is completed, and either `error` or `response` is
- # available.
+ "name": "A String", # The server-assigned name, which is only unique within the same service that
+ # originally returns it. If you use the default HTTP mapping, the
+ # `name` should be a resource name ending with `operations/{unique_id}`.
"response": { # The normal 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
@@ -1455,9 +1455,15 @@
# `TakeSnapshotResponse`.
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
- "name": "A String", # The server-assigned name, which is only unique within the same service that
- # originally returns it. If you use the default HTTP mapping, the
- # `name` should be a resource name ending with `operations/{unique_id}`.
+ "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.
+ # If `true`, the operation is completed, and either `error` or `response` is
+ # available.
"error": { # The `Status` type defines a logical error model that is suitable for # 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
@@ -1471,16 +1477,10 @@
"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.
- },
- "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.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
},
}</pre>
</div>