diff --git a/docs/dyn/composer_v1.projects.locations.environments.html b/docs/dyn/composer_v1.projects.locations.environments.html index 480e678a06f..306fd3db4cb 100644 --- a/docs/dyn/composer_v1.projects.locations.environments.html +++ b/docs/dyn/composer_v1.projects.locations.environments.html @@ -92,9 +92,15 @@

Instance Methods

list_next()

Retrieves the next page of results.

+

+ loadSnapshot(environment, body=None, x__xgafv=None)

+

Loads a snapshot of a Cloud Composer environment. As a result of this operation, a snapshot of environment's specified in LoadSnapshotRequest is loaded into the environment.

patch(name, body=None, updateMask=None, x__xgafv=None)

Update an environment.

+

+ saveSnapshot(environment, body=None, x__xgafv=None)

+

Creates a snapshots of a Cloud Composer environment. As a result of this operation, snapshot of environment's state is stored in a location specified in the SaveSnapshotRequest.

Method Details

close() @@ -177,6 +183,14 @@

Method Details

"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`. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. }, + "recoveryConfig": { # The Recovery settings of an environment. # Optional. The Recovery settings configuration of an environment. This field is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer. + "scheduledSnapshotsConfig": { # The configuration for scheduled snapshot creation mechanism. # Optional. The configuration for scheduled snapshot creation mechanism. + "enabled": True or False, # Optional. Whether scheduled snapshots creation is enabled. + "snapshotCreationSchedule": "A String", # Optional. The cron expression representing the time when snapshots creation mechanism runs. This field is subject to additional validation around frequency of execution. + "snapshotLocation": "A String", # Optional. The Cloud Storage location for storing automatically created snapshots. + "timeZone": "A String", # Optional. Time zone that sets the context to interpret snapshot_creation_schedule. + }, + }, "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 [blocked](/composer/docs/concepts/airflow-configurations), and cannot be overridden. "a_key": "A String", @@ -378,6 +392,14 @@

Method Details

"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`. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. }, + "recoveryConfig": { # The Recovery settings of an environment. # Optional. The Recovery settings configuration of an environment. This field is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer. + "scheduledSnapshotsConfig": { # The configuration for scheduled snapshot creation mechanism. # Optional. The configuration for scheduled snapshot creation mechanism. + "enabled": True or False, # Optional. Whether scheduled snapshots creation is enabled. + "snapshotCreationSchedule": "A String", # Optional. The cron expression representing the time when snapshots creation mechanism runs. This field is subject to additional validation around frequency of execution. + "snapshotLocation": "A String", # Optional. The Cloud Storage location for storing automatically created snapshots. + "timeZone": "A String", # Optional. Time zone that sets the context to interpret snapshot_creation_schedule. + }, + }, "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 [blocked](/composer/docs/concepts/airflow-configurations), and cannot be overridden. "a_key": "A String", @@ -520,6 +542,14 @@

Method Details

"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`. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. }, + "recoveryConfig": { # The Recovery settings of an environment. # Optional. The Recovery settings configuration of an environment. This field is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer. + "scheduledSnapshotsConfig": { # The configuration for scheduled snapshot creation mechanism. # Optional. The configuration for scheduled snapshot creation mechanism. + "enabled": True or False, # Optional. Whether scheduled snapshots creation is enabled. + "snapshotCreationSchedule": "A String", # Optional. The cron expression representing the time when snapshots creation mechanism runs. This field is subject to additional validation around frequency of execution. + "snapshotLocation": "A String", # Optional. The Cloud Storage location for storing automatically created snapshots. + "timeZone": "A String", # Optional. Time zone that sets the context to interpret snapshot_creation_schedule. + }, + }, "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 [blocked](/composer/docs/concepts/airflow-configurations), and cannot be overridden. "a_key": "A String", @@ -594,6 +624,52 @@

Method Details

+
+ loadSnapshot(environment, body=None, x__xgafv=None) +
Loads a snapshot of a Cloud Composer environment. As a result of this operation, a snapshot of environment's specified in LoadSnapshotRequest is loaded into the environment.
+
+Args:
+  environment: string, The resource name of the target environment in the form: "projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to load a snapshot into a Cloud Composer environment.
+  "skipAirflowOverridesSetting": True or False, # Whether or not to skip setting Airflow overrides when loading the environment's state.
+  "skipEnvironmentVariablesSetting": True or False, # Whether or not to skip setting environment variables when loading the environment's state.
+  "skipGcsDataCopying": True or False, # Whether or not to skip copying Cloud Storage data when loading the environment's state.
+  "skipPypiPackagesInstallation": True or False, # Whether or not to skip installing Pypi packages when loading the environment's state.
+  "snapshotPath": "A String", # A Cloud Storage path to a snapshot to load, e.g.: "gs://my-bucket/snapshots/project_location_environment_timestamp".
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+  "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+}
+
+
patch(name, body=None, updateMask=None, x__xgafv=None)
Update an environment.
@@ -670,6 +746,14 @@ 

Method Details

"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`. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. "webServerIpv4ReservedRange": "A String", # Output only. The IP range reserved for the tenant project's App Engine VMs. This field is supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*. }, + "recoveryConfig": { # The Recovery settings of an environment. # Optional. The Recovery settings configuration of an environment. This field is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer. + "scheduledSnapshotsConfig": { # The configuration for scheduled snapshot creation mechanism. # Optional. The configuration for scheduled snapshot creation mechanism. + "enabled": True or False, # Optional. Whether scheduled snapshots creation is enabled. + "snapshotCreationSchedule": "A String", # Optional. The cron expression representing the time when snapshots creation mechanism runs. This field is subject to additional validation around frequency of execution. + "snapshotLocation": "A String", # Optional. The Cloud Storage location for storing automatically created snapshots. + "timeZone": "A String", # Optional. Time zone that sets the context to interpret snapshot_creation_schedule. + }, + }, "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 [blocked](/composer/docs/concepts/airflow-configurations), and cannot be overridden. "a_key": "A String", @@ -756,4 +840,46 @@

Method Details

}
+
+ saveSnapshot(environment, body=None, x__xgafv=None) +
Creates a snapshots of a Cloud Composer environment. As a result of this operation, snapshot of environment's state is stored in a location specified in the SaveSnapshotRequest.
+
+Args:
+  environment: string, The resource name of the source environment in the form: "projects/{projectId}/locations/{locationId}/environments/{environmentId}" (required)
+  body: object, The request body.
+    The object takes the form of:
+
+{ # Request to create a snapshot of a Cloud Composer environment.
+  "snapshotLocation": "A String", # Location in a Cloud Storage where the snapshot is going to be stored, e.g.: "gs://my-bucket/snapshots".
+}
+
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # This resource represents a long-running operation that is the result of a network API call.
+  "done": True or False, # If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available.
+  "error": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # The error result of the operation in case of failure or cancellation.
+    "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+    "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+      {
+        "a_key": "", # Properties of the object. Contains field @type with type URL.
+      },
+    ],
+    "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
+  },
+  "metadata": { # Service-specific metadata associated with the operation. It typically contains progress information and common metadata such as create time. Some services might not provide such metadata. Any method that returns a long-running operation should document the metadata type, if any.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+  "name": "A String", # The server-assigned name, which is only unique within the same service that originally returns it. If you use the default HTTP mapping, the `name` should be a resource name ending with `operations/{unique_id}`.
+  "response": { # The normal response of the operation in case of success. If the original method returns no data on success, such as `Delete`, the response is `google.protobuf.Empty`. If the original method is standard `Get`/`Create`/`Update`, the response should be the resource. For other methods, the response should have the type `XxxResponse`, where `Xxx` is the original method name. For example, if the original method name is `TakeSnapshot()`, the inferred response type is `TakeSnapshotResponse`.
+    "a_key": "", # Properties of the object. Contains field @type with type URL.
+  },
+}
+
+ \ No newline at end of file diff --git a/googleapiclient/discovery_cache/documents/composer.v1.json b/googleapiclient/discovery_cache/documents/composer.v1.json index a6462e0f26c..c437807be2d 100644 --- a/googleapiclient/discovery_cache/documents/composer.v1.json +++ b/googleapiclient/discovery_cache/documents/composer.v1.json @@ -225,6 +225,34 @@ "https://www.googleapis.com/auth/cloud-platform" ] }, + "loadSnapshot": { + "description": "Loads a snapshot of a Cloud Composer environment. As a result of this operation, a snapshot of environment's specified in LoadSnapshotRequest is loaded into the environment.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:loadSnapshot", + "httpMethod": "POST", + "id": "composer.projects.locations.environments.loadSnapshot", + "parameterOrder": [ + "environment" + ], + "parameters": { + "environment": { + "description": "The resource name of the target environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+environment}:loadSnapshot", + "request": { + "$ref": "LoadSnapshotRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] + }, "patch": { "description": "Update an environment.", "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}", @@ -258,6 +286,34 @@ "scopes": [ "https://www.googleapis.com/auth/cloud-platform" ] + }, + "saveSnapshot": { + "description": "Creates a snapshots of a Cloud Composer environment. As a result of this operation, snapshot of environment's state is stored in a location specified in the SaveSnapshotRequest.", + "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:saveSnapshot", + "httpMethod": "POST", + "id": "composer.projects.locations.environments.saveSnapshot", + "parameterOrder": [ + "environment" + ], + "parameters": { + "environment": { + "description": "The resource name of the source environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"", + "location": "path", + "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$", + "required": true, + "type": "string" + } + }, + "path": "v1/{+environment}:saveSnapshot", + "request": { + "$ref": "SaveSnapshotRequest" + }, + "response": { + "$ref": "Operation" + }, + "scopes": [ + "https://www.googleapis.com/auth/cloud-platform" + ] } } }, @@ -406,7 +462,7 @@ } } }, - "revision": "20221114", + "revision": "20221130", "rootUrl": "https://composer.googleapis.com/", "schemas": { "AllowedIpRange": { @@ -649,6 +705,10 @@ "$ref": "PrivateEnvironmentConfig", "description": "The configuration used for the Private IP Cloud Composer environment." }, + "recoveryConfig": { + "$ref": "RecoveryConfig", + "description": "Optional. The Recovery settings configuration of an environment. This field is supported for Cloud Composer environments in versions composer-2.*.*-airflow-*.*.* and newer." + }, "softwareConfig": { "$ref": "SoftwareConfig", "description": "The configuration settings for software inside the environment." @@ -783,6 +843,33 @@ }, "type": "object" }, + "LoadSnapshotRequest": { + "description": "Request to load a snapshot into a Cloud Composer environment.", + "id": "LoadSnapshotRequest", + "properties": { + "skipAirflowOverridesSetting": { + "description": "Whether or not to skip setting Airflow overrides when loading the environment's state.", + "type": "boolean" + }, + "skipEnvironmentVariablesSetting": { + "description": "Whether or not to skip setting environment variables when loading the environment's state.", + "type": "boolean" + }, + "skipGcsDataCopying": { + "description": "Whether or not to skip copying Cloud Storage data when loading the environment's state.", + "type": "boolean" + }, + "skipPypiPackagesInstallation": { + "description": "Whether or not to skip installing Pypi packages when loading the environment's state.", + "type": "boolean" + }, + "snapshotPath": { + "description": "A Cloud Storage path to a snapshot to load, e.g.: \"gs://my-bucket/snapshots/project_location_environment_timestamp\".", + "type": "string" + } + }, + "type": "object" + }, "LoadSnapshotResponse": { "description": "Response to LoadSnapshotRequest.", "id": "LoadSnapshotResponse", @@ -1074,6 +1161,28 @@ }, "type": "object" }, + "RecoveryConfig": { + "description": "The Recovery settings of an environment.", + "id": "RecoveryConfig", + "properties": { + "scheduledSnapshotsConfig": { + "$ref": "ScheduledSnapshotsConfig", + "description": "Optional. The configuration for scheduled snapshot creation mechanism." + } + }, + "type": "object" + }, + "SaveSnapshotRequest": { + "description": "Request to create a snapshot of a Cloud Composer environment.", + "id": "SaveSnapshotRequest", + "properties": { + "snapshotLocation": { + "description": "Location in a Cloud Storage where the snapshot is going to be stored, e.g.: \"gs://my-bucket/snapshots\".", + "type": "string" + } + }, + "type": "object" + }, "SaveSnapshotResponse": { "description": "Response to SaveSnapshotRequest.", "id": "SaveSnapshotResponse", @@ -1085,6 +1194,29 @@ }, "type": "object" }, + "ScheduledSnapshotsConfig": { + "description": "The configuration for scheduled snapshot creation mechanism.", + "id": "ScheduledSnapshotsConfig", + "properties": { + "enabled": { + "description": "Optional. Whether scheduled snapshots creation is enabled.", + "type": "boolean" + }, + "snapshotCreationSchedule": { + "description": "Optional. The cron expression representing the time when snapshots creation mechanism runs. This field is subject to additional validation around frequency of execution.", + "type": "string" + }, + "snapshotLocation": { + "description": "Optional. The Cloud Storage location for storing automatically created snapshots.", + "type": "string" + }, + "timeZone": { + "description": "Optional. Time zone that sets the context to interpret snapshot_creation_schedule.", + "type": "string" + } + }, + "type": "object" + }, "SchedulerResource": { "description": "Configuration for resources used by Airflow schedulers.", "id": "SchedulerResource", diff --git a/googleapiclient/discovery_cache/documents/composer.v1beta1.json b/googleapiclient/discovery_cache/documents/composer.v1beta1.json index 01ef0af0fb1..7c38777291a 100644 --- a/googleapiclient/discovery_cache/documents/composer.v1beta1.json +++ b/googleapiclient/discovery_cache/documents/composer.v1beta1.json @@ -518,7 +518,7 @@ } } }, - "revision": "20221114", + "revision": "20221130", "rootUrl": "https://composer.googleapis.com/", "schemas": { "AllowedIpRange": {