1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="apigee_v1.html">Apigee API</a> . <a href="apigee_v1.organizations.html">organizations</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="apigee_v1.organizations.analytics.html">analytics()</a></code> 79</p> 80<p class="firstline">Returns the analytics Resource.</p> 81 82<p class="toc_element"> 83 <code><a href="apigee_v1.organizations.apiproducts.html">apiproducts()</a></code> 84</p> 85<p class="firstline">Returns the apiproducts Resource.</p> 86 87<p class="toc_element"> 88 <code><a href="apigee_v1.organizations.apis.html">apis()</a></code> 89</p> 90<p class="firstline">Returns the apis Resource.</p> 91 92<p class="toc_element"> 93 <code><a href="apigee_v1.organizations.apps.html">apps()</a></code> 94</p> 95<p class="firstline">Returns the apps Resource.</p> 96 97<p class="toc_element"> 98 <code><a href="apigee_v1.organizations.datacollectors.html">datacollectors()</a></code> 99</p> 100<p class="firstline">Returns the datacollectors Resource.</p> 101 102<p class="toc_element"> 103 <code><a href="apigee_v1.organizations.deployments.html">deployments()</a></code> 104</p> 105<p class="firstline">Returns the deployments Resource.</p> 106 107<p class="toc_element"> 108 <code><a href="apigee_v1.organizations.developers.html">developers()</a></code> 109</p> 110<p class="firstline">Returns the developers Resource.</p> 111 112<p class="toc_element"> 113 <code><a href="apigee_v1.organizations.envgroups.html">envgroups()</a></code> 114</p> 115<p class="firstline">Returns the envgroups Resource.</p> 116 117<p class="toc_element"> 118 <code><a href="apigee_v1.organizations.environments.html">environments()</a></code> 119</p> 120<p class="firstline">Returns the environments Resource.</p> 121 122<p class="toc_element"> 123 <code><a href="apigee_v1.organizations.hostQueries.html">hostQueries()</a></code> 124</p> 125<p class="firstline">Returns the hostQueries Resource.</p> 126 127<p class="toc_element"> 128 <code><a href="apigee_v1.organizations.hostStats.html">hostStats()</a></code> 129</p> 130<p class="firstline">Returns the hostStats Resource.</p> 131 132<p class="toc_element"> 133 <code><a href="apigee_v1.organizations.instances.html">instances()</a></code> 134</p> 135<p class="firstline">Returns the instances Resource.</p> 136 137<p class="toc_element"> 138 <code><a href="apigee_v1.organizations.keyvaluemaps.html">keyvaluemaps()</a></code> 139</p> 140<p class="firstline">Returns the keyvaluemaps Resource.</p> 141 142<p class="toc_element"> 143 <code><a href="apigee_v1.organizations.operations.html">operations()</a></code> 144</p> 145<p class="firstline">Returns the operations Resource.</p> 146 147<p class="toc_element"> 148 <code><a href="apigee_v1.organizations.optimizedHostStats.html">optimizedHostStats()</a></code> 149</p> 150<p class="firstline">Returns the optimizedHostStats Resource.</p> 151 152<p class="toc_element"> 153 <code><a href="apigee_v1.organizations.reports.html">reports()</a></code> 154</p> 155<p class="firstline">Returns the reports Resource.</p> 156 157<p class="toc_element"> 158 <code><a href="apigee_v1.organizations.sharedflows.html">sharedflows()</a></code> 159</p> 160<p class="firstline">Returns the sharedflows Resource.</p> 161 162<p class="toc_element"> 163 <code><a href="apigee_v1.organizations.sites.html">sites()</a></code> 164</p> 165<p class="firstline">Returns the sites Resource.</p> 166 167<p class="toc_element"> 168 <code><a href="#close">close()</a></code></p> 169<p class="firstline">Close httplib2 connections.</p> 170<p class="toc_element"> 171 <code><a href="#create">create(body=None, parent=None, x__xgafv=None)</a></code></p> 172<p class="firstline">Creates an Apigee organization. See [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org).</p> 173<p class="toc_element"> 174 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p> 175<p class="firstline">Delete an Apigee organization. Only supported for SubscriptionType TRIAL.</p> 176<p class="toc_element"> 177 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 178<p class="firstline">Gets the profile for an Apigee organization. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure).</p> 179<p class="toc_element"> 180 <code><a href="#getDeployedIngressConfig">getDeployedIngressConfig(name, view=None, x__xgafv=None)</a></code></p> 181<p class="firstline">Gets the deployed ingress configuration for an organization.</p> 182<p class="toc_element"> 183 <code><a href="#getRuntimeConfig">getRuntimeConfig(name, x__xgafv=None)</a></code></p> 184<p class="firstline">Get runtime config for an organization.</p> 185<p class="toc_element"> 186 <code><a href="#getSyncAuthorization">getSyncAuthorization(name, body=None, x__xgafv=None)</a></code></p> 187<p class="firstline">Lists the service accounts with the permissions required to allow the Synchronizer to download environment data from the control plane. An ETag is returned in the response to `getSyncAuthorization`. Pass that ETag when calling [setSyncAuthorization](setSyncAuthorization) to ensure that you are updating the correct version. If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. For more information, see [Configure the Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**: Available to Apigee hybrid only.</p> 188<p class="toc_element"> 189 <code><a href="#list">list(parent, x__xgafv=None)</a></code></p> 190<p class="firstline">Lists the Apigee organizations and associated GCP projects that you have permission to access. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure).</p> 191<p class="toc_element"> 192 <code><a href="#setAddons">setAddons(org, body=None, x__xgafv=None)</a></code></p> 193<p class="firstline">Configures the add-ons for the Apigee organization. The existing add-on configuration will be fully replaced.</p> 194<p class="toc_element"> 195 <code><a href="#setSyncAuthorization">setSyncAuthorization(name, body=None, x__xgafv=None)</a></code></p> 196<p class="firstline">Sets the permissions required to allow the Synchronizer to download environment data from the control plane. You must call this API to enable proper functioning of hybrid. Pass the ETag when calling `setSyncAuthorization` to ensure that you are updating the correct version. To get an ETag, call [getSyncAuthorization](getSyncAuthorization). If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. For more information, see [Configure the Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**: Available to Apigee hybrid only.</p> 197<p class="toc_element"> 198 <code><a href="#update">update(name, body=None, x__xgafv=None)</a></code></p> 199<p class="firstline">Updates the properties for an Apigee organization. No other fields in the organization profile will be updated.</p> 200<h3>Method Details</h3> 201<div class="method"> 202 <code class="details" id="close">close()</code> 203 <pre>Close httplib2 connections.</pre> 204</div> 205 206<div class="method"> 207 <code class="details" id="create">create(body=None, parent=None, x__xgafv=None)</code> 208 <pre>Creates an Apigee organization. See [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 209 210Args: 211 body: object, The request body. 212 The object takes the form of: 213 214{ 215 "addonsConfig": { # Add-on configurations for the Apigee organization. # Addon configurations of the Apigee organization. 216 "advancedApiOpsConfig": { # Configuration for the Advanced API Ops add-on. # Configuration for the Advanced API Ops add-on. 217 "enabled": True or False, # Flag that specifies whether the Advanced API Ops add-on is enabled. 218 }, 219 "connectorsPlatformConfig": { # Configuration for the Connectors Platform add-on. # Configuration for the Connectors Platform add-on. 220 "enabled": True or False, # Flag that specifies whether the Connectors Platform add-on is enabled. 221 "expiresAt": "A String", # Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire. 222 }, 223 "integrationConfig": { # Configuration for the Integration add-on. # Configuration for the Integration add-on. 224 "enabled": True or False, # Flag that specifies whether the Integration add-on is enabled. 225 }, 226 "monetizationConfig": { # Configuration for the Monetization add-on. # Configuration for the Monetization add-on. 227 "enabled": True or False, # Flag that specifies whether the Monetization add-on is enabled. 228 }, 229 }, 230 "analyticsRegion": "A String", # Required. Primary GCP region for analytics data storage. For valid values, see [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 231 "attributes": [ # Not used by Apigee. 232 "A String", 233 ], 234 "authorizedNetwork": "A String", # Compute Engine network used for Service Networking to be peered with Apigee runtime instances. See [Getting started with the Service Networking API](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started). Valid only when [RuntimeType](#RuntimeType) is set to `CLOUD`. The value must be set before the creation of a runtime instance and can be updated only when there are no runtime instances. For example: `default`. Apigee also supports shared VPC (that is, the host network project is not the same as the one that is peering with Apigee). See [Shared VPC overview](https://cloud.google.com/vpc/docs/shared-vpc). To use a shared VPC network, use the following format: `projects/{host-project-id}/{region}/networks/{network-name}`. For example: `projects/my-sharedvpc-host/global/networks/mynetwork` **Note:** Not supported for Apigee hybrid. 235 "billingType": "A String", # Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing). 236 "caCertificate": "A String", # Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`. 237 "createdAt": "A String", # Output only. Time that the Apigee organization was created in milliseconds since epoch. 238 "customerName": "A String", # Not used by Apigee. 239 "description": "A String", # Description of the Apigee organization. 240 "displayName": "A String", # Display name for the Apigee organization. Unused, but reserved for future use. 241 "environments": [ # Output only. List of environments in the Apigee organization. 242 "A String", 243 ], 244 "expiresAt": "A String", # Output only. Time that the Apigee organization is scheduled for deletion. 245 "lastModifiedAt": "A String", # Output only. Time that the Apigee organization was last modified in milliseconds since epoch. 246 "name": "A String", # Output only. Name of the Apigee organization. 247 "portalDisabled": True or False, # Configuration for the Portals settings. 248 "projectId": "A String", # Output only. Project ID associated with the Apigee organization. 249 "properties": { # Message for compatibility with legacy Edge specification for Java Properties object in JSON. # Properties defined in the Apigee organization profile. 250 "property": [ # List of all properties in the object 251 { # A single property entry in the Properties message. 252 "name": "A String", # The property key 253 "value": "A String", # The property value 254 }, 255 ], 256 }, 257 "runtimeDatabaseEncryptionKeyName": "A String", # Cloud KMS key name used for encrypting the data that is stored and replicated across runtime instances. Update is not allowed after the organization is created. Required when [RuntimeType](#RuntimeType) is `CLOUD`. If not specified when [RuntimeType](#RuntimeType) is `TRIAL`, a Google-Managed encryption key will be used. For example: "projects/foo/locations/us/keyRings/bar/cryptoKeys/baz". **Note:** Not supported for Apigee hybrid. 258 "runtimeType": "A String", # Required. Runtime type of the Apigee organization based on the Apigee subscription purchased. 259 "state": "A String", # Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use. 260 "subscriptionType": "A String", # Output only. DEPRECATED: This will eventually be replaced by BillingType. Subscription type of the Apigee organization. Valid values include trial (free, limited, and for evaluation purposes only) or paid (full subscription has been purchased). See [Apigee pricing](https://cloud.google.com/apigee/pricing/). 261 "type": "A String", # Not used by Apigee. 262} 263 264 parent: string, Required. Name of the GCP project in which to associate the Apigee organization. Pass the information as a query parameter using the following structure in your request: `projects/` 265 x__xgafv: string, V1 error format. 266 Allowed values 267 1 - v1 error format 268 2 - v2 error format 269 270Returns: 271 An object of the form: 272 273 { # This resource represents a long-running operation that is the result of a network API call. 274 "done": 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. 275 "error": { # 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. 276 "code": 42, # The status code, which should be an enum value of google.rpc.Code. 277 "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. 278 { 279 "a_key": "", # Properties of the object. Contains field @type with type URL. 280 }, 281 ], 282 "message": "A String", # 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. 283 }, 284 "metadata": { # 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. 285 "a_key": "", # Properties of the object. Contains field @type with type URL. 286 }, 287 "name": "A String", # 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}`. 288 "response": { # 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`. 289 "a_key": "", # Properties of the object. Contains field @type with type URL. 290 }, 291}</pre> 292</div> 293 294<div class="method"> 295 <code class="details" id="delete">delete(name, x__xgafv=None)</code> 296 <pre>Delete an Apigee organization. Only supported for SubscriptionType TRIAL. 297 298Args: 299 name: string, Required. Name of the organization. Use the following structure in your request: `organizations/{org}` (required) 300 x__xgafv: string, V1 error format. 301 Allowed values 302 1 - v1 error format 303 2 - v2 error format 304 305Returns: 306 An object of the form: 307 308 { # This resource represents a long-running operation that is the result of a network API call. 309 "done": 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. 310 "error": { # 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. 311 "code": 42, # The status code, which should be an enum value of google.rpc.Code. 312 "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. 313 { 314 "a_key": "", # Properties of the object. Contains field @type with type URL. 315 }, 316 ], 317 "message": "A String", # 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. 318 }, 319 "metadata": { # 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. 320 "a_key": "", # Properties of the object. Contains field @type with type URL. 321 }, 322 "name": "A String", # 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}`. 323 "response": { # 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`. 324 "a_key": "", # Properties of the object. Contains field @type with type URL. 325 }, 326}</pre> 327</div> 328 329<div class="method"> 330 <code class="details" id="get">get(name, x__xgafv=None)</code> 331 <pre>Gets the profile for an Apigee organization. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure). 332 333Args: 334 name: string, Required. Apigee organization name in the following format: `organizations/{org}` (required) 335 x__xgafv: string, V1 error format. 336 Allowed values 337 1 - v1 error format 338 2 - v2 error format 339 340Returns: 341 An object of the form: 342 343 { 344 "addonsConfig": { # Add-on configurations for the Apigee organization. # Addon configurations of the Apigee organization. 345 "advancedApiOpsConfig": { # Configuration for the Advanced API Ops add-on. # Configuration for the Advanced API Ops add-on. 346 "enabled": True or False, # Flag that specifies whether the Advanced API Ops add-on is enabled. 347 }, 348 "connectorsPlatformConfig": { # Configuration for the Connectors Platform add-on. # Configuration for the Connectors Platform add-on. 349 "enabled": True or False, # Flag that specifies whether the Connectors Platform add-on is enabled. 350 "expiresAt": "A String", # Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire. 351 }, 352 "integrationConfig": { # Configuration for the Integration add-on. # Configuration for the Integration add-on. 353 "enabled": True or False, # Flag that specifies whether the Integration add-on is enabled. 354 }, 355 "monetizationConfig": { # Configuration for the Monetization add-on. # Configuration for the Monetization add-on. 356 "enabled": True or False, # Flag that specifies whether the Monetization add-on is enabled. 357 }, 358 }, 359 "analyticsRegion": "A String", # Required. Primary GCP region for analytics data storage. For valid values, see [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 360 "attributes": [ # Not used by Apigee. 361 "A String", 362 ], 363 "authorizedNetwork": "A String", # Compute Engine network used for Service Networking to be peered with Apigee runtime instances. See [Getting started with the Service Networking API](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started). Valid only when [RuntimeType](#RuntimeType) is set to `CLOUD`. The value must be set before the creation of a runtime instance and can be updated only when there are no runtime instances. For example: `default`. Apigee also supports shared VPC (that is, the host network project is not the same as the one that is peering with Apigee). See [Shared VPC overview](https://cloud.google.com/vpc/docs/shared-vpc). To use a shared VPC network, use the following format: `projects/{host-project-id}/{region}/networks/{network-name}`. For example: `projects/my-sharedvpc-host/global/networks/mynetwork` **Note:** Not supported for Apigee hybrid. 364 "billingType": "A String", # Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing). 365 "caCertificate": "A String", # Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`. 366 "createdAt": "A String", # Output only. Time that the Apigee organization was created in milliseconds since epoch. 367 "customerName": "A String", # Not used by Apigee. 368 "description": "A String", # Description of the Apigee organization. 369 "displayName": "A String", # Display name for the Apigee organization. Unused, but reserved for future use. 370 "environments": [ # Output only. List of environments in the Apigee organization. 371 "A String", 372 ], 373 "expiresAt": "A String", # Output only. Time that the Apigee organization is scheduled for deletion. 374 "lastModifiedAt": "A String", # Output only. Time that the Apigee organization was last modified in milliseconds since epoch. 375 "name": "A String", # Output only. Name of the Apigee organization. 376 "portalDisabled": True or False, # Configuration for the Portals settings. 377 "projectId": "A String", # Output only. Project ID associated with the Apigee organization. 378 "properties": { # Message for compatibility with legacy Edge specification for Java Properties object in JSON. # Properties defined in the Apigee organization profile. 379 "property": [ # List of all properties in the object 380 { # A single property entry in the Properties message. 381 "name": "A String", # The property key 382 "value": "A String", # The property value 383 }, 384 ], 385 }, 386 "runtimeDatabaseEncryptionKeyName": "A String", # Cloud KMS key name used for encrypting the data that is stored and replicated across runtime instances. Update is not allowed after the organization is created. Required when [RuntimeType](#RuntimeType) is `CLOUD`. If not specified when [RuntimeType](#RuntimeType) is `TRIAL`, a Google-Managed encryption key will be used. For example: "projects/foo/locations/us/keyRings/bar/cryptoKeys/baz". **Note:** Not supported for Apigee hybrid. 387 "runtimeType": "A String", # Required. Runtime type of the Apigee organization based on the Apigee subscription purchased. 388 "state": "A String", # Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use. 389 "subscriptionType": "A String", # Output only. DEPRECATED: This will eventually be replaced by BillingType. Subscription type of the Apigee organization. Valid values include trial (free, limited, and for evaluation purposes only) or paid (full subscription has been purchased). See [Apigee pricing](https://cloud.google.com/apigee/pricing/). 390 "type": "A String", # Not used by Apigee. 391}</pre> 392</div> 393 394<div class="method"> 395 <code class="details" id="getDeployedIngressConfig">getDeployedIngressConfig(name, view=None, x__xgafv=None)</code> 396 <pre>Gets the deployed ingress configuration for an organization. 397 398Args: 399 name: string, Required. Name of the deployed configuration for the organization in the following format: 'organizations/{org}/deployedIngressConfig'. (required) 400 view: string, When set to FULL, additional details about the specific deployments receiving traffic will be included in the IngressConfig response's RoutingRules. 401 Allowed values 402 INGRESS_CONFIG_VIEW_UNSPECIFIED - The default/unset value. The API will default to the BASIC view. 403 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. 404 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. 405 x__xgafv: string, V1 error format. 406 Allowed values 407 1 - v1 error format 408 2 - v2 error format 409 410Returns: 411 An object of the form: 412 413 { 414 "environmentGroups": [ # List of environment groups in the organization. 415 { # EnvironmentGroupConfig is a revisioned snapshot of an EnvironmentGroup and its associated routing rules. 416 "hostnames": [ # Host names for the environment group. 417 "A String", 418 ], 419 "name": "A String", # Name of the environment group in the following format: `organizations/{org}/envgroups/{envgroup}`. 420 "revisionId": "A String", # Revision id that defines the ordering of the EnvironmentGroupConfig resource. The higher the revision, the more recently the configuration was deployed. 421 "routingRules": [ # Ordered list of routing rules defining how traffic to this environment group's hostnames should be routed to different environments. 422 { 423 "basepath": "A String", # 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. 424 "envGroupRevision": "A String", # 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. 425 "environment": "A String", # Name of an environment bound to the environment group in the following format: `organizations/{org}/environments/{env}`. 426 "receiver": "A String", # 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. 427 "updateTime": "A String", # 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. 428 }, 429 ], 430 "uid": "A String", # A unique id for the environment group config that will only change if the environment group is deleted and recreated. 431 }, 432 ], 433 "name": "A String", # Name of the resource in the following format: `organizations/{org}/deployedIngressConfig`. 434 "revisionCreateTime": "A String", # Time at which the IngressConfig revision was created. 435 "revisionId": "A String", # Revision id that defines the ordering on IngressConfig resources. The higher the revision, the more recently the configuration was deployed. 436 "uid": "A String", # A unique id for the ingress config that will only change if the organization is deleted and recreated. 437}</pre> 438</div> 439 440<div class="method"> 441 <code class="details" id="getRuntimeConfig">getRuntimeConfig(name, x__xgafv=None)</code> 442 <pre>Get runtime config for an organization. 443 444Args: 445 name: string, Required. Name of the runtime config for the organization in the following format: 'organizations/{org}/runtimeConfig'. (required) 446 x__xgafv: string, V1 error format. 447 Allowed values 448 1 - v1 error format 449 2 - v2 error format 450 451Returns: 452 An object of the form: 453 454 { # Runtime configuration for the organization. Response for GetRuntimeConfig. 455 "analyticsBucket": "A String", # Cloud Storage bucket used for uploading Analytics records. 456 "name": "A String", # Name of the resource in the following format: `organizations/{org}/runtimeConfig`. 457 "tenantProjectId": "A String", # Output only. Tenant project ID associated with the Apigee organization. The tenant project is used to host Google-managed resources that are dedicated to this Apigee organization. Clients have limited access to resources within the tenant project used to support Apigee runtime instances. Access to the tenant project is managed using SetSyncAuthorization. It can be empty if the tenant project hasn't been created yet. 458 "traceBucket": "A String", # Cloud Storage bucket used for uploading Trace records. 459}</pre> 460</div> 461 462<div class="method"> 463 <code class="details" id="getSyncAuthorization">getSyncAuthorization(name, body=None, x__xgafv=None)</code> 464 <pre>Lists the service accounts with the permissions required to allow the Synchronizer to download environment data from the control plane. An ETag is returned in the response to `getSyncAuthorization`. Pass that ETag when calling [setSyncAuthorization](setSyncAuthorization) to ensure that you are updating the correct version. If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. For more information, see [Configure the Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**: Available to Apigee hybrid only. 465 466Args: 467 name: string, Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}` (required) 468 body: object, The request body. 469 The object takes the form of: 470 471{ # Request for GetSyncAuthorization. 472} 473 474 x__xgafv: string, V1 error format. 475 Allowed values 476 1 - v1 error format 477 2 - v2 error format 478 479Returns: 480 An object of the form: 481 482 { 483 "etag": "A String", # Entity tag (ETag) used for optimistic concurrency control as a way to help prevent simultaneous updates from overwriting each other. For example, when you call [getSyncAuthorization](organizations/getSyncAuthorization) an ETag is returned in the response. Pass that ETag when calling the [setSyncAuthorization](organizations/setSyncAuthorization) to ensure that you are updating the correct version. If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. **Note**: We strongly recommend that you use the ETag in the read-modify-write cycle to avoid race conditions. 484 "identities": [ # Required. Array of service accounts to grant access to control plane resources, each specified using the following format: `serviceAccount:` service-account-name. The service-account-name is formatted like an email address. For example: `my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com` You might specify multiple service accounts, for example, if you have multiple environments and wish to assign a unique service account to each one. The service accounts must have **Apigee Synchronizer Manager** role. See also [Create service accounts](https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts). 485 "A String", 486 ], 487}</pre> 488</div> 489 490<div class="method"> 491 <code class="details" id="list">list(parent, x__xgafv=None)</code> 492 <pre>Lists the Apigee organizations and associated GCP projects that you have permission to access. See [Understanding organizations](https://cloud.google.com/apigee/docs/api-platform/fundamentals/organization-structure). 493 494Args: 495 parent: string, Required. Use the following structure in your request: `organizations` (required) 496 x__xgafv: string, V1 error format. 497 Allowed values 498 1 - v1 error format 499 2 - v2 error format 500 501Returns: 502 An object of the form: 503 504 { 505 "organizations": [ # List of Apigee organizations and associated GCP projects. 506 { 507 "organization": "A String", # Name of the Apigee organization. 508 "projectId": "A String", # GCP project associated with the Apigee organization 509 "projectIds": [ # DEPRECATED: Use `project_id`. An Apigee Organization is mapped to a single project. 510 "A String", 511 ], 512 }, 513 ], 514}</pre> 515</div> 516 517<div class="method"> 518 <code class="details" id="setAddons">setAddons(org, body=None, x__xgafv=None)</code> 519 <pre>Configures the add-ons for the Apigee organization. The existing add-on configuration will be fully replaced. 520 521Args: 522 org: string, Required. Name of the organization. Use the following structure in your request: `organizations/{org}` (required) 523 body: object, The request body. 524 The object takes the form of: 525 526{ # Request for SetAddons. 527 "addonsConfig": { # Add-on configurations for the Apigee organization. # Required. Add-on configurations. 528 "advancedApiOpsConfig": { # Configuration for the Advanced API Ops add-on. # Configuration for the Advanced API Ops add-on. 529 "enabled": True or False, # Flag that specifies whether the Advanced API Ops add-on is enabled. 530 }, 531 "connectorsPlatformConfig": { # Configuration for the Connectors Platform add-on. # Configuration for the Connectors Platform add-on. 532 "enabled": True or False, # Flag that specifies whether the Connectors Platform add-on is enabled. 533 "expiresAt": "A String", # Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire. 534 }, 535 "integrationConfig": { # Configuration for the Integration add-on. # Configuration for the Integration add-on. 536 "enabled": True or False, # Flag that specifies whether the Integration add-on is enabled. 537 }, 538 "monetizationConfig": { # Configuration for the Monetization add-on. # Configuration for the Monetization add-on. 539 "enabled": True or False, # Flag that specifies whether the Monetization add-on is enabled. 540 }, 541 }, 542} 543 544 x__xgafv: string, V1 error format. 545 Allowed values 546 1 - v1 error format 547 2 - v2 error format 548 549Returns: 550 An object of the form: 551 552 { # This resource represents a long-running operation that is the result of a network API call. 553 "done": 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. 554 "error": { # 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. 555 "code": 42, # The status code, which should be an enum value of google.rpc.Code. 556 "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. 557 { 558 "a_key": "", # Properties of the object. Contains field @type with type URL. 559 }, 560 ], 561 "message": "A String", # 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. 562 }, 563 "metadata": { # 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. 564 "a_key": "", # Properties of the object. Contains field @type with type URL. 565 }, 566 "name": "A String", # 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}`. 567 "response": { # 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`. 568 "a_key": "", # Properties of the object. Contains field @type with type URL. 569 }, 570}</pre> 571</div> 572 573<div class="method"> 574 <code class="details" id="setSyncAuthorization">setSyncAuthorization(name, body=None, x__xgafv=None)</code> 575 <pre>Sets the permissions required to allow the Synchronizer to download environment data from the control plane. You must call this API to enable proper functioning of hybrid. Pass the ETag when calling `setSyncAuthorization` to ensure that you are updating the correct version. To get an ETag, call [getSyncAuthorization](getSyncAuthorization). If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. For more information, see [Configure the Synchronizer](https://cloud.google.com/apigee/docs/hybrid/latest/synchronizer-access). **Note**: Available to Apigee hybrid only. 576 577Args: 578 name: string, Required. Name of the Apigee organization. Use the following structure in your request: `organizations/{org}` (required) 579 body: object, The request body. 580 The object takes the form of: 581 582{ 583 "etag": "A String", # Entity tag (ETag) used for optimistic concurrency control as a way to help prevent simultaneous updates from overwriting each other. For example, when you call [getSyncAuthorization](organizations/getSyncAuthorization) an ETag is returned in the response. Pass that ETag when calling the [setSyncAuthorization](organizations/setSyncAuthorization) to ensure that you are updating the correct version. If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. **Note**: We strongly recommend that you use the ETag in the read-modify-write cycle to avoid race conditions. 584 "identities": [ # Required. Array of service accounts to grant access to control plane resources, each specified using the following format: `serviceAccount:` service-account-name. The service-account-name is formatted like an email address. For example: `my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com` You might specify multiple service accounts, for example, if you have multiple environments and wish to assign a unique service account to each one. The service accounts must have **Apigee Synchronizer Manager** role. See also [Create service accounts](https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts). 585 "A String", 586 ], 587} 588 589 x__xgafv: string, V1 error format. 590 Allowed values 591 1 - v1 error format 592 2 - v2 error format 593 594Returns: 595 An object of the form: 596 597 { 598 "etag": "A String", # Entity tag (ETag) used for optimistic concurrency control as a way to help prevent simultaneous updates from overwriting each other. For example, when you call [getSyncAuthorization](organizations/getSyncAuthorization) an ETag is returned in the response. Pass that ETag when calling the [setSyncAuthorization](organizations/setSyncAuthorization) to ensure that you are updating the correct version. If you don't pass the ETag in the call to `setSyncAuthorization`, then the existing authorization is overwritten indiscriminately. **Note**: We strongly recommend that you use the ETag in the read-modify-write cycle to avoid race conditions. 599 "identities": [ # Required. Array of service accounts to grant access to control plane resources, each specified using the following format: `serviceAccount:` service-account-name. The service-account-name is formatted like an email address. For example: `my-synchronizer-manager-service_account@my_project_id.iam.gserviceaccount.com` You might specify multiple service accounts, for example, if you have multiple environments and wish to assign a unique service account to each one. The service accounts must have **Apigee Synchronizer Manager** role. See also [Create service accounts](https://cloud.google.com/apigee/docs/hybrid/latest/sa-about#create-the-service-accounts). 600 "A String", 601 ], 602}</pre> 603</div> 604 605<div class="method"> 606 <code class="details" id="update">update(name, body=None, x__xgafv=None)</code> 607 <pre>Updates the properties for an Apigee organization. No other fields in the organization profile will be updated. 608 609Args: 610 name: string, Required. Apigee organization name in the following format: `organizations/{org}` (required) 611 body: object, The request body. 612 The object takes the form of: 613 614{ 615 "addonsConfig": { # Add-on configurations for the Apigee organization. # Addon configurations of the Apigee organization. 616 "advancedApiOpsConfig": { # Configuration for the Advanced API Ops add-on. # Configuration for the Advanced API Ops add-on. 617 "enabled": True or False, # Flag that specifies whether the Advanced API Ops add-on is enabled. 618 }, 619 "connectorsPlatformConfig": { # Configuration for the Connectors Platform add-on. # Configuration for the Connectors Platform add-on. 620 "enabled": True or False, # Flag that specifies whether the Connectors Platform add-on is enabled. 621 "expiresAt": "A String", # Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire. 622 }, 623 "integrationConfig": { # Configuration for the Integration add-on. # Configuration for the Integration add-on. 624 "enabled": True or False, # Flag that specifies whether the Integration add-on is enabled. 625 }, 626 "monetizationConfig": { # Configuration for the Monetization add-on. # Configuration for the Monetization add-on. 627 "enabled": True or False, # Flag that specifies whether the Monetization add-on is enabled. 628 }, 629 }, 630 "analyticsRegion": "A String", # Required. Primary GCP region for analytics data storage. For valid values, see [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 631 "attributes": [ # Not used by Apigee. 632 "A String", 633 ], 634 "authorizedNetwork": "A String", # Compute Engine network used for Service Networking to be peered with Apigee runtime instances. See [Getting started with the Service Networking API](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started). Valid only when [RuntimeType](#RuntimeType) is set to `CLOUD`. The value must be set before the creation of a runtime instance and can be updated only when there are no runtime instances. For example: `default`. Apigee also supports shared VPC (that is, the host network project is not the same as the one that is peering with Apigee). See [Shared VPC overview](https://cloud.google.com/vpc/docs/shared-vpc). To use a shared VPC network, use the following format: `projects/{host-project-id}/{region}/networks/{network-name}`. For example: `projects/my-sharedvpc-host/global/networks/mynetwork` **Note:** Not supported for Apigee hybrid. 635 "billingType": "A String", # Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing). 636 "caCertificate": "A String", # Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`. 637 "createdAt": "A String", # Output only. Time that the Apigee organization was created in milliseconds since epoch. 638 "customerName": "A String", # Not used by Apigee. 639 "description": "A String", # Description of the Apigee organization. 640 "displayName": "A String", # Display name for the Apigee organization. Unused, but reserved for future use. 641 "environments": [ # Output only. List of environments in the Apigee organization. 642 "A String", 643 ], 644 "expiresAt": "A String", # Output only. Time that the Apigee organization is scheduled for deletion. 645 "lastModifiedAt": "A String", # Output only. Time that the Apigee organization was last modified in milliseconds since epoch. 646 "name": "A String", # Output only. Name of the Apigee organization. 647 "portalDisabled": True or False, # Configuration for the Portals settings. 648 "projectId": "A String", # Output only. Project ID associated with the Apigee organization. 649 "properties": { # Message for compatibility with legacy Edge specification for Java Properties object in JSON. # Properties defined in the Apigee organization profile. 650 "property": [ # List of all properties in the object 651 { # A single property entry in the Properties message. 652 "name": "A String", # The property key 653 "value": "A String", # The property value 654 }, 655 ], 656 }, 657 "runtimeDatabaseEncryptionKeyName": "A String", # Cloud KMS key name used for encrypting the data that is stored and replicated across runtime instances. Update is not allowed after the organization is created. Required when [RuntimeType](#RuntimeType) is `CLOUD`. If not specified when [RuntimeType](#RuntimeType) is `TRIAL`, a Google-Managed encryption key will be used. For example: "projects/foo/locations/us/keyRings/bar/cryptoKeys/baz". **Note:** Not supported for Apigee hybrid. 658 "runtimeType": "A String", # Required. Runtime type of the Apigee organization based on the Apigee subscription purchased. 659 "state": "A String", # Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use. 660 "subscriptionType": "A String", # Output only. DEPRECATED: This will eventually be replaced by BillingType. Subscription type of the Apigee organization. Valid values include trial (free, limited, and for evaluation purposes only) or paid (full subscription has been purchased). See [Apigee pricing](https://cloud.google.com/apigee/pricing/). 661 "type": "A String", # Not used by Apigee. 662} 663 664 x__xgafv: string, V1 error format. 665 Allowed values 666 1 - v1 error format 667 2 - v2 error format 668 669Returns: 670 An object of the form: 671 672 { 673 "addonsConfig": { # Add-on configurations for the Apigee organization. # Addon configurations of the Apigee organization. 674 "advancedApiOpsConfig": { # Configuration for the Advanced API Ops add-on. # Configuration for the Advanced API Ops add-on. 675 "enabled": True or False, # Flag that specifies whether the Advanced API Ops add-on is enabled. 676 }, 677 "connectorsPlatformConfig": { # Configuration for the Connectors Platform add-on. # Configuration for the Connectors Platform add-on. 678 "enabled": True or False, # Flag that specifies whether the Connectors Platform add-on is enabled. 679 "expiresAt": "A String", # Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire. 680 }, 681 "integrationConfig": { # Configuration for the Integration add-on. # Configuration for the Integration add-on. 682 "enabled": True or False, # Flag that specifies whether the Integration add-on is enabled. 683 }, 684 "monetizationConfig": { # Configuration for the Monetization add-on. # Configuration for the Monetization add-on. 685 "enabled": True or False, # Flag that specifies whether the Monetization add-on is enabled. 686 }, 687 }, 688 "analyticsRegion": "A String", # Required. Primary GCP region for analytics data storage. For valid values, see [Create an Apigee organization](https://cloud.google.com/apigee/docs/api-platform/get-started/create-org). 689 "attributes": [ # Not used by Apigee. 690 "A String", 691 ], 692 "authorizedNetwork": "A String", # Compute Engine network used for Service Networking to be peered with Apigee runtime instances. See [Getting started with the Service Networking API](https://cloud.google.com/service-infrastructure/docs/service-networking/getting-started). Valid only when [RuntimeType](#RuntimeType) is set to `CLOUD`. The value must be set before the creation of a runtime instance and can be updated only when there are no runtime instances. For example: `default`. Apigee also supports shared VPC (that is, the host network project is not the same as the one that is peering with Apigee). See [Shared VPC overview](https://cloud.google.com/vpc/docs/shared-vpc). To use a shared VPC network, use the following format: `projects/{host-project-id}/{region}/networks/{network-name}`. For example: `projects/my-sharedvpc-host/global/networks/mynetwork` **Note:** Not supported for Apigee hybrid. 693 "billingType": "A String", # Billing type of the Apigee organization. See [Apigee pricing](https://cloud.google.com/apigee/pricing). 694 "caCertificate": "A String", # Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when [RuntimeType](#RuntimeType) is `CLOUD`. 695 "createdAt": "A String", # Output only. Time that the Apigee organization was created in milliseconds since epoch. 696 "customerName": "A String", # Not used by Apigee. 697 "description": "A String", # Description of the Apigee organization. 698 "displayName": "A String", # Display name for the Apigee organization. Unused, but reserved for future use. 699 "environments": [ # Output only. List of environments in the Apigee organization. 700 "A String", 701 ], 702 "expiresAt": "A String", # Output only. Time that the Apigee organization is scheduled for deletion. 703 "lastModifiedAt": "A String", # Output only. Time that the Apigee organization was last modified in milliseconds since epoch. 704 "name": "A String", # Output only. Name of the Apigee organization. 705 "portalDisabled": True or False, # Configuration for the Portals settings. 706 "projectId": "A String", # Output only. Project ID associated with the Apigee organization. 707 "properties": { # Message for compatibility with legacy Edge specification for Java Properties object in JSON. # Properties defined in the Apigee organization profile. 708 "property": [ # List of all properties in the object 709 { # A single property entry in the Properties message. 710 "name": "A String", # The property key 711 "value": "A String", # The property value 712 }, 713 ], 714 }, 715 "runtimeDatabaseEncryptionKeyName": "A String", # Cloud KMS key name used for encrypting the data that is stored and replicated across runtime instances. Update is not allowed after the organization is created. Required when [RuntimeType](#RuntimeType) is `CLOUD`. If not specified when [RuntimeType](#RuntimeType) is `TRIAL`, a Google-Managed encryption key will be used. For example: "projects/foo/locations/us/keyRings/bar/cryptoKeys/baz". **Note:** Not supported for Apigee hybrid. 716 "runtimeType": "A String", # Required. Runtime type of the Apigee organization based on the Apigee subscription purchased. 717 "state": "A String", # Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use. 718 "subscriptionType": "A String", # Output only. DEPRECATED: This will eventually be replaced by BillingType. Subscription type of the Apigee organization. Valid values include trial (free, limited, and for evaluation purposes only) or paid (full subscription has been purchased). See [Apigee pricing](https://cloud.google.com/apigee/pricing/). 719 "type": "A String", # Not used by Apigee. 720}</pre> 721</div> 722 723</body></html>