feat(apigee): update the api

#### apigee:v1 The following keys were added: - resources.organizations.resources.envgroups.methods.getDeployedIngressConfig (Total Keys: 13) - schemas.GoogleCloudApigeeV1DeploymentConfig.properties.deploymentGroups (Total Keys: 2) - schemas.GoogleCloudApigeeV1DeploymentConfig.properties.endpoints (Total Keys: 2) - schemas.GoogleCloudApigeeV1DeploymentGroupConfig (Total Keys: 4) - schemas.GoogleCloudApigeeV1EndpointChainingRule (Total Keys: 5) - schemas.GoogleCloudApigeeV1EnvironmentConfig.properties.deploymentGroups (Total Keys: 2) - schemas.GoogleCloudApigeeV1EnvironmentGroupConfig.properties.endpointChainingRules (Total Keys: 2) - schemas.GoogleCloudApigeeV1EnvironmentGroupConfig.properties.location.type (Total Keys: 1) - schemas.GoogleCloudApigeeV1RoutingRule.properties.deploymentGroup.type (Total Keys: 1) - schemas.GoogleCloudApigeeV1RoutingRule.properties.otherTargets (Total Keys: 2)
googleapis · Dec 20, 2022 · 43f435c · 43f435c
1 parent ec22103
commit 43f435c
Show file tree

Hide file tree

Showing 5 changed files with 219 additions and 12 deletions.
diff --git a/docs/dyn/apigee_v1.organizations.envgroups.html b/docs/dyn/apigee_v1.organizations.envgroups.html
@@ -91,6 +91,9 @@ <h2>Instance Methods</h2>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Gets an environment group.</p>
+<p class="toc_element">
+  <code><a href="#getDeployedIngressConfig">getDeployedIngressConfig(name, view=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Gets the deployed ingress configuration for an environment group.</p>
 <p class="toc_element">
   <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists all environment groups.</p>
@@ -215,6 +218,57 @@ <h3>Method Details</h3>
 }</pre>
 </div>
 
+<div class="method">
+    <code class="details" id="getDeployedIngressConfig">getDeployedIngressConfig(name, view=None, x__xgafv=None)</code>
+  <pre>Gets the deployed ingress configuration for an environment group.
+
+Args:
+  name: string, Required. Name of the deployed configuration for the environment group in the following format: &#x27;organizations/{org}/envgroups/{envgroup}/deployedIngressConfig&#x27;. (required)
+  view: string, When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response&#x27;s RoutingRules.
+    Allowed values
+      INGRESS_CONFIG_VIEW_UNSPECIFIED - The default/unset value. The API will default to the BASIC view.
+      BASIC - Include all ingress config data necessary for the runtime to configure ingress, but no more. Routing rules will include only basepath and destination environment. This the default value.
+      FULL - Include all ingress config data, including internal debug info for each routing rule such as the proxy claiming a particular basepath and when the routing rule first appeared in the env group.
+  x__xgafv: string, V1 error format.
+    Allowed values
+      1 - v1 error format
+      2 - v2 error format
+
+Returns:
+  An object of the form:
+
+    { # EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules.
+  &quot;endpointChainingRules&quot;: [ # A list of proxies in each deployment group for proxy chaining calls.
+    { # EndpointChainingRule specifies the proxies contained in a particular deployment group, so that other deployment groups can find them in chaining calls.
+      &quot;deploymentGroup&quot;: &quot;A String&quot;, # The deployment group to target for cross-shard chaining calls to these proxies.
+      &quot;proxyIds&quot;: [ # List of proxy ids which may be found in the given deployment group.
+        &quot;A String&quot;,
+      ],
+    },
+  ],
+  &quot;hostnames&quot;: [ # Host names for the environment group.
+    &quot;A String&quot;,
+  ],
+  &quot;location&quot;: &quot;A String&quot;, # When this message appears in the top-level IngressConfig, this field will be populated in lieu of the inlined routing_rules and hostnames fields. Some URL for downloading the full EnvironmentGroupConfig for this group.
+  &quot;name&quot;: &quot;A String&quot;, # Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.
+  &quot;revisionId&quot;: &quot;A String&quot;, # Revision id that defines the ordering of the EnvironmentGroupConfig resource. The higher the revision, the more recently the configuration was deployed.
+  &quot;routingRules&quot;: [ # Ordered list of routing rules defining how traffic to this environment group&#x27;s hostnames should be routed to different environments.
+    {
+      &quot;basepath&quot;: &quot;A String&quot;, # URI path prefix used to route to the specified environment. May contain one or more wildcards. For example, path segments consisting of a single `*` character will match any string.
+      &quot;deploymentGroup&quot;: &quot;A String&quot;, # Name of a deployment group in an environment bound to the environment group in the following format: `organizations/{org}/environment/{env}/deploymentGroups/{group}` Only one of environment or deployment_group will be set.
+      &quot;envGroupRevision&quot;: &quot;A String&quot;, # The env group config revision_id when this rule was added or last updated. This value is set when the rule is created and will only update if the the environment_id changes. It is used to determine if the runtime is up to date with respect to this rule. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
+      &quot;environment&quot;: &quot;A String&quot;, # Name of an environment bound to the environment group in the following format: `organizations/{org}/environments/{env}`. Only one of environment or deployment_group will be set.
+      &quot;otherTargets&quot;: [ # Conflicting targets, which will be resource names specifying either deployment groups or environments.
+        &quot;A String&quot;,
+      ],
+      &quot;receiver&quot;: &quot;A String&quot;, # The resource name of the proxy revision that is receiving this basepath in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
+      &quot;updateTime&quot;: &quot;A String&quot;, # The unix timestamp when this rule was updated. This is updated whenever env_group_revision is updated. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
+    },
+  ],
+  &quot;uid&quot;: &quot;A String&quot;, # A unique id for the environment group config that will only change if the environment group is deleted and recreated.
+}</pre>
+</div>
+
 <div class="method">
     <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists all environment groups.

diff --git a/docs/dyn/apigee_v1.organizations.environments.html b/docs/dyn/apigee_v1.organizations.environments.html
@@ -481,19 +481,33 @@ <h3>Method Details</h3>
       &quot;A String&quot;,
     ],
   },
+  &quot;deploymentGroups&quot;: [ # List of deployment groups in the environment.
+    { # DeploymentGroupConfig represents a deployment group that should be present in a particular environment.
+      &quot;name&quot;: &quot;A String&quot;, # Name of the deployment group in the following format: `organizations/{org}/environments/{env}/deploymentGroups/{group}`.
+      &quot;revisionId&quot;: &quot;A String&quot;, # Revision number which can be used by the runtime to detect if the deployment group has changed between two versions.
+      &quot;uid&quot;: &quot;A String&quot;, # Unique ID. The ID will only change if the deployment group is deleted and recreated.
+    },
+  ],
   &quot;deployments&quot;: [ # List of deployments in the environment.
-    { # NEXT ID: 9
+    { # NEXT ID: 11
       &quot;attributes&quot;: { # Additional key-value metadata for the deployment.
         &quot;a_key&quot;: &quot;A String&quot;,
       },
       &quot;basePath&quot;: &quot;A String&quot;, # Base path where the application will be hosted. Defaults to &quot;/&quot;.
+      &quot;deploymentGroups&quot;: [ # The list of deployment groups in which this proxy should be deployed. Not currently populated for shared flows.
+        &quot;A String&quot;,
+      ],
+      &quot;endpoints&quot;: { # A mapping from basepaths to proxy endpoint names in this proxy. Not populated for shared flows.
+        &quot;a_key&quot;: &quot;A String&quot;,
+      },
       &quot;location&quot;: &quot;A String&quot;, # Location of the API proxy bundle as a URI.
       &quot;name&quot;: &quot;A String&quot;, # Name of the API or shared flow revision to be deployed in the following format: `organizations/{org}/apis/{api}/revisions/{rev}` or `organizations/{org}/sharedflows/{sharedflow}/revisions/{rev}`
       &quot;proxyUid&quot;: &quot;A String&quot;, # Unique ID of the API proxy revision.
       &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account identity associated with this deployment. If non-empty, will be in the following format: `projects/-/serviceAccounts/{account_email}`
       &quot;uid&quot;: &quot;A String&quot;, # Unique ID. The ID will only change if the deployment is deleted and recreated.
     },
   ],
+  &quot;envScopedRevisionId&quot;: &quot;A String&quot;, # Revision ID for environment-scoped resources (e.g. target servers, keystores) in this config. This ID will increment any time a resource not scoped to a deployment group changes.
   &quot;featureFlags&quot;: { # Feature flags inherited from the organization and environment.
     &quot;a_key&quot;: &quot;A String&quot;,
   },

diff --git a/docs/dyn/apigee_v1.organizations.environments.targetservers.html b/docs/dyn/apigee_v1.organizations.environments.targetservers.html
@@ -104,7 +104,7 @@ <h3>Method Details</h3>
   body: object, The request body.
     The object takes the form of:
 
-{ # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+{ # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.
@@ -140,7 +140,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+    { # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.
@@ -182,7 +182,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+    { # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.
@@ -224,7 +224,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+    { # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.
@@ -261,7 +261,7 @@ <h3>Method Details</h3>
   body: object, The request body.
     The object takes the form of:
 
-{ # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+{ # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.
@@ -296,7 +296,7 @@ <h3>Method Details</h3>
 Returns:
   An object of the form:
 
-    { # TargetServer configuration. TargetServers are used to decouple a proxy&#x27;s TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
+    { # TargetServer configuration. TargetServers are used to decouple a proxy TargetEndpoint HTTPTargetConnections from concrete URLs for backend services.
   &quot;description&quot;: &quot;A String&quot;, # Optional. A human-readable description of this TargetServer.
   &quot;host&quot;: &quot;A String&quot;, # Required. The host name this target connects to. Value must be a valid hostname as described by RFC-1123.
   &quot;isEnabled&quot;: True or False, # Optional. Enabling/disabling a TargetServer is useful when TargetServers are used in load balancing configurations, and one or more TargetServers need to taken out of rotation periodically. Defaults to true.

diff --git a/docs/dyn/apigee_v1.organizations.html b/docs/dyn/apigee_v1.organizations.html
@@ -445,16 +445,29 @@ <h3>Method Details</h3>
     {
   &quot;environmentGroups&quot;: [ # List of environment groups in the organization.
     { # EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules.
+      &quot;endpointChainingRules&quot;: [ # A list of proxies in each deployment group for proxy chaining calls.
+        { # EndpointChainingRule specifies the proxies contained in a particular deployment group, so that other deployment groups can find them in chaining calls.
+          &quot;deploymentGroup&quot;: &quot;A String&quot;, # The deployment group to target for cross-shard chaining calls to these proxies.
+          &quot;proxyIds&quot;: [ # List of proxy ids which may be found in the given deployment group.
+            &quot;A String&quot;,
+          ],
+        },
+      ],
       &quot;hostnames&quot;: [ # Host names for the environment group.
         &quot;A String&quot;,
       ],
+      &quot;location&quot;: &quot;A String&quot;, # When this message appears in the top-level IngressConfig, this field will be populated in lieu of the inlined routing_rules and hostnames fields. Some URL for downloading the full EnvironmentGroupConfig for this group.
       &quot;name&quot;: &quot;A String&quot;, # Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`.
       &quot;revisionId&quot;: &quot;A String&quot;, # Revision id that defines the ordering of the EnvironmentGroupConfig resource. The higher the revision, the more recently the configuration was deployed.
       &quot;routingRules&quot;: [ # Ordered list of routing rules defining how traffic to this environment group&#x27;s hostnames should be routed to different environments.
         {
           &quot;basepath&quot;: &quot;A String&quot;, # URI path prefix used to route to the specified environment. May contain one or more wildcards. For example, path segments consisting of a single `*` character will match any string.
+          &quot;deploymentGroup&quot;: &quot;A String&quot;, # Name of a deployment group in an environment bound to the environment group in the following format: `organizations/{org}/environment/{env}/deploymentGroups/{group}` Only one of environment or deployment_group will be set.
           &quot;envGroupRevision&quot;: &quot;A String&quot;, # The env group config revision_id when this rule was added or last updated. This value is set when the rule is created and will only update if the the environment_id changes. It is used to determine if the runtime is up to date with respect to this rule. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
-          &quot;environment&quot;: &quot;A String&quot;, # Name of an environment bound to the environment group in the following format: `organizations/{org}/environments/{env}`.
+          &quot;environment&quot;: &quot;A String&quot;, # Name of an environment bound to the environment group in the following format: `organizations/{org}/environments/{env}`. Only one of environment or deployment_group will be set.
+          &quot;otherTargets&quot;: [ # Conflicting targets, which will be resource names specifying either deployment groups or environments.
+            &quot;A String&quot;,
+          ],
           &quot;receiver&quot;: &quot;A String&quot;, # The resource name of the proxy revision that is receiving this basepath in the following format: `organizations/{org}/apis/{api}/revisions/{rev}`. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
           &quot;updateTime&quot;: &quot;A String&quot;, # The unix timestamp when this rule was updated. This is updated whenever env_group_revision is updated. This field is omitted from the IngressConfig unless the GetDeployedIngressConfig API is called with view=FULL.
         },