Skip to main content

organizations

Overview

Nameorganizations
TypeResource
Idgoogle.apigee.organizations

Fields

NameDatatypeDescription
namestringOutput only. Name of the Apigee organization.
descriptionstringDescription of the Apigee organization.
addonsConfigobjectAdd-on configurations for the Apigee organization.
analyticsRegionstringRequired. DEPRECATED: This field will eventually be deprecated and replaced with a differently-named field. Primary Google Cloud region for analytics data storage. For valid values, see Create an Apigee organization.
apiConsumerDataEncryptionKeyNamestringCloud KMS key name used for encrypting API consumer data. Required for US/EU regions when BillingType is SUBSCRIPTION. When BillingType is EVALUATION or the region is not US/EU, a Google-Managed encryption key will be used. Format: projects/*/locations/*/keyRings/*/cryptoKeys/*
apiConsumerDataLocationstringThis field is needed only for customers with control plane in US or EU. Apigee stores some control plane data only in single region. This field determines which single region Apigee should use. For example: "us-west1" when control plane is in US or "europe-west2" when control plane is in EU.
apigeeProjectIdstringOutput only. Apigee Project ID associated with the organization. Use this project to allowlist Apigee in the Service Attachment when using private service connect with Apigee.
attributesarrayNot used by Apigee.
authorizedNetworkstringCompute Engine network used for Service Networking to be peered with Apigee runtime instances. See Getting started with the Service Networking API. Valid only when 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. 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.
billingTypestringBilling type of the Apigee organization. See Apigee pricing.
caCertificatestringOutput only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when RuntimeType is CLOUD.
controlPlaneEncryptionKeyNamestringCloud KMS key name used for encrypting control plane data that is stored in a multi region. Required when BillingType is SUBSCRIPTION. When BillingType is EVALUATION, a Google-Managed encryption key will be used. Format: projects/*/locations/*/keyRings/*/cryptoKeys/*
createdAtstringOutput only. Time that the Apigee organization was created in milliseconds since epoch.
customerNamestringNot used by Apigee.
disableVpcPeeringbooleanOptional. Flag that specifies whether the VPC Peering through Private Google Access should be disabled between the consumer network and Apigee. Valid only when RuntimeType is set to CLOUD. Required if an authorizedNetwork on the consumer project is not provided, in which case the flag should be set to true. The value must be set before the creation of any Apigee runtime instance and can be updated only when there are no runtime instances. Note: Apigee will be deprecating the vpc peering model that requires you to provide 'authorizedNetwork', by making the non-peering model as the default way of provisioning Apigee organization in future. So, this will be a temporary flag to enable the transition. Not supported for Apigee hybrid.
displayNamestringDisplay name for the Apigee organization. Unused, but reserved for future use.
environmentsarrayOutput only. List of environments in the Apigee organization.
expiresAtstringOutput only. Time that the Apigee organization is scheduled for deletion.
lastModifiedAtstringOutput only. Time that the Apigee organization was last modified in milliseconds since epoch.
portalDisabledbooleanConfiguration for the Portals settings.
projectIdstringOutput only. Project ID associated with the Apigee organization.
propertiesobjectMessage for compatibility with legacy Edge specification for Java Properties object in JSON.
runtimeDatabaseEncryptionKeyNamestringCloud 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 is CLOUD. If not specified when 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.
runtimeTypestringRequired. Runtime type of the Apigee organization based on the Apigee subscription purchased.
statestringOutput only. State of the organization. Values other than ACTIVE means the resource is not ready to use.
subscriptionTypestringOutput 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.
typestringNot used by Apigee.

Methods

NameAccessible byRequired ParamsDescription
organizations_getSELECTorganizationsIdGets the profile for an Apigee organization. See Understanding organizations.
organizations_listSELECTLists the Apigee organizations and associated Google Cloud projects that you have permission to access. See Understanding organizations.
organizations_createINSERTCreates an Apigee organization. See Create an Apigee organization.
organizations_deleteDELETEorganizationsIdDelete an Apigee organization. For organizations with BillingType EVALUATION, an immediate deletion is performed. For paid organizations, a soft-deletion is performed. The organization can be restored within the soft-deletion period which can be controlled using the retention field in the request.
organizations_set_addonsEXECorganizationsIdConfigures the add-ons for the Apigee organization. The existing add-on configuration will be fully replaced.
organizations_set_sync_authorizationEXECorganizationsIdSets 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. 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. Note: Available to Apigee hybrid only.
organizations_updateEXECorganizationsIdUpdates the properties for an Apigee organization. No other fields in the organization profile will be updated.