google-api-python-client 2.86.0__py2.py3-none-any.whl → 2.87.0__py2.py3-none-any.whl

googleapiclient/discovery_cache/documents/composer.v1.json

@@ -139,6 +139,34 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "databaseFailover": {
+                  "description": "Triggers database failover (only for highly resilient environments).",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:databaseFailover",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.databaseFailover",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "Target environment: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+environment}:databaseFailover",
+                  "request": {
+                    "$ref": "DatabaseFailoverRequest"
+                  },
+                  "response": {
+                    "$ref": "Operation"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
                 "delete": {
                   "description": "Delete an environment.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}",
@@ -164,6 +192,59 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "executeAirflowCommand": {
+                  "description": "Executes Airflow CLI command.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:executeAirflowCommand",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.executeAirflowCommand",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "The resource name of the environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\".",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+environment}:executeAirflowCommand",
+                  "request": {
+                    "$ref": "ExecuteAirflowCommandRequest"
+                  },
+                  "response": {
+                    "$ref": "ExecuteAirflowCommandResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
+                "fetchDatabaseProperties": {
+                  "description": "Fetches database properties.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:fetchDatabaseProperties",
+                  "httpMethod": "GET",
+                  "id": "composer.projects.locations.environments.fetchDatabaseProperties",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "Required. The resource name of the environment, in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+environment}:fetchDatabaseProperties",
+                  "response": {
+                    "$ref": "FetchDatabasePropertiesResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
+                },
                 "get": {
                   "description": "Get an existing environment.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}",
@@ -287,6 +368,34 @@
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
                 },
+                "pollAirflowCommand": {
+                  "description": "Polls Airflow CLI command execution and fetches logs.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:pollAirflowCommand",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.pollAirflowCommand",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "The resource name of the environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\"",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+environment}:pollAirflowCommand",
+                  "request": {
+                    "$ref": "PollAirflowCommandRequest"
+                  },
+                  "response": {
+                    "$ref": "PollAirflowCommandResponse"
+                  },
+                  "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",
@@ -314,6 +423,34 @@
                   "scopes": [
                     "https://www.googleapis.com/auth/cloud-platform"
                   ]
+                },
+                "stopAirflowCommand": {
+                  "description": "Stops Airflow CLI command execution.",
+                  "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/environments/{environmentsId}:stopAirflowCommand",
+                  "httpMethod": "POST",
+                  "id": "composer.projects.locations.environments.stopAirflowCommand",
+                  "parameterOrder": [
+                    "environment"
+                  ],
+                  "parameters": {
+                    "environment": {
+                      "description": "The resource name of the environment in the form: \"projects/{projectId}/locations/{locationId}/environments/{environmentId}\".",
+                      "location": "path",
+                      "pattern": "^projects/[^/]+/locations/[^/]+/environments/[^/]+$",
+                      "required": true,
+                      "type": "string"
+                    }
+                  },
+                  "path": "v1/{+environment}:stopAirflowCommand",
+                  "request": {
+                    "$ref": "StopAirflowCommandRequest"
+                  },
+                  "response": {
+                    "$ref": "StopAirflowCommandResponse"
+                  },
+                  "scopes": [
+                    "https://www.googleapis.com/auth/cloud-platform"
+                  ]
                 }
               }
             },
@@ -462,7 +599,7 @@
       }
     }
   },
-  "revision": "20230407",
+  "revision": "20230516",
   "rootUrl": "https://composer.googleapis.com/",
   "schemas": {
     "AllowedIpRange": {
@@ -549,6 +686,18 @@
       },
       "type": "object"
     },
+    "DatabaseFailoverRequest": {
+      "description": "Request to trigger database failover (only for highly resilient environments).",
+      "id": "DatabaseFailoverRequest",
+      "properties": {},
+      "type": "object"
+    },
+    "DatabaseFailoverResponse": {
+      "description": "Response for DatabaseFailoverRequest.",
+      "id": "DatabaseFailoverResponse",
+      "properties": {},
+      "type": "object"
+    },
     "Date": {
       "description": "Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following: * A full date, with non-zero year, month, and day values. * A month and day, with a zero year (for example, an anniversary). * A year on its own, with a zero month and a zero day. * A year and month, with a zero day (for example, a credit card expiration date). Related types: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp",
       "id": "Date",
@@ -714,6 +863,18 @@
           "$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."
         },
+        "resilienceMode": {
+          "description": "Optional. Resilience mode of the Cloud Composer Environment. This field is supported for Cloud Composer environments in versions composer-2.2.0-airflow-*.*.* and newer.",
+          "enum": [
+            "RESILIENCE_MODE_UNSPECIFIED",
+            "HIGH_RESILIENCE"
+          ],
+          "enumDescriptions": [
+            "Default mode doesn't change environment parameters.",
+            "Enabled High Resilience mode, including Cloud SQL HA."
+          ],
+          "type": "string"
+        },
         "softwareConfig": {
           "$ref": "SoftwareConfig",
           "description": "The configuration settings for software inside the environment."
@@ -733,6 +894,86 @@
       },
       "type": "object"
     },
+    "ExecuteAirflowCommandRequest": {
+      "description": "Execute Airflow Command request.",
+      "id": "ExecuteAirflowCommandRequest",
+      "properties": {
+        "command": {
+          "description": "Airflow command.",
+          "type": "string"
+        },
+        "parameters": {
+          "description": "Parameters for the Airflow command/subcommand as an array of arguments. It may contain positional arguments like `[\"my-dag-id\"]`, key-value parameters like `[\"--foo=bar\"]` or `[\"--foo\",\"bar\"]`, or other flags like `[\"-f\"]`.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "subcommand": {
+          "description": "Airflow subcommand.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ExecuteAirflowCommandResponse": {
+      "description": "Response to ExecuteAirflowCommandRequest.",
+      "id": "ExecuteAirflowCommandResponse",
+      "properties": {
+        "error": {
+          "description": "Error message. Empty if there was no error.",
+          "type": "string"
+        },
+        "executionId": {
+          "description": "The unique ID of the command execution for polling.",
+          "type": "string"
+        },
+        "pod": {
+          "description": "The name of the pod where the command is executed.",
+          "type": "string"
+        },
+        "podNamespace": {
+          "description": "The namespace of the pod where the command is executed.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "ExitInfo": {
+      "description": "Information about how a command ended.",
+      "id": "ExitInfo",
+      "properties": {
+        "error": {
+          "description": "Error message. Empty if there was no error.",
+          "type": "string"
+        },
+        "exitCode": {
+          "description": "The exit code from the command execution.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "FetchDatabasePropertiesResponse": {
+      "description": "Response for FetchDatabasePropertiesRequest.",
+      "id": "FetchDatabasePropertiesResponse",
+      "properties": {
+        "isFailoverReplicaAvailable": {
+          "description": "The availability status of the failover replica. A false status indicates that the failover replica is out of sync. The primary instance can only fail over to the failover replica when the status is true.",
+          "type": "boolean"
+        },
+        "primaryGceZone": {
+          "description": "The Compute Engine zone that the instance is currently serving from.",
+          "type": "string"
+        },
+        "secondaryGceZone": {
+          "description": "The Compute Engine zone that the failover instance is currently serving from for a regional Cloud SQL instance.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
     "IPAllocationPolicy": {
       "description": "Configuration for controlling how IPs are allocated in the GKE cluster running the Apache Airflow software.",
       "id": "IPAllocationPolicy",
@@ -794,6 +1035,22 @@
       },
       "type": "object"
     },
+    "Line": {
+      "description": "Contains information about a single line from logs.",
+      "id": "Line",
+      "properties": {
+        "content": {
+          "description": "Text content of the log line.",
+          "type": "string"
+        },
+        "lineNumber": {
+          "description": "Number of the line.",
+          "format": "int32",
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
     "ListEnvironmentsResponse": {
       "description": "The environments in a project and location.",
       "id": "ListEnvironmentsResponse",
@@ -1053,7 +1310,8 @@
             "UPDATE",
             "CHECK",
             "SAVE_SNAPSHOT",
-            "LOAD_SNAPSHOT"
+            "LOAD_SNAPSHOT",
+            "DATABASE_FAILOVER"
           ],
           "enumDescriptions": [
             "Unused.",
@@ -1062,7 +1320,8 @@
             "A resource update operation.",
             "A resource check operation.",
             "Saves snapshot of the resource operation.",
-            "Loads snapshot of the resource operation."
+            "Loads snapshot of the resource operation.",
+            "Triggers failover of environment's Cloud SQL instance (only for highly resilient environments)."
           ],
           "type": "string"
         },
@@ -1097,6 +1356,52 @@
       },
       "type": "object"
     },
+    "PollAirflowCommandRequest": {
+      "description": "Poll Airflow Command request.",
+      "id": "PollAirflowCommandRequest",
+      "properties": {
+        "executionId": {
+          "description": "The unique ID of the command execution.",
+          "type": "string"
+        },
+        "nextLineNumber": {
+          "description": "Line number from which new logs should be fetched.",
+          "format": "int32",
+          "type": "integer"
+        },
+        "pod": {
+          "description": "The name of the pod where the command is executed.",
+          "type": "string"
+        },
+        "podNamespace": {
+          "description": "The namespace of the pod where the command is executed.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "PollAirflowCommandResponse": {
+      "description": "Response to PollAirflowCommandRequest.",
+      "id": "PollAirflowCommandResponse",
+      "properties": {
+        "exitInfo": {
+          "$ref": "ExitInfo",
+          "description": "The result exit status of the command."
+        },
+        "output": {
+          "description": "Output from the command execution. It may not contain the full output and the caller may need to poll for more lines.",
+          "items": {
+            "$ref": "Line"
+          },
+          "type": "array"
+        },
+        "outputEnd": {
+          "description": "Whether the command execution has finished and there is no more output.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
     "PrivateClusterConfig": {
       "description": "Configuration options for the private GKE cluster in a Cloud Composer environment.",
       "id": "PrivateClusterConfig",
@@ -1317,6 +1622,47 @@
       },
       "type": "object"
     },
+    "StopAirflowCommandRequest": {
+      "description": "Stop Airflow Command request.",
+      "id": "StopAirflowCommandRequest",
+      "properties": {
+        "executionId": {
+          "description": "The unique ID of the command execution.",
+          "type": "string"
+        },
+        "force": {
+          "description": "If true, the execution is terminated forcefully (SIGKILL). If false, the execution is stopped gracefully, giving it time for cleanup.",
+          "type": "boolean"
+        },
+        "pod": {
+          "description": "The name of the pod where the command is executed.",
+          "type": "string"
+        },
+        "podNamespace": {
+          "description": "The namespace of the pod where the command is executed.",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "StopAirflowCommandResponse": {
+      "description": "Response to StopAirflowCommandRequest.",
+      "id": "StopAirflowCommandResponse",
+      "properties": {
+        "isDone": {
+          "description": "Whether the execution is still running.",
+          "type": "boolean"
+        },
+        "output": {
+          "description": "Output message from stopping execution request.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
     "WebServerConfig": {
       "description": "The configuration settings for the Airflow web server App Engine instance. Supported for Cloud Composer environments in versions composer-1.*.*-airflow-*.*.*",
       "id": "WebServerConfig",