feat(memcache): update the API

#### memcache:v1beta2 The following keys were added: - schemas.GoogleCloudMemcacheV1beta2ZoneMetadata.id - schemas.GoogleCloudMemcacheV1beta2ZoneMetadata.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.id - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.additionalProperties.$ref - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.perSliEligibility.$ref - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.perSliEligibility.description - schemas.Instance.description - schemas.LocationMetadata.description - schemas.LocationMetadata.id - schemas.LocationMetadata.properties.availableZones.additionalProperties.$ref - schemas.LocationMetadata.properties.availableZones.description - schemas.LocationMetadata.properties.availableZones.readOnly - schemas.LocationMetadata.properties.availableZones.type - schemas.LocationMetadata.type - schemas.MemcacheParameters.description The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.filter.description - resources.projects.resources.locations.methods.list.parameters.pageSize.description - resources.projects.resources.locations.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.instances.methods.applyParameters.description - resources.projects.resources.locations.resources.instances.methods.create.parameters.instanceId.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.filter.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.instances.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.instances.methods.updateParameters.description - schemas.ApplyParametersRequest.properties.applyAll.description - schemas.ApplyParametersRequest.properties.nodeIds.description - schemas.GoogleCloudMemcacheV1beta2LocationMetadata.properties.availableZones.additionalProperties.$ref - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.canReschedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.scheduleDeadlineTime.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.sliName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.eligibility.description - schemas.Instance.properties.discoveryEndpoint.description - schemas.Instance.properties.displayName.description - schemas.Instance.properties.instanceMessages.description - schemas.Instance.properties.memcacheNodes.description - schemas.Instance.properties.memcacheVersion.description - schemas.Instance.properties.name.description - schemas.Instance.properties.zones.description - schemas.MemcacheParameters.properties.id.description #### memcache:v1 The following keys were added: - schemas.GoogleCloudMemcacheV1LocationMetadata.description - schemas.GoogleCloudMemcacheV1LocationMetadata.id - schemas.GoogleCloudMemcacheV1LocationMetadata.properties.availableZones.additionalProperties.$ref - schemas.GoogleCloudMemcacheV1LocationMetadata.properties.availableZones.description - schemas.GoogleCloudMemcacheV1LocationMetadata.properties.availableZones.readOnly - schemas.GoogleCloudMemcacheV1LocationMetadata.properties.availableZones.type - schemas.GoogleCloudMemcacheV1LocationMetadata.type - schemas.GoogleCloudMemcacheV1ZoneMetadata.id - schemas.GoogleCloudMemcacheV1ZoneMetadata.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.id - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.additionalProperties.$ref - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.properties.eligibilities.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility.type - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.perSliEligibility.$ref - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.perSliEligibility.description - schemas.Instance.description - schemas.MemcacheParameters.description The following keys were changed: - resources.projects.resources.locations.methods.list.parameters.filter.description - resources.projects.resources.locations.methods.list.parameters.pageSize.description - resources.projects.resources.locations.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.instances.methods.applyParameters.description - resources.projects.resources.locations.resources.instances.methods.create.parameters.instanceId.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.filter.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.pageSize.description - resources.projects.resources.locations.resources.instances.methods.list.parameters.pageToken.description - resources.projects.resources.locations.resources.instances.methods.patch.parameters.name.description - resources.projects.resources.locations.resources.instances.methods.updateParameters.description - schemas.ApplyParametersRequest.properties.applyAll.description - schemas.ApplyParametersRequest.properties.nodeIds.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.canReschedule.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule.properties.scheduleDeadlineTime.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloExclusion.properties.sliName.description - schemas.GoogleCloudSaasacceleratorManagementProvidersV1SloMetadata.properties.eligibility.description - schemas.Instance.properties.discoveryEndpoint.description - schemas.Instance.properties.displayName.description - schemas.Instance.properties.instanceMessages.description - schemas.Instance.properties.memcacheNodes.description - schemas.Instance.properties.memcacheVersion.description - schemas.Instance.properties.name.description - schemas.Instance.properties.zones.description - schemas.MemcacheParameters.properties.id.description
googleapis · Apr 5, 2021 · c5ec2a9 · c5ec2a9
1 parent e7e9490
commit c5ec2a9
Show file tree

Hide file tree

Showing 4 changed files with 266 additions and 116 deletions.
diff --git a/discovery/memcache-v1.json b/discovery/memcache-v1.json
@@ -144,7 +144,7 @@
               ],
               "parameters": {
                 "filter": {
-                  "description": "The standard list filter.",
+                  "description": "A filter to narrow down results to a preferred subset. The filtering language accepts strings like \"displayName=tokyo\", and is documented in more detail in [AIP-160](https://google.aip.dev/160).",
                   "location": "query",
                   "type": "string"
                 },
@@ -156,13 +156,13 @@
                   "type": "string"
                 },
                 "pageSize": {
-                  "description": "The standard list page size.",
+                  "description": "The maximum number of results to return. If not set, the service will select a default.",
                   "format": "int32",
                   "location": "query",
                   "type": "integer"
                 },
                 "pageToken": {
-                  "description": "The standard list page token.",
+                  "description": "A page token received from the `next_page_token` field in the response. Send that page token to receive the subsequent page.",
                   "location": "query",
                   "type": "string"
                 }
@@ -180,7 +180,7 @@
             "instances": {
               "methods": {
                 "applyParameters": {
-                  "description": "ApplyParameters will restart the set of specified nodes in order to update them to the current set of parameters for the Memcached Instance.",
+                  "description": "`ApplyParameters` restarts the set of specified nodes in order to update them to the current set of parameters for the Memcached Instance.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:applyParameters",
                   "httpMethod": "POST",
                   "id": "memcache.projects.locations.instances.applyParameters",
@@ -217,7 +217,7 @@
                   ],
                   "parameters": {
                     "instanceId": {
-                      "description": "Required. The logical name of the Memcached instance in the user project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a number or a letter. * Must be unique within the user project / location If any of the above are not met, will raise an invalid argument error.",
+                      "description": "Required. The logical name of the Memcached instance in the user project with the following restrictions: * Must contain only lowercase letters, numbers, and hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a number or a letter. * Must be unique within the user project / location. If any of the above are not met, the API raises an invalid argument error.",
                       "location": "query",
                       "type": "string"
                     },
@@ -300,7 +300,7 @@
                   ],
                   "parameters": {
                     "filter": {
-                      "description": "List filter. For example, exclude all Memcached instances with name as my-instance by specifying \"name != my-instance\".",
+                      "description": "List filter. For example, exclude all Memcached instances with name as my-instance by specifying `\"name != my-instance\"`.",
                       "location": "query",
                       "type": "string"
                     },
@@ -310,13 +310,13 @@
                       "type": "string"
                     },
                     "pageSize": {
-                      "description": "The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the page_size value, the response may include a partial list and a caller should only rely on response's next_page_token to determine if there are more instances left to be queried.",
+                      "description": "The maximum number of items to return. If not specified, a default value of 1000 will be used by the service. Regardless of the `page_size` value, the response may include a partial list and a caller should only rely on response's `next_page_token` to determine if there are more instances left to be queried.",
                       "format": "int32",
                       "location": "query",
                       "type": "integer"
                     },
                     "pageToken": {
-                      "description": "The next_page_token value returned from a previous List request, if any.",
+                      "description": "The `next_page_token` value returned from a previous List request, if any.",
                       "location": "query",
                       "type": "string"
                     },
@@ -346,7 +346,7 @@
                   ],
                   "parameters": {
                     "name": {
-                      "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Memcached instances are managed and addressed at regional level so location_id here refers to a GCP region; however, users may choose which zones Memcached nodes within an instances should be provisioned in. Refer to [zones] field for more details.",
+                      "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Memcached instances are managed and addressed at the regional level so `location_id` here refers to a Google Cloud region; however, users may choose which zones Memcached nodes should be provisioned in within an instance. Refer to zones field for more details.",
                       "location": "path",
                       "pattern": "^projects/[^/]+/locations/[^/]+/instances/[^/]+$",
                       "required": true,
@@ -371,7 +371,7 @@
                   ]
                 },
                 "updateParameters": {
-                  "description": "Updates the defined Memcached Parameters for an existing Instance. This method only stages the parameters, it must be followed by ApplyParameters to apply the parameters to nodes of the Memcached Instance.",
+                  "description": "Updates the defined Memcached parameters for an existing instance. This method only stages the parameters, it must be followed by `ApplyParameters` to apply the parameters to nodes of the Memcached instance.",
                   "flatPath": "v1/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:updateParameters",
                   "httpMethod": "PATCH",
                   "id": "memcache.projects.locations.instances.updateParameters",
@@ -528,19 +528,19 @@
       }
     }
   },
-  "revision": "20210209",
+  "revision": "20210401",
   "rootUrl": "https://memcache.googleapis.com/",
   "schemas": {
     "ApplyParametersRequest": {
       "description": "Request for ApplyParameters.",
       "id": "ApplyParametersRequest",
       "properties": {
         "applyAll": {
-          "description": "Whether to apply instance-level parameter group to all nodes. If set to true, will explicitly restrict users from specifying any nodes, and apply parameter group updates to all nodes within the instance.",
+          "description": "Whether to apply instance-level parameter group to all nodes. If set to true, users are restricted from specifying individual nodes, and `ApplyParameters` updates all nodes within the instance.",
           "type": "boolean"
         },
         "nodeIds": {
-          "description": "Nodes to which we should apply the instance-level parameter group.",
+          "description": "Nodes to which the instance-level parameter group is applied.",
           "items": {
             "type": "string"
           },
@@ -618,6 +618,21 @@
       "properties": {},
       "type": "object"
     },
+    "GoogleCloudMemcacheV1LocationMetadata": {
+      "description": "Metadata for the given google.cloud.location.Location.",
+      "id": "GoogleCloudMemcacheV1LocationMetadata",
+      "properties": {
+        "availableZones": {
+          "additionalProperties": {
+            "$ref": "GoogleCloudMemcacheV1ZoneMetadata"
+          },
+          "description": "Output only. The set of available zones in the location. The map is keyed by the lowercase ID of each zone, as defined by GCE. These keys can be specified in the `zones` field when creating a Memcached instance.",
+          "readOnly": true,
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudMemcacheV1OperationMetadata": {
       "description": "Represents the metadata of a long-running operation.",
       "id": "GoogleCloudMemcacheV1OperationMetadata",
@@ -662,6 +677,11 @@
       },
       "type": "object"
     },
+    "GoogleCloudMemcacheV1ZoneMetadata": {
+      "id": "GoogleCloudMemcacheV1ZoneMetadata",
+      "properties": {},
+      "type": "object"
+    },
     "GoogleCloudSaasacceleratorManagementProvidersV1Instance": {
       "id": "GoogleCloudSaasacceleratorManagementProvidersV1Instance",
       "properties": {
@@ -778,7 +798,7 @@
       "id": "GoogleCloudSaasacceleratorManagementProvidersV1MaintenanceSchedule",
       "properties": {
         "canReschedule": {
-          "description": "Can this scheduled update be rescheduled? By default, it's true and API needs to do explicitly check whether it's set, if it's set as false explicitly, it's false",
+          "description": "This field will be deprecated, and will be always set to true since reschedule can happen multiple times now.",
           "type": "boolean"
         },
         "endTime": {
@@ -791,7 +811,7 @@
           "type": "string"
         },
         "scheduleDeadlineTime": {
-          "description": "schedule_deadline_time is the time deadline any schedule start time cannot go beyond, including reschedule. It's normally the initial schedule start time plus a week. If the reschedule type is next window, simply take this value as start time. If reschedule type is IMMEDIATELY or BY_TIME, current or selected time cannot go beyond this deadline.",
+          "description": "schedule_deadline_time is the time deadline any schedule start time cannot go beyond, including reschedule. It's normally the initial schedule start time plus maintenance window length (1 day or 1 week). Maintenance cannot be scheduled to start beyond this deadline.",
           "format": "google-datetime",
           "type": "string"
         },
@@ -847,6 +867,20 @@
       },
       "type": "object"
     },
+    "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility": {
+      "description": "PerSliSloEligibility is a mapping from an SLI name to eligibility.",
+      "id": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility",
+      "properties": {
+        "eligibilities": {
+          "additionalProperties": {
+            "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility"
+          },
+          "description": "An entry in the eligibilities map specifies an eligibility for a particular SLI for the given instance. The SLI key in the name must be a valid SLI name specified in the Eligibility Exporter binary flags otherwise an error will be emitted by Eligibility Exporter and the oncaller will be alerted. If an SLI has been defined in the binary flags but the eligibilities map does not contain it, the corresponding SLI time series will not be emitted by the Eligibility Exporter. This ensures a smooth rollout and compatibility between the data produced by different versions of the Eligibility Exporters. If eligibilities map contains a key for an SLI which has not been declared in the binary flags, there will be an error message emitted in the Eligibility Exporter log and the metric for the SLI in question will not be emitted.",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
     "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource": {
       "description": "Describes provisioned dataplane resources.",
       "id": "GoogleCloudSaasacceleratorManagementProvidersV1ProvisionedResource",
@@ -891,7 +925,7 @@
           "type": "string"
         },
         "sliName": {
-          "description": "Name of an SLI that this exclusion applies to. Can be left empty, signaling that the instance should be excluded from all SLIs defined in the service SLO configuration.",
+          "description": "Name of an SLI that this exclusion applies to. Can be left empty, signaling that the instance should be excluded from all SLIs.",
           "type": "string"
         },
         "startTime": {
@@ -908,7 +942,7 @@
       "properties": {
         "eligibility": {
           "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1SloEligibility",
-          "description": "Optional. User-defined instance eligibility."
+          "description": "Optional. Global per-instance SLI eligibility which applies to all defined SLIs. Exactly one of 'eligibility' and 'per_sli_eligibility' fields must be used."
         },
         "exclusions": {
           "description": "List of SLO exclusion windows. When multiple entries in the list match (matching the exclusion time-window against current time point) the exclusion reason used in the first matching entry will be published. It is not needed to include expired exclusion in this list, as only the currently applicable exclusions are taken into account by the eligibility exporting subsystem (the historical state of exclusions will be reflected in the historically produced timeseries regardless of the current state). This field can be used to mark the instance as temporary ineligible for the purpose of SLO calculation. For permanent instance SLO exclusion, use of custom instance eligibility is recommended. See 'eligibility' field below.",
@@ -924,6 +958,10 @@
           },
           "type": "array"
         },
+        "perSliEligibility": {
+          "$ref": "GoogleCloudSaasacceleratorManagementProvidersV1PerSliSloEligibility",
+          "description": "Optional. Multiple per-instance SLI eligibilities which apply for individual SLIs. Exactly one of 'eligibility' and 'per_sli_eligibility' fields must be used."
+        },
         "tier": {
           "description": "Name of the SLO tier the Instance belongs to. This name will be expected to match the tiers specified in the service SLO configuration. Field is mandatory and must not be empty.",
           "type": "string"
@@ -932,6 +970,7 @@
       "type": "object"
     },
     "Instance": {
+      "description": "A Memorystore for Memcached instance",
       "id": "Instance",
       "properties": {
         "authorizedNetwork": {
@@ -945,16 +984,16 @@
           "type": "string"
         },
         "discoveryEndpoint": {
-          "description": "Output only. Endpoint for Discovery API",
+          "description": "Output only. Endpoint for the Discovery API.",
           "readOnly": true,
           "type": "string"
         },
         "displayName": {
-          "description": "User provided name for the instance only used for display purposes. Cannot be more than 80 characters.",
+          "description": "User provided name for the instance, which is only used for display purposes. Cannot be more than 80 characters.",
           "type": "string"
         },
         "instanceMessages": {
-          "description": "List of messages that describe current statuses of memcached instance.",
+          "description": "List of messages that describe the current state of the Memcached instance.",
           "items": {
             "$ref": "InstanceMessage"
           },
@@ -973,15 +1012,15 @@
           "type": "string"
         },
         "memcacheNodes": {
-          "description": "Output only. List of Memcached nodes. Refer to [Node] message for more details.",
+          "description": "Output only. List of Memcached nodes. Refer to Node message for more details.",
           "items": {
             "$ref": "Node"
           },
           "readOnly": true,
           "type": "array"
         },
         "memcacheVersion": {
-          "description": "The major version of Memcached software. If not provided, latest supported version will be used. Currently the latest supported major version is MEMCACHE_1_5. The minor version will be automatically determined by our system based on the latest supported minor version.",
+          "description": "The major version of Memcached software. If not provided, latest supported version will be used. Currently the latest supported major version is `MEMCACHE_1_5`. The minor version will be automatically determined by our system based on the latest supported minor version.",
           "enum": [
             "MEMCACHE_VERSION_UNSPECIFIED",
             "MEMCACHE_1_5"
@@ -993,7 +1032,7 @@
           "type": "string"
         },
         "name": {
-          "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Memcached instances are managed and addressed at regional level so location_id here refers to a GCP region; however, users may choose which zones Memcached nodes within an instances should be provisioned in. Refer to [zones] field for more details.",
+          "description": "Required. Unique name of the resource in this scope including project and location using the form: `projects/{project_id}/locations/{location_id}/instances/{instance_id}` Note: Memcached instances are managed and addressed at the regional level so `location_id` here refers to a Google Cloud region; however, users may choose which zones Memcached nodes should be provisioned in within an instance. Refer to zones field for more details.",
           "type": "string"
         },
         "nodeConfig": {
@@ -1035,7 +1074,7 @@
           "type": "string"
         },
         "zones": {
-          "description": "Zones where Memcached nodes should be provisioned in. Memcached nodes will be equally distributed across these zones. If not provided, the service will by default create nodes in all zones in the region for the instance.",
+          "description": "Zones in which Memcached nodes should be provisioned. Memcached nodes will be equally distributed across these zones. If not provided, the service will by default create nodes in all zones in the region for the instance.",
           "items": {
             "type": "string"
           },
@@ -1242,10 +1281,11 @@
       "type": "object"
     },
     "MemcacheParameters": {
+      "description": "The unique ID associated with this set of parameters. Users can use this id to determine if the parameters associated with the instance differ from the parameters associated with the nodes. A discrepancy between parameter ids can inform users that they may need to take action to apply parameters on nodes.",
       "id": "MemcacheParameters",
       "properties": {
         "id": {
-          "description": "Output only. The unique ID associated with this set of parameters. Users can use this id to determine if the parameters associated with the instance differ from the parameters associated with the nodes and any action needs to be taken to apply parameters on nodes.",
+          "description": "Output only.",
           "readOnly": true,
           "type": "string"
         },