build: run docs regen in synth.py (#1059)

diff --git a/docs/dyn/apigee_v1.organizations.instances.html b/docs/dyn/apigee_v1.organizations.instances.html
index f29ee48..101fc43 100644
--- a/docs/dyn/apigee_v1.organizations.instances.html
+++ b/docs/dyn/apigee_v1.organizations.instances.html
@@ -80,6 +80,11 @@
 <p class="firstline">Returns the attachments Resource.</p>
 
 <p class="toc_element">
+  <code><a href="apigee_v1.organizations.instances.canaryevaluations.html">canaryevaluations()</a></code>
+</p>
+<p class="firstline">Returns the canaryevaluations Resource.</p>
+
+<p class="toc_element">
   <code><a href="#close">close()</a></code></p>
 <p class="firstline">Close httplib2 connections.</p>
 <p class="toc_element">
@@ -116,15 +121,16 @@
     The object takes the form of:
 
 { # Apigee runtime instance.
-  &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
-  &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
-  &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
-  &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
   &quot;createdAt&quot;: &quot;A String&quot;, # Output only. Time the instance was created in milliseconds since epoch.
-  &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+  &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
   &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Apigee endpoint used by clients to connect to the service.
-  &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+  &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
+  &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+  &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
   &quot;lastModifiedAt&quot;: &quot;A String&quot;, # Output only. Time the instance was last modified in milliseconds since epoch.
+  &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+  &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
+  &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance. Values other than ACTIVE means the resource is not ready to use.
 }
 
   x__xgafv: string, V1 error format.
@@ -136,23 +142,23 @@
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
+    &quot;error&quot;: { # 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.
+      &quot;message&quot;: &quot;A String&quot;, # 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.
+      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+        {
+          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
+    },
+    &quot;name&quot;: &quot;A String&quot;, # 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}`.
+    &quot;done&quot;: 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.
     &quot;response&quot;: { # 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`.
       &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
     &quot;metadata&quot;: { # 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.
       &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
-    &quot;error&quot;: { # 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.
-      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
-      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
-        {
-          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
-        },
-      ],
-      &quot;message&quot;: &quot;A String&quot;, # 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.
-    },
-    &quot;name&quot;: &quot;A String&quot;, # 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}`.
-    &quot;done&quot;: 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.
   }</pre>
 </div>
 
@@ -161,7 +167,7 @@
   <pre>Deletes an Apigee runtime instance. The instance stops serving requests and the runtime data is deleted. **Note:** Not supported for Apigee hybrid.
 
 Args:
-  name: string, Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instance/{instance}`. (required)
+  name: string, Required. Name of the instance. Use the following structure in your request: `organizations/{org}/instances/{instance}`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -171,23 +177,23 @@
   An object of the form:
 
     { # This resource represents a long-running operation that is the result of a network API call.
+    &quot;error&quot;: { # 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.
+      &quot;message&quot;: &quot;A String&quot;, # 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.
+      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
+        {
+          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
+    },
+    &quot;name&quot;: &quot;A String&quot;, # 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}`.
+    &quot;done&quot;: 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.
     &quot;response&quot;: { # 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`.
       &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
     &quot;metadata&quot;: { # 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.
       &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
-    &quot;error&quot;: { # 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.
-      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
-      &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
-        {
-          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
-        },
-      ],
-      &quot;message&quot;: &quot;A String&quot;, # 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.
-    },
-    &quot;name&quot;: &quot;A String&quot;, # 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}`.
-    &quot;done&quot;: 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.
   }</pre>
 </div>
 
@@ -206,15 +212,16 @@
   An object of the form:
 
     { # Apigee runtime instance.
-    &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
-    &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
-    &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
-    &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
     &quot;createdAt&quot;: &quot;A String&quot;, # Output only. Time the instance was created in milliseconds since epoch.
-    &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+    &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
     &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Apigee endpoint used by clients to connect to the service.
-    &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+    &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
+    &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+    &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
     &quot;lastModifiedAt&quot;: &quot;A String&quot;, # Output only. Time the instance was last modified in milliseconds since epoch.
+    &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+    &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
+    &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance. Values other than ACTIVE means the resource is not ready to use.
   }</pre>
 </div>
 
@@ -235,20 +242,21 @@
   An object of the form:
 
     { # Response for ListInstances.
+    &quot;nextPageToken&quot;: &quot;A String&quot;, # Page token that you can include in a ListInstance request to retrieve the next page of content. If omitted, no subsequent pages exist.
     &quot;instances&quot;: [ # Instances in the specified organization.
       { # Apigee runtime instance.
-        &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
-        &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
-        &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
-        &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
         &quot;createdAt&quot;: &quot;A String&quot;, # Output only. Time the instance was created in milliseconds since epoch.
-        &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+        &quot;diskEncryptionKeyName&quot;: &quot;A String&quot;, # Optional. Customer Managed Encryption Key (CMEK) used for disk &amp; volume encryption.
         &quot;host&quot;: &quot;A String&quot;, # Output only. Hostname or IP address of the exposed Apigee endpoint used by clients to connect to the service.
-        &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+        &quot;location&quot;: &quot;A String&quot;, # Required. Compute Engine location where the instance resides.
+        &quot;port&quot;: &quot;A String&quot;, # Output only. Port number of the exposed Apigee endpoint.
+        &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the instance.
         &quot;lastModifiedAt&quot;: &quot;A String&quot;, # Output only. Time the instance was last modified in milliseconds since epoch.
+        &quot;displayName&quot;: &quot;A String&quot;, # Optional. Display name for the instance.
+        &quot;name&quot;: &quot;A String&quot;, # Required. Resource ID of the instance. Values must match the regular expression `^a-z{0,30}[a-z\d]$`.
+        &quot;state&quot;: &quot;A String&quot;, # Output only. State of the instance. Values other than ACTIVE means the resource is not ready to use.
       },
     ],
-    &quot;nextPageToken&quot;: &quot;A String&quot;, # Page token that you can include in a ListInstance request to retrieve the next page of content. If omitted, no subsequent pages exist.
   }</pre>
 </div>
 
@@ -276,30 +284,30 @@
     The object takes the form of:
 
 { # Request for ReportInstanceStatus.
-    &quot;reportTime&quot;: &quot;A String&quot;, # The time the report was generated in the runtime. Used to prevent an old status from overwriting a newer one. An instance should space out it&#x27;s status reports so that clock skew does not play a factor.
-    &quot;instanceUid&quot;: &quot;A String&quot;, # A unique ID for the instance which is guaranteed to be unique in case the user installs multiple hybrid runtimes with the same instance ID.
     &quot;resources&quot;: [ # Status for config resources
       { # The status of a resource loaded in the runtime.
-        &quot;totalReplicas&quot;: 42, # The total number of replicas that should have this resource.
-        &quot;resource&quot;: &quot;A String&quot;, # The resource name. Currently only two resources are supported: EnvironmentGroup - organizations/{org}/envgroups/{envgroup} EnvironmentConfig - organizations/{org}/environments/{environment}/deployedConfig
         &quot;uid&quot;: &quot;A String&quot;, # The uid of the resource. In the unexpected case that the instance has multiple uids for the same name, they should be reported under separate ResourceStatuses.
         &quot;revisions&quot;: [ # Revisions of the resource currently deployed in the instance.
           { # The status of a specific resource revision.
             &quot;errors&quot;: [ # Errors reported when attempting to load this revision.
               { # Details on why a resource update failed in the runtime.
-                &quot;type&quot;: &quot;A String&quot;, # A string that uniquely identifies the type of error. This provides a more reliable means to deduplicate errors across revisions and instances.
-                &quot;resource&quot;: &quot;A String&quot;, # The sub resource specific to this error (e.g. a proxy deployed within the EnvironmentConfig). If empty the error refers to the top level resource.
-                &quot;message&quot;: &quot;A String&quot;, # User-friendly error message.
                 &quot;code&quot;: &quot;A String&quot;, # Status code.
+                &quot;message&quot;: &quot;A String&quot;, # User-friendly error message.
+                &quot;resource&quot;: &quot;A String&quot;, # The sub resource specific to this error (e.g. a proxy deployed within the EnvironmentConfig). If empty the error refers to the top level resource.
+                &quot;type&quot;: &quot;A String&quot;, # A string that uniquely identifies the type of error. This provides a more reliable means to deduplicate errors across revisions and instances.
               },
             ],
-            &quot;jsonSpec&quot;: &quot;A String&quot;, # The json content of the resource revision.
             &quot;replicas&quot;: 42, # The number of replicas that have successfully loaded this revision.
             &quot;revisionId&quot;: &quot;A String&quot;, # The revision of the resource.
+            &quot;jsonSpec&quot;: &quot;A String&quot;, # The json content of the resource revision.
           },
         ],
+        &quot;resource&quot;: &quot;A String&quot;, # The resource name. Currently only two resources are supported: EnvironmentGroup - organizations/{org}/envgroups/{envgroup} EnvironmentConfig - organizations/{org}/environments/{environment}/deployedConfig
+        &quot;totalReplicas&quot;: 42, # The total number of replicas that should have this resource.
       },
     ],
+    &quot;reportTime&quot;: &quot;A String&quot;, # The time the report was generated in the runtime. Used to prevent an old status from overwriting a newer one. An instance should space out it&#x27;s status reports so that clock skew does not play a factor.
+    &quot;instanceUid&quot;: &quot;A String&quot;, # A unique ID for the instance which is guaranteed to be unique in case the user installs multiple hybrid runtimes with the same instance ID.
   }
 
   x__xgafv: string, V1 error format.