Skip to content

Commit

Permalink
feat(all): auto-regenerate discovery clients (#1777)
Browse files Browse the repository at this point in the history
  • Loading branch information
@yoshi-automation
yoshi-automation committed Dec 14, 2022
1 parent c58bf4c commit 5b02761
Show file tree
Hide file tree
Showing 41 changed files with 5,931 additions and 2,616 deletions.
30 changes: 30 additions & 0 deletions api-list.json
View file
Expand Up @@ -5962,6 +5962,36 @@
"documentationLink": "https://cloud.google.com/workflows",
"preferred": true
},
{
"kind": "discovery#directoryItem",
"id": "workloadmanager:v1",
"name": "workloadmanager",
"version": "v1",
"title": "Workload Manager API",
"description": "",
"discoveryRestUrl": "https://workloadmanager.googleapis.com/$discovery/rest?version=v1",
"icons": {
"x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
"x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
},
"documentationLink": "https://g3doc.corp.google.com/company/teams/compute-fe/index.md?cl=head",
"preferred": true
},
{
"kind": "discovery#directoryItem",
"id": "workstations:v1beta",
"name": "workstations",
"version": "v1beta",
"title": "Cloud Workstations API",
"description": "",
"discoveryRestUrl": "https://workstations.googleapis.com/$discovery/rest?version=v1beta",
"icons": {
"x16": "https://www.gstatic.com/images/branding/product/1x/googleg_16dp.png",
"x32": "https://www.gstatic.com/images/branding/product/1x/googleg_32dp.png"
},
"documentationLink": "https://cloud.google.com/workstations",
"preferred": true
},
{
"kind": "discovery#directoryItem",
"id": "youtube:v3",
Expand Down
193 changes: 192 additions & 1 deletion appengine/v1/appengine-api.json
View file
Expand Up @@ -1595,7 +1595,7 @@
}
}
},
"revision": "20220826",
"revision": "20221205",
"rootUrl": "https://appengine.googleapis.com/",
"schemas": {
"ApiConfigHandler": {
Expand Down Expand Up @@ -3059,6 +3059,122 @@
},
"type": "object"
},
"ProjectEvent": {
"description": "The request sent to CLHs during project events.",
"id": "ProjectEvent",
"properties": {
"eventId": {
"description": "The unique ID for this project event. CLHs can use this value to dedup repeated calls. required",
"type": "string"
},
"phase": {
"enum": [
"UNKNOWN",
"BEFORE_RESOURCE_HANDLING",
"AFTER_RESOURCE_HANDLING"
],
"enumDescriptions": [
"",
"",
""
],
"type": "string"
},
"projectMetadata": {
"$ref": "ProjectsMetadata",
"description": "The projects metadata for this project. required"
},
"state": {
"$ref": "ProjectState",
"description": "The state of the project that led to this event."
}
},
"type": "object"
},
"ProjectState": {
"description": "ProjectState contains the externally-visible project state that is used to communicate the state and reasoning for that state to the CLH. This data is not persisted by CCFE, but is instead derived from CCFE's internal representation of the project state.",
"id": "ProjectState",
"properties": {
"currentReasons": {
"$ref": "Reasons"
},
"previousReasons": {
"$ref": "Reasons",
"description": "The previous and current reasons for a project state will be sent for a project event. CLHs that need to know the signal that caused the project event to trigger (edges) as opposed to just knowing the state can act upon differences in the previous and current reasons.Reasons will be provided for every system: service management, data governance, abuse, and billing.If this is a CCFE-triggered event used for reconciliation then the current reasons will be set to their *_CONTROL_PLANE_SYNC state. The previous reasons will contain the last known set of non-unknown non-control_plane_sync reasons for the state.Reasons fields are deprecated. New tenants should only use the state field. If you must know the reason(s) behind a specific state, please consult with CCFE team first (cloud-ccfe-discuss@google.com)."
},
"state": {
"description": "The current state of the project. This state is the culmination of all of the opinions from external systems that CCFE knows about of the project.",
"enum": [
"UNKNOWN_STATE",
"ON",
"OFF",
"DELETED"
],
"enumDescriptions": [
"A project should never be in an unknown state. Receipt of a project with this state is an error.",
"CCFE considers the project to be serving or transitioning into serving.",
"CCFE considers the project to be in an OFF state. This could occur due to various factors. The state could be triggered by Google-internal audits (ex. abuse suspension, billing closed) or cleanups trigged by compliance systems (ex. data governance hide). User-initiated events such as service management deactivation trigger a project to an OFF state.CLHs might choose to do nothing in this case or to turn off costly resources. CLHs need to consider the customer experience if an ON/OFF/ON sequence of state transitions occurs vs. the cost of deleting resources, keeping metadata about resources, or even keeping resources live for a period of time.CCFE will not send any new customer requests to the CLH when the project is in an OFF state. However, CCFE will allow all previous customer requests relayed to CLH to complete.",
"This state indicates that the project has been (or is being) completely removed. This is often due to a data governance purge request and therefore resources should be deleted when this state is reached."
],
"type": "string"
}
},
"type": "object"
},
"ProjectsMetadata": {
"description": "ProjectsMetadata is the metadata CCFE stores about the all the relevant projects (tenant, consumer, producer).",
"id": "ProjectsMetadata",
"properties": {
"consumerProjectId": {
"description": "The consumer project id.",
"type": "string"
},
"consumerProjectNumber": {
"description": "The consumer project number.",
"format": "int64",
"type": "string"
},
"consumerProjectState": {
"description": "The CCFE state of the consumer project. It is the same state that is communicated to the CLH during project events. Notice that this field is not set in the DB, it is only set in this proto when communicated to CLH in the side channel.",
"enum": [
"UNKNOWN_STATE",
"ON",
"OFF",
"DELETED"
],
"enumDescriptions": [
"A project should never be in an unknown state. Receipt of a project with this state is an error.",
"CCFE considers the project to be serving or transitioning into serving.",
"CCFE considers the project to be in an OFF state. This could occur due to various factors. The state could be triggered by Google-internal audits (ex. abuse suspension, billing closed) or cleanups trigged by compliance systems (ex. data governance hide). User-initiated events such as service management deactivation trigger a project to an OFF state.CLHs might choose to do nothing in this case or to turn off costly resources. CLHs need to consider the customer experience if an ON/OFF/ON sequence of state transitions occurs vs. the cost of deleting resources, keeping metadata about resources, or even keeping resources live for a period of time.CCFE will not send any new customer requests to the CLH when the project is in an OFF state. However, CCFE will allow all previous customer requests relayed to CLH to complete.",
"This state indicates that the project has been (or is being) completely removed. This is often due to a data governance purge request and therefore resources should be deleted when this state is reached."
],
"type": "string"
},
"p4ServiceAccount": {
"description": "The service account authorized to operate on the consumer project. Note: CCFE only propagates P4SA with default tag to CLH.",
"type": "string"
},
"producerProjectId": {
"description": "The producer project id.",
"type": "string"
},
"producerProjectNumber": {
"description": "The producer project number.",
"format": "int64",
"type": "string"
},
"tenantProjectId": {
"description": "The tenant project id.",
"type": "string"
},
"tenantProjectNumber": {
"description": "The tenant project number.",
"format": "int64",
"type": "string"
}
},
"type": "object"
},
"ReadinessCheck": {
"description": "Readiness checking configuration for VM instances. Unhealthy instances are removed from traffic rotation.",
"id": "ReadinessCheck",
Expand Down Expand Up @@ -3099,6 +3215,81 @@
},
"type": "object"
},
"Reasons": {
"description": "Projects transition between and within states based on reasons sent from various systems. CCFE will provide the CLH with reasons for the current state per system.The current systems that CCFE supports are: Service Management (Inception) Data Governance (Wipeout) Abuse (Ares) Billing (Internal Cloud Billing API)",
"id": "Reasons",
"properties": {
"abuse": {
"enum": [
"ABUSE_UNKNOWN_REASON",
"ABUSE_CONTROL_PLANE_SYNC",
"SUSPEND",
"REINSTATE"
],
"enumDescriptions": [
"An unknown reason indicates that the abuse system has not sent a signal for this project.",
"Due to various reasons CCFE might proactively restate a project state to a CLH to ensure that the CLH and CCFE are both aware of the project state. This reason can be tied to any of the states.",
"If a project is deemed abusive we receive a suspend signal. Suspend is a reason to put the project into an INTERNAL_OFF state.",
"Projects that were once considered abusive can later be deemed non-abusive. When this happens we must reinstate the project. Reinstate is a reason to put the project into an ON state."
],
"type": "string"
},
"billing": {
"enum": [
"BILLING_UNKNOWN_REASON",
"BILLING_CONTROL_PLANE_SYNC",
"PROBATION",
"CLOSE",
"OPEN"
],
"enumDescriptions": [
"An unknown reason indicates that the billing system has not sent a signal for this project.",
"Due to various reasons CCFE might proactively restate a project state to a CLH to ensure that the CLH and CCFE are both aware of the project state. This reason can be tied to any of the states.",
"Minor infractions cause a probation signal to be sent. Probation is a reason to put the project into a ON state even though it is a negative signal. CCFE will block mutations for this project while it is on billing probation, but the CLH is expected to serve non-mutation requests.",
"When a billing account is closed, it is a stronger signal about non-payment. Close is a reason to put the project into an INTERNAL_OFF state.",
"Consumers can re-open billing accounts and update accounts to pull them out of probation. When this happens, we get a signal that the account is open. Open is a reason to put the project into an ON state."
],
"type": "string"
},
"dataGovernance": {
"enum": [
"DATA_GOVERNANCE_UNKNOWN_REASON",
"DATA_GOVERNANCE_CONTROL_PLANE_SYNC",
"HIDE",
"UNHIDE",
"PURGE"
],
"enumDescriptions": [
"An unknown reason indicates that data governance has not sent a signal for this project.",
"Due to various reasons CCFE might proactively restate a project state to a CLH to ensure that the CLH and CCFE are both aware of the project state. This reason can be tied to any of the states.",
"When a project is deleted we retain some data for a period of time to allow the consumer to change their mind. Data governance sends a signal to hide the data when this occurs. Hide is a reason to put the project in an INTERNAL_OFF state.",
"The decision to un-delete a project can be made. When this happens data governance tells us to unhide any hidden data. Unhide is a reason to put the project in an ON state.",
"After a period of time data must be completely removed from our systems. When data governance sends a purge signal we need to remove data. Purge is a reason to put the project in a DELETED state. Purge is the only event that triggers a delete mutation. All other events have update semantics."
],
"type": "string"
},
"serviceManagement": {
"enum": [
"SERVICE_MANAGEMENT_UNKNOWN_REASON",
"SERVICE_MANAGEMENT_CONTROL_PLANE_SYNC",
"ACTIVATION",
"PREPARE_DEACTIVATION",
"ABORT_DEACTIVATION",
"COMMIT_DEACTIVATION"
],
"enumDescriptions": [
"An unknown reason indicates that we have not received a signal from service management about this project. Since projects are created by request of service management, this reason should never be set.",
"Due to various reasons CCFE might proactively restate a project state to a CLH to ensure that the CLH and CCFE are both aware of the project state. This reason can be tied to any of the states.",
"When a customer activates an API CCFE notifies the CLH and sets the project to the ON state.",
"When a customer deactivates and API service management starts a two-step process to perform the deactivation. The first step is to prepare. Prepare is a reason to put the project in a EXTERNAL_OFF state.",
"If the deactivation is cancelled, service managed needs to abort the deactivation. Abort is a reason to put the project in an ON state.",
"If the deactivation is followed through with, service management needs to finish deactivation. Commit is a reason to put the project in a DELETED state."
],
"type": "string"
}
},
"type": "object"
},
"RepairApplicationRequest": {
"description": "Request message for 'Applications.RepairApplication'.",
"id": "RepairApplicationRequest",
Expand Down

0 comments on commit 5b02761

Please sign in to comment.