REST Resource: organizations

Resource: Organization

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "customerName": string,
  "attributes": [
    string
  ],
  "createdAt": string,
  "lastModifiedAt": string,
  "expiresAt": string,
  "environments": [
    string
  ],
  "properties": {
    object (Properties)
  },
  "type": enum (Type),
  "analyticsRegion": string,
  "authorizedNetwork": string,
  "disableVpcPeering": boolean,
  "runtimeType": enum (RuntimeType),
  "subscriptionType": enum (SubscriptionType),
  "billingType": enum (BillingType),
  "addonsConfig": {
    object (AddonsConfig)
  },
  "caCertificate": string,
  "runtimeDatabaseEncryptionKeyName": string,
  "projectId": string,
  "state": enum (State),
  "portalDisabled": boolean,
  "apiConsumerDataEncryptionKeyName": string,
  "controlPlaneEncryptionKeyName": string,
  "apiConsumerDataLocation": string,
  "apigeeProjectId": string,
  "subscriptionPlan": enum (SubscriptionPlan)
}
Fields
name

string

Output only. Name of the Apigee organization.

displayName

string

Display name for the Apigee organization. Unused, but reserved for future use.

description

string

Description of the Apigee organization.

customerName

string

Not used by Apigee.

attributes[]

string

Not used by Apigee.

createdAt

string (int64 format)

Output only. Time that the Apigee organization was created in milliseconds since epoch.

lastModifiedAt

string (int64 format)

Output only. Time that the Apigee organization was last modified in milliseconds since epoch.

expiresAt

string (int64 format)

Output only. Time that the Apigee organization is scheduled for deletion.

environments[]

string

Output only. List of environments in the Apigee organization.

properties

object (Properties)

Properties defined in the Apigee organization profile.

type

enum (Type)

Not used by Apigee.

analyticsRegion
(deprecated)

string

Required. 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.

authorizedNetwork

string

Compute 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.

disableVpcPeering

boolean

Optional. 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.

runtimeType

enum (RuntimeType)

Required. Runtime type of the Apigee organization based on the Apigee subscription purchased.

subscriptionType
(deprecated)

enum (SubscriptionType)

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.

billingType

enum (BillingType)

Billing type of the Apigee organization. See Apigee pricing.

addonsConfig

object (AddonsConfig)

Addon configurations of the Apigee organization.

caCertificate

string (bytes format)

Output only. Base64-encoded public certificate for the root CA of the Apigee organization. Valid only when RuntimeType is CLOUD.

A base64-encoded string.

runtimeDatabaseEncryptionKeyName

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 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.

projectId

string

Output only. Project ID associated with the Apigee organization.

state

enum (State)

Output only. State of the organization. Values other than ACTIVE means the resource is not ready to use.

portalDisabled

boolean

Configuration for the Portals settings.

apiConsumerDataEncryptionKeyName

string

Cloud 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/*

controlPlaneEncryptionKeyName

string

Cloud 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/*

apiConsumerDataLocation

string

This 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.

apigeeProjectId

string

Output 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.

subscriptionPlan

enum (SubscriptionPlan)

Output only. Subscription plan that the customer has purchased. Output only.

Type

Enums
TYPE_UNSPECIFIED Subscription type not specified.
TYPE_TRIAL Subscription to Apigee is free, limited, and used for evaluation purposes only.
TYPE_PAID Full subscription to Apigee has been purchased. See Apigee pricing.
TYPE_INTERNAL For internal users only.

RuntimeType

Enums
RUNTIME_TYPE_UNSPECIFIED Runtime type not specified.
CLOUD Google-managed Apigee runtime.
HYBRID User-managed Apigee hybrid runtime.

SubscriptionType

Enums
SUBSCRIPTION_TYPE_UNSPECIFIED Subscription type not specified.
PAID Full subscription to Apigee has been purchased.
TRIAL Subscription to Apigee is free, limited, and used for evaluation purposes only.

BillingType

Billing type of the Apigee organization.

Enums
BILLING_TYPE_UNSPECIFIED Billing type not specified.
SUBSCRIPTION A pre-paid subscription to Apigee.
EVALUATION Free and limited access to Apigee for evaluation purposes only.
PAYG Access to Apigee using a Pay-As-You-Go plan.

AddonsConfig

Add-on configurations for the Apigee organization.

JSON representation
{
  "advancedApiOpsConfig": {
    object (AdvancedApiOpsConfig)
  },
  "integrationConfig": {
    object (IntegrationConfig)
  },
  "monetizationConfig": {
    object (MonetizationConfig)
  },
  "apiSecurityConfig": {
    object (ApiSecurityConfig)
  },
  "connectorsPlatformConfig": {
    object (ConnectorsPlatformConfig)
  },
  "analyticsConfig": {
    object (AnalyticsConfig)
  }
}
Fields
advancedApiOpsConfig

object (AdvancedApiOpsConfig)

Configuration for the Advanced API Ops add-on.

integrationConfig

object (IntegrationConfig)

Configuration for the Integration add-on.

monetizationConfig

object (MonetizationConfig)

Configuration for the Monetization add-on.

apiSecurityConfig

object (ApiSecurityConfig)

Configuration for the API Security add-on.

connectorsPlatformConfig

object (ConnectorsPlatformConfig)

Configuration for the Connectors Platform add-on.

analyticsConfig

object (AnalyticsConfig)

Configuration for the Analytics add-on.

AdvancedApiOpsConfig

Configuration for the Advanced API Ops add-on.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Flag that specifies whether the Advanced API Ops add-on is enabled.

IntegrationConfig

Configuration for the Integration add-on.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Flag that specifies whether the Integration add-on is enabled.

MonetizationConfig

Configuration for the Monetization add-on.

JSON representation
{
  "enabled": boolean
}
Fields
enabled

boolean

Flag that specifies whether the Monetization add-on is enabled.

ApiSecurityConfig

Configurations of the API Security add-on.

JSON representation
{
  "enabled": boolean,
  "expiresAt": string
}
Fields
enabled

boolean

Flag that specifies whether the API security add-on is enabled.

expiresAt

string (int64 format)

Output only. Time at which the API Security add-on expires in in milliseconds since epoch. If unspecified, the add-on will never expire.

ConnectorsPlatformConfig

Configuration for the Connectors Platform add-on.

JSON representation
{
  "enabled": boolean,
  "expiresAt": string
}
Fields
enabled

boolean

Flag that specifies whether the Connectors Platform add-on is enabled.

expiresAt

string (int64 format)

Output only. Time at which the Connectors Platform add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire.

AnalyticsConfig

Configuration for the Analytics add-on.

JSON representation
{
  "enabled": boolean,
  "expireTimeMillis": string,
  "state": enum (AddonState),
  "updateTime": string
}
Fields
enabled

boolean

Whether the Analytics add-on is enabled.

expireTimeMillis

string (int64 format)

Output only. Time at which the Analytics add-on expires in milliseconds since epoch. If unspecified, the add-on will never expire.

state

enum (AddonState)

Output only. The state of the Analytics add-on.

updateTime

string (Timestamp format)

Output only. The latest update time.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

AddonState

The actual state of an addon.

Enums
ADDON_STATE_UNSPECIFIED Default value.
ENABLING Add-on is in progress of enabling.
ENABLED Add-on is fully enabled and ready to use.
DISABLING Add-on is in progress of disabling.
DISABLED Add-on is fully disabled.

SubscriptionPlan

Subscription plan that the customer has purchased.

Enums
SUBSCRIPTION_PLAN_UNSPECIFIED Subscription plan not specified.
SUBSCRIPTION_2021 Traditional subscription plan.
SUBSCRIPTION_2024 New subscription plan that provides standard proxy and scaled proxy implementation.

Methods

create

Creates an Apigee organization.

delete

Delete an Apigee organization.

get

Gets the profile for an Apigee organization.

getProjectMapping

Gets the project ID and region for an Apigee organization.

getSecuritySettings

GetSecuritySettings gets the security settings for API Security.

getSyncAuthorization

Lists the service accounts with the permissions required to allow the Synchronizer to download environment data from the control plane.

list

Lists the Apigee organizations and associated Google Cloud projects that you have permission to access.

setAddons

Configures the add-ons for the Apigee organization.

setSyncAuthorization

Sets the permissions required to allow the Synchronizer to download environment data from the control plane.

update

Updates the properties for an Apigee organization.

updateSecuritySettings

UpdateSecuritySettings updates the current security settings for API Security.